1. Posicionarse en la vista Services y seleccionar el ítem Servers. En el menú contextual del Mouse seleccionar la opción Add Server

Transcripción

1 Requisitos Versión 1.5 (o superior) de la JDK de Java NetBeans 6 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). Configuración del servidor JBoss Configuración del servidor de aplicaciones JBoss en NetBeans: 1. Posicionarse en la vista Services y seleccionar el ítem Servers. En el menú contextual del Mouse seleccionar la opción Add Server 2. En la lista de servidores seleccionar la opción correspondiente a JBoss

2 3. Especificar la ruta de instalación del servidor JBoss

3 4. Por omisión, la configuración del servidor utilizará el dominio default que será accedido por el puerto No es necesario cambiar esta configuración. Finalizar el asistente. Una vez finalizada la configuración del servidor podrá verse una nueva instancia de JBoss Aplication Server en la vista Services: 5. Posicionarse sobre el servidor recién creado y seleccionar del menú contextual del mouse la opción Start. Esto iniciará el servidor de aplicaciones.

4 Ejercicio de EJB Message-Driven Bean Tomaremos como ejemplo el escenario donde una aplicación java cliente requiere interactuar con otra aplicación java, que se ejecuta en un Application Server, para enviarle un mensaje el cual es resuelto por un servicio que realiza un procesamiento muy pesado. Esta aplicación servidor está construida por dos EJB, un SessionBean y un Message-Driven Bean, uno recibe un mensaje con la información para realizar el procesamiento y el otro se simula el procesamiento. Se definirán en NetBeans dos proyectos: Proyecto EJB Module, para la aplicación que ejecuta en el servidor Proyecto Enterprise Application Client, para la aplicación cliente 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 Enterprise y de la lista de proyectos la opción EJB Module.

5 2. Ingresar ProcesamientoEJB como nombre de Proyecto, especificar la ubicación del directorio de trabajo, y el servidor de aplicaciones JBoss configurado en la primera parte de este documento.

6 3. 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: Carpeta Enterprise Beans: muestra los SessionBeans y Message Driven Beans definidos Carpeta Configuration Files: contiene los archivos de configuración de la aplicación que se construye, tales como: jboss.xml, ejb.xml, persistente.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 SessionBean 1. En la carpeta Source Packages crear un package con el nombre sample.ort.ejb, crear un componente Session Bean con el nombre ProcesamientoSessionBean, especificando que sea de tipo Stateless y marcar la opción para crear su interfaz Local:

7 2. Agregar a la clase ProcesamientoSessionBean el método que realizara el procesamiento pesado. Para ello seleccionar desde el menú contextual del mouse, estando en el cuerpo de la clase, la opción EJB Methods _ Add Business Method. Especificar el nombre del método y sus parámetros:

8 Al confirmar se puede verificar en el código que el nuevo método fue agregado a la clase ProcesamientoSessionBean y a su interfaz local. 3. Completar el método procesar() en la clase ProcesamientoSessionBean para que simule el proceso pesado : Message-Driven Bean 1. En el package sample.ort.ejb creado anteriormente, crear un componente Message-Driven Bean con el nombre ProcesamientoMDB, especificando el destino del mensaje como Queue y de nombre mdbqueue:

9 En este momento la estructura del proyecto es la siguiente: Al confirmar, se puede verificar en el código de la clase del MDB la Queue donde subscribirá el mismo: NetBeans por defecto crea un MDB para consumir de una cola. La configuración del MDB mediante la debe modificarse para especificarle de que cola de mensajes va a consumir

10 los mensajes. En JBoss, es necesario agregar la propiedad destination, y especificarle el nombre en JNDI donde ubicar la cola. 2. En el código generado agregar una nueva propiedad de nombre destination y de valor queue/ procesamiento: 3. Para que el componente ProcesamientoMDB pueda delegar en el componente ProcesamientoSessionBean el procesamiento del mensaje, es necesario crear una dependencia entre ambos. Estando en el cuerpo de la clase ProcesamientoMDB seleccionar desde el menú contextual del mouse la opción Enterprise Resources _ call Enterprise Bean. Seleccionar el componente ProcesamientoSessionBean. Al confirmar, se puede verificar en el código de la clase el mecanismo de invocación de un componente EJB:

11 4. Implementar el método onmessage() que se invocara cada vez que se publique un mensaje en la cola queue/procesamiento. public void onmessage(message message) { try { TextMessage msg = (TextMessage) message; procesamientosessionbean.procesar(msg.gettext()); } catch (JMSException ex) { Logger.getLogger(ProcesamientoMDBBean.class.getName()).log(Level.SEVERE, null, ex); } } Build y deploy del proyecto en JBoss 1. Posicionarse en la raíz del proyecto (ProcesamientoEJB) y seleccionar del menú contextual del mouse a 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. Desde la raíz del proyecto (ProcesamientoEJB) seleccionar del menú contextual del mouse la opción Undeploy and Deploy. En la consola de NetBeans podrá verificarse el resultado del deploy revisando dos cosas: el log del proyecto:

12 y el log del Server:

13 Creación del proyecto Enterprise Application Client 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 Enterprise y de la lista de proyectos la opción Enterprise Application Client. 2. Ingresar ApplicationClient como nombre de Proyecto, especificar la ubicación del directorio de trabajo, y el servidor de aplicaciones JBoss configurado en la primera parte de este documento. Asignar el nombre MyAppClient a la clase main del proyecto y desmarcar la opción Set Source Level to 1.4 Nota: dado que la versión 4.2.x de JBoss no es 100% compatible con la especificación JEE5, la IDE muestra por omisión la versión J2EE 1.4. De todas formas, esta versión de JBoss sí soporta la especificación EJB3, por lo tanto no hay problema en al ejecución. Completar el método main de la clase MyAppClient. Desde esta clase se publicara un mensaje en la cola queue/procesamiento de mensajes anteriormente definida: public class MyAppClient { public static void main(string[] args) { MyAppClient myac = new MyAppClient(); myac.enviarmensaje();

14 } public void enviarmensaje() { Destination queue = null; Connection connection = null; Session session = null; MessageProducer messageproducer = null; try { Context ctx = new InitialContext(); queue = (Destination) ctx.lookup("queue/procesamiento"); ConnectionFactory factory = (ConnectionFactory) ctx.lookup ("ConnectionFactory"); connection = factory.createconnection(); session = connection.createsession(false, Session.AUTO_ACKNOWLEDGE); messageproducer = session.createproducer(queue); TextMessage message = session.createtextmessage(); message.settext("mensaje enviado desde " + MyAppClient.class + "..."); } } messageproducer.send(message); messageproducer.close(); session.close(); connection.close(); } catch (JMSException ex) { ex.printstacktrace(); } catch (NamingException ex) { ex.printstacktrace(); } Build y ejecución de la aplicación cliente 1. Posicionarse en la raíz del proyecto (EjemploApplicationClient) 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 MyAppClient y seleccionar del menú contextual del mouse la opción Run File 3. Verificar el log del servidor en la consola de NetBeans: