Entre os tipos de projetos disponíveis para criação low-code no Cronapp estão os de Microsserviços. Um microsserviço é uma abordagem arquitetônica e organizacional do desenvolvimento 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.

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

Criar projeto

Novo Projeto

Para criar um projeto do tipo Microsserviços, clique botão Novo Projeto (seta da Figura 1) e a primeira janela de configuração será aberta para selecionar o tipo do projeto. Selecione o 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.

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

Modelos

Os modelos de Microsserviços possuem uma série de tecnologias que vem integradas junto com sua aplicação. Atualmente dois modelos 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 "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 ao usuário para desenvolver a aplicação de acordo com os objetivos gerais dos negócios de sua organização. É um modelo com menos recursos configurados que o modelo anterior, por exemplo, não possui um Diagrama de dados e conexões criadas no Banco de dados. No entanto, se necessário, é possível configurar essas funcionalidades.

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), independente do modelo escolhido na janela anterior (Figura 1.1). Para concluir a criação do projeto, clique 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 acesso a serviços, apenas o tipo "Token" está disponível, sendo utilizado 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 de Microsserviços possuem menos funcionalidades que um projeto web e mobile. Além disso, algumas funcionalidades possuem 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...

• 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", é possível criar um diagrama.
• Fonte de dados: lista as Fontes de dados do projeto. Por padrão, projetos de Microsserviços não possuem Fontes de dados criadas previamente, dando autonomia ao usuário criá-las se necessário.
• Bloco de programação servidor: diretório virtual para agrupar as pastas dos blocos de programação servidor. Por padrão, já vem com o blockly "HelloWorld".
• Relatórios: armazena os Relatórios criados no projeto.
• Recursos: 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 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.
• Banco de dados: permite configurar um banco de dados. 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", é possível configurá-lo.
• Chave de internacionalização: exibe as chaves de internacionalização. 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 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.
• 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 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 nas abas "Geral" e "Configuração do Projeto" Para mais informações, acesse a documentação Configurações do projeto.

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.

• 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.

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:

• Visualizar 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): 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

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