...
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
1 - Criar diretóriopacote
Criar um novo diretório pacote 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 diretóriopacote
2 - Criar classe java
O diretório pacote criado deve receber um novo arquivo do tipo Java, Diretório>Novo>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
3 - 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.
...
| Informações | ||
|---|---|---|
| ||
typetype - Tipo do parâmetro de entrada da função descriptiondescription - Descrição do parâmetro de entrada da função returnTypereturnType - Tipo do parâmetro de saída da função Var input - Variável do tipo Var de nome input - (O nome da variável pode ser alterado mas indica-se manter seu tipo como Var) Exemplo de definição do tipo do parâmetro: type = ObjectType.STRING |
Figura 5 - Estrutura interna do componente
...
Figura 7 - Alguns dos métodos contidos em uma instância de um objeto do tipo Var
5 - 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:
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
@CronapiMetaData(categoryName = "Obter Valor")
public class MenorValorLista {
@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;
}
} |
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:
...