JBoss - Déployer un module WEB standalone dans un fichier « .war »

JBoss | Déployer un module WEB standalone dans un fichier « .war »

Un module web peut être déployé dans un fichier « .war ».

Voici le contenu possible du fichier « .war » :
META-INF/MANIFEST.MF WEB-INF/classes/[packages]/[files].class WEB-INF/lib/[files].jar WEB-INF/web.xml WEB-INF/jboss-web.xml WEB-INF/jboss-deployment-structure.xml
Exemple : « mtitek-modulez-web.war »
|+ META-INF |+ MANIFEST.MF |+ WEB-INF |+ web.xml |+ jboss-web.xml |+ jboss-deployment-structure.xml |+ testJndi-ejb.jsp
Voici le contenu du fichier « 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-ref> <ejb-ref-name>ejb/ValueHolderManagerBean</ejb-ref-name> <ejb-ref-type>Session</ejb-ref-type> <remote>com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerRemote</remote> </ejb-ref> </web-app>
Notes :
- <ejb-ref-name>
  Cet élément contient le nom d'une référence EJB.
  Le nom de la référence EJB doit être unique au sein de l'application Web.
  Il est recommandé que le nom de la référence EJB soit préfixé par "ejb/".
  La référence EJB correspondra à une entrée dans l'environnement de l'application Web et sera relative au contexte "java:comp/env".
  
  Exemple, pour faire un lookup de la référence EJB ("ejb/ValueHolderManagerBean") :
  context.lookup("java:comp/env/ejb/ValueHolderManagerBean")
Voici le contenu du fichier « jboss-web.xml » :
<jboss-web> <context-root>/modulez</context-root> <ejb-ref> <ejb-ref-name>ejb/ValueHolderManagerBean</ejb-ref-name> <jndi-name>ejb:/mtitek-modulez-ejb/ValueHolderManagerBean!com.mtitek.session.beans.stateless.interfaces.ValueHolderManagerRemote </jndi-name> </ejb-ref> </jboss-web>
Ce fichier de configuration est utile quand le "war" est déployé seule à l'extérieur du "ear" et permet, entre autres, de spécifier un contexte root pour le module web, en plus de donner des noms aux références JNDI des beans des modules EJB.
Voici le contenu du fichier « jboss-deployment-structure.xml » :
<jboss-deployment-structure> <deployment> <dependencies> <module name="com.mtitek" /> </dependencies> </deployment> </jboss-deployment-structure>
Ce fichier de configuration permet de préciser les dépendances du jar EJB avec les modules déployés dans JBoss.
Dans cet exemple, le module EJB dépend du module "mtitek-modulez-api.jar".
Voici le contenu des fichiers testJndi-ejb.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; %>  <% ValueHolderManagerRemote valueHolderManagerRemote = (ValueHolderManagerRemote) initialContext.lookup("java:comp/env/ejb/ValueHolderManagerBean"); 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 « mtitek-modulez-web.war » dans JBoss donne la sortie suivante :
20:07:06,094 INFO [org.jboss.as.server.deployment] (MSC service thread 1-5) JBAS015876: Starting deployment of "mtitek-modulez-web.war" 20:07:06,252 WARN [org.jboss.as.dependency.private] (MSC service thread 1-5) JBAS018567: Deployment "deployment.mtitek-modulez-web.war" is using a private module ("com.mtitek:main") which may be changed or removed in future versions without notice. 20:07:06,794 INFO [org.jboss.web] (MSC service thread 1-8) JBAS018210: Registering web context: /modulez 20:07:06,839 INFO [org.jboss.as.server] (DeploymentScanner-threads - 1) JBAS018559: Deployed "mtitek-modulez-web.war"
Voici l'URL à utiliser pour accéder à la page testJndi-ejb.jsp du module web mtitek-modulez-web.war :
http://localhost:8080/modulez/testJndi-ejb.jsp