Installation de modules d'entreprise avec JSR-88

Vous pouvez installer des modules Java™ Platform, Enterprise Edition (Java EE) sur un serveur d'applications fourni par un WebSphere Application Server produit utilisant la spécification d'interface de programme d'application Java EE Application Deployment (JSR-88).

Avant de commencer

Fonction obsolète Fonction obsolète: L'installation d'application à l'aide de la spécification d'API de déploiement d'application Java EE (JSR-88) a été dépréciée dans WebSphere Application Server Version 8.0. Procédez autrement pour déployer des applications sur un serveur. La méthode se rapprochant le plus de l'utilisation de l'API de déploiement Java EE est l'utilisation de la programmation Mbean JMX (Java Management Extensions). Pour plus d'informations sur les options de déploiement, voir la rubrique relative aux "méthodes d'installation de modules ou d'applications d'entreprise".depfeat

JSR-88 définit des API standard permettant le déploiement d'applications Java EE et de modules autonomes sur des plateformes Java EE. The Java EE Application Deployment specification Version 1.1 is available at http://www.oracle.com/technetwork/java/index.html as part of the Java 2 Platform, Enterprise Edition (J2EE) 1.4 Application Server Developer Release.

Pourquoi et quand exécuter cette tâche

JSR-88 définit un contrat entre un fournisseur d'outils et une plateforme, qui permet de configurer, de déployer et de gérer des applications sur toutes les plateformes Java EE avec des outils de plusieurs fournisseurs. Le fournisseur fournit généralement des outils logiciels et un environnement de développement intégré (IDE) pour le développement et l'assemblage des modules d'application Java EE. La plateforme Java EE offre des fonctions de gestion d'application permettant de déployer, d'annuler le déploiement, de démarrer, d'arrêter des applications Java EE et d'effectuer un grand nombre de tâches de gestion.

WebSphere Application Server est une plateforme compatible avec la spécification Java EE qui implémente les API JSR-88. Effectuez les étapes suivantes pour déployer (installer) des modules Java EE sur un serveur d'applications fourni par la plateforme WebSphere Application Server.

Procédure

  1. Codez un programme Java pouvant accéder à la classe JSR-88 DeploymentManager pour le produit.
    1. Rédigez le code qui recherche l'attribut de manifeste JAR J2EE-DeploymentFactory-Implementation-Class.

      Sous JSR-88, le code recherche la fabrique de déploiement (DeploymentFactory) à l'aide de l'attribut de manifeste JAR J2EE-DeploymentFactory-Implementation-Class. Les fichiers JAR de gestion des applications du produit ci-dessous contiennent cet attribut et assurent la prise en charge.

      Tableau 1. Fichiers JAR contenant l'attribut de manifeste. Le code recherche la fabrique de déploiement (DeploymentFactory) à l'aide de l'attribut de manifeste JAR.
      Environnement Fichier JAR contenant l'attribut de manifeste
      Serveur d'applications racine_serveur_app/plugins/com.ibm.ws.admin.services.jar
      Client d'application racine_client_app/plugins/com.ibm.ws.j2ee.client.jar
      Client d'application léger app_client_root/runtimes/com.ibm.ws.admin.client_9.0.jar

      Une fois que le code a trouvé DeploymentFactory, l'outil de déploiement peut créer une instance de WebSphere DeploymentFactory et enregistrer l'instance avec son gestionnaire de fabrique de déploiement (DeploymentFactoryManager).

      Vous trouverez un exemple de code pour l'environnement du serveur d'applications ci-après. L'exemple de code exige que vous utilisiez le kit de développement livré avec le produit ou que vous utilisiez le client tiers pour le déploiement de modules autonomes. See WebSphere Application Server detailed system requirements at http://www.ibm.com/support/docview.wss?rs=180&uid=swg27006921 for information on supported development kits.

      import javax.enterprise.deploy.shared.factories.DeploymentFactoryManager;
      import javax.enterprise.deploy.spi.DeploymentManager;
      import javax.enterprise.deploy.spi.factories.DeploymentFactory;
      import java.util.jar.JarFile;
      import java.util.jar.Manifest;
      
      // Get the DeploymentFactory implementation class from the MANIFEST.MF file.
      File jsr88Jar = new File(wasHome + "/plugins/com.ibm.ws.admin.services.jar");
      JarFile jarFile = new JarFile(jsr88Jar);
      Manifest manifest = jarFile.getManifest();
      Attributes attributes = manifest.getMainAttributes();
      String key = "J2EE-DeploymentFactory-Implementation-Class";
      String className = attributes.getValue(key);
      // Get an instance of the DeploymentFactoryManager
      DeploymentFactoryManager dfm = DeploymentFactoryManager.getInstance();
      
      // Create an instance of the WebSphere Application Server DeploymentFactory.
      Class deploymentFactory = Class.forName(className);
      DeploymentFactory deploymentFactoryInstance =
         (DeploymentFactory) deploymentFactory.newInstance();
      
      // Register the DeploymentFactory instance with the DeploymentFactoryManager.
      dfm.registerDeploymentFactory(deploymentFactoryInstance);
      
      // Provide WebSphere Application Server URI, user ID, and password.
      // For more information, see the step that follows.
      wsDM = dfm.getDeploymentManager(
         "deployer:WebSphere:myserver:8880", null, null);
    2. Ecrivez le code permettant d'accéder à l'instance DeploymentManager pour le produit.

      L'identificateur URI du produit pour le déploiement a le format suivant :

      "deployer:WebSphere:host:port"

      L'exemple de l'étape précédente, "deployer:WebSphere:monserveur:8880", tente par défaut de se connecter à l'hôte monserveur sur le port 8880 à l'aide du connecteur SOAP.

      Vous pouvez entrer une adresse IPv6 (Internet Protocol version 6) pour l'élément host dans l'URI pour le déploiement. Enclose the IPv6 address using brackets ([]); for example:

      "deployer:WebSphere:[IPv6_address]:port"

      Le paramètre facultatif connectorType peut aussi être ajouté à l'URI de déploiement. Par exemple, pour utiliser le connecteur RMI pour accéder à monserveur, codez l'URL comme suit :

      "deployer:WebSphere:myserver:2809?connectorType=RMI"
  2. Facultatif : Codez un programme Java permettant de personnaliser ou de déployer des applications ou des modules Java EE à l'aide du support JSR-88 fourni par le produit.
  3. Démarrez les applications Java EE déployées ou les modules Java EE autonomes à l'aide de l'API JSR-88 utilisée pour démarrer des applications ou des modules.

Que faire ensuite

Testez les applications ou les modules déployés. Par exemple, pointez un navigateur Web sur l'URL d'une application déployée et vérifiez ses performances. Si nécessaire, mettez à jour l'application.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_jsr88
Nom du fichier : trun_app_jsr88.html