Nota sobre la creación de Servlets con JBuilder Enterprise

(Septiembre de 2005)

Introducción

Lo que sigue es una breve explicación de la creación y ejecución de servlets con JBuilder. Nos referimos a JBuilder versión 9 Enterprise Edition, aunque se puede observar que hay pocas diferencias con otras versiones próximas. Lo que resulta imprescindible es contar con una edición "Developer" o "Enterprise", ya que son las que incluyen versiones ligeras de servidores de aplicaciones. En nuestro caso hemos prácticado con Tomcat 4.0 y 4.1.

Para comprobar que nuestra versión de JBuilder incluye servidores de aplicaciones debemos:

  1. Entrar en Tools - Configure Servers. Podremos ver la lista de servidores disponibles.
  2. Para habilitar un servidor hay que seleccionarlo de la lista y marcar la casilla "Enable Server".

Creación de servlets

Vamos a ver el apoyo que da JBuilder en la creación del servlet, que va más allá de la simple creación de código fuente:

  1. Empezamos indicando el tipo de clase que vamos a crear: File-New-Pestaña "Web"-Servlet. Accedemos a la ventana donde definimos el paquete y el nombre de la clase. Al inicio del aprendizaje es aconsejable dejar las opciones por defecto; en especial es relevante que este marcado "Standard Servlet". Pulsamos "Next":
  2. Definimos los métodos que implementaremos. Para novatos es de utilidad marcar la opción "Generate HTML file", que señala la creación automática de la página HTML que invocará al servlet. Su utilidad es observar la forma de dicha invocación. Pulsamos "Next":
  3. Vamos a la ventana de parámetros; puesto que no los necesitamos para esta somera introducción, volvemos a pulsar "Next":
  4. Definimos el nombre que el servlet tendrá para el servidor de aplicaciones y su "mapping" (su ruta desde un directorio raíz que creará JBuilder, llamado normalmente "defaultroot"). Por ser la primera vez dejaremos los textos por defecto: para el nombre "hola_mundo" y para la URL "/hola_mundo". pulsamos "Next":
  5. La última ventana nos ofrece la creación de una configuración de ejecución. Lo aconsejo por simple comodidad (aunque se puede crear a posteriori en Project-Project Properties-Run-New). Esta opción indica automáticamente el servidor de aplicaciones, archivo HTML que lanza el servlet, puerto, etc. Terminamos con "Finish".

Con lo dicho se puede ver que el apoyo de JBuilder va más allá de la creación de código, apoyándonos en la creación de la llamada en HTML y definiendo parámetros del servidor de aplicaciones. Pero hay más: observamos que ha creado el archivo de descripción de despliegue web.xml. En la ventana de proyecto (zona superior izquierda) podemos ver los nodos "Default WebApp" - "Deployment descriptors" - "web.xml". Si pulsamos en este último (teniendo activada la pestaña inferior "Source") podremos ver el siguiente código:


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
  <servlet>
    <servlet-name>hola_mundo</servlet-name>
    <servlet-class>docen_servlet01.hola_mundo</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>hola_mundo</servlet-name>
    <url-pattern>/hola_mundo</url-pattern>
  </servlet-mapping>
</web-app>

Configurar el servidor de aplicaciones para el proyecto

Puede acceder a la configuración del servidor de aplicaciones para el proyecto por medio de "Project-Project Propertie-Run-Seleccionamos nuestra configuración y Edit". Accede a la ventana donde se puede ver el tipo de servidor (en nuestro caso Tomcat 4.0) y los servicios que ofrece. Es necesario que uno de los servicios sea "JSP/Servlet". Si pulsa en este servicio puede ver información sobre:


Ejecución

La ejecución es sencilla: selecciona el archivo hola_mundo.html que ha creado JBuilder y pulsa el botón derecho de su ratón, con ello aparece un menú donde selecciona "Web run using 'nombre de su configuración de ejecución'" (en nuestro ejemplo aparece "Web run using hola_mundo"). JBuilder interpreta el archivo HTML y realiza la llamada al servlet.

Otra forma aún más sencilla: pulsar F9. Esto es válido en el caso de que la configuración de ejecución sea la única o la configuración por defecto. Como en nuestro ejemplo sólo tenemos una configuración de ejecución el asunto va bien y sin problemas.