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: 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
- Codez un programme Java pouvant accéder à la classe JSR-88
DeploymentManager pour le produit.
- 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);
- 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"
- 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.
- 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.