Mise en place de l'environnement Java de l'entreprise

watsonx Code Assistant Plan standard

Si vous utilisez le plan Standard et souhaitez travailler avec des applications Java 'entreprise, vous devez configurer votre environnement pour votre IDE.

Configuration logicielle requise

Les conditions requises pour utiliser watsonx Code Assistant for Enterprise Java Applications dans Visual Studio Code ou dans Eclipse sont les suivantes :

Configuration système requise
Elément Détails
Java Java SE 11 avec Java Developer Kit 11 ou une version ultérieure
Maven Utilisez Maven pour construire votre application. Si vous utilisez Liberty Tools et le plug-in Liberty Maven pour construire votre application ou votre projet, utilisez Maven 3.8.6 ou une version plus récente.

Visual Studio Code configuration

Définissez les variables d'environnement

Définissez vos variables d'environnement.

JAVA_HOME

Définissez la variable d'environnement 'JAVA_HOME de la même manière que pour Maven. Définissez-le sur le répertoire JDK qui contient le répertoire /bin afin que votre fichier exécutable Java se trouve dans le chemin $JAVA_HOME/bin/java.

Vous pouvez définir la variable d'environnement " JAVA_HOME pour créer votre application avec une version différente, par exemple Java 11.

CHEMIN

Définissez la variable d'environnement PATH pour inclure le fichier exécutable mvn.

  • Windows : mvn.cmd
  • macOS: mvn

Si vous utilisez le terminal Visual Studio Code pour définir les variables d'environnement, vous devez redémarrer Visual Studio Code pour appliquer les modifications.

Déterminer le kit du développeur Java

Pour Visual Studio Code, si vous utilisez l'Extension Pack for Java, watsonx Code Assistant détermine le kit de développement Java à utiliser dans cet ordre de priorité :

Commande du kit du développeurJava
Ordre de priorité Description
1 Kit de développement Java configuré globalement pour la construction automatique dans l'extension Red Hat, qui est java.configuration.runtimes dans le fichier IDE settings.json.
2 java.jdt.ls.java.home ou java.home Les paramètres de l'IDE s'ils sont présents.
3 JDK_HOME variable d'environnement du système.
4 JAVA_HOME variable d'environnement du système. Requis si les points 1 à 3 ne sont pas définis.

Lorsque des fonctionnalités watsonx Code Assistant for Enterprise Java Applications sont utilisées, telles que la modernisation ou la mise à niveau de Java, vous pouvez vérifier quel kit de développement Java est utilisé :

  1. Dans Visual Studio Code, cliquez sur View, puis sur Output.

  2. Dans la vue Output, utilisez la liste déroulante pour sélectionner WCA.

  3. Vérifier la présence d'un message tel que " Using the Java developer kit that is defined in <location> to run watsonx Code Assistant components. The path is: <path>.

Définir le niveau de journalisation

Pour ajuster la journalisation pour l'extension Visual Studio Code:

  1. Dans Visual Studio Code, ouvrez les paramètres d'extension pour watsonx Code Assistant

  2. Dans Wca : Niveau d'enregistrement, passez de la valeur par défaut " INFO à une autre valeur telle que " WARN.

Configuration de l Eclipse IDE

Déterminer l'installation de Java

Pour Eclipse, l'installation de Java est déterminée dans cet ordre :

  • L'installation qui est configurée dans le chemin de construction du projet
  • L'installation par défaut de Java pour l'IDE

Pour la modernisation et la mise à niveau des applications, les correctifs automatiques utilisent l'installation du kit de développement Java qui correspond le mieux à la version cible de Java que vous avez choisie. Vous devez :

  1. Installer le kit de développement Java.
  2. Dans les paramètres de l' Eclipse IDE, ouvrez la section Java et ajoutez l'installation aux JRE installés.

Installation de Maven dans Eclipse

Veillez à utiliser Maven pour construire votre application.

Maven doit être placé dans le PATH.

Définissez la variable d'environnement PATH pour inclure le fichier exécutable mvn.

Fichiers exécutables Maven
Système d'exploitation Fichier exécutable
Windows mvn.cmd
macOS mvn

Pour les systèmes d'exploitation macOS, les variables d'environnement peuvent ne pas être définies comme prévu lorsque vous exécutez Eclipse. Pour résoudre le problème, vous pouvez redémarrer Eclipse en utilisant l'outil Finder, en cliquant avec le bouton droit de la souris sur votre application Eclipse et en choisissant Afficher le contenu du paquet. Ouvrez le dossier Contents, sélectionnez MacOS, puis exécutez Eclipse en cliquant sur le code exécutable.

Comment se trouve le fichier pom.xml d'un projet Maven?

Watsonx Code Assistant utilise le fichier agrégateur pom.xml pour construire et gérer l'ensemble du projet multimodule Maven. Lorsque watsonx Code Assistant tente d'effectuer des constructions et d'autres activités liées à Maven, il utilise la racine multi-module (MMR) pour localiser le fichier agrégateur pom.xml.

  • Le MMR recherche d'abord le fichier pom.xml de l'agrégateur dans le répertoire de projet le plus élevé.
  • Si le MMR ne trouve pas le fichier, il recherche dans le répertoire du projet en allant de la structure de répertoire la plus élevée à la suivante, et ainsi de suite, jusqu'à ce qu'il trouve un fichier agrégateur pom.xml.
  • Si le MMR ne trouve pas de fichier agrégateur pom.xml, il recherche dans le répertoire du projet en allant de la structure de répertoire la plus élevée à la suivante, et ainsi de suite, jusqu'à ce qu'il trouve un fichier normal pom.xml. Un fichier pom.xml normal indique que le projet Maven est un projet à module unique au lieu d'un projet à modules multiples.

Cependant, il existe une restriction supplémentaire. Le projet multimodule doit avoir un fichier WAR ou un fichier EAR. Il peut y avoir plusieurs fichiers WAR s'il n'y a qu'un seul fichier EAR. Mais s'il y a plusieurs fichiers WAR et aucun fichier EAR, le projet n'est pas pris en charge. La raison en est que watsonx Code Assistant peut analyser le bon binaire et placer le fichier de configuration Liberty (server.xml) dans le bon sous-module.