Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Entre os tipos de projetos disponíveis para criação Dentre as opções de projetos low-code disponíveis no Cronapp estão os projetos de Microsserviços. Um microsserviço é uma abordagem arquitetônica e organizacional do desenvolvimento de software de software na qual consiste em pequenos serviços independentes que se comunicam usando APIs bem definidas . Diferentemente dos demais tipos disponíveis, projetos em arquitetura monolítica, em que todos os processos são altamente acoplados e executam como um único serviço, os projetos de microsserviços são executados de forma independente, por isso cada serviço pode ser atualizado, implantado e escalado para atender a demanda de funções específicas de uma aplicação com agilidade, baixo acoplamento, escalabilidade, flexibilidade e fácil implantação.e, por isso, não possui os recursos de interfaces cliente de um projeto web ou mobile, mas apenas os recursos de uma aplicação servidor. 

Dessa forma, projetos do tipo de Microsserviços permitem a criação de um projeto enxutosimplificado, sem tantas muitas funcionalidades prontaspredefinidas, oferecendo ao usuário autonomia para desenvolver os serviços necessários à sua aplicação com agilidade, baixo acoplamento, escalabilidade e flexibilidade. Nesta documentação, abordaremos as principais características de um projeto projetos de Microsserviços, seus os recursos disponíveis e as diferenças entre os demais tipos de projetos low-code disponíveis no do Cronapp.

Criar projeto

Novo Projeto

Para criar um projeto do tipo Microsserviços, clique no botão Novo Projeto (seta da Figura 1) e a . A primeira janela de configuração será aberta para selecionar o exibida, permitindo a escolha do tipo do projeto. Selecione o tipo tipo Microsserviços (destaque 1), em seguida, informe um nome (2) e escolha a opção Baseado em Modelo existente, por fim, clique em Finalizar. Para mais informações dos campos de configuração, consulte a documentação Criar projeto.


Figura 1 - Criação de um projeto de Microsserviços no Cronapp

Modelos

Âncora
modelos
modelos

Modelos

Os modelos de Microsserviços possuem uma série de tecnologias que vem integradas junto com sua aplicação. Atualmente dois modelos de microsserviços estão disponíveis: Serviço de dados, que oferecem serviços suportados por banco de dados, e Serviço de negócio, um modelo mais simplificado. Selecione a opção desejada e clique em Avançar. Abaixo, listamos as principais características de cada modelo.


Figura 1.1 - Modelos disponíveis para o projeto de Microsserviços


  1. Serviço de dados: fornece ao usuário a funcionalidade de gerenciar serviços suportados por banco de dados. Esse modelo possui mais recursos previamente configurados em comparação com o de "Serviço de negócio", por exemplo, já possui uma classe "Sample" no Diagrama de dados e a tabela correspondente no Banco de dados, além do arquivo persistence.xml.

  2. Serviços de negócios: oferece mais autonomia define um projeto mais simplificado e fornece ao usuário a autonomia para desenvolver a aplicação de acordo com os objetivos gerais dos negócios de sua organização. É um Este modelo com possui menos recursos configurados que em comparação com o modelo anterior, por exemplo, não possui um Diagrama de dados e conexões criadas no  Banco de dados configurados. No entanto, se necessário, é possível configurar essas funcionalidades conforme a necessidade.

Configuração

A próxima tela permite definir as informações de configuração do Id da Aplicação e Tipo de Autorização. Essa mesma janela será exibida (Figura 1.2) será exibida, independente do modelo escolhido na janela anterior (Figura 1.1). Para concluir a criação do projeto, clique em em Finalizar.


Figura 1.2 - Janela de configurações iniciais do projeto


  • Id da Aplicação: identificação da aplicação.
  • Tipo de Autorização: define o tipo de autorização dos serviços. Como trata-se do No contexto de acesso a serviços, apenas o tipo "Token" está disponível, sendo utilizado empregado para conceder ou negar acesso a serviços específicos do sistema.


Ao finalizar as configurações de criação do projeto, o Cronapp exibirá uma pop-up perguntando se você deseja habilitar o backup automático desse projeto. Após a escolha ou não de backup, a criação do projeto será concluída.

Recursos disponíveis

Como informado anteriormente, projetos Projetos de Microsserviços possuem apresentam menos funcionalidades que um projeto web e mobilequando comparados a projetos web ou mobile, uma vez que não incluem os recursos de interfaces cliente. Além disso, algumas funcionalidades possuem algumas diferenças em seus recursos. A seguir, destacamos os principais recursos e funcionalidades da árvore de arquivos, menu "Projetos" e ferramentas disponíveis nesse tipo de projeto no Cronapp.

Árvore de arquivos

A árvore de arquivos exibe os diretórios e arquivos pertencentes ao seu projeto. Abaixo listamos os diretórios disponíveis em projetos de Microsserviços. Para detalhes sobre a estrutura de arquivos do projeto, acesse a documentação Estrutura de arquivos.


Image Added

Figura 2 - Árvore de recursos de um projeto Microsserviços baseado no modelo Serviço de negócio


  • Diagramas de Dados: apenas Diagrama de dados: contém os Diagramas de classe do projeto. Apenas os projetos criados utilizando o modelo "Serviço de dados", por padrão, possuem o diagrama "app". No entanto, ao utilizar o modelo "Serviço de negócio", também é possível criar um diagramaconfigurá-lo.
  • Fonte Fontes de dados: lista as Fontes de dados do projeto. Por padrão, projetos de Dados: projetos de Microsserviços não possuem Fontes de dados criadas previamente, dando autonomia ao usuário para criá-las se necessário.
  • Bloco de programação servidor: diretório virtual para agrupar as pastas dos Lógicas: possui apenas blocos de programação servidor. Por padrão, já vem com apresenta o blockly "HelloWorld".
  • Relatórios: armazena os Relatórios criados no relatórios do projeto.
  • RecursosMídias: diretório virtual para agrupar arquivos estáticos do projeto.
  • Testes: pasta reservada para os blocos de programação de teste do projeto servidor.
  • Documentação: diretório usado para manter os arquivos de documentação do projeto.

Menu Projetos

Esse menu é responsável por O menu de Sistemas Projeto (destaque 1 da figura 2) possui recursos para gerenciar e configurar o projeto aberto, além de abrir algumas funcionalidades. Abaixo listamos as funcionalidades...

Fonte de dados: abre a janela de fontes de dados. Para mais informações, acesse a documentação Fonte de dados.

principais funcionalidades presentes nos projetos de Microsserviços.

  • Banco de dados: permite configurar um banco de dados. Apenas apenas os projetos criados utilizando o modelo "Serviço de dados", por padrão, possuem tabelas no banco de dados. No entanto, ao utilizar o modelo "Serviço de negócio", também é possível configurá-lo.
  • Chave de internacionalização:exibe as chaves de internacionalização. Está está habilitada apenas na opção servidor. Para mais informações dessa funcionalidade, acesse a documentação Internacionalização. 
  • Eventos e ações: abre uma janela para criar eventos através dos blocos de programação. Apenas apenas o evento "Depois de Iniciar Sistema" está disponível em projetos de "Microsserviços". Para mais informações desse evento, acesse a documentação Eventos e ações.
  • Permissão de Segurança: abre a tela para configuração apenas dos permissionáveis.
  • Gerenciamento de Tokens: permite a configuração de tokens para autenticação por chave de API (Api Key) e OAuth 2.0.
  • Parâmetros do sistema: abre a janela de parâmetros do sistema, através dela é possível criar parâmetros e vinculá-los aos perfis de banco de dados. Para mais informações, acesse a documentação Gerar Parâmetros do sistema.. 
  • Agendador de tarefas: abre uma abre a janela para criação de jobs, permitindo definir tempo para executar ações geradas por bloco de programação. Para mais informações, acesse a documentação Agendador de tarefas.
  • Gerar documentação: permite gerar documentações automáticas a partir das implementações do sistema. Para mais informações, acesse a documentação Gerar documentação.
  • Configurações: abre a janela de configurações do projeto. Nessa funcionalidade, alguns campos não estão presentes Alguns campos foram removidos nas abas "Geral", como os campos de "Rota Principal Web" e "Rota Principal Mobile", e "Configuração do Projeto" Para mais informações, acesse a documentação Configurações do projeto., como os campos de "Tema" e "Autenticação". 

Ferramentas

Em ferramentas é possível fazer o gerenciamento dos tipos de bancos de dados e dos backups automáticos, além de abrir o terminal. Projetos de Microsserviços possuem as mesmas ferramentas que um projeto web ou mobile: Gerenciador de SQL

: abre o Sistema de Gerenciamento de Banco de Dados (SGBD) online. Para mais informações

,

acesse o tópico "Manipular dados" na documentação Banco de dados.

Terminal

: acessa o terminal Linux

,

onde você tem acesso a todos os arquivos do seu projeto.

Testador de consultas JPQL

: abre uma janela onde é possível testar consultas JPQL, para mais informações, acesse a documentação do Assistente de consulta.Gerenciamento de Backups: gerencia os backups de seus projetos, permitindo baixar, remover ou restaura-los. Para mais informações, acesse a documentação Backup Cronapp.

Gerenciamento de Backups.

Recursos não disponíveis

Visto que seu principal objetivo é apenas gerenciar e disponibilizar serviços do lado servidor, não é necessário o uso de interfaces cliente. Desse modo, projetos de Microsserviços não possuem os seguintes recursos :

  • Fragmentos: diretório virtual para agrupar as pastas dos Fragmentos mobile e web.
  • Formulários: diretório virtual para agrupar as pastas de formulários dos projetos mobile e web.

  • Blocos de programação cliente: diretório virtual para agrupar as pastas dos blocos de programação mobile e web.
  • Dashboards: armazena os Dashboards criados no projeto.

  • Skins de Tema: armazena os Skins de temas criados no projeto.

  • Fluxo de Trabalho: contém os arquivos de fluxo de trabalho do Cronapp BPM.

  • Permissão de segurança: esta funcionalidade não está habilitada, visto que o projeto não precisa do cadastro de permissionáveis e a autorização é realizada via token.

Executando o projeto

... Breve descrição sobre as opções de execução disponíveis..

Execução:

de Fragmentos, FormuláriosDashboards, Skins de Tema e Fluxo de Trabalho.

Autenticação

Projetos de Microsserviços não possuem recursos de autenticação próprios. Se houver a necessidade de disponibilizar um serviço de forma privada, exigindo a autenticação de usuários, será necessário integrar outra aplicação para lidar com a autenticação. Para mais informações de integração com outras aplicações, consulte o tutorial Projeto de Microsserviços com autenticação. Também é importante destacar que os Permissionáveis do projeto de Microsserviços devem ser os mesmos disponíveis no projeto de autenticação. Para configurar os permissionáveis, acesse a ferramenta Permissão de Segurança (Figura 3). As alterações realizadas nessa ferramenta irá afetar o arquivo authorities.json (Endereço: src/main/java/META-INF/authorities.json). 


Image Added

Figura 3 - Ferramenta Permissão de Segurança

Executando o projeto

Visto que projetos de Microsserviços são do tipo servidor, seus recursos serão executados a partir de requisições REST. Dessa forma, estão disponíveis apenas duas opções de execução do projeto, conforme apresentadas na imagem abaixo. Para mais informações, acesse a documentação do Swagger - OpenAPI.


Image Added

Figura 4 - Executando o projeto


  • Swagger UIVisualizar documentação das APIs (Swagger): abre outra aba no navegador com a página do Swagger.

    • O Swagger possui um conjunto de ferramentas construídas em torno de uma especificação chamada OpenAPI, que ajuda a projetar, construir, documentar e consumir APIs.

    • A especificação cria uma interface RESTful para desenvolver e consumir facilmente uma API mapeando efetivamente todos os recursos e operações associados a ela.

    • Fornece informações detalhadas sobre os pontos finais (endpoints) da API, os parâmetros que cada endpoint aceita, os tipos de dados esperados, os códigos de resposta possíveis, exemplos de solicitações e respostas, entre outras informações relevantes.

  • Visualizar arquivo de configuração (OpenAPI)Arquivo OpenAPI: abre outra aba no navegador com o esquema do OpenAPI.

    • O arquivo de configuração OpenAPI é geralmente escrito em formato YAML ou JSON e contém informações detalhadas sobre a API, incluindo endpoints, parâmetros, tipos de dados aceitos, autenticação, exemplos de solicitações e respostas, entre outros.

Bloco de programação

..

Figura - Bloco de programação HelloWorld

Figura - Execução da função da Figura 

Fonte de dados

Figura - Fonte de dados

Âncora
blocoDeProgramacao
blocoDeProgramacao

Bloco de programação

Na imagem abaixo, podemos visualizar o blockly "HelloWorld" e a função "Executar" que já estão configurados em projetos de Microsserviços. Essa função, assim como as demais criadas, serão executadas a partir de requisições REST. Para configurar o endereço REST de uma função de bloco de programação, clique no ícone de engrenagem (destaque 1 da Figura 5) do editor de blockly. Para mais informações de configuração, acesse o tópico "Propriedades do Blockly" da documentação Bloco de programação


Image Added

Figura 5 - Bloco de programação HelloWorld


Na imagem a seguir, podemos observar a execução da função da Figura 5 no Swagger. Nessa página, podemos visualizar o endpoint (destaque 1 da Figura 5.1) e o resultado de execução da função (destaque 2). Ao executar em ambientes externos, é necessário concatenar o endpoint da função com o domínio da aplicação.


Image Added

Figura 5.1 - Execução da função da Figura 

Fonte de dados

Projetos de Microsserviços não possuem Fonte de dados criadas previamente, oferecendo aos usuários autonomia para criá-las conforme a necessidade. Para o exemplo da imagem abaixo, criamos uma classe "Usuarios" no diagrama de dados e, a partir dela, a Fonte de dados "Usuarios" (destaque 1 da Figura 5.2). Em seguida, na aba Ações (2), marcamos a checkbox da ação "Para Inserir" (verbo HTTP POST) e a deixamos como pública. Também habilitamos a opção "Swagger/Open API" (3). Para mais informações de configuração, acesse o tópico "Como configurar" da documentação do Swagger.

Para executar as ações da Fonte de dados em ambientes externos, o endereço REST (4) deverá ser concatenado com o domínio da aplicação. Na Figura 5.3, é possível visualizar a execução na página do Swagger.


Image Added

Figura 5.2 - Criação de uma Fonte de dados


A imagem a seguir mostra a execução do método POST da Fonte de dados. No corpo da requisição, informamos os dados do usuário (destaque 1 da Figura 5.3) e, após a execução, esses dados (2) serão armazenados no banco de dados do sistema.


Image Added

Figura 5.3 Figura - Execução da requisição da Fonte de dados no Swagger

Nesta página

Índice


Saiba mais