JBoss - Déployer une application entreprise dans un fichier « .ear »

JBoss | Déployer une application entreprise dans un fichier « .ear »

Une application entreprise peut contenir plusieurs modules EJB et web.
Une application entreprise peut être déployée dans un fichier « .ear ».

Voici le contenu possible du fichier « .ear » :
META-INF/application.xml lib/modules-[lib|api].jar modules-ejb.jar modules-web.war
Exemple : « myjeeapp.ear »
L'application « MYJEEAPP » a été packagé dans le fichier « myjeeapp.ear » et contient les modules EJB et WEB : « mtitek-modulez-ejb.jar », « mtitek-modulez-web.war ». |+ META-INF |+ application.xml |+ lib |+ mtitek-modulez-api.jar |+ mtitek-modulez-ejb.jar |+ mtitek-modulez-web.war
Voici le contenu du fichier « application.xml » <?xml version="1.0" encoding="UTF-8"?> <application xmlns="http://java.sun.com/xml/ns/javaee" xmlns:application="http://java.sun.com/xml/ns/javaee/application_5.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_6.xsd" version="6"> <display-name>myjeeapp</display-name> <module> <ejb>mtitek-modulez-ejb.jar</ejb> </module> <module> <web> <web-uri>mtitek-modulez-web.war</web-uri> <context-root>/modulez</context-root> </web> </module> </application>
Module mtitek-modulez-api.jar
Le contenu du module mtitek-modulez-api.jar a été présenté dans la page : JBoss 7 - Déployer un module (API, lib) dans JBoss.
Module mtitek-modulez-ejb.jar
Le contenu du module mtitek-modulez-ejb.jar a été présenté dans la page : JBoss 7 - Déployer un module EJB standalone dans un fichier « .jar ».
|+ ca |+ mtitek |+ session |+ beans |+ stateless |+ ValueHolderManagerBean.class (com.mtitek.session.beans.stateless) |+ META-INF |+ MANIFEST.MF |+ ejb-jar.xml
Note : Pour le besoin de cet exemple, on n'a pas besoin de fournir le fichier de configuration jboss-deployment-structure.xml.
Module mtitek-modulez-web.war
Le contenu du module mtitek-modulez-web.warr a été présenté dans la page : JBoss 7 - Déployer un module WEB standalone dans un fichier « .war ».
|+ META-INF |+ MANIFEST.MF |+ WEB-INF |+ web.xml |+ testJndi-ear.jsp
Note : Pour le besoin de cet exemple, on n'a pas besoin de fournir les fichiers de configuration jboss-web.xml et jboss-deployment-structure.xml.

Voici le contenu des fichiers web.xml :
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0"> <display-name>mtitek-modulez-war</display-name> <ejb-local-ref> <ejb-ref-name>ejb/ValueHolderManagerBeanLocal</ejb-ref-name> <ejb-ref-type>Session</ejb-ref-type> <local>com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerLocal</local> <ejb-link>mtitek-modulez-ejb.jar#ValueHolderManagerBean</ejb-link> </ejb-local-ref> <ejb-ref> <ejb-ref-name>ejb/ValueHolderManagerBeanRemote</ejb-ref-name> <ejb-ref-type>Session</ejb-ref-type> <remote>com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerRemote</remote> <ejb-link>mtitek-modulez-ejb.jar#ValueHolderManagerBean</ejb-link> </ejb-ref> </web-app>
Notes :
- <ejb-link>
  La valeur de cet élément est composée du nom du jar EJB (chemin d'accès) et du bean séparés par le caractère "#".
  Le chemin d'accès au jar EJB est relatif à l'application Web (fichier WAR) qui fait référence à l'EJB.
Voici le contenu du fichier testJndi-ear.jsp :
<%@ page import="com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerLocal" %> <%@ page import="com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerRemote" %> <%@ page import="com.mtitek.utils.ValueHolder" %> <%@ page import="java.util.Properties" %> <%@ page import="javax.naming.Context" %> <%@ page import="javax.naming.InitialContext" %> <%@ page import="javax.naming.NamingException" %> <html> <head> <title>test JNDI</title> </head> <body> <h1>test JNDI</h1>  <% Properties properties = new Properties(); properties.put(Context.INITIAL_CONTEXT_FACTORY, "org.jboss.as.naming.InitialContextFactory"); properties.put(Context.URL_PKG_PREFIXES, "org.jboss.ejb.client.naming"); properties.put(Context.PROVIDER_URL, "jnp://localhost:1099"); Context initialContext = new InitialContext(properties); ValueHolder<Integer> valueHolder; %>  <% ValueHolderManagerLocal valueHolderManagerLocal = (ValueHolderManagerLocal) initialContext.lookup("java:comp/env/ejb/ValueHolderManagerBeanLocal"); valueHolder = new ValueHolder<Integer>(50); %> ValueHolder ( <%= valueHolder.toString() %> ) = <%= valueHolder.getValue() %><br /> <%= valueHolderManagerLocal.setValueHolderInteger(valueHolder) %><br /> <%= valueHolder.getValue() %><br /> <br /><br />  <% ValueHolderManagerRemote valueHolderManagerRemote = (ValueHolderManagerRemote) initialContext.lookup("java:comp/env/ejb/ValueHolderManagerBeanRemote"); valueHolder = new ValueHolder<Integer>(50); %> ValueHolder ( <%= valueHolder.toString() %> ) = <%= valueHolder.getValue() %><br /> <%= valueHolderManagerRemote.setValueHolderInteger(valueHolder) %><br /> <%= valueHolder.getValue() %><br /> </body> </html>
Le déploiement du fichier « myjeeapp.ear » dans JBoss donne la sortie suivante :
12:10:17,206 INFO [org.jboss.as.server.deployment] (MSC service thread 1-11) JBAS015876: Starting deployment of "myjeeapp.ear" 12:10:17,306 INFO [org.jboss.as.server.deployment] (MSC service thread 1-10) JBAS015876: Starting deployment of "mtitek-modulez-ejb.jar" 12:10:17,306 INFO [org.jboss.as.server.deployment] (MSC service thread 1-8) JBAS015876: Starting deployment of "mtitek-modulez-web.war" 12:10:17,484 INFO [org.jboss.as.ejb3.deployment.processors.EjbJndiBindingsDeploymentUnitProcessor] (MSC service thread 1-5) JNDI bindings for session bean named ValueHolderManagerBean in deployment unit subdeployment "mtitek-modulez-ejb.jar" of deployment "myjeeapp.ear" are as follows: java:global/myjeeapp/mtitek-modulez-ejb/ValueHolderManagerBean!com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerRemote java:app/mtitek-modulez-ejb/ValueHolderManagerBean!com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerRemote java:module/ValueHolderManagerBean!com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerRemote java:jboss/exported/myjeeapp/mtitek-modulez-ejb/ValueHolderManagerBean!com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerRemote java:global/myjeeapp/mtitek-modulez-ejb/ValueHolderManagerBean!com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerLocal java:app/mtitek-modulez-ejb/ValueHolderManagerBean!com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerLocal java:module/ValueHolderManagerBean!com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerLocal 12:10:17,788 INFO [org.jboss.web] (MSC service thread 1-14) JBAS018210: Registering web context: /modulez 12:10:17,790 INFO [org.jboss.as] (MSC service thread 1-14) JBAS015951: Admin console listening on http://127.0.0.1:9990 12:10:17,791 INFO [org.jboss.as] (MSC service thread 1-14) JBAS015874: JBoss AS 7.1.1.Final "Brontes" started in 3961ms - Started 278 of 363 services (84 services are passive or on-demand) 12:10:17,847 INFO [org.jboss.as.server] (DeploymentScanner-threads - 2) JBAS018559: Deployed "myjeeapp.ear"
Voici le nom à utiliser pour faire un lookup Remote sur la Stateless ValueHolderManagerBean du module EJB mtitek-modulez-ejb.jar :
ejb:myjeeapp/mtitek-modulez-ejb/ValueHolderManagerBean!com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerRemote
Voici l'URL à utiliser pour accéder à la page testJndi-ear.jsp du module web mtitek-modulez-web.war :
http://localhost:8080/modulez/testJndi-ear.jsp