Configuração de seu ambiente Java corporativo

watsonx Code Assistant Plano padrão

Se você estiver usando o plano Standard e quiser trabalhar com aplicativos Java corporativos, precisará configurar o ambiente para o IDE.

Requisitos de software

Os requisitos para usar watsonx Code Assistant for Enterprise Java Applications em Visual Studio Code ou em Eclipse são:

Requisitos do sistema
Item Detalhes
Java Java SE 11 com Java Developer Kit 11 ou uma versão posterior
Maven Use o Maven para criar seu aplicativo. Se estiver usando o Liberty Tools e o plug-in do Liberty Maven para criar seu aplicativo ou projeto, use o Maven 3.8.6 ou uma versão posterior.

Visual Studio Code configuração

Configurar variáveis de ambiente

Configure suas variáveis de ambiente.

JAVA_HOME

Defina a variável de ambiente ' JAVA_HOME da mesma forma que você faz para o Maven. Defina-o como o diretório JDK que contém o diretório /bin para que o arquivo executável Java esteja no caminho $JAVA_HOME/bin/java.

Você pode definir a variável de ambiente ' JAVA_HOME para criar seu aplicativo em uma versão diferente, por exemplo, Java 11.

PATH

Defina a variável de ambiente PATH para incluir o arquivo executável mvn.

  • Windows: mvn.cmd
  • macOS: mvn

Se você usar o terminal Visual Studio Code para definir as variáveis de ambiente, será necessário reiniciar Visual Studio Code para aplicar as alterações.

Determinação do kit de desenvolvedor Java

Para o Visual Studio Code, se você estiver usando o Extension Pack for Java, watsonx Code Assistant determina o kit de desenvolvedor Java a ser usado nesta ordem de precedência:

Pedido do kit de desenvolvedorJava
Ordem de precedência Descrição
1 Kit de desenvolvedor Java configurado globalmente para criação automática na extensão Red Hat, que é java.configuration.runtimes no arquivo IDE settings.json.
2 java.jdt.ls.java.home ou java.home configurações do IDE, se estiverem presentes.
3 JDK_HOME variável de ambiente do sistema.
4 JAVA_HOME variável de ambiente do sistema. Necessário se os itens 1 a 3 não estiverem definidos.

Quando os recursos watsonx Code Assistant for Enterprise Java Applications são usados, como modernização ou atualização Java, você pode verificar qual kit de desenvolvedor Java está sendo usado:

  1. No Visual Studio Code, clique em Exibir e, em seguida, clique em Saída.

  2. Na exibição Saída, use a lista suspensa para selecionar WCA.

  3. Verifique se há uma mensagem como " Using the Java developer kit that is defined in <location> to run watsonx Code Assistant components. The path is: <path>.

Definir o nível de registro

Para ajustar o registro para a extensão do Visual Studio Code:

  1. No Visual Studio Code, abra as configurações de extensão para watsonx Code Assistant.

  2. Em Wca: Nível de registro, mude do padrão " INFO para outra configuração, como " WARN.

Configuração Eclipse IDE

Determinação da instalação Java

Para o Eclipse, a instalação Java é determinada nesta ordem:

  • A instalação que está configurada no caminho de compilação do projeto
  • A instalação padrão do Java para o IDE

Para modernização e atualização de aplicativos, as correções automatizadas usam a instalação do kit de desenvolvedor Java que melhor corresponde à versão Java de destino que você escolheu. É necessário:

  1. Instale o kit de desenvolvedor Java.
  2. Nas configurações do Eclipse IDE, abra a seção Java e adicione a instalação aos JREs instalados.

Configuração do Maven em Eclipse

Certifique-se de usar o Maven para criar seu aplicativo.

É necessário que o Maven esteja definido no PATH.

Defina a variável de ambiente PATH para incluir o arquivo executável mvn.

Arquivos executáveis do Maven
Sistema operacional Arquivo Executável
Windows mvn.cmd
macOS mvn

Nos sistemas operacionais macOS, as variáveis de ambiente podem não ser definidas conforme o esperado quando você executa Eclipse. Para corrigir o problema, você pode reiniciar o Eclipse usando a ferramenta Finder para clicar com o botão direito do mouse no aplicativo Eclipse e escolher Show Package Contents. Abra a pasta Contents, selecione MacOS e, em seguida, execute Eclipse clicando no código executável.

Como está localizado o arquivo pom.xml de um projeto Maven?

Watsonx Code Assistant usa o arquivo pom.xml do agregador para criar e gerenciar todo o projeto Maven multimódulo. Quando o watsonx Code Assistant tenta fazer compilações e outras atividades relacionadas ao Maven, ele usa a raiz de vários módulos (MMR) para localizar o arquivo pom.xml do agregador.

  • O MMR primeiro procura o arquivo pom.xml do agregador no diretório de projeto de nível mais alto.
  • Se o MMR não encontrar o arquivo, ele pesquisará o diretório do projeto, indo da estrutura de diretório mais alta para a próxima mais alta, e assim por diante, até encontrar um arquivo pom.xml agregador.
  • Se o MMR novamente não encontrar um arquivo pom.xml agregador, ele pesquisará o diretório do projeto indo da estrutura de diretório mais alta para a próxima mais alta, e assim por diante, até encontrar um arquivo pom.xml regular. Um arquivo pom.xml regular indica que o projeto Maven é um projeto de módulo único em vez de um projeto de vários módulos.

No entanto, há uma restrição extra. O projeto multimódulo deve ter um arquivo WAR ou um arquivo EAR. Pode haver vários arquivos WAR se houver um único arquivo EAR. Porém, se houver vários arquivos WAR e nenhum arquivo EAR, o projeto não será compatível. O motivo é que o site watsonx Code Assistant pode analisar o binário correto e colocar o arquivo de configuração do Liberty (server.xml) no submódulo correto.