Configuração do Projeto com IntelliJ IDEA

Pré-requisitos

Neste exemplo iremos utilizar o IDE IntelliJ IDEA Community Edition, neste link anterior a versão Community é encontrada mais abaixo logo depois da versão Ultimate.

Outra IDE específica para Java poderá ser utilizada em alternativa, por exemplo, o Eclipse ou o NetBeans, basta realizar uma configuração semelhante.

Instale a plataforma Netuno, o projeto em Java será integrado com a plataforma do Netuno pré-instalada.

Criar Projeto

Assim que abrir o IntelliJ IDEA Community crie um novo Projeto, clique no botão New Project.

Escolha a opção Java do lado esquerdo, e no nome do Projeto, no campo Name:, para o exemplo vamos utilizar Calc.

Escolha em Location: onde o projeto ficará nos seus arquivos.

E o Build system: é o IntelliJ mesmo.

No JDK devemos escolher a GraalVM que vem com o Netuno, altere para adicionar utilizando a opção Add JDK from Disk..., e vá até a onde tem a plataforma do Netuno instalada, e escolha a pasta:

• netuno/core/graalvm

Este é o JDK da GraalVM que recomendamos que deverá ser utilizado no projeto, para garantir que conseguimos executar e depurar o projeto.

Configurações do Projeto

Nos arquivos de projeto apresentados a esquerda, no primeiro que diz o nome do projeto, no caso Calc, clique com o botão direito para abrir o menu de opções e vá em Open Module Settings.

A janela que abre deverá estar na opção Modules do lado esquerdo, com 3 abas do lado direito:

1. Sources
2. Paths
3. Dependencies

Caminhos

Na aba dos Paths vamos escolher em Compiler Output a segunda opção:

• Use module compile output path

E vamos escolher a pasta netuno/core/web/WEB-INF/classes que fica na plataforma do Netuno instalada, para ambas as opções de Output path: e o Test output path: devem ter este mesmo caminho.

A pasta classes em netuno/core/web/WEB-INF deverá ser criada porque não existe por padrão.

Dependências

Na aba das Dependencies, clique no botão + que está por cima do quadro com opções de listagem.

Nas opções que aparecem, clique na primeira opção que é 1 Jars or Directories....

Vamos onde tem a plataforma do Netuno instalada e adicione todas as dependências:

1. netuno/netuno.jar - está na raíz da plataforma.
2. netuno/core/lib - selecione e adicione todos os arquivos.
3. netuno/core/web/WEB-INF/lib - selecione e adicione todos os arquivos.

Caso apareça uma janela dizendo Detected Roots e Choose Roots, desmarque todas as opções selecionadas e clique em OK.

Valide na lista de arquivos que desde o primeiro até ao último JAR foram adicionados, se tentar selecionar todos os arquivos com as teclas de atalho do teclado não funcionará muito bem, deve selecionar o primeiro JAR e descer até que com a tecla shift clique no último JAR, desta forma o IntelliJ consegue carregar todos bem.

Certifique bem que todas as dependências são corretamente adicionadas, verifique se encontra o primeiro e o último JAR de cada pasta na lista.

Com isso todo o ecossistema do Netuno para Java está relacionado com o seu projeto.

Artefatos

É onde podemos gerar o arquivo JAR do nosso projeto, o que facilita a distribuição do código para outras instâncias do Netuno que estão em outros computadores.

Na opção de Artifiacts que está disponível no menu do lado esquerdo da janela que é apresentada em Open Module Settings, clique no botão de + que está disponível, depois na opção JAR e por fim clique na opção Empty.

No campo Name: coloque o nome do projeto, por exemplo calc.

Logo abaixo no Output Layout, clique no botão de + e escolha a opção Module Output, e na janela de opções que aparece selecione o nosso projeto e clique em OK.

Clique me Apply ou em OK para fechar a janela de configurações do projeto.

Gerar o Artefato

Para gerar o artefato basta ir no menu global do IntelliJ, e na opção de Build > Build Artifacts....

Escolha a opção do respectivo projeto e clique em Build.

Nos arquivos do lado esquerdo aparece o arquivo gerado dentro da pasta out, no caso deste exemplo será:

• out/artifacts/calc/calc.jar

Publicar Artefato

O arquivo de JAR criado pode ser distribuído e colocado em qualquer outra plataforma do Netuno.

Sendo que na plataforma que está sendo realizado o desenvolvimento não pode conter o JAR do projeto, porque o código já é publicado em:

• netuno/core/web/WEB-INF/classes

Portanto, para as outras plataformas que não são utilizadas no desenvolvimento e que não tem as classes, então utilizamos o arquivo JAR.

Em qualquer plataforma do Netuno instalada este JAR deve ser colocado na pasta lib na raíz do Netuno:

• netuno/lib

Repare que está pasta não existe por padrão, portanto pode ser necessário criá-la.

Todos os JARs que se encontram nessa pasta são carregados automaticamente na plataforma do Netuno.

Pacote do Código

Como é padrão no Java, o código deve ter sempre um package.

O seu package deve ser registrado no arquivo de configuração global do Netuno:

• netuno/config.js

Adicone no fim o seguinte código:

config.packagesScan.add("meu.projeto.java")

Caso o seu pacote não seja adicionado na configuração desta forma então o seu projeto nunca será carregado.

Porque o Netuno apenas procura por recursos e serviços nos pacotes previamente adicionados.

Uma alternativa para evitar registar o pacote na configuração é utilizar pacotes Java que começam com org.netuno.

O Netuno procura automaticamente por recursos e serviços que estejam em pacotes que iniciem com org.netuno.

É recomendado utilizar o prefixo: org.netuno.addon

Por exemplo, podemos utilizar: org.netuno.addon.calc

O prefixo de pacote org.netuno.addon distingue que é uma funcionalidade adicionada externamente e que não faz parte do Netuno em si.

Portanto, todo o seu código Java que integra com o Netuno deve ser definido e construído em:

• org.netuno.addon.meu.projeto

Após o org.netuno.addon adicione a identificação do seu projeto.

Execução

Para executar o projeto precisamos criar uma nova configuração de execução.

Na barra superior, temos um botão de Run e o de Debug.

Clique na opção que diz Current File com o símbolo de seta para baixo, antes do botão em seta para execução.

A seguir clique em Edit configurations....

Na janela que abre clique no botão + no canto superior esquerdo, e escolha a opção Application.

No Name: coloque Netuno, e no campo que diz Main class coloque org.netuno.cli.Main.

Em Program arguments preencha a instrução de inicialização do servidor Netuno com uma aplicação, neste exemplo foi criado uma aplicação previamente chamada também de calc:

server app=calc

A app deve ser criada antes, no Netuno utilize o comando: ./netuno app

Coloque em Working directory: a pasta raíz do Netuno, é muito importante que esteja o caminho completo.

Deve ficar assim:

Agora basta clicar em Apply e OK.

Com isso pode executar o projeto ou mesmo fazer debug.

Conclusão

Foi visto como criar um novo projeto Java para adicionar novos comportamentos no núcleo do Netuno.

Também vimos as boas práticas para gerar o arquivo JAR e como distribuir na pasta netuno/lib.

Todas as técnicas e bibliotecas de programação Java podem ser utilizadas para criar qualquer tipo de funcionalidade no Netuno.

Especialmente criar recurso de programação low-code que fica disponível para todas as linguagens de script suportas, tais como:

• JavaScript
• Python
• Ruby
• Kotlin
• Groovy

Nos tutoriais seguintes, veja como criar o seu primeiro recurso de programação low-code.

E também como criar o seu primeiro serviço web multi-aplicacional, disponível em todas as aplicações que estão configuradas no Netuno.