Desarrollo de una Servlet básica con las herramientas de JBuilder 9

Transcripción

1 Tutorial JBuilder 9 Servlets Desarrollo de una Servlet básica con las herramientas de JBuilder 9 Este tutorial muestra el desarrollo y prueba de una servlet básica. Se pretende presentar las herramientas que JBuilder 9 de Borland provee para facilitar el desarrollo de este tipo de aplicaciones web. Por un lado, el asistente de creación de servlets; por el otro, el servidor web Tomcat integrado en el entorno. JBuilder 9 incluye un cómodo asistente que permite crear una servlet básica con las características especificadas en el mismo, a partir de la cual desarrollar nuestra aplicación. JBuilder 9 dispone del contenedor web Tomcat completamente integrado en su IDE, así como de un browser. De este modo, se puede ejecutar e incluso depurar cualquier servlet o JSP desde el propio entorno, lo que facilita enormemente el desarrollo y la depuración. JBuilder 9 incluye tres versiones del contenedor Tomcat: Tomcat 3.2, para el desarrollo de Servlets 2.2 y JSPs 1.1. Tomcat 4.0, para el desarrollo de Servlets 2.3 y JSPs 1.2. Tomcat 4.1, la versión más reciente, también para el desarrollo de Servlets 2.3 y JSPs 1.2. Cada una de las especificaciones presentan ciertas particularidades, que se traducen en alguna pequeña diferencia en el asistente, dependiendo del contenedor web en el que deseamos desplegar nuestra servlet. En el presente tutorial se va a desarrollar una sencilla Servlet llamada DuplicServlet, que va a recibir como parámetros el nombre del usuario y un número, devolviendo el valor doble del mismo. A continuación, se probará dentro del entorno de JBuilder 9 usando el contenedor Tomcat 4.0 incluido en la misma. Configuraciones iniciales En primer lugar, vamos a crear un nuevo proyecto. Seleccione el menú File New Project. Aparece el asistente para creación de nuevos proyectos. Rellene el campo Name con el nombre ServletProject. A continuación, pulse el botón Finish para aceptar el resto de opciones por defecto en la creación de nuestro nuevo proyecto. Una vez hemos generado el nuevo proyecto y antes de comenzar a desarrollar nuestra servlet, es necesario configurar en JBuilder cuál es el servidor sobre el que se desplegará posteriormente nuestra aplicación. En el presente tutorial, vamos a usar el contenedor web Tomcat 4.0 incluido en JBuilder. Ya que se encuentra integrado, no es necesaria la configuración del mismo. Únicamente necesitamos indicar en JBuilder que ese será el servidor web en el que se desplegará nuestra servlet. Artículos técnicos Grupo Danysoft Pág 1/10

2 Para ello, debemos seleccionar el menú Project Project Properties (o hacer click con el botón derecho del ratón sobre ServletProject.jpx en el navegador de clases, y seleccionar Properties). Active la pestaña Servers. JBuilder 9 permite configurar un único servidor para todo tipo de servicios, o bien seleccionar varios servidores, proporcionando cada uno de ellos distintos servicios. Por ejemplo, podría interesarnos definir Tomcat como servidor web, y JBoss o Borland Enterprise Server para el despliegue de EJBs. En nuestro caso, vamos a configurar como servidor a Tomcat 4.0. Para ello, deje seleccionado Single Server for all services in project, y seleccione en el cuadro desplegable asociado el servidor web Tomcat 4.0. La apariencia de la ventana debería ser la siguiente: Se puede apreciar que en la lista de servicios únicamente aparece activo JSP/Servlet, el resto de los servicios está deshabilitado. Esto es debido a que Tomcat 4.0 es únicamente un servidor web y no puede proporcionar ninguno de los demás servicios. Pulse el botón Ok. Nuestro proyecto ha sido configurado para desplegar la servlet que desarrollaremos al servidor que nosotros escogimos. Artículos técnicos Grupo Danysoft Pág 2/10

3 Creación de un WebApp Un WebApp define la estructura de una aplicación web. De hecho, básicamente se trata de una estructura de directorios en la que se guardará de un modo ordenado el contenido de nuestra aplicación web. Generalmente, usaremos una WebApp cuando nuestra aplicación web contenga como mínimo una servlet o JSP. Asociado a cada WebApp, existe un fichero web.xml. Se trata de un descriptor de despliegue que almacena información que el servidor de destino usará para desplegar nuestra aplicación web. Este fichero es generado de forma automática por JBuilder. Si el servidor de destino precisa algún fichero adicional de despliegue, JBuilder lo generará también de forma automática. En nuestro caso, Tomcat 4.0 no necesita descriptores de despliegue adicionales. Todo el contenido de un WebApp puede incluirse en un archivo WAR. La filosofía es la misma que un fichero JAR: facilita el despliegue en un servidor de aplicaciones de la aplicación web completa. Para crear un WebApp, seleccione el menú File New, y en la pestaña Web seleccione el icono WebApplication. Vamos a crear una aplicación web llamada MyWebApp. Para ello, rellene la ventana como indica la siguiente figura. El directorio es relativo al directorio de trabajo de nuestro proyecto. El valor de la opción Build WAR indica que se generará un archivo WAR cada vez que se haga un build a nuestro proyecto. Pulse el botón Ok. Nota: Toda servlet o JSP desarrollada en JBuilder debe incluirse en un WebApp. De ese modo, JBuilder automatizará la creación de los descriptores de despliegue con el gran ahorro de trabajo que ello supone. Si se crea una servlet o JSP a partir de los asistentes de JBuilder, ya son añadidas por defecto a un WebApp. Artículos técnicos Grupo Danysoft Pág 3/10

4 En cambio, si son creadas manualmente o con otra herramienta y se desea importarlas a un proyecto de JBuilder, se las debe añadir también manualmente al WebApp. Esto se puede hacer de diversos modos. El más sencillo es indicar en el campo Directory del asistente de creación del nodo WebApp, el directorio donde se encuentran los contenidos de la aplicación web que se desea importar. JBuilder los reconocerá de forma automática. Desarrollo de la Servlet A continuación, vamos a usar el asistente de generación de servlets para crear nuestra servlet. Para lanzar el asistente, seleccione el menú File New y a continuación la pestaña Web. Nos aparecen los posibles asistentes que JBuilder 9 ofrece para la creación de aplicaciones web. Haga doble clic en el icono Servlet. En la primera pantalla del asistente, se pueden seleccionar diversas características. Cambie Class Name a DuplicServlet. En el campo WebApp, seleccione la aplicación web que hemos generado previamente, MyWebApp. Nota: Si no hubiésemos creado anteriormente un WebApp, JBuilder habría creado uno por defecto llamado DefaultWebApp. La pantalla debería tener la siguiente apariencia. No seleccionamos la opción Single Thread Model, ya que no deseamos implementar el interfaz SingleThreadModel. En la parte inferior se aprecia que podemos optar por crear tres tipos de servlets: Standard, Filter y Listener. Escogemos Standard servlet. Nota: Esta última característica es propia de la especificación 2.3 de Servlets. Si se trabaja sobre un servidor que soporte una versión inferior (como Tomcat 3.2), estas opciones no estarán disponibles. Artículos técnicos Grupo Danysoft Pág 4/10

5 Pulse Next. Aparecerá la siguiente pantalla. Rellénela como aparece en la figura. Esta ventana nos permite introducir el tipo de contenido que deseamos para nuestra servlet (en nuestro caso, HTML). A continuación, se indica qué métodos de la superclase HttpServlet deseamos sobreescribir. JBuilder declarará estos métodos en nuestra servlet. De ese modo, el desarrollo se facilita ya que el desarrollador sólo tiene que añadir su propio código sobre lo creado por JBuilder. La última opción seleccionada es Generate HTML file with form. JBuilder generará de modo automático un fichero HTML, que nos servirá para simular el acceso a nuestra servlet desde una pagina HTML. Pulse el botón Next. La siguiente pantalla nos permite introducir qué parámetros de entrada tendrá nuestra servlet. Deseamos que nuestra servlet reciba dos parámetros. Uno con el nombre del usuario, y otro con un número entero sobre el que operaremos para devolver su valor duplicado. Pulse el botón Add Parameter y rellene el parámetro UserName, y luego pulse de nuevo el botón Add Parameter para introducir el parámetro Number, del modo que indica la siguiente figura. Artículos técnicos Grupo Danysoft Pág 5/10

6 Vea que en el asistente podemos indicar el nombre de la variable que guardará el parámetro, su tipo, y un valor por defecto a usar en caso de que ese parámetro no sea facilitado. Pulse Next. En la siguiente página del asistente se permiten introducir las opciones de mapeo de la servlet en el servidor web de destino. Las opciones introducidas serán automáticamente añadidas en el fichero web.xml por JBuilder. Por defecto, serán: Pulse Next. Artículos técnicos Grupo Danysoft Pág 6/10

7 La última pantalla nos permite crear una configuración de ejecución por defecto. Pulse Finish para aceptar el defecto. Veamos qué es lo que JBuilder nos ha generado. La siguiente figura muestra el panel de proyecto. Se puede ver el fichero DuplicServlet.java, el fichero fuente Java que contiene la servlet. Dentro de nuestra aplicación web, MyWebApp, se distinguen el archivo MyWebApp.war (que contiene el típico fichero de manifiesto y el descriptor de despliegue web.xml) y el fichero de prueba DuplicServlet.html. Haciendo doble click en DuplicServlet.java, accedemos al fichero en el editor. Navegue por el fichero para ver qué es lo que JBuilder ha creado por nosotros. Verá que se han generado los métodos doget() y dopost(), y que dopost() por defecto llama a doget(). El cuerpo de doget() se encarga de: Especificar el tipo de contenido de la respuesta response. response.setcontenttype(content_type); Obtener los parámetros de la servlet. Producir una respuesta básica en formato html. La respuesta en formato HTML simplemente devuelve uno de los siguientes mensajes, dependiendo del tipo de llamada HTTP: The servlet has received a GET. This is the reply. O bien: The servlet has received a POST. This is the reply. A continuación vamos a dotar a trabajar sobre el código creado por JBuilder, para completar la servlet creada con nuestra propia lógica. Artículos técnicos Grupo Danysoft Pág 7/10

8 Vamos a modificar el método doget(). Localice la la línea de código: out.println("</body></html>"); Y añadir precediendo a esa línea el siguiente código. out.println("user: " + username + ""); out.println("number: " + num + ""); out.println("doubled number: " + num*2 + ""); Este código añade contenido a la respuesta que JBuilder había incluido por defecto. Muestra los valores de los parámetros de entrada username y num, y a continuación devuelve el valor del parámetro num multiplicado por dos. Con esto, nuestra servlet ha sido terminada. Seleccione la opción Project Make Project ServletProject.jpx del menú para compilarla. Ejecución y prueba de la servlet Existen diversos modos para ejecutar nuestra servlet. En primer lugar, podemos hacer click con el botón derecho del ratón sobre el fichero DuplicServlet.java, y seleccionar WebRun Using DuplicServlet. Esta acción lanza el servidor web Tomcat. A continuación, el área del editor se convierte en un navegador que obtiene la salida de nuestra servlet. Ejecutar un WebRun desde la propia clase java de la servlet es equivalente a escribir la URL de la servlet en un navegador web, por lo que el método http de llamada es GET. La salida debe ser la siguiente: The servlet has received a GET. This is the reply. Pulse el botón para detener el servidor web. La segunda posibilidad consiste en usar el fichero HTML generado por JBuilder. Para ello, haga clic con el botón derecho del ratón sobre el fichero DuplicServlet.html, y seleccione WebRun Using DuplicServlet. En el navegador obtendrá ahora visualizado el fichero HTML. Artículos técnicos Grupo Danysoft Pág 8/10

9 Antes de probar la servlet, familiarícese con las distintas pestañas que aparecen en el panel de contenidos. La pestaña View presenta la visión estática del código que hemos desarrollado. No precisa ningún servidor web en ejecución, y no permite navegar. La pestaña Source nos permite acceder al código fuente de nuestra aplicación a través del editor. La pestaña Web View presenta la vista del browser integrado en JBuilder, que permite navegar sobre nuestra aplicación para probarla. Web View Source muestra el código fuente HTML que el browser integrado interpreta para mostrar la vista Web View. Por último, la pestaña History muestra información sobre el historial de versiones de ficheros. La página HTML de prueba creada por JBuilder contiene un formulario que nos permite probar directamente el método POST. Para ello, rellene el pequeño formulario y pulse el botón Submit. La salida obtenida será similar a: The servlet has received a POST. This is the reply. User: Pepe Number: 27 Doubled number: 54 Para terminar, antes de detener el servidor web Tomcat usando el botón, puede testear su aplicación (mediante el método GET) desde cualquier browser. La URL podría ser la siguiente: El resultado en Internet Explorer 6 es el siguiente: Artículos técnicos Grupo Danysoft Pág 9/10

10 Resumen Este tutorial ha cubierto los siguientes aspectos del desarrollo con JBuilder 9: Selección de un servidor en el entorno de JBuilder 9. Creación de un nodo de Aplicación Web. Creación de una servlet simple a partir del asistente de JBuilder 9. Ejecución y prueba de la servlet. Artículos técnicos Grupo Danysoft Pág 10/10