O Cronapp permite que novos blocos de programação ( cliente ou servidor ) sejam criados. É possível criar esses novos componentes dentro da própria plataforma e de acordo com a necessidade de cada projeto.

Pré-requisitos

Antes de começar a seguir os passos do tutorial é preciso ter certeza de que se tem um ambiente minimamente preparado para reproduzir o exemplo. Abaixo estão os requisitos principais.

Requisitos:

1. Projeto do tipo mobile criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link ( Criar novo projeto );

Visão Geral

Nesse tutorial iremos criar um componente, que obtém a quantidade de itens que uma lista possui, para os blocos de programação do tipo servidor.

Passos

Criar pacote 

Criar um novo pacote ( Em nosso exemplo o nome do pacote será menorValorLista) que irá conter a classe java referente ao componente. Faz parte da boa prática de desenvolvimento criar diretórios ou arquivos referentes ao bloco de programação do tipo servidor no diretório Códigos Fonte Servidor.

Figura 1 - Criação do pacote

Criar classe java

O pacote criado deve receber um novo arquivo do tipo Java, Pacote>Novo>Java (Figura 2). Após selecionada a opção a IDE irá exibir a tela de escolha do modelo do arquivo. Para o caso da criação de componentes, o modelo correto é o Nova Função para Bloco de Programação como pode ser visto na (Figura 3). O botão Avançar confirma a seleção do modelo e exibe a tela de definição das informações.

Figura 2 - Criação da classe java

Figura 3 - Escolha do modelo do arquivo

Definir informações do componente

O componente a ser criado pode ter as seguintes informações definidas: Nome da classe, Nome da função, Nome reduzido da função, Descrição da função e Categoria. 

Figura 4 - Definindo informações sobre o componente

Alterar parâmetros do componente(função)

A geração do código base para o componente vem com alguns parâmetros padrões, como por exemplo: type, returnType e Var input. Esses valores não são fixos e podem ser alterados. Ver Figura 5.

Figura 5 - Estrutura interna do componente

Figura 6 - Alguns dos tipos de parâmetro que podem ser utilizados

Figura 7 - Alguns dos métodos contidos em uma instância de um objeto do tipo Var 

Adicionar código 

Primeiramente, devemos alterar os tipos de dados atuais para list e além disso devemos acrescentar algumas informações sobre o parâmetro no código:

@CronapiMetaData(type = "function", name = "obterMenorValorLista", description = "Função que retorna o menor valor contido em uma lista")
public static String obMenVaList(@ParamMetaData(description = "Parâmetro: Descrição do parâmetro") String input) throws Exception {

		return "Input " + input;
	
}

@CronapiMetaData(type = "function", name = "obterMenorValorLista", description = "Função que retorna o menor valor contido em uma lista")
public static Var obMenVaList(@ParamMetaData(type = ObjectType.LIST ,description = "Lista: lista que será passada para a função") Var list) throws Exception {


    
}

Após a adequação dos parâmetros, o código referente a funcionalidade pode ser adicionado ao corpo da função. Nesse exemplo, o código que retorna o menor valor contido em uma lista é o seguinte:

		Optional<Var> opt = list.getObjectAsList().stream().min(Comparator.comparingLong(Var::getObjectAsLong));
		return opt.get();

Figura 8 - Código adicionado ao corpo da função referente a funcionalidade do componente

Acessar a função 

O último passo após a inserção do código no componente é a visualização desta função como disponível para utilização no bloco de programação. Primeiro devemos recarregar o projeto para que a nossa função seja carregada.

Figura 9 - Recarregar projeto

Figura 9.2 - Função sendo exibida em sua respectiva categoria no bloco de programação

Exibição de informações 

É possível visualizar as informações definidas durante o desenvolvimento da função passando-se o ponteiro do mouse sobre o componente (Figura 10).

 Figura 10 - Exibição das informações da função