Atualizar a versão Java para seu aplicativo

watsonx Code Assistant Plano padrão

Para atualizar o código Java, primeiro você cria e analisa o aplicativo e, em seguida, corrige os problemas identificados. Dependendo dos problemas, a capacidade de corrigi-los pode ser automatizada, assistida ou autodirigida.

Antes de começar, configure seu ambiente Java corporativo.

Somente no Eclipse IDE: Para obter melhores resultados com um aplicativo Java multimódulo, certifique-se de importar o módulo agregador e cada submódulo como projetos separados no espaço de trabalho Eclipse. é improvável que Watsonx Code Assistant introspeccione seu projeto com sucesso se você importar o diretório de nível superior como um único projeto.

Tempo necessário para analisar seu código

O tempo para analisar seu aplicativo varia. Os horários a seguir são típicos.

Tempo necessário para analisar
Hora	Detalhes do aplicativo
Segundos a alguns minutos	Menos de 100 aulas
2 a 10 minutos	20.000 a 50.000 linhas de código
10 minutos ou mais	300.000 linhas de código

Quando watsonx Code Assistant analisa seu aplicativo, ele exclui alguns pacotes de terceiros da análise de código por padrão. Para obter mais informações, consulte Pacotes de terceiros que são excluídos da análise de aplicativos.

Analisar seu aplicativo para atualizar a versão Java

A análise fornece a você uma lista de problemas a serem abordados. Depois de corrigir os problemas, a versão Java do aplicativo é atualizada.

Se você reverter as alterações no código, deverá clicar em Return to analyze e fazer uma análise completa se quiser fazer a atualização do Java novamente.

No seu IDE, clique com o botão direito do mouse em qualquer item da hierarquia no diretório do aplicativo que deseja atualizar.
Use qualquer um dos caminhos para iniciar o processo de upgrade. Ambos são iguais:
- Clique em watsonx Code Assistant e, em seguida, clique em Upgrade Java Version.
- Clique em Modernize Java Applications (Modernizar aplicativos ) e, em s eguida, clique em Upgrade Java Version (Atualizar versão ).
Em sua página Upgrade <o nome do seu aplicativo>, selecione os parâmetros de análise, que definem as regras contra as quais o aplicativo é analisado.
1. Opcionalmente, altere a fonte Java, que é exibida automaticamente com um valor recomendado.
  
  A versão de origem do Java é a versão do Java da qual você está fazendo a atualização. Com base na versão Java detectada na configuração de compilação, watsonx Code Assistant recomenda uma versão Java a ser usada como fonte. Você pode escolher uma versão " Java diferente na lista de versões " Java compatíveis, se isso for apropriado para o seu aplicativo. A configuração de compilação está no arquivo " pom.xml do Maven.
  
  A versão do Java recomendada é a versão Java detectada na configuração de compilação ou é a melhor versão Java disponível, considerando a versão Java detectada. Por exemplo, se Java 9, que não é suportado, for especificado na configuração de compilação, Java 8 será a versão recomendada do Java. Java 8 é recomendado por ser a versão Java compatível mais próxima para a análise e por ser anterior à versão Java detectada.
  
  A versão mínima suportada do Java é o Java 6.
2. Selecione o alvo Java.
  
  A versão de destino Java é a versão Java para a qual você está atualizando o aplicativo Java. As versões de destino que você pode selecionar são versões de longo prazo (LTS) do site Java.
3. Clique em Analisar ou Criar e analisar.
  
  A análise do aplicativo é feita no binário do aplicativo. O aplicativo deve ser criado antes do início da análise. Você pode criar o aplicativo automática ou manualmente.
  - Clique em Criar e analisar para criar e analisar automaticamente o aplicativo.
  - Clique em Analyze depois de criar o aplicativo manualmente.
  Depois que seu aplicativo for criado e analisado, os problemas a serem corrigidos ou revisados serão exibidos. Dependendo dos problemas a serem corrigidos, a capacidade de corrigi-los pode ser automatizada, assistida ou autodirigida. Esses problemas a serem revisados não exigem uma alteração de código para migrar seu código. No entanto, elas podem precisar ser verificadas ou testadas.
  
  Quando você clica em Build and analyze (Criar e analisar ), o aplicativo é criado em sua versão de origem Java atual, para que possa ser analisado quanto a problemas de atualização do Java. Certifique-se de configurar o IDE com o kit de desenvolvedor Java da versão de origem Java, para que o IDE possa construir o aplicativo com êxito.
  
  Ao compilar e analisar, se você tiver problemas com um projeto multimódulo que inclua um submódulo com o empacotamento liberty-assembly, execute mvn install no nível raiz do projeto e tente novamente.

Por que um arquivo.class é incluído em um relatório de análise em vez de um arquivo.java?

Quando você executa uma análise de um binário (JAR/WAR/EAR), os problemas são sempre descobertos nos arquivos de classe. Quando o scanner binário é executado fora do site watsonx Code Assistant, ele não tem acesso ao código-fonte, portanto, o arquivo.class é incluído no relatório de análise. Quando você importa um plano de migração ou executa uma análise em watsonx Code Assistant, os relatórios mostram referências a arquivos de classe, mas watsonx Code Assistant vincula o arquivo.class ao arquivo.java, e os arquivos.java são mostrados na interface do usuário de watsonx Code Assistant.

Correção de problemas e revisão de informações adicionais para seu aplicativo

A página Upgrade <your*application name>*lista as seguintes informações:

A versão de origem " Java e a versão de destino " Java
Links para um relatório de tecnologia, um relatório de inventário e um relatório de análise
Guias para problemas a serem corrigidos, que podem ser correções automatizadas, assistidas ou autodirigidas, e para informações adicionais

O kit de desenvolvedor Java de destino é necessário quando você executa correções automatizadas e quando cria o aplicativo depois que as alterações de destino da versão Java são feitas. Certifique-se de que o kit de desenvolvedor Java de destino esteja configurado para o seu IDE.

A extensão Eclipse IDE tenta automaticamente encontrar o kit de desenvolvedor Java correto que corresponda ao destino da versão Java a partir do conjunto de todos os kits de desenvolvedor Java configurados no IDE.
No IDE Visual Studio Code, você deve alterar manualmente a configuração do kit de desenvolvedor Java.

Conclusão de correções automatizadas

Se você tiver uma guia Correções automatizadas com uma ou mais correções, selecione a guia.

Como watsonx Code Assistant conclui as correções para você, não é necessário fazer nenhuma alteração no código. O modelo de linguagem grande (LLM) não é usado para correções automatizadas.

Expanda as instruções e leia-as.
Opcionalmente, abra o problema para revisar a descrição do problema.
Clique em Run automated fixes (Executar correções automáticas).
- As correções automatizadas foram corrigidas.
- Os problemas externos permanecem na lista até que você atualize a dependência associada.
Quando a execução das correções automatizadas for concluída, clique em Rebuild e atualize para atualizar a lista de problemas.

Se as correções automatizadas não forem executadas e produzirem erros de compilação na saída do console, certifique-se de atualizar a versão do plug-in maven-compiler para 3.13.0 ou mais recente.

Ao executar automações, se você tiver problemas com um projeto multimódulo que inclua um submódulo com o empacotamento liberty-assembly, execute mvn install no nível raiz do projeto e tente novamente.

Conclusão de correções assistidas

Se você tiver uma guia Correções assistidas com uma ou mais correções, selecione a guia.

Embora você corrija seu código, watsonx Code Assistant o ajuda fornecendo sugestões no bate-papo sobre como alterar seu código.

O nível de assistência disponível varia de acordo com o problema. As correções assistidas o ajudam a resolver o problema e, às vezes, uma sugestão de código o ajuda a resolver o problema. Outras vezes, a sugestão de código pode ser tão simples quanto remover uma API antiga para evitar uma falha de compilação, e nenhuma ação adicional é exigida de você. É importante seguir as etapas de cada correção assistida para entender o valor e as limitações de cada correção assistida. Nos casos em que não for fornecida uma sugestão de código completa, você pode pensar na correção assistida como um iniciador de conversa no bate-papo. Continue a se envolver com o bate-papo para aumentar sua compreensão do problema e de sua resolução.

Para obter uma lista de problemas associados às correções assistidas, consulte a Referência de correções assistidas.

Para usar correções assistidas:

Expanda as instruções e siga as instruções.
Para cada questão, expanda-a.
Clique em Leia mais para expandir a edição.
Clique no arquivo que está listado no problema. O arquivo é aberto no editor.
Expanda o problema para ver os detalhes do problema.
Se, nos detalhes, você for orientado a selecionar um trecho de código, selecione-o.
Clique em Help me (Ajude-me ) para obter assistência na correção do problema.

Se você estiver usando Visual Studio Code, as seguintes restrições se aplicam:
- Certifique-se de selecionar o código Java em apenas um editor ativo.
- Certifique-se de que o editor ativo no qual você selecionou o código Java esteja em um grupo de editores diferente da visualização Modernize to Liberty ou Java Upgrade.
Siga as sugestões de código no bate-papo para modificar o código e corrigir o problema.

Às vezes, o bate-papo fornece uma resposta informativa em vez de uma sugestão de código.
À medida que você corrigir os problemas, clique em Rebuild e atualize até que todas as correções assistidas sejam corrigidas.

Conclusão de correções autodirigidas

Se você tiver uma guia Correções autodirigidas com uma ou mais correções, selecione a guia.

Você altera o código e determina como corrigi-lo, mas pode obter ajuda do bate-papo.

Expanda as instruções e siga as instruções.
Expandir cada edição.
Clique em Leia mais para expandir a edição.
Clique no arquivo que está listado no problema. O arquivo é aberto no editor.
Clique em Iniciar bate-papo, que é exibido para cada ocorrência do problema. A janela de bate-papo é aberta para que você possa obter ajuda para a ocorrência. Por exemplo, você pode perguntar ao assistente de código o que o código atual faz. Ou você pode perguntar se existe uma implementação alternativa para o código problemático.
À medida que você corrigir os problemas, clique em Rebuild e atualize até que todas as correções autodirigidas sejam corrigidas.

Endereçamento de informações adicionais

Se você tiver uma guia Informações adicionais com um número de um ou mais, selecione a guia.

Os problemas listados na guia são determinados da mesma forma que os problemas em outras guias. Embora os problemas de informações adicionais não exijam uma alteração no seu código, revise-os para garantir que o aplicativo esteja funcionando quando o código for migrado.

As informações adicionais podem indicar problemas, como pequenas alterações de comportamento em uma API e o que fazer a respeito.

Amplie as instruções e siga-as.
Clique em cada edição.
- Clique em Leia mais para expandir a edição.
- Clique no link do arquivo que está listado no problema para revisar o código.

Trabalhar em questões externas fora do aplicativo atual

Enquanto você trabalha nas correções, algumas podem ser categorizadas como ocorrências de problemas externos fora do aplicativo atual. O código-fonte desses problemas está em arquivos específicos que não fazem parte do aplicativo de código-fonte atual.

Se o arquivo for uma biblioteca de propriedade de sua organização:

Você pode abrir o código-fonte associado como um aplicativo separado e usar o site watsonx Code Assistant para corrigir os problemas.
Em seguida, você pode atualizar seu aplicativo atual para usar a nova versão corrigida.

Se o arquivo for uma biblioteca da qual sua organização não é proprietária:

Você precisa atualizar para uma versão que não contenha esse problema. Se essa versão não existir, talvez seja necessário usar uma tecnologia alternativa.
Você pode iniciar uma conversa com watsonx Code Assistant para obter ajuda na determinação de uma substituição. Para começar, tente perguntar a What is the library X used for? ou Is it easy to replace?. Continue a conversa para obter mais informações sobre seu uso específico da biblioteca.