Mise à jour de la version de Java pour votre application

watsonx Code Assistant Plan standard

Pour mettre à jour votre code Java, vous devez d'abord créer et analyser votre application, puis corriger les problèmes identifiés. Selon les problèmes, la capacité à les résoudre peut être automatisée, assistée ou autonome.

Avant de commencer, configurez votre environnement Java d'entreprise.

Eclipse IDE uniquement: Pour obtenir les meilleurs résultats avec une application Java multimodule, veillez à importer le module agrégateur et chaque sous-module en tant que projets distincts dans l'espace de travail Eclipse. il est peu probable que Watsonx Code Assistant réussisse à inspecter votre projet si vous importez le répertoire de premier niveau en tant que projet unique.

Temps nécessaire à l'analyse de votre code

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

Temps nécessaire à l'analyse
Durée Détails de l'application
Quelques secondes à quelques minutes Moins de 100 classes
2 à 10 minutes 20 000 à 50 000 lignes de code
10 minutes ou plus 300 000 lignes de code

Lorsque watsonx Code Assistant analyse votre application, il exclut par défaut certains paquets tiers de l'analyse du code. Pour plus d'informations, voir Paquets tiers exclus de l'analyse des applications.

Analyse de votre application pour mettre à jour la version de 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 pour analyser et effectuer une analyse complète si vous souhaitez procéder à nouveau à la mise à niveau d' 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 souhaitez mettre à niveau.

  2. Utilisez l'un ou l'autre chemin pour lancer le processus de mise à niveau. Les deux sont identiques :

    • Cliquez sur watsonx Code Assistant puis cliquez sur Mettre à jour la version de Java.
    • Cliquez sur Moderniser les applications Java, puis sur Mettre à niveau la version Java.

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

    1. Il est possible de modifier la source Java, qui s'affiche automatiquement avec une valeur recommandée.

      La version source de Java est la version de Java à partir de laquelle vous effectuez la mise à niveau. Sur la base de la version de Java détectée dans la configuration de construction, watsonx Code Assistant recommande une version de Java à utiliser comme source. Vous pouvez choisir une autre version de Java dans la liste des versions supportées 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 soit la version de Java détectée dans la configuration de la compilation, soit la meilleure version de Java disponible compte tenu de la version de Java détectée. Par exemple, si Java 9, qui n'est pas pris en charge, est spécifié dans la configuration de la compilation, 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 qu'elle est antérieure à la version de Java détectée.

      La version minimale de Java prise en charge 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. Cliquez sur Analyser ou Construire et 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. Vous pouvez construire l'application automatiquement ou manuellement.

      • Cliquez sur Construire et analyser pour construire et analyser automatiquement l'application.
      • Cliquez sur Analyser après avoir créé manuellement 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, assistée ou autogérée. Ces 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 Build and analyze (Créer et analyser ), l'application est créée dans sa version source d' Java, afin de pouvoir être analysée pour détecter d'éventuels problèmes de mise à niveau d' Java. Assurez-vous de configurer l'IDE avec le kit de développement IDE ( Java ) de la version source d' Java, afin que l'IDE puisse construire l'application avec succès.

      Lors de la construction et de l'analyse, si vous rencontrez des problèmes avec un projet multimodule qui inclut un sous-module avec un packaging d' liberty-assembly, exécutez mvn install au niveau racine du projet et réessayez.

Pourquoi un fichier.class est-il inclus dans un rapport d'analyse au lieu d'un fichier.java?

Lorsque vous effectuez une analyse d'un fichier binaire (JAR/WAR/EAR), les problèmes sont toujours découverts dans les fichiers de classe. Lorsque l'analyseur binaire est exécuté en dehors de watsonx Code Assistant, il n'a pas accès au code source, de sorte que le fichier.class est inclus dans le rapport d'analyse. Lorsque vous importez un plan de migration ou que vous exécutez une analyse à l'intérieur de watsonx Code Assistant, les rapports font référence à des fichiers de classe, mais watsonx Code Assistant relie le fichier.class au fichier.java, et les fichiers.java sont affichés dans l'interface utilisateur de watsonx Code Assistant.

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 version Java source et la version Java cible
  • 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, assistés ou autogérés, et pour des informations supplémentaires

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

  • L'extension Eclipse IDE tente automatiquement de trouver le kit de développement Java correct qui correspond à la version Java cible à partir de l'ensemble de tous les kits de développement Java configurés dans l'IDE.
  • Dans l'IDE Visual Studio Code, vous devez modifier manuellement la configuration du kit de développement Java.

Achèvement des corrections automatisées

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

Comme watsonx Code Assistant effectue les corrections pour vous, vous n'avez pas besoin de modifier le code. Le grand modèle linguistique (LLM) n'est pas utilisé pour les corrections automatiques.

  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.

Si les correctifs automatisés ne s'exécutent pas et produisent des erreurs de compilation dans la sortie de la console, assurez-vous de mettre à jour la version du plug-in d' maven-compiler s vers 3.13.0 ou une version plus récente.

Lorsque vous exécutez des automatisations, si vous rencontrez des problèmes avec un projet multimodule qui inclut un sous-module avec un packaging d' liberty-assembly, exécutez mvn install au niveau de la racine du projet et réessayez.

Compléter les corrections assistées

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

Bien que vous corrigiez votre code, watsonx Code Assistant vous assiste en fournissant des suggestions dans le chat sur la manière de modifier votre code.

Le niveau d'assistance disponible varie selon le problème. Les correctifs assistés vous aident à résoudre le problème, et parfois une suggestion de code vous permet de le résoudre entièrement ou en grande partie. Dans d'autres cas, la suggestion de code peut être aussi simple que la suppression d'une ancienne API pour éviter un échec de compilation, et aucune autre action n'est requise de votre part. Il est important de suivre les étapes de chaque correction assistée pour comprendre la valeur et les limites de chacune d'entre elles. Dans les cas où aucune suggestion de code complète n'est fournie, vous pouvez considérer la correction assistée comme un déclencheur de conversation dans le chat. Continuez à participer au chat pour mieux comprendre le problème et sa résolution.

Pour une liste des problèmes associés aux corrections assistées, voir la référence des corrections assistées.

Pour utiliser les correctifs assistés :

  1. Développez les instructions et suivez-les.

  2. Pour chaque question, développez-la.

  3. Cliquez sur Lire la suite pour développer le numéro.

  4. Cliquez sur le fichier répertorié dans le problème. Le fichier s'ouvre dans l'éditeur.

  5. Développez la question pour en afficher les détails.

  6. Si, dans les détails, il vous est demandé de sélectionner un extrait de code, sélectionnez-le.

  7. Cliquez sur Aidez-moi pour obtenir de l'aide afin de résoudre le problème.

    Si vous utilisez Visual Studio Code, les restrictions suivantes s'appliquent :

    • Veillez à ne sélectionner le code Java que dans un seul éditeur actif.
    • Assurez-vous que l'éditeur actif dans lequel vous avez sélectionné le code Java se trouve dans un groupe d'éditeurs différent de celui de la vue Moderniser vers Liberty ou Java Upgrade.

  8. Suivez les suggestions de code dans le chat pour modifier le code et corriger le problème.

    Parfois, le chat fournit une réponse informative au lieu d'une suggestion de code.

  9. Lorsque vous corrigez des problèmes, cliquez sur Reconstruire et actualisez jusqu'à ce que toutes les corrections assistées soient corrigées.

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, mais vous pouvez obtenir de l'aide sur le chat.

  1. Développez les instructions et suivez-les.
  2. Développez chaque numéro.
  3. Cliquez sur Lire la suite pour développer le numéro.
  4. Cliquez sur le fichier répertorié dans le problème. Le fichier s'ouvre dans l'éditeur.
  5. Cliquez sur Démarrer le chat, qui s'affiche pour chaque occurrence du problème. La fenêtre de chat s'ouvre pour que vous puissiez obtenir de l'aide pour l'événement. Par exemple, vous pouvez demander à l'assistant de code ce que fait le code actuel. Vous pouvez également demander s'il existe une autre solution pour le code qui pose problème.
  6. Lorsque vous corrigez des problèmes, cliquez sur Reconstruire et actualisez jusqu'à ce que toutes les corrections automatiques soient effectuées.

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 problèmes répertoriés dans l'onglet sont déterminés de la même manière que ceux des autres onglets. Bien que les problèmes d'informations supplémentaires ne nécessitent pas de modification de votre code, examinez-les afin de vous assurer que votre application fonctionne lorsque votre code est migré.

Les informations supplémentaires peuvent indiquer des problèmes, tels que des changements mineurs de comportement dans une API et ce qu'il faut faire à ce sujet.

  • Développez les instructions et suivez-les.

  • Cliquez sur chaque numéro.

    • Cliquez sur Lire la suite pour développer 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 watsonx Code Assistant 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 :

  1. 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 autre technologie.

  2. Vous pouvez entamer une conversation avec watsonx Code Assistant pour obtenir de l'aide dans la détermination d'un remplacement. Pour commencer, essayez de demander What is the library X used for? ou Is it easy to replace?. Poursuivez la conversation pour obtenir plus d'informations sur votre utilisation spécifique de la bibliothèque.