JEE (EJB3) Configuración Ambiente de Desarrollo

Resumen Instalar JDK 1.5 (jdk-1_5_0_17-windows-i586-p.exe) Instalar Servidor de aplicaciones Jboss (jboss-4.2.2.GA-UADE-09.zip) Instalar IDE (eclipse3.3.2-UADE-09.zip) Para los puntos 1, 2 y 3 seguir los pasos que indica el documento: “Instrucciones_Instalacion.pdf”

JEE (EJB3) Iniciando Servidor de aplicaciones desde Eclipse

Configuración de Jboss en Eclipse Configurar Jboss en el Eclipse. Objetivo: El objetivo de esta pantalla es indicar donde está instalado el Jboss, jre que va a utilizar y la configuración del mismo. Iniciar el Jboss desde el Eclipse Objetivo: Iniciar el JBoss

1. Configurar JBoss en Eclipse File -> New -> Other -> Server Seleccionar Server y presionar Next Seleccionar Carpeta “Jboss, a division of..” -> Jboss AS 4.2 y presionar Next Pantalla “Create a new JBoss Server Runtime” Name: Nombre del Runtime (Ej: JBoss 4.2 Runtime) Home Directory: Ingresar la ruta al directorio raíz donde se encuentra el JBoss (Ej: c:\jboss-4.2.2.GA) JRE: seleccionar jre1.5.0_17 Configuration: default Presionar Next Pantalla: “Create a new Jboss Server” name: Nombre descriptivo de la instancia de Jboss (Ej: “JBoss 4.2 Server”)

1. Iniciar JBoss desde Eclipse Windows -> Show View -> Other -> Server -> Jboss Server View Seleccionar Run o Debug

JEE (EJB3) Creando un Proyecto EJB3

Nuevo Proyecto EJB3 File -> New -> Other -> EJB -> EJB Project -> Next Ingresar nombre descriptivo del Proyecto Seleccionar el Servidor de Aplicaciones (Ej: JBoss) Activar la opción de “Ear Membership, Add project to an EAR”. Dejar la opción de EAR Project Name como default Clickear next. Activar “Create an EJB JAR module..” y “Generate Deployment descriptor” Esto generará tres proyectos de eclipse: Uno para el EJB, otro para el EAR y uno para cliente que no vamos a utilizar NOTA: Si el proyecto recién creado no compila, verificar el compliance del compilador. Este debe estar en 5.0

JEE (EJB3) Creando Session Beans

Creando Session Beans Creando Session Beans Stateless con Eclipse Creando Session Beans Stateful con Eclipse

1. Creando un Session Beans Stateless Para crear un Session Bean Stateless: Botón derecho en el proyecto EJB New -> Other ->EJB 3.0 -> Session Bean -> Next En la pantalla “Create a new EJB3 Session Bean” ingrear: Bean Name: nombre del session bean (Ej: AdministradorProductos) Bean package: por ejemplo “ar.edu.uade.ingsoft.ejemploejb” Session Bean Type: Seleccionar Stateless Presionar Finish

1. Creando un Session Beans Stateless Este proceso hace que el IDE cree: Una clase AdministradorProductosBean. Contiene una anotación “@Stateless”. Implementa la interface AdministradorProductos Una interface AdministradorProductos. Contiene una anotación @Remote. NOTA: Estas clases e interfaces pueden ser creadas a mano sin necesidad de utilizar el wizard que provee el IDE.

1. Creando un Session Beans Stateless Fuente del Bean Fuente de la interface

Agregando métodos de negocio Un método de negocio se define e implementa como cualquier método en lenguaje JAVA. El método de negocio debe estar definido en la interface del SessionBean y debe estar implementado en el SessionBean. El método de negocio debe tener una visibilidad pública. Ejemplo:

2. Creando un Session Beans Stateful Para crear un Session Bean Stateful: Botón derecho en paquete donde se quiere crear el Session Bean dentro del proyecto New -> Other ->EJB 3.0 -> Session Bean -> Next En la pantalla “Create a new EJB3 Session Bean” ingrear: Bean Name: nombre del session bean (Ej: AdministradorProductos) Session Bean Type: Seleccionar Stateful Presionar Finish

2. Creando un Session Beans Stateful Este proceso hace que el IDE cree: Una clase AdministradorProductosBean. Contiene una anotación “@Stateful”. Implementa la interface AdministradorProductos Una interface AdministradorProductos. Contiene una anotación @Remote. NOTA: Estas clases e interfaces pueden ser creadas a mano sin necesidad de utilizar el wizard que provee el IDE.

JEE (EJB3) Empaquetando y Desplegando una aplicación JEE - Packaging and Deployment -

Contenido Empaquetando EJBs Empaquetando aplicación JEE Desplegando aplicación JEE

1. Empaquetando EJBs Un Enterprise Bean es un componente JEE que contiene: Las clases (.class) de los Beans que implementan la lógica del negocio y métodos del ciclo de vida (callbacks) Las interfaces de negocio (.class) implementadas por los Beans. Otras clases (.class) que necesitan los Beans como ser clases que definen excepciones o clases utilitarias. Este contenido debe estar en un archivo EJB JAR.

1. Empaquetando EJBs con Eclipse Para empaquetar un EJB se deben realizar los siquientes pasos: Botón derecho sobre el proyecto EJB. Export, EJB Jar File En “Destination” especificar el directorio EarContent del proyecto AdministradorProductosEAR Esto dejará listo los session beans para ser incluidos en el futuro EAR Se crea el archivo EJB JAR correspondiente (Ej:AdministradorProductosEJB.jar)

2. Empaquetando una aplicación JEE Una aplicación JEE contiene: Uno o varios EJB JAR. Un archivo descriptor en xml que indica los módulos EJB que contiene la aplicación (entre otros). Este archivo descriptor se llama: application.xml La aplicación JEE se debe empaquetar en un archivo EAR

2. Empaquetando una aplicación JEE Pasos para crear el descriptor de la aplicación: En la carpeta EarContent del proyecto xxxEAR crear el directorio “META-INF”. (Botón derecho sobre EarContent, New Folder) Botón derecho sobre la carpeta META-INF -> New -> Other -> Jboss Tools -> EAR 1.4 Deployment descriptor -> Next -> Finish Esto crea el application.xml. Se debe ingresar en el TAG <ejb> los módulos EJB que contiene la aplicación (Ej: AdministradorProductosEJB.jar)

2. Empaquetando una aplicación JEE Pasos para empaquetar la aplicación JEE: Botón derecho sobre el proyecto xxxEAR -> Export -> Ear File En destination especificar donde exportar el archivo EAR (directorio Deploy del Jboss/Server)

Empaquetado sin Eclipse El empaquetado y creación de archivos .jar y .ear puede realizarse mediante el comando jar que provee el jdk. Asimismo, puede crearse a mando tareas del ANT para que realice esta labor

Despliegue de una aplicación JEE (Deploy) con Eclipse Para realizar el despliegue (deploy) de una aplicación JEE se debe realizar: Iniciar el Servidor de aplicaciones (JBoss). Si necesita ayuda con esto, puede ver el documento: “01 JEE EJB3 - Iniciando Servidor de Aplicaciones desde Eclipse.ppt” Copiar el archivo EAR generado en JBOSS/server/default/deploy Opcionalmente se puede desde el eclipse clickear botón derecho sobre el archivo EAR e indicar “Deploy to Server” En este momento, la aplicación JEE puede ser utilizada por cualquier cliente.

JEE (1.5 - EJB3) Creando cliente que consumen aplicaciones JEE

Contenido Agregando librerías Agregando interfaces remotas Invocando métodos de aplicaciones JEE desde el cliente

1. Agregando Librerías Para agregar los JARs: Un cliente que necesite consumir aplicaciones JEE servidoras debe tener referencia a las siguientes librerías: jbossall-client.jar Jboss-aop-jdk50-client.jar Jboss-aspect-jdk50-client.jar Estas librerías las provee Jboss. Están ubicadas en el directorio “client” dentro del directorio raíz del Jboss. (Ej: c:\jboss-4.0.5.GA\client) 4. Jboss EJB Libraries (paquete que contiene varios JARs) Para agregar los JARs: Botón derecho sobre el proyecto cliente -> Properties -> Java Build Path -> Solapa Libraries Presionar Add External JARs… Seleccionar los archivos .jar a agregar Para agregar la librería Jboss EJB Libraries: En la misma solapa Libraries, presionar “Add Library…” Seleccionar “Jboss EJB Libraries” -> Next Seleccionar el Servidor de aplicaciones -> Finish

2. Agregando interfaces remotas El Cliente debe contener la definición de las interfaces remotas (Ej: AdministradorProductos). Estas se pueden copiar del servidor al cliente. NOTA: Otra alternativa es que el proyecto cliente referencie al proyecto Servidor. Para hacer esto se deben seguir los siguientes pasos: Boton derecho sobre el proyecto cliente -> properties Java Build Path -> Solapa Projects Presionar “Add…” Seleccionar el proyecto Servidor -> OK

3. Invocando método de negocios desde un cliente Para poder invocar un método de negocio de un bean dentro de una aplicación JEE se debe proporcionar: URL de ubicación del Servidor de Aplicaciones (Ej: jnp://127.0.0.1:1099) Nombre con el que está publicado el Bean. Este nombre se debe formar de la siguiente manera: NombreEAR/NombreBean/remote (Si la interface es remota) NombreEAR/NombreBean/local (Si la interface es local) Ej: AdministradorProductosApp/AdministradorProductosBean/remote

3. Invocando método de negocios desde un cliente Esta información sobre url y nombre del Bean deben proporcionarse de la siguiente manera: Se realiza el lookup y se obtiene una “referencia” del Bean. (sin importar si el Bean es Stateless o Statefull) La invocación de métodos se realiza de la manera habitual.