JEE (EJB3)Configuración Ambiente de

Desarrollo

2

Resumen

1. Instalar JDK 1.5 (jdk-1_5_0_17-windows-i586-p.exe) 2. Instalar Servidor de aplicaciones Jboss (jboss-4.2.2.GA-

UADE-09.zip)3. 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

4

Configuración de Jboss en Eclipse

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

2. Iniciar el Jboss desde el EclipseObjetivo: Iniciar el JBoss

5

1. Configurar JBoss en Eclipse

1. File -> New -> Other -> Server2. Seleccionar Server y presionar Next3. Seleccionar Carpeta “Jboss, a division of..” -> Jboss AS 4.2

y presionar Next4. 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_17Configuration: defaultPresionar Next

5. Pantalla: “Create a new Jboss Server”name: Nombre descriptivo de la instancia de Jboss (Ej: “JBoss 4.2 Server”)

6

1. Iniciar JBoss desde Eclipse

• Windows -> Show View -> Other -> Server -> Jboss Server View

• Seleccionar Run o Debug

JEE (EJB3)Creando un Proyecto EJB3

8

Nuevo Proyecto EJB3

1. File -> New -> Other -> EJB -> EJB Project -> Next2. Ingresar nombre descriptivo del Proyecto3. Seleccionar el Servidor de Aplicaciones (Ej: JBoss)4. Activar la opción de “Ear Membership, Add project to an

EAR”. Dejar la opción de EAR Project Name como default5. Clickear next. Activar “Create an EJB JAR module..” y

“Generate Deployment descriptor”6. 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

10

Creando Session Beans

1. Creando Session Beans Stateless con Eclipse2. Creando Session Beans Stateful con Eclipse

11

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

12

1. Creando un Session Beans Stateless

Este proceso hace que el IDE cree:1. Una clase AdministradorProductosBean. Contiene una

anotación “@Stateless”. Implementa la interface AdministradorProductos

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

13

1. Creando un Session Beans Stateless

• Fuente del Bean

• Fuente de la interface

14

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:

15

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

16

2. Creando un Session Beans Stateful

Este proceso hace que el IDE cree:1. Una clase AdministradorProductosBean. Contiene una

anotación “@Stateful”. Implementa la interface AdministradorProductos

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

18

Contenido

1. Empaquetando EJBs2. Empaquetando aplicación JEE3. Desplegando aplicación JEE

19

1. Empaquetando EJBs

• Un Enterprise Bean es un componente JEE que contiene:

1. Las clases (.class) de los Beans que implementan la lógica del negocio y métodos del ciclo de vida (callbacks)

2. Las interfaces de negocio (.class) implementadas por los Beans.

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

20

1. Empaquetando EJBs con Eclipse

Para empaquetar un EJB se deben realizar los siquientes pasos:1. Botón derecho sobre el proyecto EJB.2. Export, EJB Jar File3. En “Destination” especificar el directorio EarContent del

proyecto AdministradorProductosEAR4. Esto dejará listo los session beans para ser incluidos en el

futuro EAR5. Se crea el archivo EJB JAR correspondiente

(Ej:AdministradorProductosEJB.jar)

21

2. Empaquetando una aplicación JEE

• Una aplicación JEE contiene:1. Uno o varios EJB JAR.2. 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

22

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)

23

2. Empaquetando una aplicación JEE

• Pasos para empaquetar la aplicación JEE:1. Botón derecho sobre el proyecto xxxEAR -> Export -> Ear File2. En destination especificar donde exportar el archivo EAR

(directorio Deploy del Jboss/Server)

24

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

25

Despliegue de una aplicación JEE (Deploy) con Eclipse

• Para realizar el despliegue (deploy) de una aplicación JEE se debe realizar:

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

2. Copiar el archivo EAR generado en JBOSS/server/default/deploy

3. Opcionalmente se puede desde el eclipse clickear botón derecho sobre el archivo EAR e indicar “Deploy to Server”

4. En este momento, la aplicación JEE puede ser utilizada por cualquier cliente.

JEE (1.5 - EJB3) Creando cliente que consumen

aplicaciones JEE

27

Contenido

1. Agregando librerías2. Agregando interfaces remotas3. Invocando métodos de aplicaciones JEE desde el cliente

28

1. Agregando Librerías

• Un cliente que necesite consumir aplicaciones JEE servidoras debe tener referencia a las siguientes librerías:1. jbossall-client.jar2. Jboss-aop-jdk50-client.jar3. Jboss-aspect-jdk50-client.jarEstas 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

29

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

30

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

31

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.