Pré requisitos
- Projeto do tipo web criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link (Criando Projeto Web).
- Criar classes no Diagrama, gerar persistência e popular o banco. Para criar classes e gerar persistência acesse o link (Geração da camada de dados a partir do diagrama).
Passos
Para esse exemplo vamos criar um agenda simples, utilizando um relacionamento de 1 para N, onde um cliente pode possuir vários telefones. (Figura 1)
Figura 1 - Relacionamento usado nesse exemplo.
1. Criando Bloco de programação
Crie um bloco de programação do lado Servidor. Nesse exemplo, nomeamos o bloco para "WebServiceRest" e uma função "cliente" que recebe o parâmetro identificador do cliente e retorna os dados desse cliente.
Como a função deve só retornar os dados do banco, configuramos a consulta para ser enviada no retorno da função. (Figura 2)
Figura 2 - Configurando o bloco de programação e consulta.
2. Configurando a chamada Rest
Após finalizar a lógica da função, clique na engrenagem "Configuração dos tipos de regras" (lado direito/superior) para abrir a janela de "Propriedades do bloco de programação". Nessa janela, os únicos campos que nos interessam são os campos descritos abaixo. (Figura 3)
- Tempo limite: Limite em segundos para a execução. Após o limite, o bloco é finalizado.
- Tipo: Tipo externo gera Rest e tipo interno gera função.
- Segurança: O campo segurança abre uma outra janela que nos permite dar autorização de CRUD e Execução a diferentes perfis de segurança.
Autorize para "Todos" os campos: Permitir Executar e Permitir Obter.
Figura 3 - Configuração da chamada REST.
Salve as alterações e pronto! O CronApp acaba de criar uma requisição Rest para realizar uma consultar aos telefones de um cliente. Todas as notações necessárias para as requisições Rest são geradas automaticamente pela IDE após a configuração do Tipo Externo nas Propriedades do Bloco de programação do lado Servidor e tudo isso em Low Code ou RAD. (Figura 4)
Figura 4 - Notações REST gerado pelo CronApp ao alterar as propriedades do Bloco.
aaaaaaaaaaaaaaaaaaaaaaaaaaaa
3. Endereço Rest
O modelo da URI Rest para esta função está descrita no campo "Rest" (Figura 3): /api/cronapi/rest/blockly.WebServiceRest:<Função>[/<Parâmetro 1>[/Parâmetro n]]
Antes do modelo acima, é necessário inserir o domínio do sistema. Como estamos em modo desenvolvimento, precisamos executar a aplicação para verificar o endereço temporário gerado pelo CronApp, como mostrado na Figura 4.
Figura 4 - Domínio de desenvolvimento gerado pelo CronApp.
Ao final, o endereço que iremos usar para testar a consulta reste será:
https://9-211-10090.debug.ide.cronapp.io/api/cronapi/rest/blockly.WebServiceRest:cliente/<id do Cliente>
2. Configurand
Após carregar os pacotes e Recompilar o projeto, a IDE gera um arquivo Java com as chamadas para as funções. Esse arquivo é gerado automaticamente, visto que o serviço web pode ter sido desenvolvido em qualquer arquitetura e/ou linguagem de programação. (Figura 4)
Figura 4 - Arquivo gerado para as chamada das funções.
2. Utilizando o serviço importado
Ao