DESARROLLADO POR:

Roberto Canales Mora

Creador y propietario de AdictosAlTrabajo.com, Director General de Autentia S.L., Ingeniero Técnico de Telecomunicaciones y Executive MBA por el Instituto de Empresa 2007. Twitter: @rcanalesmora

Autor del Libro: Informática profesional, las reglas no escritas para triunfar en la empresa

Puedes consultar mi CV y alguna de mis primeras aplicaciones (de los 90) aquí

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

/*
 * iFacturasHome.java
 *
 * Created on 20 de septiembre de 2003, 9:41
 */

package ejbfacturas;

/**
 *
 * @author  Roberto Canales
 */

import java.rmi.*;
import javax.ejb.*;
import java.io.*;

/**
 * Interfaz Home para definir los metodos de creación de nuestro EJB
 *
 */
public interface iFacturasHome extends EJBHome
{
    public iFacturas create() throws CreateException, RemoteException;
}


    

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

/*
 * iFacturasContrato.java
 *
 * Created on 20 de septiembre de 2003, 10:11
 */

package ejbfacturas;

import java.rmi.*;
import javax.ejb.*;
import java.util.*;
import facturascomun.*;

/**
 *
 * @author  Administrator
 */
public interface iFacturasContrato {

   /**
    * Función que retorna el numero de facturas en la base de datos
    */
    public int recuperaNumeroFacturas() throws RemoteException;
    public Vector recuperaIdFacturas() throws RemoteException;
    public Factura recuperaFacturaPorId(int pId) throws RemoteException;
}

    

Ahora escribimos el Remove

/*
 * ifacturas.java
 *
 * Created on 20 de septiembre de 2003, 9:40
 */

package ejbfacturas;

/**
 *
 * Interfaz remoto a nuestro EJB de Facturas
 *
 * @author  Roberto Canales
 */
import java.rmi.*;
import javax.ejb.*;
import facturascomun.*;
import java.util.*;

public interface iFacturas extends EJBObject, iFacturasContrato
{
    // todos los metodos estan definidos en iFacturasContrato
}


    

Y por último el código de nuestro Bean

/*
 * iFacturasBean.java
 *
 * Created on 20 de septiembre de 2003, 9:41
 */

package ejbfacturas;

/**
 *
 * @author Roberto Canales
 */

import java.rmi.*;
import javax.ejb.*;
import java.util.*;

import facturascomun.*;


public class iFacturasBean extends Object implements SessionBean, iFacturasContrato
{

    public void ejbCreate() throws CreateException {
    }

    public void ejbActivate() {
    }

    public void ejbPassivate() {
    }

    public void ejbRemove() {
    }

    public void setSessionContext(SessionContext context) {
    }

    /**
     * Retorna el numero de facturas en base de datos
     */
    public int recuperaNumeroFacturas()
    {
        // Retornamos un valor por defecto
        return 1;
    }

    /**
    * Recupera las lista de facturas de base de datos
    */
    public Vector recuperaIdFacturas()
    {
        Vector vIdFacturas = new Vector();
        vIdFacturas.addElement(new Integer(0));
        return vIdFacturas;
    }

    /**
     * Recupera una factura concreta
     */
    public Factura recuperaFacturaPorId(int pId)
    {
        return new Factura(0,"AdictosAlTrabajo","Desarrollo creativo","54332211s", "Calle Desconocida", "20/10/2203", 1234.12);
    }
}
    

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...

/*
 * Factura.java
 *
 * Created on 20 de septiembre de 2003, 9:50
 */

package facturascomun;

import java.io.*;

/**
 * La clase Factura es la clase de transito que nos permite manejar facturas
 * de un modo sencillo en nuestra aplicación
 * @author  Administrator
 */
public class Factura implements Serializable
{
    int iId;
    String sTitular;
    String sConcepto;
    String sCif;
    String sDireccion;
    String sFecha;
    double dCandidad;


    /** Constructor por defecto */
    public Factura() {

    }

    /**
     * Constructor para inicializar valores básicos
     */
    public Factura(int pId, String pTitular, String pConcepto, String pCif, String pDireccion, String pFecha, double pCantidad)
    {
        iId         = pId;
        sTitular    = pTitular;
        sConcepto   = pConcepto;
        sCif        = pCif;
        sDireccion  = pDireccion;
        sFecha      = pFecha;
        dCandidad   = pCantidad;
    }
}    

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.

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 un repositorio 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

Web.xml

ejb-jar.xml

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>

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.

/*
 * pruebaEjbFacturas.java
 *
 * Created on 20 de septiembre de 2003, 17:25
 */
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  Administrator
 */
public class pruebaEjbFacturas {

    /** Creates a new instance of pruebaEjbFacturas */
    public pruebaEjbFacturas() {
    }


    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);
    }

    /**
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        pruebaEjbFacturas app = new pruebaEjbFacturas();
        app.ejecuta();
    }

    void ejecuta()
    {
        Context contexto = null;
        iFacturasHome miHome = null;


        try
        {
            contexto = getInitialContext();
            Object objetoGenerico = contexto.lookup("enlaceejb");

            depura("La clase original es " + objetoGenerico.getClass().getName());

            miHome = (iFacturasHome)PortableRemoteObject.narrow(objetoGenerico,iFacturasHome.class);

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

        }
    }

    void depura(String sCadena)
    {
        System.out.println("Depuracion: " + sCadena);
    }
}

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 ..

Esta obra está licenciada bajo licencia Creative Commons de Reconocimiento-No comercial-Sin obras derivadas 2.5