Requisitos Versión 1.5 (o superior) de la JDK de Java NetBeans 6.5 como IDE de desarrollo JBoss 4.2.x como Application Server Variable de entorno de Windows JAVA_HOME apuntando al directorio de instalación de Java (el directorio raíz de la JDK, no el de la JRE). Curso práctico pág. 1
Ejercicio de EJB stateless SessionBeans Introducción Tomaremos como ejemplo el escenario donde una aplicación java cliente requiere interactuar con otra aplicación java que ejecuta en un Application Server, para consumir un servicio que calcula el sueldo de un empleado. Esta aplicación servidor está construida con un componente EJB SessionBean que implementa la lógica concreta del cálculo del sueldo. Se definirán en NetBeans tres proyectos: Proyecto de tipo Enterprise Application que representar a nuestra aplicación servidor Proyecto de tipo EJB Module donde construiremos el componente EJB Proyecto de tipo Java Application para la aplicación cliente Creación del proyecto Enterprise Application 1. Seleccionar del menú de NetBeans la opción para crear un nuevo proyecto. En la ventana que se muestra, seleccionar de la lista de categorías (a la izquierda) la opción Java EE y de la lista de proyectos la opción Enterprise Application. 2. Ingresar EjercicioSessionBeans como nombre de Proyecto y especificar la ubicación del directorio de trabajo (verificar que no quede marcada la opción Set as Main Project). Curso práctico pág. 2
3. Seleccionar como servidor la opción JBoss Application Server. Desmarcar todas las opciones (crearemos el módulo EJB a mano luego). Nótese que la versión de la plataforma que se reconoce para nuestro servidor es J2EE 1.4. Esto es porque el servidor JBoss 4.2.1 no es oficialmente compatible con la especificación JEE 5 (solo el EJB container lo es). Creación del proyecto EJB Module 1. Seleccionar del menú de NetBeans la opción para crear un nuevo proyecto. En la ventana que se muestra, seleccionar de la lista de categorías (a la izquierda) la opción Java EE y de la lista de proyectos la opción EJB Module. 2. Ingresar EjercicioSessionBeans-ejb como nombre de Proyecto y especificar la ubicación del directorio de trabajo (verificar que no quede marcada la opción Set as Main Project). Curso práctico pág. 3
3. Asociar a la aplicación Enterprise que creamos en el paso anterior como y seleccionar como servidor la opción JBoss Application Server. Nótese que por tratarse de un módulo EJB ahora sí se reconoce el servidor JBoss como compatible con la versión JEE 5. 4. Una vez confirmada la finalización del asistente de creación de proyectos, se podrá ver en la vista Projects la estructura del proyecto recién creado: Curso práctico pág. 4
Carpeta Enterprise Beans: muestra los componentes EJB definidos Carpeta Configuration Files: contiene los archivos de configuración de la aplicación que se construye, tales como: jboss.xml, ejb.xml, persistence.xml Carpeta Server Resources: contiene los archivos de configuración de los recursos específicos del servidor que son utilizados por la aplicación que se construye. Carpeta Source Packages: contiene el código fuente de la aplicación que se construye Carpeta Test Packages: contiene las clases utilizadas para realizar testing sobre la aplicación que se construye Carpeta Libraries: contiene las librerías referenciadas por nuestra aplicación para poder ejecutar. Carpeta Test Libraries: contiene las librerías necesarias para el test Creación del Session Bean 1. Posicionarse en la carpeta Source Packages y crear un componente Session Bean con el nombre CalculadorSueldos en el package app.negocio.ejb, especificando que sea de tipo Stateless y marcando sólo la opción para crear su interfaz Remote: Curso práctico pág. 5
2. Posicionarse en la carpeta Enterprise Beans y seleccionar el Session Bean recién creado. Desde el menú contextual del mouse seleccionar la opción Add Business Method para crear el método con el nombre pasoporpostconstruction sin parámetros: 3. Repetir el paso para crear otro método con el nombre pasoporpredestroy, también sin parámetros. 4. Repetir el paso para crear otro método con el nombre calcularsueldo que tenga por parámetros dos variables de tipo int con nombres sueldo y descuentos: 5. Abrir el Session Bean (o la clase CalculadorSueldosBean que es la que lo implementa) y anotar el método pasoporpostconstruction con @PostConstruct y el método pasoporpredestroy con @PreDestroy. Luego completar las implementaciones de los métodos: Curso práctico pág. 6
@Stateless public class CalculadorSueldosBean implements CalculadorSueldosRemote { @PostConstruct public void pasoporpostconstruction() { System.out.println("--> Paso por PostConstruction del Session Bean"); @PreDestroy public void pasoporpredestroy() { System.out.println("--> Paso por PreDestroy del Session Bean"); public int calcularsueldo(int sueldo, int descuentos) { return sueldo-descuentos; Build y deploy del proyecto en el servidor de aplicaciones 1. Posicionarse en la raíz del proyecto de nuestra enterprise application (EjercicioSessionBeans) y seleccionar del menú contextual del mouse la opción Build. Se podrá verificar en la consola de NetBeans el empaquetamiento de los componentes y su ubicación para ser distribuidos al servidor: 2. En la vista Files de NetBeans, se podrá verificar que cada proyecto tiene creada una carpeta dist que contiene los componentes de nuestra aplicación: Curso práctico pág. 7
El archivo EAR es el que contiene toda nuestra aplicación y es el que debemos instalar en el servidor para ejecutarla. 3. Verificar que el server esté iniciado. Desde la raíz del proyecto de nuestra aplicación Enterprise seleccionar del menú contextual del mouse la opción Deploy. En la consola de NetBeans podrá verificarse el resultado del deploy revisando dos cosas: el log del proyecto: y el log del Server: Curso práctico pág. 8
Creación del proyecto Java Application 1. Seleccionar del menú de NetBeans la opción para crear un nuevo proyecto. En la ventana que se muestra, seleccionar de la lista de categorías (a la izquierda) la opción Java y de la lista de proyectos la opción Java Application. 2. Ingresar Cliente como nombre de Proyecto, especificar la ubicación del directorio de trabajo, asignar el nombre app.cliente.cliente a la clase main del proyecto. 3. Posicionarse en la carpeta Libraries y agregar el JAR jbossall-client.jar que se encuentra en la ruta de instalación del servidor JBoss: <%Path_JBOSS>/client/jbossall-client.jar 4. Posicionarse en la carpeta Libraries y seleccionar del menú contextual del mouse la opción Add Project. Seleccionar la ubicación del proyecto EjercicioSessionBeans-ejb (es decir, el correspondiente a nuestro módulo EJB) y confirmar: Se puede verificar en la carpeta Libraries que se ha agregado al proyecto la distribución JAR de la aplicación que ejecuta en el server, con lo cual se pueden referenciar ahora las clases de esa aplicación. Curso práctico pág. 9
5. Abrir la clase Cliente y agregar el siguiente método que permite realizar el lookup desde la aplicación cliente de la interfaz remota del SessionBean de la aplicación servidor: private CalculadorSueldosRemote lookupcalculadorsueldosbean() { try { Properties props = new Properties(); props.put(context.initial_context_factory, "org.jnp.interfaces.namingcontextfactory"); props.put(context.provider_url, "jnp://localhost:1099"); Context c = new InitialContext(props); return (CalculadorSueldosRemote) c.lookup("ejerciciosessionbeans/calculadorsueldosbean/remote"); catch (NamingException ne) { Logger.getLogger(getClass().getName()).log(Level.SEVERE, "exception caught", ne); throw new RuntimeException(ne); Nótese que se utiliza una instancia con la interfaz Context que es la que nos permite dialogar con el servidor remoto. La implementación de esta interfaz (InitialContext) es provista en este caso por JBoss y encapsula la comunicación remota. Nótese además que el String que se utiliza en el lookup para recuperar la interfaz remota del SessionBean debe cumplir con el siguiente formato: <nombre_ear>/<nombre_bean>/<tipo_interfaz> 6. Completar el método main de la clase Cliente para hacer la invocación del SessionBean a través que se instancia utilizando el lookup del paso anterior: public static void main(string[] args) { Cliente ejemplo = new Cliente(); CalculadorSueldosRemote ejb = ejemplo.lookupcalculadorsueldosbean(); System.out.println(ejb.calcularSueldo(18, 5)); Curso práctico pág. 10
Build y ejecución de la aplicación cliente 1. Posicionarse en la raíz del proyecto Cliente y seleccionar del menú contextual del mouse la opción Build. Se podrá verificar en la consola de NetBeans el empaquetamiento de los componentes y su ubicación para ser distribuidos al servidor: 2. Posicionarse en la clase Cliente y seleccionar del menú contextual del mouse la opción Run File 3. Verificar el resultado del llamado en el log del proyecto en la consola de NetBeans Curso práctico pág. 11