Ambiente Desenvolvimento e Produção

Ambiente e Versões Homologados

Registro das versões e sistema utilizados durante o processo de certificação do ambiente:

• Java
  • jdk-20.0.2 x64bits - Para servidor de aplicações
  • jdk-8u301 - Para alguns módulos e aplicações quando necessário. Deve ser documentado no módulo o uso da versão 32 ou 64 bits.
• IDEs
  • Eclipse: eclipse-jee-2023-06-R-win32-x86_64.zip
• Servidor de Aplicações
  • wildfly-29.0.0.Final
• Versionamento
  • Deixamos de utilizar o SVN próprio e utilizar os repositórios privados do GitHub.
  • O Eclipse já vem com o EGit (plugin da própria eclipse instalado e com suporte)

Eclipse

Instalação

1. Baixe o eclipse diretamente do site Eclipse Fundation.
2. Instale descompactando o .zip em seu local de preferência.

Definição da VM para Execução do Eclipse

Se precisar definir a VM para execução (inicialização) do Eclipse. Edite o arquivo eclipse.ini na raiz do eclipse, e inclua/modifique os parâmetros como o exemplo abaixo:

-vm
c:/Program Files/Java/jdk-19/bin/javaw.exe

Quebra de Linha Observe que a quebra de linha é obrigatória, cada parâmetro em uma linha separada. A definição da JVM de execução normalmente só é necessária caso o Eclipse apresente erros durante sua inicialização.

JAutoDoc

Este plugin permite que todo o javaDoc criado para um "field" (atributo da classe) seja replicado automaticamente nos métodos Get e Set ao pressionar a tecla de atalho 'CTRL+ALT+J'.

Instalação pelo MarketPlace

1. Vá em 'Help -> Eclipse Marketplace' e procure por 'JAutoDoc'.
2. Clique em Instalar siga os passos e Reinicie quando solicitado

Configuração do Módulo

1. Após a instalação vá no menu 'Windows > Preferences', no caminho 'Java > JAutoDoc' e clique no botão 'Import All...' para importar as configurações usadas no projeto BIS.
2. O arquivo com as opções salvas ficam no projeto 'BIS' no arquivo 'etc\Environment Setup\jautodoc-eclipse.xml'.

Configurando o JDK e Bibliotecas no Eclipse

Ao carregar o pom.xml do Maven, o Eclipse configurará o projeto para utilizar o Execution Environment de acordo com a versão do JDK definida no arquivo. Por isso, é importante que o Execution Environment do Eclipse esteja apontando para o JDK homologado. Atualmente o Execution Environment é o JavaSE-1.8.

Versão x64 e x32 Embora o BIS esteja homologado para rodar na versão 64bits, alguns módulos e aplicações externas podem requerer a versão 32bits. Um exemplo é o BISPDV que por questões de compatibilidade com DLLs de SAT, Impressoras, PinPads e etc., precisam rodar em 32Bits. Para estes casos a cada vez que o Eclipse recarregar o pom.xml do Maven, é necessário configurar manualmente que desejamos que o projeto rode no JDK de 32bits homologado.

1. Vá em 'Windows -> Preferences -> Java -> Installed JREs'
2. Adicione a instalação do JDK homologado apontando para a pasta do JDK de 64 bits homologado.
3. Repita o passo anterior para a versão do JDK de 32 bits homologado.
4. Vá em 'Windows -> Preferences -> Java -> Installed JREs -> Execution Environment e em JavaSE-1.8 escolha o JDK 64bits homologado.

Maven Desde a adoção do Maven para controlar as bibliotecas de cada projeto não é mais necessário realizar configurações extras de bibliotecas no Eclipse

Configurando o WildFly

Antes de configurar o Servidor é necessário baixar o plugin do servidor.

1. Vá na aba 'Servidor e click para criar um novo servidor.
2. Na tela que se abre, escolha 'JBoss AS, WildFly, & EAP Server Tools' e clique em Next. Este passo pode demorar.

   

3. Termine os passos do Wizard até finalizar. Aguarde o fim da instalação e reinicie se for solicitado.
4. Após o término e reinicio do Eclipse, volte à aba 'Servers' e clique em adicionar um novo servidor novamente.
5. Desta vez escolha a opção 'WildFly27+', e deixe o Server Name como 'WildFly'.

   

6. Clique em 'Next.
7. Na próxima imagem escolha a opção 'Management Operation' para que o Eclipse controle o WildFly corretamente.

   * Para que o eclipse controle adequadamente o a instalação do WildFly precisa ser realizada como orientado nesta página.}}

   

8. Na definição de RunTime, selecione o ambiente conforme homologado.

   

9. Clique em Finish