Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

Chapitre 3. Développement d'applications avec JBoss EAP

3.1. Vue d'ensemble

Ce guide fournit des informations sur le démarrage d'applications de développement à l'aide de Red Hat JBoss Developer Studio et des exemples de quickstart de JBoss EAP 7.

Red Hat JBoss Developer Studio est un environnement de développement intégré (IDE) basé sur Eclipse et intégrant les plug-ins de développement d'application de JBoss. JBoss Developer Studio peut vous assister avec le développement de votre application, avec la disponibilité des assistants de JBoss et avec l'abilité de déployer des applications vers des serveurs JBoss EAP. Plusieurs exemples de codes de quickstart sont fournis avec JBoss EAP 7 pour aider les utilisateurs à écrire des applications avec les différentes technologies Java EE 7.

Ce guide fournit des instructions d'installation de base pour JBoss Developer Studio. Voir le guide Install Red Hat JBoss Developer Studio pour obtenir des instructions d'installation complètes.

3.2. Configurer l'environnement de développement

3.2.1. Télécharger JBoss Developer Studio

JBoss Developer Studio peut être téléchargé à partir du Portail Client de Red Hat.

  1. Se connecter au Portail Clients de Red Hat.
  2. Cliquer sur Téléchargements.
  3. Dans la liste Téléchargements de produits, cliquer sur Red Hat JBoss Developer Studio.

  4. Sélectionner la version souhaitée à partir du menu déroulant Version.

    Note

    Il est recommandé d'utiliser JBoss Developer Studio version 9.1 ou ultérieure.

  5. Trouver l'entrée Red Hat JBoss Developer Studio 9.x.x Stand-alone Installer dans le tableau et cliquer sur Télécharger.
  6. Enregistrer le fichier JAR sur le répertoire souhaité.

3.2.2. Installer JBoss Developer Studio

  1. Ouvrir une session de terminal et naviguer vers le répertoire qui contient le fichier JAR téléchargé.

  2. Exécuter la commande suivante pour lancer le GUI d'installation : 

    $ java -jar jboss-devstudio-BUILD_VERSION-installer-standalone.jar
    Note

    Sinon, ouvrez-le fichier JAR d'un double-clic pour lancer le programme d'installation.

  3. Cliquer sur Next pour démarrer le processus d'instalation.
  4. Sélectionner I accept the terms of this license agreement (J'accepte les conditions de ce contrat de licence), puis cliquez sur Suite.

  5. Ajuster le chemin d'accès et cliquer sur Suite.

    Note

    Si le dossier de chemin d'installation n'existe pas, vous verrez une invite. Cliquer alors sur OK pour créer le dossier.

  6. Choisir une JVM, ou bien conserver la JVM sélectionnée par défaut, et cliquer sur Suite.
  7. Cliquer sur Suite quand on vous demande de sélectionner des plateformes ou des serveurs.
  8. Revoir les informations d'installation, et cliquer sur Suite.
  9. Cliquer sur Suite quand le processus d'installation est terminé.
  10. Configurer les raccourcis de bureau de JBoss Developer Studio, et cliquer sur Suite.
  11. Cliquer sur Terminé.

3.2.3. Démarrer JBoss Developer Studio

Pour lancer JBoss Developer Studio, vous pouvez double-cliquer sur le raccourci du Bureau créé pendant l'installation, ou vous pouvez le lancer par ligne de commande. Effectuez les étapes ci-dessous pour démarrer JBoss Developer Studio par ligne de commande.

  1. Ouvrir un terminal et naviguer dans le répertoire d'installation de JBoss Developer Studio.

  2. Lancer la commande suivante pour démarrer JBoss Developer Studio  : 

    $ ./jbdevstudio
    Note

    Pour Windows Server, utiliser le fichier jbdevstudio.bat.

3.2.4. Ajouter le serveur de JBoss EAP au JBoss Developer Studio

Ces instructions partent du principe que vous n'avez pas encore ajouté de serveur JBoss EAP à JBoss Developer Studio. Utiliser les étapes suivantes pour ajouter votre serveur JBoss EAP à l'aide de l'assistant de création Define New Server.

  1. Ouvrir l'onglet Servers.

    Note

    Si l'onglet Serveurs ne s'affiche pas, ajoutez-le au tableau de bord en sélectionnant Window Afficher Vue Serveurs.

  2. Cliquer sur le lien Aucun serveur n'est disponible actuellement. Cliquer sur ce lien pour créer un nouveau serveur.

    Figure 3.1. Ajouter un nouveau serveur

    The *Servers* tab when no servers are available.

  3. Agrandir Red Hat JBoss Middleware et choisir JBoss Enterprise Application Platform 7.0 . Saisir un nom de serveur, par exemple JBoss EAP 7.0, puis cliquer sur Suite.

    Figure 3.2. Définir un nouveau serveur

    The *Define a New Server* window.

  4. Créer un Adaptateur de serveur pour gérer le démarrage et l'arrêt du serveur. Conserver les valeurs par défaut, et cliquer sur Suite.

    Figure 3.3. Créer un nouvel Adpatateur de serveur

    The *Create a New Server Adapter* window.

  5. Saisir un nom, par exemple JBoss EAP 7.0 Runtime. Cliquer sur Naviguer à côté de répertoire d'accueil et naviguer vers votre répertoire d'installation de JBoss EAP. Cliquer ensuite sur Suite.

    Figure 3.4. Ajouter l'environnement de runtime du nouveau serveur

    The *JBoss Runtime* window.
    Note

    Certains quickstarts exigent que vous exécutiez le serveur avec un profil différent ou avec des arguments supplémentaires. Par exemple, pour déployer un quickstart qui nécessite le profil full, vous devez définir un nouveau serveur et spécifier standalone-full.xml dans le champ Fichier de configuration. Veillez à donner un nom descriptif au nouveau serveur.

  6. Vous permet de configurer les projets existants pour le nouveau serveur. Puisque vous n'avez pas de projet à ce stade, cliquer sur Terminé.

    Figure 3.5. Modifier les ressources dans le nouveau serveur

    The *Add and Remove Resources* window.

Le serveur JBoss EAP 7.0 est désormais répertorié dans l'onglet Serveurs.

Figure 3.6. Liste de serveurs

The *Servers* tab when the `JBoss EAP 7.0` server is listed.

3.3. Utilisation des exemples de quickstart

3.3.1. Maven

Apache Maven est un outil d'automation de builds distribuées, utilisé en développement Java pour créer, gérer et générer des projets de logiciels. Maven utilise des fichiers de configuration nommés Project Object Model, ou POM, pour définir des projets et gérer le processus de build. Les POM décrivent le module et les dépendance du composant, et les sorties sont sous forme de fichier XML. Cela garantit que le projet soit construit de façon correcte et uniforme.

Note

Les exemples de Quickstart de JBoss EAP sont des projets Maven.

Maven y parvient en utilisant un référentiel. Un référentiel Maven stocke les bibliothèques, plug-ins et autres artefacts de la build. Le référentiel public par défaut est Maven 2 Central Repository, mais les référentiels peuvent être privés et internes à une entreprise dans le but de partager des artefacts communs au sein d'équipes de développeurs. Les référentiels sont également disponibles auprès de tierces parties. Pour plus d'informations, voir le projet Apache Maven et le guide Introduction aux référentiels.

JBoss EAP inclut un référentiel Maven contenant les prérequis que les développeurs Java EE utilisent généralement pour créer des applications sur JBoss EAP.

Pour obtenir des informations supplémentaires sur la façon d'utiliser Maven dans JBoss EAP, voir Utiliser Maven dans JBoss EAP dans le Guide de développement de JBoss EAP.

3.3.2. Utilisation de Maven avec des Quickstarts

Les artefacts et dépendances nécessaires pour créer et déployer des applications vers JBoss EAP 7 sont hébergés sur un référentiel public. En commençant par les quickstarts de JBoss EAP 7, il n'est plus nécessaire de configurer votre fichier settings.xml de Maven pour utiliser ces référentiels lors de la création des quickstarts. Les référentiels Maven sont désormais configurés dans les fichiers POM de projet de quickstart. Cette méthode de configuration est fournie pour faciliter le quickstart mais n'est généralement pas recommandée pour les projets de production car votre build peut être ralenti.

Red Hat JBoss Developer Studio inclut Maven, il est donc inutile de le télécharger et de l'installer séparément. Il est recommandé d'utiliser JBoss Developer Studio version 9.1 ou ultérieure.

Si vous souhaitez utiliser la ligne de commande Maven pour créer et déployer vos applications, vous devez tout d'abord télécharger Maven à partir du projet Apache Maven et l'installer à l'aide des instructions fournies dans la documentation Maven.

3.3.3. Télécharger et exécuter les quickstarts

3.3.3.1. Télécharger les quickstarts

JBoss EAP contient une bonne série d'exemples de code quickstart (démarrage rapide) conçus pour aider les utilisateurs à commencer à rédiger des applications en utilisant différentes technologies Java EE 7. Les quickstarts peuvent être téléchargés à partir du portail client Red Hat.

  1. Se connecter au Portail Clients de Red Hat.
  2. Cliquer sur Téléchargements.
  3. À partir de la liste Téléchargements de produits, cliquer sur Red Hat JBoss Enterprise Application Platform.
  4. Sélectionner la version souhaitée à partir du menu déroulant Version.
  5. Trouver l'entrée Red Hat JBoss Enterprise Application Platform 7.0.0 Quickstarts dans le tableau et cliquer sur Télécharger.
  6. Enregistrer le fichier ZIP sur le répertoire souhaité.
  7. Veuillez extraire le fichier ZIP.

3.3.3.2. Exécuter les quickstarts dans JBoss Developer Studio

Une fois les quickstarts téléchargés, ceux-ci peuvent être importés dans JBoss Developer Studio et déployés vers JBoss EAP.

Importer un quickstart dans JBoss Developer Studio

Chaque quickstart est fourni avec un fichier POM qui contient des informations de projet et de configuration. À l'aide de ce fichier POM, vous pouvez facilement importer le quickstart dans JBoss Developer Studio.

Important

Si votre dossier de projet quickstart se situe dans l'espace de travail IDE, lorsque vous l'importez dans JBoss Developer Studio, l'IDE génère un nom de projet non valide et un nom d'archive WAR. N'oubliez pas que votre dossier de projet quickstart doit être situé en dehors de l'espace de travail IDE avant de commencer.

  1. Démarrer JBoss Developer Studio.
  2. Sélectionner File Import.

  3. Sélectionner Maven Projets Maven existants, puis cliquer sur Suite.

    Figure 3.7. Importer les projets Maven existants

    The *Import* window.

  4. Naviguer vers le répertoire de quickstart souhaité (par exemple le quickstart helloworld) puis cliquer sur OK. Le champ de la liste Projects se remplit avec le fichier pom.xml du projet de quickstart sélectionné.

    Figure 3.8. Sélectionner les projets Maven

    The *Maven Projects* selection window.
  5. Cliquer sur Finish.

Exécuter le quickstart helloworld

Le quickstart helloworld est une manière simplifiée de vérifier que le serveur JBoss EAP est configuré et exécuté correctement.

  1. Si vous n'avez pas encore défini de serveur, ajouter le serveur JBoss EAP dans JBoss Developer Studio

  2. Effectuer un clic droit sur le projet jboss-helloworld dans l'onglet Project Explorer et sélectionner Run As Run on Server.

    Figure 3.9. Run As - Run on Server

    The *Run As* -> *Run on Server* screen capture.

  3. Sélectionner JBoss EAP 7.0 à partir de la liste de serveurs et cliquer sur Suite.

    Figure 3.10. Run on Server

    The *Run on Server* window.

  4. Le quickstart jboss-helloworld apparaît déjà comme devant être configuré sur le serveur. Cliquer sur Terminé pour déployer le quickstart.

    Figure 3.11. Modifier les ressources configurées sur le serveur

    The *Add and Remove Resources* window.

  5. Vérifier les résultats.

    • Dans l'onglet Server, le statut du serveur JBoss EAP 7.0 devient Started (Démarré).

    • L'onglet Console montre des messages détaillant le démarrage du serveur JBoss EAP et le déploiement du quickstart helloworld. 

      WFLYUT0021: Registered web context: /jboss-helloworld
WFLYSRV0010: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
    • L'application helloworld est disponible sur http://localhost:8080/jboss-helloworld et affiche le texte Hello World!.

Exécuter le quickstart bean-validation

Certains quickstarts, comme bean-validation quickstart, ne fournissent pas de couche d'interface utilisateur, mais fournissent des tests Arquillian pour démontrer la fonctionnalité à la place.

  1. Importer le quickstart bean-validation dans JBoss Developer Studio.
  2. Dans l'onglet Servers, effectuer un clic droit sur le serveur et sélectionner Start pour démarrer le serveur JBoss EAP. Si vous ne voyez pas un onglet Servers ou n'avez pas encore défini un serveur, ajoutez le serveur JBoss EAP au Red Hat JBoss Developer Studio.
  3. Effectuer un clic droit sur le projet jboss-bean-validation dans l'onglet Project Explorer et sélectionner Run As Maven Build.

  4. Saisir ce qui suit dans le champ de saisie Goals puis cliquer sur Run. 

    clean test -Parq-wildfly-remote

    Figure 3.12. Modifier la configuration

    The *Edit Configuration* window.

  5. Vérifier les résultats.

    L'onglet Console affiche les résultats des tests Arquillian bean-validation : 

    -------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest
Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.189 sec

Results :

Tests run: 5, Failures: 0, Errors: 0, Skipped: 0

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

3.3.3.3. Exécuter les Quickstarts à partir de la ligne de commande

Vous pouvez facilement créer et déployer des quickstarts à partir de la ligne de commande en utilisant Maven. Si vous n'avez pas encore installé Maven, voir le projet Apache Maven pour le télécharger et l'installer.

A README.md file is provided at the root directory of the quickstarts that contains general information about system requirements, configuring Maven, adding users, and running the quickstarts.

Chaque quickstart contient son propre fichier README.md fournissant les instructions spécifiques et les commandes Maven qui servent à exécuter ce quickstart.

Exécuter le quickstart helloworld à partir de la ligne de commandes

  1. Vérifier le fichier README.md dans le répertoire racine du quickstart helloworld.

  2. Démarrer le serveur JBoss EAP. 

    $ EAP_HOME/bin/standalone.sh
  3. Navuguez dans le répertoire quickstart helloworld.

  4. Construire et déployer le quickstart à l'aide de la commande Maven fournie dans le fichier README.md du quickstart. 

    mvn clean install wildfly:deploy
  5. L'application helloworld se trouve maintenant à l'adresse suivante http://localhost:8080/jboss-helloworld et affiche le texte Hello World!.
Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.