Cómo compilar y ejecutar un servlet en Tomcat

Si os fue bien la instalación y configuración de Tomcat en Mac OS X ha llegado el momento de programar un servlet.

Estoy segura que hay montones de herramientas para hacerlo, pero después de haberme pegado con unas cuantas y ver que los resultados no eran muy buenos, os voy a contar cual es la solución más fácil que he encontrado y que por supuesto funciona.
Antes de empezar, para los que no lo sepan, un servlet es una clase en java que necesita un contenedor de servlets para funcionar. Puede que así dicho no quede muy claro. Si pensáis en el típico proyecto en java, solo necesitáis compilarlo y ya estaría listo para su ejecución. Un servlet, en cambio, después de su compilación necesita un contenedor de servlets (en nuestro caso Tomcat) para poder ser ejecutado, y eso es lo que yo os voy a explicar hoy, como compilar esa clase java y ejecutarla después desde Tomcat.

Lo primero de todo (después de instalar Tomcat y configurarlo) es crear un directorio donde colocar los servlets. Tomcat tiene, dentro de su directorio raiz, un directorio llamado webapps (/usr/local/apache-tomcat-6.0.29/webapps). Ahí es donde crearemos nuestros servlets, pero no podemos ponerlos de cualquier forma, es importante que cumplan una estructura determinada, sino Tomcat no los reconocerá. La estructura que tendrá nuestro directorio de servlets será la siguiente:



Proyecto:
El proyecto será el directorio que contedrá, como su nombre indica, todo el proyecto. Es un directorio que crearemos dentro de webapps y por supuesto lo podéis llamar como queráis. Si lo hacéis mediante la consola bastará con escribir esta linea:

mkdir /usr/local/apache-tomcat-6.0.29/webapps/tutoriales

Como podéis ver yo lo he llamado tutoriales.
Aquí dentro podéis poner paginas estáticas (html) o paginas dinámicas JSP, pero nada más, los servlets irán en otro sitio.

WEB-INF:
Este directorio hay que crearlo dentro de nuestro proyecto, contendrá otro subdirectorio classes con todos los servlets y el fichero web.xml que luego explicaré con detalle lo que es.
Para crear WEB-INF bastará con escribir en la consola:

mkdir /usr/local/apache-tomcat-6.0.29/webapps/tutoriales/WEB-INF

e inmediatamente podemos crear el directorio classes que contendrá los servlets:

mkdir /usr/local/apache-tomcat-6.0.29/webapps/tutoriales/WEB-INF/classes

Una vez hecho, prácticamente tenemos la estructura de nuestro proyecto, ahora empezaremos a programar. Yo he optado por usar el editor vi como os explique en post anteriores, pero podéis usar el que queráis.
Crearemos nuestro primer servlet que será el típico hola mundo y tendrá extensión .java:
Nos movemos al directorio del proyecto por comodidad:

cd /usr/local/apache-tomcat-6.0.29/webapps/tutoriales

y creamos el servlet:

vi HolaMundo.java

Tened cuidado con el nombre que le dais ya que tiene que coincidir con el nombre de la clase java que vamos a implementar dentro del servlet (java distingue entre mayúsculas y minúsculas)
El contenido de nuestro servlet será el siguiente:

Guardamos y cerramos pulsando esc :wq
Una vez guardado el servlet hay que compilarlo utilizando el api para servlets incluido en Tomcat (que se encuentra en la ruta /usr/local/apache-tomcat-6.0.29/lib/servlet-api.jar), para ello escribimos la siguiente linea:

javac -classpath /usr/local/apache-tomcat-6.0.29/lib/servlet-api.jar HolaMundo.java

Tras compilar, si todo ha ido bien, se generará un archivo HolaMundo.class que contendrá el servlet ya compilado. Este archivo hay que cambiarlo al directorio classes que creamos dentro de WEB-INF. Si lo hacéis por consola, basta con escribir esta linea:

mv HolaMundo.class classes

web.xml:
Si habéis llegado hasta aquí ya casi tenemos el servlet listo para ejecutarlo en Tomcat, lo único que nos queda es indicarle al servidor donde se encuentran los servlets, para ellos crearemos dentro de WEB-INF un archivo xml con la siguiente estructura:

display-name: Nombre identificativo para todos los servlets del documento
description: Una descripción de los servlets
servlet: Descripción de un servlet. Contiene dos elementos:
- servlet-name: Nombre del servlet
- servlet-class: Nombre de la clase del servlet, normalmente coincide con el nombre
servlet-mapping: Indica al servidor cómo se ejecuta un servlet en concreto. También tiene dos elementos:
- servlet-name: Nombre del servlet que queremos referenciar
- url-pattern: Ruta del servlet. Puede contener directorios virtuales. Será la ruta que usemos para lanzar el servlet con el Tomcat

Podéis crear este fichero con el vi como ya hemos visto.

Y una vez terminados todos estos pasos ya podemos arrancar Tomcat y probar el servlet. Arrancais Tomcat, abrís el explorador y escribís localjost:8080. Se os abrirá la página principal de Tomcat. Si pinchais en Tomcat Manager, en la parte izquierda (introducir user y pass), se os abrirá el gestor de aplicaciones web de Tomcat donde tendrá que aparecer el servlet que hemos creado:



Si os fijáis a la parte derecha del servlet aparece un menú como este:



Si el servlet no aparece como arrancado lo tenéis que arrancar, sino no funcionará.

Y llegó la hora de la verdad, para probar nuestro servlet escribiremos en el explorador la ruta que le indicamos en el documentos web.xml de la siguiente forma:
localhost:8080/tutorial/servlet/HolaMundo (o la ruta que hayáis puesto). Si todo ha ido bien deberiais ver en vuestro explorador algo como esto: