Despliegue gráfico de EJBs

0
33149

Despliegue de EJBs en J2EE 1.3.1

A partir de ahora, vamos a subir un poco el nivel …. comenzando a comentar
buenas técnicas y prácticas en el desarrollo de EJBs.

Para ello, debemos crear un entorno adecuado de pruebas donde, de un modo
sencillo, podamos aplicar nuestros cambios.

El desarrollo de EJBs no es algo complicado…. aunque lo es más dificil es
probar su funcionamiento, optimización y depuración.

Vamos a crear un EJB desde cero y lo vamos a desplegar en el servidor de
aplicaciones de referencia de Sun.

Para instalar el servidor, lo único que tenemos que hacer es descargárnoslo y
establecer correctamente las variables de entorno. Para ello, podéis ver
otro de nuestros tutoriales
.

Definición de interfaces Home y Remoto

En principio vamos a crear un EJB de sesión sin estado por ser más
sencillo.

Lo primero que debemos hacer es crear los interfaces necesarios para el
desarrollo de un EJB. 

En este caso, hace falta un interfaz, llamado Home, que
establece como se deben crear e inicializar los objetos. Este interfaz debe
heredar de EJBHome

Posteriormente se define un interfaz con la definición de los métodos que
tendrá el servicio que deseamos construir. Este es el llamado interfaz Remoto y
debe heredar de EJBObject

Nuestro EJB, deberá implementar este interfaz… es decir, tener el
código de estos métodos.

En el desarrollo de EJBs, el EJB no se define con este interfaz, sino que
es en tiempo de ensamblaje y despliegue donde se realiza la validación. Esto no
nos proporciona ningura garantía de funcionamiento …. por lo que vamos a usar
otra técnica para asegurarnos que si nuestro código compila….. entonces no
dará problemas al desplegar.

Creamos un interfaz simple que heredará el interfaz remoto y que
implementará en Bean

Ahora escribimos el Remove

Y por último el código de nuestro Bean

Otra buena práctica en el desarrollo de aplicaciones consiste en utilizar
clases para agrupar los datos que deben viajar entre distintas máquinas o
instancias de servidores de aplicaciones. 

En nuestro caso, hemos creado una clase llamada Factura

Servlet de Prueba

Ahora, vamos a crear un servlet básico (aunque poco óptimo) para probar de
un modo sencillo si nuestro EJB funciona correctamente.

/*
* servletVerificadorFacturas.java
*
* Created on 20 de septiembre de 2003, 10:48
*/

import java.io.*;
import java.net.*;

import javax.servlet.*;
import javax.servlet.http.*;

import facturascomun.*;
import ejbfacturas.*;

import javax.naming.*;
import ejbfacturas.*;
import javax.rmi.*;

import java.util.*;

/**
*
* @author Roberto Canales
* @version
*/
public class servletVerificadorFacturas extends HttpServlet {

/** Initializes the servlet.
*/
public void init(ServletConfig config) throws ServletException {
super.init(config);

}

/** Destroys the servlet.
*/
public void destroy() {

}

private static InitialContext getInitialContext() throws NamingException 

Hashtable env = new Hashtable(); 
env.put(Context.INITIAL_CONTEXT_FACTORY,»com.sun.enterprise.naming.SerialInitContextFactory»);
env.put(«java.naming.factory.url.pkgs», «com.sun.enterprise.naming»);
env.put(Context.PROVIDER_URL, «iiop://127.0.0.1:1050»);

return new InitialContext(env); 
}

/** Processes requests for both HTTP <code>GET</code> and <code>POST</code> methods.
* @param request servlet request
* @param response servlet response
*/
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType(«text/html»);
PrintWriter out = response.getWriter();

out.println(«<html>»);
out.println(«<head>»);
out.println(«<title>Prueba de EJB Factura</title>»);
out.println(«</head>»);
out.println(«<body>»);

Context contexto = null;
iFacturasHome miHome = null;

try
{
contexto = getInitialContext();
Object objetoGenerico = contexto.lookup(«java:comp/env/ejb/iFacturasHome»);
miHome = (iFacturasHome)PortableRemoteObject.narrow(objetoGenerico,iFacturasHome.class);

iFacturas ejbGestorFacturas = miHome.create();
depura(out,»Número de facturas en BBDD = » + ejbGestorFacturas.recuperaNumeroFacturas());
}
catch(Exception e)
{
depura(out,»Error al gestionar Facturas\n» + e.getMessage());
e.printStackTrace();
}

out.println(«</body>»);
out.println(«</html>»);

out.close();
}

/**
*  Funcion basica de depuracion
*/
void depura(PrintWriter pOut, String sCadena)
{
pOut.println(«Depuracion: » + sCadena);
System.out.println(«Depuracion: » + sCadena);
}

protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}

protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}

}

Generador de descriptores

Para poder instalar un EJB en un servidor de aplicaciones, hay que crear
unos ficheros XML que describen que es lo que pretendemos desplegar y algunos
parámetros de configuración.

Estos ficheros deberían ser iguales para cualquier servidor de aplicaciones
anque … como siempre pasa ….. esto luego no es cierto y hay que introducir
variaciones particulares para cada servidor.

Nuestro servidor de aplicaciones trae una herramienta gráfica para ayudarnos
a hacerlo (generar los XML) y empaquetar (en ficheros comprimidos) e instalar la
aplicación dentro del servidor.

Normalmente, luego no lo haremos así sino que trabajaremos con unrepositorio de código (porque mucha gente trabaja en paralelo sobre el
mismo código) y se compilará y empaquetará con ANT
(aunque reuitilzaremos los XML que genere esta herramienta)

 Vamos a nuestro directorio y ejecutamos la utilidad deploytool

Añadimos un nuevo servidor a la lista de servidores que queremos administrar, en este caso, el servidor local

Añadimos el servidor localhost

Pinchamos el primer botón, es decir, creamos una nueva
aplicación

Le asignamos un trayecto al fichero

Seleccionamos el botón para añadir un nuevo EJB

Vemos la primera ventana de instrucciones y seguimos

Le asignamos un nombre al contenedor de nuestro EJB y pinchamos el botón de editar, para añadir las
clases necesitadas

Seleccionamos, en el sistema de ficheros, nuestos archivos (todos los .class
de nuestra aplicación)

Seleccionamos el EJB (iFacturasBean) de tipo Session sin estado.

Tambien seleccionamos las clases del interfaz Home y Remoto

Avanzamos y seleccionamos el resto de los valores por defecto

Y ya hemos terminado

Ahora añadimos un nuevo contenedor Web, una llamada Web-app, para
desplegar  nuestro servlet de
prueba

Vemos la descripción.

Asignamos el nombre y pinchamos editar

Seleccionamos el Servlet y las clases necesarias del EJB.

Seleccionamos un servlet

Elegimos la clase adecuada

Y como nuestro servlet utiliza un EJB, añadimos una referencia. Desde
nuestro servlet lo invocamos como ejb/iFacturasHome

En la Web-app (y en nuestro servlet) buscaremos un EJB llamado ejb/iFacturasHome.
Podría darse la circunstancia de que nosotros no hubieramos desarrollado el EJB
y ya estuviera desplegado en el servidor con un nombre determinado. Para evitar
problemas y tener que tocar el código (adaptando los nombres) se pueden crear
alias…. de este modo… si alguien cambia algun nombre … solo hay que
cambiar las referencia.

Esto es introducir un nivel más de indirección.

Creamos un nombre JNDI …. en este caso enlaceejb. Cualquier
aplicación podrá localizar el EJB por este alias y como vemos en la siguiente
pantalla, asociamos ejb/FacturasHome con el alias
creado.

Descriptores

Vamos a ver cada uno de los descriptores….. No lo comentamos porque para
eso esta la especificación EJB que podéis encontrar en el Web de Sun

application.xml

<?xml version=»1.0″ encoding=»UTF-8″?>

<!DOCTYPE application PUBLIC ‘-//Sun Microsystems, Inc.//DTD J2EE Application 1.3//EN’ ‘http://java.sun.com/dtd/application_1_3.dtd’>

<application>
<display-name>facturas</display-name>
<description>Application description</description>
<module>
<ejb>ejb-jar-ic.jar</ejb>
</module>
<module>
<web>
<web-uri>war-ic.war</web-uri>
<context-root>adictos</context-root>
</web>
</module>
</application>

Web.xml

<?xml version=»1.0″ encoding=»UTF-8″?>

<!DOCTYPE web-app PUBLIC ‘-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN’ ‘http://java.sun.com/dtd/web-app_2_3.dtd’>

<web-app>
<display-name>webapp</display-name>
<servlet>
<servlet-name>servletVerificadorFacturas</servlet-name>
<display-name>servletVerificadorFacturas</display-name>
<servlet-class>servletVerificadorFacturas</servlet-class>
</servlet>
<session-config>
<session-timeout>30</session-timeout>
</session-config>
<ejb-ref>
<ejb-ref-name>ejb/iFacturasHome</ejb-ref-name>
<ejb-ref-type>Session</ejb-ref-type>
<home>ejbfacturas.iFacturasHome</home>
<remote>ejbfacturas.iFacturas</remote>
<ejb-link>iFacturasBean</ejb-link>
</ejb-ref>
</web-app>

ejb-jar.xml

<?xml version=»1.0″ encoding=»UTF-8″?>

<!DOCTYPE ejb-jar PUBLIC ‘-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 2.0//EN’ ‘http://java.sun.com/dtd/ejb-jar_2_0.dtd’>

<ejb-jar>
<display-name>ejbapp</display-name>
<enterprise-beans>
<session>
<display-name>iFacturasBean</display-name>
<ejb-name>iFacturasBean</ejb-name>
<home>ejbfacturas.iFacturasHome</home>
<remote>ejbfacturas.iFacturas</remote>
<ejb-class>ejbfacturas.iFacturasBean</ejb-class>
<session-type>Stateless</session-type>
<transaction-type>Bean</transaction-type>
<security-identity>
<description></description>
<use-caller-identity></use-caller-identity>
</security-identity>
</session>
</enterprise-beans>
<assembly-descriptor>
<method-permission>
<unchecked />
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>recuperaIdFacturas</method-name>
<method-params />
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>getHandle</method-name>
<method-params />
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Home</method-intf>
<method-name>getEJBMetaData</method-name>
<method-params />
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>getPrimaryKey</method-name>
<method-params />
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>remove</method-name>
<method-params />
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>recuperaNumeroFacturas</method-name>
<method-params />
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>recuperaFacturaPorId</method-name>
<method-params>
<method-param>int</method-param>
</method-params>
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Home</method-intf>
<method-name>remove</method-name>
<method-params>
<method-param>javax.ejb.Handle</method-param>
</method-params>
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Home</method-intf>
<method-name>getHomeHandle</method-name>
<method-params />
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>isIdentical</method-name>
<method-params>
<method-param>javax.ejb.EJBObject</method-param>
</method-params>
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Home</method-intf>
<method-name>remove</method-name>
<method-params>
<method-param>java.lang.Object</method-param>
</method-params>
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Home</method-intf>
<method-name>create</method-name>
<method-params />
</method>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>getEJBHome</method-name>
<method-params />
</method>
</method-permission>
<container-transaction>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>recuperaIdFacturas</method-name>
<method-params />
</method>
<trans-attribute>Required</trans-attribute>
</container-transaction>
<container-transaction>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>recuperaFacturaPorId</method-name>
<method-params>
<method-param>int</method-param>
</method-params>
</method>
<trans-attribute>Required</trans-attribute>
</container-transaction>
<container-transaction>
<method>
<ejb-name>iFacturasBean</ejb-name>
<method-intf>Remote</method-intf>
<method-name>recuperaNumeroFacturas</method-name>
<method-params />
</method>
<trans-attribute>Required</trans-attribute>
</container-transaction>
</assembly-descriptor>
</ejb-jar>

 

Despliegue de la aplicación

Ahora, pulsamos el botón de grabar y desplegamos la aplicación. Al grabar
se recopilará toda la información y se generarán los ficheros comprimidos con
toda la información de despliegue:

  • Clases de la aplicación
  • Ficheros descriptores
  • Clases generadas para acceder de modo remoto a nuestra aplicación (proxy
    y stubs)

 

Ordenamos crear los ficheros necesarios para poder acceder a nuestro EJB
desde otros servidores de aplicaciones (Return Client Jar).

Si queremos que estos EJB puedan ser utilizados desde otras máquinas y
aplicaciones, deberemos distribuir este jar al equipo que intente hacerlo.

Asignamos un contexto a nuestra Web-app, en este caso, adictos

Al pulsar el botón finalizar, vemos que se despliega bien la aplicación

Ahora invocamos nuestra web-app y vemos como funciona correctamente

Tambien vamos a ver el descriptor generado en facturasCliente.jar

Las lineas importantes son

<remote-home-impl>ejbfacturas.iFacturasBean_RemoteHomeImpl</remote-home-impl>
<remote-impl>ejbfacturas.iFacturasBean_EJBObjectImpl</remote-impl>

<?xml version=»1.0″ encoding=»UTF-8″?>

<!DOCTYPE j2ee-ri-specific-information PUBLIC ‘-//Sun Microsystems Inc.//DTD J2EE Reference Implementation 1.3//EN’ ‘http://localhost:8000/sun-j2ee-ri_1_3.dtd’>

<j2ee-ri-specific-information>
<rolemapping />
<web>
<module-name>war-ic.war</module-name>
<context-root>adictos</context-root>
<ejb-ref>
<ejb-ref-name>ejb/iFacturasHome</ejb-ref-name>
<jndi-name>enlaceejb</jndi-name>
</ejb-ref>
</web>
<enterprise-beans>
<module-name>ejb-jar-ic.jar</module-name>
<unique-id>-1096004843</unique-id>
<ejb>
<ejb-name>iFacturasBean</ejb-name>
<jndi-name>enlaceejb</jndi-name>
<ior-security-config>
<transport-config>
<integrity>supported</integrity>
<confidentiality>supported</confidentiality>
<establish-trust-in-target>supported</establish-trust-in-target>
<establish-trust-in-client>supported</establish-trust-in-client>
</transport-config>
<as-context>
<auth-method>username_password</auth-method>
<realm>default</realm>
<required>false</required>
</as-context>
<sas-context>
<caller-propagation>supported</caller-propagation>
</sas-context>
</ior-security-config>
<gen-classes>
<remote-home-impl>ejbfacturas.iFacturasBean_RemoteHomeImpl</remote-home-impl>
<remote-impl>ejbfacturas.iFacturasBean_EJBObjectImpl</remote-impl>
</gen-classes>
</ejb>
</enterprise-beans>
</j2ee-ri-specific-information>

Prueba externa del EJB

Tambien es interesante tener un sistema sencillo de probar desde
una aplicación de un modo externo.

Vamos a crear una función main para llamar desde fuera del
servidor de aplicaciones a nuestro EJB.

Para que este código funcione, es necesario incluir en el classpath los
ficheros j2ee.jar y facturasCliente.jar

Un vez realizados todos estos pasos, estamos en marcha…..

A partir de aquí, empezaremos a complicar un poquito la
aplicación e introducir nuevas técnicas ……… hasta pronto.

Sobre
el Autor ..

Dejar respuesta

Please enter your comment!
Please enter your name here