Eclipse -- III -- El Plug-in de JBoss

Puede encontrar la versión original de este artículo en Inglés en:

http://www.devx.com/

Introducción

JBoss, el servidor de aplicaciones J2EE, open source, ha sido el favorito de la comunidad Java durante mucho tiempo, pero recientemente JBoss ha presentado una nueva herramienta, gracias a Eclipse, una herramienta que podría hacer que JBoss subiera hasta el escalón más alto de los servidores de aplicaciones Java.

Aunque siempre se ha aplaudido a JBoss por ser robusto y escalable, con soporte para seguridad, balance de carga y capacidades transaccionales, lo que no tenía era un IDE basado en GUI. Y esto había dejado el mercado en manos de sus rivales más cercanos como IBM, BEA y Borland. Aquellos que lo prefieran pueden continuar configurando JBoss desde la línea de comandos, pero gracias al proyecto Eclipse, JBoss tiene un IDE que se conecta en el marco de desarrollo de Eclipse, haciendo de este producto una opción legítima para miles de desarrolladores que prefieren un GUI.

Algunos plug-ins de Eclipse ya dan soporte para JBoss, pero el plug-in JBoss-IDE es de lejos el más fácil de instalar, actualizar y utilizar. El plug-in soporta el arranque y paro del servidor, depuración de código del lado del servidor, empaquetado y despliegue de ficheros de archivo web. También soporta XDoclet para generación de código. Pero lo mejor de todo, es que el plug-in JBoss-IDE está desarrollado y mantenido por JBoss Inc., los propios creadores del Servidor de Aplicaciones JBoss.

Instalar el Plug-in

Muchos plug-ins de Eclipse se empaquetan como ficheros ZIP que se descargan y se descomprimen directamente en el directorio de plug-ins de Eclipse. Pero JBoss-IDE utiliza la funcionalidad de control de actualizaciones interna de Eclipse que hace muy sencilla la instalación inicial e incluso más sencillas las actualizaciones posteriores.

  • Eclipse 2.x
    1. En el menú principal seleccione Help -> Software Updates -> Update Manager.
    2. En la vista Feature Updates, pulse con el botón derecho y seleccione New -> Site Bookmark.
    3. Seleccione un nombre para el Bookmark y escriba la dirección http://jboss.sourceforge.net/jbosside/updates.
    4. Expanda el bookmark que se acaba de añadir y seleccione JBoss-IDE 1.0/Eclipse 2.1.
    5. Ahora debería ver las versiones del plug-in disponibles. Seleccione la última versión.
    6. Después de unos momentos pedirá que reinicie Eclipse.
  • Eclipse 3.x
    1. En el menú principal seleccione Help -> Software Updates -> Find and Install.
    2. Seleccione Search for new features to install.
    3. Pulse sobre Add Update Site.
    4. Seleccione un nombre para el Bookmark y escriba la dirección http://jboss.sourceforge.net/jbosside/updates.
    5. Expanda el bookmark que se acaba de añadir y seleccione JBoss-IDE 1.0/Eclipse 3.0.
    6. Ahora debería ver las versiones del plug-in disponibles. Seleccione la última versión.

    7. Después de unos momentos pedirá que reinicie Eclipse.

Añadir Opciones al Menú Superior

El plug-in JBoss-IDE proporciona un conjunto de botones para arrancar, parar y terminar un servidor, así como una vista de la consola del servidor y de los ficheros de log. Estos botones sólo operan sobre un único servidor que se define como Default Server. Cómo configurar el servidor por defecto vendrá después, ahora, veamos como hacer que estos botones se vean en la barra de herramientas:

  • Eclipse 2.x
    1. Pulse con el botón derecho en cualquier lugar de la barra de herramientas
    2. Seleccione Customize Perpective.
    3. Expanda el nodo Other.
    4. Marque Default Server.
    5. Pulse sobre OK.

  • Eclipse 3.x
    1. Pulse con el botón derecho en cualquier lugar de la barra de herramientas
    2. Seleccione Customize Perpective.
    3. Seleccione la pestaña Commands.
    4. Marque Default Server en el Panel Available Command Groups.
    5. Pulse sobre OK

    Tras hacer esto aparecerán los botones en la barra de herramientas y un nuevo ítem en el menú principal:

Configurar y Lanzar el Servidor

Por supuesto que antes de poder lanzar el servidor JBoss tendrá que tenerlo instalado en tu sistema:

Instalar JBoss

Puede descargar JBOSS listo para ejecutarse. Como JBOSS viene con una sencilla base de datos embebida (Hypersonic) y un servidor Web (JBossWEB o Tomcat) puede utilizarlo sin ninguna configuración inicial. Las descargas se pueden realizar desde la página del proyecto JBOSS en http://sourceforge.net/projects/jboss, donde siempre podrá encontrar descargas actualizadas, o desde la página de JBOSS, donde podrá encontrar información útil sobre JBoss, forums, información del proyecto, etc., y también la página de descarga http://www.jboss.org/downloads.jsp. Para este tutorial hemos utilizado la versión JBOSS-3.2.3 con el servidor HTTP interno JBOSSWeb Jetty.

Primero entre como root en Linux y descomprima el fichero que acaba de descargar en algún lugar apropiado donde tenga suficiente espacio. Yo lo tengo bajo el directorio /opt/.

Esto creará un directorio llamado jboss-3.2.3 bajo /opt/

Antes de poder ejecutar JBOSS, debe asegurarse de que ha configurado correctamente las siguientes variables de entorno:

    JBOSS_HOME: /opt/jboss-3.2.3 
    JAVA_HOME: /usr/java/j2sdk1.4.1_02 -- su directorio del J2SDK
    CLASSPATH: /usr/java/j2sdk1.4.1_02/lib/tools.jar -- su directorio del J2SDK

Para poder arrancar el servidor JBoss desde dentro de Eclipse, debe crear una configuración de Debug. Ejecutar JBoss de esta forma permite utilizar puntos de ruptura en el código del servidor.

  1. Vaya a Run ->Debug y debería ver varias configuraciones de JBoss en el panel izquierdo:

  2. Haga doble click en la versión que más se parezca a la que tiene instalada:

  3. En el panel derecho, ponga algún nombre a su versión (por ejemplo JBoss 3.2.3) y seleccione el directorio donde la ha instalado:

  4. Pulse en Close
  5. Vaya a Window -> Preferences -> JBoss IDE -> Launcher. En el panel de la derecha seleccione la configuración de servidor que acaba de crear y pulse Apply para que sea el servidor por defecto:

  6. Después de pulsar OK podrá arrancar el servidor utilizando los botones de la nueva barra de herramientas. Abajo tiene una imagen de la consola tras arrancar el servidor:

Crear un Servlet

Ahora para aprender cómo utilizar el plug-in, crearemos y desplegaremos un sencillo Servlet del tipo "Hello World!"

Nota:
Ahora debe crear un nuevo proyecto Java llamado Hello World. Si no recuerda como hacerlo puede verlo el artículo anterior: Eclipse -- I -- Historia y Toma de Contacto

Acuérdese de separar las carpetas fuente y destino utilizando los nombres src y bin

Ahora necesita configurar el CLASSPATH para definir las librerías (ficheros JAR) que Eclipse debería utilizar para compilar el código. También necesitará añadir un fichero JAR que permita compilar un Servlet. Afortunadamente, Eclipse viene equipado con un plug-in Tomcat, que contiene la librería que necesitamos para compilar un servlet.

  1. Pulse con el botón derecho sobre el proyecto Hello World y seleccione Properties
  2. En el panel de la izquierda seleccione Java Build Path.
  3. En el panel de la derecha seleccione la paestaña Libraries.
  4. Pulse sobre el botón Add Variable.
  5. Seleccione ECLIPSE_HOME y pulse Extend.
  6. Navegue hasta el directorio plugins/org.eclipse.tomcat.4.1.x.
  7. Seleccione servlet.jar y pulse OK.

  8. Pulse OK para salir del dialogo de propiedades.

Ahora hay que crear una clase llamada HelloWorldSerlvet en el paquete com.devx.example:

  1. Pulse con el botón derecho sobre el directorio src del proyecto Hello World y seleccione New -> Class.
  2. En el diálogo que aparece seleccione el paquete de la clase como com.devx.example y el nombre de la clase como HelloWorldServlet.
  3. Pulse sobre el boton Browse que hay junto al campo de texto Superclass y seleccione la clase HttpServlet.
  4. Pulse OK:

Ahora escriba el siguiente código dentro de la clase que acaba de crear:

package com.devx.example;
import java.io.IOException;

import javax.servlet.ServletException;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class HelloWorldServlet extends HttpServlet
{	

               protected void service(HttpServletRequest request, HttpServletResponse response)		
                           throws ServletException, IOException	
    {		
                           ServletOutputStream out = response.getOutputStream();		
                           out.println("<html><body><h1>Hello World!</h1></body></html>");	
    }
}

Necesita un descriptor de despliegue para que JBoss sepa cómo acceder al servlet. El descriptor de despliegue (web.xml) va en una carpeta llamada WEB-INF:

  1. Cree una carpeta llamada WEB-INF bajo el directorio src.
  2. En esa carpeta cree un fichero llamado web.xml y añádale el siguiente contenido:
    <!DOCTYPE web-app PUBLIC
     	'-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN'
    	'http://java.sun.com/j2ee/dtds/web-app_2.2.dtd'>
    <web-app>
    		<servlet>
    		<servlet-name>HelloWorldServlet</servlet-name>
    		<servlet-class>com.devx.example.HelloWorldServlet</servlet-class>
    	</servlet>
    		<servlet-mapping>
    		<servlet-name>HelloWorldServlet</servlet-name>
    		<url-pattern>/Hello</url-pattern>
    	</servlet-mapping>
    </web-app>
    

Después de esto se puede decir que prácticamente hemos terminado, la estructura del proyecto se debería parecer a la que muestra la ventana Package Explorer de la siguiente figura:

Seleccionar la configuración de Empaquetado

Antes de poder desplegar la aplicación en JBoss, necesita definir la estuctura de tu fichero WAR mediante una configuración de empaquetado, que luego puede ejecutar para crear un fichero WAR.

  1. Pulse con el botón derecho sobre el proyecto Hello World en el Package Explorer y seleccione Properties -> Packaging Configurations.
  2. Pulse con el botón derecho en el panel de la derecha y seleccione Add Std. Archive.
  3. Seleccione Standard-WAR.war y pulse OK.
  4. Pulse con el botón derecho sobre la configuración y elija Edit.
  5. Renombrela como helloworld.war.
  6. Expanda la configuración.
  7. Pulse con el botón derecho en la línea de Manifest.MF y eliminela.
  8. Aségurese de que laconfiguración se parece a la mostrada en la siguiente figura:

  9. Pulse OK y debería ver un fichero llamado packaging-build.xml.

Crear y Desplegar el Fichero WAR

Cree el fichero WAR pulsando con el botón derecho sobre el proyecto y seleccionando Run Packaging. Si pulsa de nuevo con el botón derecho sobre el proyecto y elige Refresh podrá ver el fichero WAR en la parte inferior del Package Explorer.

Arranque el servidor, si no está arrancado y pulse con el botón derecho sobre el fichero WAR recien creado, seleccione Deployment -> Deploy To.

En el diálogo que aparece seleccione el servidor de aplicaciones que desee, yo he utilizado el servidor por defecto (default). Después de pulsar OK podrá ver un diálogo indicando que se ha desplegado con éxito.

Ahora arranque su navegador favorito y escriba la dirección http://localhost:8080/helloworld/Hello, y debería ver algo como esto...

COMPARTE ESTE ARTÍCULO

COMPARTIR EN FACEBOOK
COMPARTIR EN TWITTER
COMPARTIR EN LINKEDIN
COMPARTIR EN WHATSAPP
ARTÍCULO ANTERIOR