Doc
  • Comece Já
  • Academia
  • Biblioteca
  • Languages iconPortuguês
    • English

›Demo Application

Academy

  • Visão Geral
  • Introdução
  • Backoffice
  • Poliglota
  • Apps
  • API
  • Estratégia
  • Demo Application

    • Configuração
    • Formulário
    • Relacionar Dados
    • Serviço
    • Interface & Design
  • Próximos Passos
  • Primeira aplicação

Explore

  • Configuração
  • Centralized Terminal
  • Linha de Comandos
  • Serviços
  • Indústria
  • Graphical Interface

    • Conheça a interface gráfica
    • Formulários
    • Campos
    • Queries Interface

User Interface

  • Modal Form
  • Implementar tabelas e gráficos
  • Eventos do Ciclo de Vida

Server

    Database

    • Excel
    • H2Database
    • MSSQL
    • Múltiplas bases de dados
    • PostgreSQL
    • DB Connection Pool

    Services

    • Serviços Web REST
    • WebSocket
    • JWT Token
    • OpenAPI
    • CORS
    • Queries Programaticamente
    • Gerar Unique ID's (UID/GUID)
    • Envio de e-mails
    • XLS - Excel
    • PDF
  • Actions
  • Cron Jobs
  • Custom URLs
  • Setup dos Dados
  • Monitor e Alertas
  • Templates
  • Desenvolvimento e debug em Java
  • Integração com NGINX

Website

  • ReactJS Create
  • Pages & Routers

Serviço

Com o Netuno é possível criar Web Services e construir qualquer tipo de APIs REST complexas.

Os serviços (Web Services) servem para realizar a integração de dados online, onde um sistema web pode trocar informação com outro.

Também serve para fornecer os dados para a frontend (páginas web) de forma assíncrona, permitindo à frontend carregar a parte visual da página web de forma mais rápida e obter a informação dinâmica através da integração com serviços (Web Services).

Isto permite proporcionar uma melhor experiência ao utilizador final, porque não fica à espera que a página toda seja processada pelo servidor e só depois devolvida, mas sim que o servidor envie rapidamente a estrutura da página que será apresentada e só depois é que efetua o carregamento gradual dos dados dinâmicos.

Editor

Para criar um serviço no Netuno é preciso um editor de código.

Recomendamos o Visual Studio Code, é gratuito, rápido, bastante simples e intuitivo.

Mas caso opte por qualquer outro editor de código funcionará de forma semelhante e todo o processo de desenvolvimento acaba por ser semelhante.

Abrir a Aplicação Demo

No Visual Studio Code ao clicar no canto esquerdo no primeiro ícone de ficheiros, tem a opção para Abrir uma Pasta (Open Folder).

Navegue nos sistema de ficheiros até a pasta onde tem o Netuno instalado.

Dentro da pasta do Netuno vá até ao diretório:

  • 📂 apps/demo

E quando estiver dentro da pasta demo clique em Abrir (Open).

Repare que a estrutura de pastas e de ficheiros da aplicação demo foram carregadas do lado esquerdo.

Criar Serviço

Os serviços são processados pelo servidor, assim para criar o serviço é preciso expandir as pastas e ir até a pasta:

  • 📂 server/services

Agora basta clicar com o botão direito em cima da pasta 📂 services e escolher a opção Novo Ficheiro (New File).

O nome do novo ficheiro deverá ser trabalhadores.js, vamos criar um serviço em JavaScript.

Basta agora realizar a codificação do nosso serviço, que será assim:

/**
*** Formata o objeto passado em JSON e realiza o seu output.
*/
const dbRegistos = _db.query(`
    SELECT DISTINCT
        trabalhador.nome, SUM(DATEDIFF(HOUR, registo.inicio, registo.fim)) AS total
    FROM trabalhador INNER JOIN registo
        ON trabalhador.id = registo.trabalhador_id
    WHERE trabalhador.active = true AND registo.active = true
    GROUP BY trabalhador.nome
    ORDER BY total ASC
`);

const lista = _val.list();

for (const dbRegisto of dbRegistos) {
    lista.add(
        _val.map()
            .set("name", dbRegisto.getString("nome"))
            .set("total", dbRegisto.getInt("total"))
    );
}

_out.json(lista);

Certifique há dados carregados nas Tarefas e que estão relacionadas com o Registo, caso contrário o resultado será vazio.

O _db.query recebe uma string com uma consulta de base de dados e realiza a sua execução transformando os dados obtidos numa lista de objectos do tipo chave-valor, ou seja coluna-dados.

O _out.json realiza o output (saída de dados) para o browser do tipo ContentType: application/json e formata o objeto passado para ser estruturado como um objeto JSON.

Executar o Serviço

Para executar o serviço basta abrir no browser o endereço do serviço criado, que neste caso será:

  • http://localhost:9000/services/trabalhadores

Neste caso recomendamos o Firefox por que permite uma melhor visualização do objeto JSON.

← Relacionar DadosInterface & Design →
  • Editor
  • Abrir a Aplicação Demo
  • Criar Serviço
  • Executar o Serviço

Open Source

Download

admin@netuno.org

support@netuno.org

Copyright © Sitana 2022