Mise à jour de la version de Java pour votre application

Avant de commencer

Si vous rencontrez un problème lors de l'utilisation Application Modernization Accelerator Developer Tools, consultez la page Dépannage.

Temps nécessaire à l'analyse de votre code

Le temps nécessaire à l'analyse de votre demande varie. Les horaires suivants sont typiques.

Tableau 1. Temps nécessaire à l'analyse

Analyse de votre application pour mettre à jour la version Java

L'analyse vous fournit une liste de questions à traiter. Une fois les problèmes résolus, la version Java de votre application est mise à jour.

Si vous annulez les modifications apportées à votre code, vous devez cliquer sur Retour à l'analyse et effectuer une analyse complète si vous souhaitez effectuer à nouveau la mise à niveau de Java .

1. Dans votre IDE, cliquez avec le bouton droit de la souris sur n'importe quel élément de la hiérarchie dans le répertoire de l'application que vous voulez mettre à niveau, cliquez sur Moderniser les applications Java, puis cliquez sur Mettre à niveau la version Java.

2. Sur la page de mise à niveau de <nom de votre application>, sélectionnez les paramètres d'analyse, qui définissent les règles en fonction desquelles l'application est analysée.

   1. Modifier la source Java , qui s'affiche automatiquement avec une valeur recommandée.

      La version source Java est la version Java à partir de laquelle vous effectuez la mise à niveau. Sur la base de la version Java détectée dans la configuration de construction, IBM Application Modernization Accelerator Developer Tools recommande une version Java à utiliser comme source. Java Vous pouvez choisir une autre version de Java dans la liste des versions prises en charge si cela convient à votre application. La configuration de la construction se trouve dans le fichier Maven pom.xml .

      La version de Java recommandée est celle qui est détectée dans la configuration de construction. Ou bien il s'agit de la meilleure version disponible de Java compte tenu de la version de Java qui a été détectée. Par exemple, si Java 9, qui n'est pas pris en charge, est spécifié dans la configuration de la construction, Java 8 est la version recommandée de Java . Java 8 est recommandé car il s'agit de la version de Java la plus proche de l'analyse, et parce qu'elle est antérieure à la version de Java détectée.

      Important : la version minimale supportée par Java est Java 6.

   2. Sélectionnez la cible Java .

      La version cible Java est la version Java vers laquelle vous mettez à jour votre application Java . Les versions cibles que vous pouvez sélectionner sont des versions à long terme (LTS) Java .

   3. Construire l'application et l'analyser.

      L'analyse de l'application est effectuée sur le binaire de l'application. L'application doit être construite avant le début de l'analyse.

      • Pour les constructions Maven, vous pouvez construire l'application manuellement ou automatiquement.

        Cliquez sur Analyser après avoir construit manuellement l'application ou sur Construire et analyser pour construire et analyser automatiquement l'application.

        Après la construction et l'analyse de votre application, les problèmes à résoudre ou à revoir sont affichés. En fonction des problèmes à résoudre, la capacité à les résoudre peut être automatisée ou autogérée. Les questions à examiner ne nécessitent pas de modification du code pour migrer votre code. Toutefois, il peut être nécessaire de les vérifier ou de les tester.

        Lorsque vous cliquez sur Construire et analyser, l'application est construite dans sa version source actuelle Java , de sorte qu'elle peut être analysée pour détecter les problèmes de mise à niveau Java . Veillez à configurer l'IDE avec le kit de développement Java de la version source Java , afin que l'IDE puisse construire l'application avec succès.

        Conseil : lors de la construction et de l'analyse, si vous rencontrez des problèmes avec un projet multimodule qui inclut un sous-module avec le paquetage liberty-assembly , exécutez mvn install au niveau racine du projet et réessayez.
      • Pour les versions non-Maven, créez manuellement l'application, puis cliquez sur Analyser.

        Après la construction et l'analyse de votre application, les problèmes à résoudre ou à revoir sont affichés. Les problèmes à résoudre sont autodirigés. Les questions à examiner ne nécessitent pas de modification du code pour migrer votre code. Toutefois, il peut être nécessaire de les vérifier ou de les tester.

Correction des problèmes et examen des informations complémentaires pour votre demande

La page Mise à niveau <nom de l'application> contient les informations suivantes :

• La source de la version Java et la cible de la version Java
• Liens vers un rapport technologique, un rapport d'inventaire et un rapport d'analyse
• Onglets pour les problèmes à résoudre, qui peuvent être automatisés ou autogérés, et pour les informations complémentaires

Le kit de développement de la cible Java est nécessaire lorsque vous exécutez des corrections automatisées et lorsque vous construisez l'application après que les modifications de la cible de la version Java ont été effectuées. Assurez-vous que le kit de développement de la cible Java est configuré pour votre IDE.

• Les plug-ins pour Eclipse IDE et IntelliJ IDE essaient automatiquement de trouver le kit de développement Java correspondant à la version cible Java . La version cible de Java provient de l'ensemble des kits de développement Java configurés dans les IDE.
• Dans l'IDE Visual Studio Code , vous devez modifier manuellement la configuration du kit de développement Java .

Compléter les correctifs automatisés pour les builds Maven

Si vous avez un onglet Corrections automatisées avec une ou plusieurs corrections, sélectionnez l'onglet.

Comme IBM Application Modernization Accelerator Developer Tools effectue les corrections pour vous, vous n'avez pas besoin de modifier le code.

1. Développez les instructions et lisez-les.
2. Il est possible d'ouvrir le problème pour en consulter la description.
3. Cliquez sur Exécuter les corrections automatiques.
   • Les correctifs automatisés sont corrigés.
   • Les questions externes restent dans la liste jusqu'à ce que vous mettiez à jour la dépendance associée.
4. Lorsque l' exécution des corrections automatisées est terminée, cliquez sur Reconstruire et actualiser pour mettre à jour la liste des problèmes.

Important :

• Si les correctifs automatiques ne s'exécutent pas et produisent des erreurs de compilation dans la sortie de la console, veillez à mettre à jour la version du plug-in maven-compiler à 3.13.0 ou à une version plus récente.
• Lorsque vous exécutez des automatismes, si vous rencontrez des problèmes avec un projet multimodule qui inclut un sous-module avec le paquetage liberty-assembly , exécutez mvn install au niveau racine du projet et réessayez.

Effectuer des corrections en autonomie

Si vous avez un onglet Corrections auto-dirigées avec une ou plusieurs corrections, sélectionnez l'onglet.

Vous modifiez le code et déterminez comment le corriger.

1. Développez les instructions et suivez-les.
2. Développez chaque numéro.
3. Cliquez sur Lire la suite pour agrandir le numéro.
4. Cliquez sur le fichier répertorié dans le problème. Le fichier s'ouvre dans l'éditeur.
5. Au fur et à mesure que vous corrigez des problèmes, cliquez sur Reconstruire et actualisez jusqu'à ce que tous les problèmes corrigés par vos soins soient résolus.

Conseil : pour certaines corrections autonomes, vous pouvez utiliser les capacités d'IA générative dans watsonx Code Assistant™ for Enterprise Java Applications.

Adresser des informations complémentaires

Si vous disposez d'un onglet Informations complémentaires comportant un ou plusieurs numéros, sélectionnez cet onglet.

Les questions figurant dans l'onglet sont déterminées de la même manière que les questions figurant dans les autres onglets. Bien que les questions relatives aux informations complémentaires ne nécessitent pas de modification de votre code, passez-les en revue afin de vous assurer que votre application fonctionnera lorsque votre code sera migré.

Les informations supplémentaires peuvent indiquer des problèmes, tels que des modifications mineures du comportement d'une API et ce qu'il convient de faire à ce sujet.

• Développez les instructions et suivez-les.

• Cliquez sur chaque numéro.

  • Cliquez sur Lire la suite pour agrandir le numéro.
  • Cliquez sur le lien du fichier figurant dans le numéro pour consulter le code.

Travailler sur des questions externes en dehors de l'application actuelle

Pendant que vous travaillez sur les correctifs, certains peuvent être classés comme des problèmes externes à l'application en cours. Le code source de ces problèmes se trouve dans des archives spécifiques qui ne font pas partie de l'application source actuelle.

Si l'archive est une bibliothèque appartenant à votre organisation.

1. Vous pouvez ouvrir le code source associé en tant qu'application distincte et utiliser IBM Application Modernization Accelerator Developer Tools pour remédier aux problèmes qui s'y trouvent.

2. Ensuite, vous pouvez mettre à jour votre application actuelle pour utiliser la nouvelle version remédiée.

Si les archives sont une bibliothèque dont votre organisation n'est pas propriétaire.

• Vous devez mettre à jour vers une version qui ne contient pas ce problème. Si une telle version n'existe pas, il se peut que vous deviez utiliser une technologie différente.