Desarrollo de una Aplicación J2EE Usando Eclipse y Sybase EAServer 5.0

Introducción

La Plataforma Eclipse es una infraestructura abierta, diseñada para construir ambientes integrados de desarrollo (IDEs por su sigla en inglés Integrated Development Environments) que pueden ser usados para crear aplicaciones tan diversas como sitios web, programas Java™, programas C++, EJB™s, Servicios Web, etc. Sus creadores lo definen como "un IDE para todo y nada en particular". Usted puede encontrar más información sobre la plataforma Eclipse en http://www.eclipse.org.

Para crear aplicaciones usando Eclipse, usted necesita instalarle componentes llamados "plug-ins". Dichos plug-ins, usualmente desarrollados por terceros, extienden las capacidades de Eclipse y le permiten desarrollar algún tipo particular de aplicación. Por ejemplo, usted puede encontrar un plug-in para desarrollar programas C++, otro plug-in que le sirva como editor HTML, y así sucesivamente.

Sybase EAServer 5.0 incluye, dentro de las opciones de instalación, la versión 2.1.1 de la plataforma Eclipse e incluye un plug-in de Sybase para Servicios Web, el cual brinda a los desarrolladores la habilidad de administrar servicios web contenidos en EAServer. En la documentación de EAServer 5.0 se hace referencia a Eclipse y al plug-in de Servicios Web, como la herramienta de desarrollo Web Services Toolkit o WST.

En éste documento describiremos cómo crear una aplicación J2EE simple usando la plataforma Eclipse, junto con el plug-in Lomboz y el servidor de aplicaciones Sybase EAServer 5.0.

¿Cómo Desarrollar una Aplicación J2EE usando Eclipse y Sybase EAServer 5.0?

Pre-requisitos

Antes de comenzar, asumiremos que usted ha instalado y configurado adecuadamente Sybase EAServer 5.0 y la plataforma Eclipse 2.1.1.

Instalación de un Plug-In J2EE

Para poder desarrollar aplicaciones J2EE usando Eclipse, usted necesita instalarle un plug-in que le permita desarrollar éste tipo de aplicaciones. Para efectos de nuestro documento utilizaremos el plug-in Lomboz. Lomboz es un plug-in Eclipse gratuito, para desarrolladores J2EE. Usted puede encontrar más información de Lomboz en http://www.objectlearn.com/index.jsp y lo puede descargar de http://forge.objectweb.org/project/showfiles.php?group_id=97.

Para instalar el plug-in Lomboz en Eclipse, siga estos pasos:

1. Descargue y desempaquete el archivo ZIP en un directorio temporal. Una vez desempaquetado, usted encontrará dos carpetas:

• com.objectlearn.jdt.j2ee, y
• com.objectlearn.jdt.j2ee.editors

2. Copie las carpetas creadas en el paso anterior (junto con todo su contenido) a la siguiente ubicación:

• %ECLIPSE%\plugins

donde %ECLIPSE% es el directorio de instalación de la plataforma Eclipse.

3. Reinicie Eclipse.

Para verificar si el plug-in quedó debidamente instalado, seleccione la opción About Eclipse Platform del menú Help. En seguida haga click sobre el botón Plug-in Details. En la lista de plug-ins instalados usted debe ver, como mínimo, dos del proveedor ObjectLearn Group. La Figura 1 muestra la lista de Plug-ins instalados, incluyendo Lomboz.

Figura 1 - Lista de Plug-ins Instalados en Eclipse

Definición del Servidor Destino

Una vez instalado el plug-in, usted debe registrar la definición del servidor destino, en este caso EAServer 5.0. El servidor destino es aquél que contendrá los componentes J2EE, como servlets, JSPs, etc. desarrollados usando el plug-in Lomboz.

La definición de EAServer está contenida en el archivo EAServer500.server, el cual se puede descargar desde la página http://easerver.codexchange.sybase.com/lomboz/EAServer-Lomboz.htm de Sybase CodeXChange.

Para instalar la definición del servidor destino, siga estos pasos:

1. Desempaquete el archivo ZIP en un directorio temporal. Una vez desempaquetado, usted encontrará tres archivos:

• EAServer500.server,

• EAServer500.server.withpassword.txt, y

• readme.txt

2. Copie el archivo EAServer500.server a la siguiente ubicación:

%ECLIPSE%\plugins\com.objectlearn.jdt.j2ee\servers

donde %ECLIPSE% es el directorio de instalación de la plataforma Eclipse. Note que la carpeta com.objectlearn.jdt.j2ee es una de las que hacen parte del plug-in Lomboz.

Para verificar que la definición de EAServer 5.0 quedó debidamente registrada en Eclipse, seleccione la opción Preferences del menú Window de Eclipse. En seguida, haga doble click sobre Lomboz y luego click sobre Server Definitions. En la lista Server types debe aparecer una definición para Sybase EAServer 5.0.

Al seleccionar de la lista el servidor Sybase EAServer 5.0, usted puede personalizar las opciones de acuerdo a su entorno. La figura 2 muestra un ejemplo de definición para el servidor Sybase EAServer 5.0.

Figura 2 - Definición del servidor Sybase EAServer 5.0

Creación de una Aplicación J2EE

Una vez instalado el plug-in Lomboz y la definición del servidor de aplicaciones EAServer 5.0, usted puede proceder a crear una nueva aplicación J2EE. Para efectos del documento, crearemos una aplicación muy sencilla que consiste de un servlet y haremos el deploy sobre nuestro servidor de aplicaciones, Sybase EAServer 5.0.

1. Cree un nuevo proyecto.

Del menú File de Eclipse seleccione la opción New y luego la opción Project... En la ventana Select haga doble click sobre Java; de la opción Lomboz J2EE Wizards seleccione Lomboz J2EE Project y por último haga click en el botón Next:

En la ventana Project Settings especifique un nombre para el proyecto en el campo Project Name. Deje la opción Use Default seleccionada y presiones el botón Next. Para efectos de nuestro ejemplo, bautizaremos nuestro proyecto demo1:

En la ventana Java Settings seleccione la pestaña Settings y haga click en el botón Add External Jars... Ubique y agregue el archivo easj2ee.jar. Este archivo usualmente se encuentra en %JAGUAR%\java\lib, donde %JAGUAR% es el directorio de instalación de Sybase EAServer. Al agregarlo, éste debería aparecer en la ventana:

El archivo easj2ee.jar contiene el API que permite desarrollar componentes J2EE para EAServer (como por ejemplo el API para el desarrollo de un servlet).

Ahora, en la misma ventana, haga click en la pestaña Order and Export. Marque las casillas correspondientes al sistema JRE y al easj2ee.jar. Luego, haga click sobre el botón Finish:

Con esto, usted habrá completado la creación del nuevo proyecto. Una vez creado, el nuevo proyecto demo1 aparecerá en el explorador de Eclipse:

2. Agregue un nuevo módulo al proyecto.

Después de crear el proyecto, usted debe agregar un módulo. Más adelante, éste módulo quedará asociado a una Aplicación Web (Web Application) de EAServer.

Haga click derecho sobre el proyecto demo1, creado antes. Del menú desplegable seleccione New y luego la opción Other...

Luego, en la ventana Select, haga doble click sobre Java, haga click en Lomboz J2EE Wizards, seleccione la opción Lomboz J2EE Module y por último haga click en Next:

En la ventana Create J2EE Module haga click sobre el botón Add... Escriba luego el nombre del nuevo módulo y haga click en OK. Para efectos de nuestro ejemplo, bautizaremos nuestro módulo modulo1. El nuevo módulo quedará registrado:

Al agregar el módulo usted debe definir el servidor sobre el cual se hará el deploy del módulo y de sus componentes. Para eso, en la misma ventana Create J2EE Module, seleccione la pestaña Targeted Servers; de la lista de servidores seleccione Sybase EAServer 5.0, haga click en el botón Add... y por último haga click en Finish:

Al abrir la carpeta del proyecto demo1 en el explorador de Eclipse, usted verá el módulo modulo1:

3. Cree un componente J2EE.

Para efectos de nuestro ejemplo, crearemos un servlet J2EE. Haga click derecho sobre el módulo modulo1. Del menú seleccione New y luego Other...

En la ventana Select, seleccione el Lomboz Servlet Wizard y haga click en Next:

En la ventana Create a new Servlet, escriba el nombre del servlet (en éste caso HolaMundo) y marque el método o métodos para los cuales se generarán stubs (por ejemplo, el método doGet); los demás campos pueden ser dejados con sus valores predeterminados. En seguida, presiones el botón Next:

En seguida, proporcione los detalles para el deploy de éste servlet. Usando el botón Browse... seleccione el módulo al cual pertenecerá el servlet; en éste caso sólo hemos definido un módulo llamado modulo1. Éste módulo será, más adelante, asociado a una Aplicación Web (Web Application) de EAServer.

En el campo Servlet Name escriba nuevamente el nombre del servlet (HolaMundo); en el campo Mapping URL escriba el path para ubicar éste servlet, por ejemplo /HolaMundo; los demás campos pueden ser dejados con sus valores predeterminados. Para terminar, haga click en Finish:

Una vez creado el servlet, éste aparecerá en el explorador de Eclipse y en el editor se generará un código base para el componente:

4. Complete y haga el deploy del componente.

Para completar el código del servlet, usted debe reemplazar la línea //TODO Method stub generated by Lomboz con el código Java adecuado para dicho método en particular (en nuestro caso el método doGet).

Para efectos del ejemplo, usaremos un sencillo código Java que genera un contenido HTML:

response.setContentType( "text/html" ); 
java.io.PrintWriter out = response.getWriter(); 
out.println("<HTML>"); 
out.println("<HEAD><TITLE>Hola Mundo</TITLE></HEAD>"); 
out.println("<BODY>"); 
out.println("<H2>Hola Mundo</H2>"); 
out.println("<P>Servlet implementado con Eclipse</P>"); 
out.println("</BODY></HTML>"); 

Una vez se ha completado el código del método, lleve a cabo el deploy del componente, haciendo click derecho sobre el módulo y seleccionando las opciones Lomboz J2EE... y Deply Module del menú desplegable.
 

Aparecerá una ventana indicando el progreso del proceso de deploy:

Finalmente, Eclipse mostrará el tiempo tomado para montar el componente en EAServer:

5. Verifique el funcionamiento de su componente.

Usando EAServer Manager, conéctese a EAServer; haga click derecho sobre el servidor Jaguar y del menú desplegable seleccione la opción Refresh:

Haga doble click en el servidor Jaguar, luego doble click sobre la carpeta Installed Web Applications, y por último doble click en la aplicación modulo1. Usted verá el servlet que acaba de crear:

Por último, asumiendo que el puerto HTTP de su servidor EAServer es el 8180 y que éste se encuentra en la dirección IP 192.9.202.32, abra el URL http://192.9.202.32:8180/modulo1/HolaMundo con su navegador favorito. Por ejemplo: