INTRODUCCIÓN

Hace poco tuve la necesidad de utilizar un servidor con soporte para Java. Tras decidirme por Apache Tomcat (debido a que ya había estado utilizando Apache de antemano) pude comprobar que a pesar de que en internet hay mucha información al respecto está todo un poco disperso, con lo que he decidido escribir este artículo para ponerlo todo más o menos juntito. Como siempre, si hay algún fallo, o se me pasa algo por alto, decídmelo y lo corregiré.

• Tomcat 5.0.12 Beta
• Linux Mandrake 9.1 (Aunque supongo que lo explicado valdrá en cualquier Linux, incluso en cualquier SO para el que esté disponible Tomcat)

REQUESITOS PREVIOS

• Java: Bajaros la JSDK oficial en http://java.sun.com/j2se/1.4.2/download.html. Después añadís el directorio bin de la instalación de java al path del sistema.

INSTALANDO EL TOMCAT

Lo primero que tenemos que hacer es bajarnos el Tomcat de la página oficial de Apache ( http://jakarta.apache.org/site/binindex.cgi ) en la cual deberemos buscar la última versión del Tomcat y bajárnoslo (Tened en cuenta que en dicha página vienen los descargables de todos los proyectos de Jakarta, buscad hasta encontrar la última versión de Tomcat). Si queréis compilar a partir del código fuente, la dirección es: (http://jakarta.apache.org/site/sourceindex.cgi )

Una vez descargado, copiamos el archivo al directorio donde vayamos a instalar Tomcat. Yo lo copié al directorio /var, pero podéis copiarlo donde queráis. Descomprimís el archivo y le cambiáis el nombre al directorio que se haya creado por otro más manejable, por ejemplo tomcat (no es necesario, es por comodidad). A partir de ahora llamaré a dicho directorio $CATALINA_HOME, por seguir la documentación oficial de Tomcat ( CATALINA_HOME = directorio de instalación de Jakarta-Tomcat)

Ahora tenéis que añadir la variable JAVA_HOME al sistema, apuntando al directorio donde instalasteis el java (Para que el Tomcat sepa donde buscar el java). Después ir al directorio $ CATALINA_HOME/bin. En este directorio están los scripts para arrancar (startup.sh) y parar (shutdown.sh) el Tomcat. También encontrareis los ejecutables para Windows (los .exe y los .bat), que podéis borrar directamente (Si por alguna razón estáis usando Windows, pues entonces borra los .sh). Bueno, pues ejecutáis el script startup.sh y accedéis a http://localhost:8080/ desde vuestro navegador favorito. Si todo ha ido bien, deberías ver la página principal de Tomcat (puede que el Tomcat tarde un poco en arrancar. Si inicialmente no se conecta al puerto 8080, darle a recargar en vuestro navegador y probad de nuevo)

CREANDO UN SERVLET

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class HolaMundo extends HttpServlet
{
	public void doGet(HttpServletRequest request, HttpServletResponse response)
	throws ServletException, IOException
	{
		response.setContentType("text/html");
		PrintWriter out = response.getWriter();
		out.println("");
		out.println("");
		out.println("Prueba");
		out.println("");
		out.println(" ¡Hola mundo! ");
		out.println("");
	}
}

Recomiendo que desarrolléis el ejemplo en un directorio ajeno a Tomcat, en vuestro home, o en donde tengais por costumbre hacer los desarrollos Java.

Bueno, grabáis el código en un fichero HolaMundo.java y lo compiláis y obtenéis el .class. Ahora tenéis que montar la estructura de directorios propia de un Servler, acorde a la especificación oficial de SUN. Dicha estructura es la siguiente:

• Nombre_de_la_aplicación (el que queráis, yo usaré prueba)
• META-INF (nosotros no lo usaremos)
• WEB-INF (Aquí incluimos el archivo web.xml, del que ya hablaremos)
• classes (para guardar los archivos compilados)
• src (opcional, para guardar las fuentes)
• lib (contendrá los .jar externos. No lo usaremos)

<?xml version="1.0" encoding="ISO-8859-15"?>
<!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>prueba</servlet-name>
		<servlet-class>HolaMundo</servlet-class>
	</servlet>

	<servlet-mapping>
		<servlet-name>prueba</servlet-name>
		<url-pattern>hola</url-pattern>
	</servlet-mapping>
</web-app>

En servlet-name indicaremos el nombre de nuestra aplicación y lo haremos coincidir con el directorio donde la tenemos guardada (aquel cuyo contenido estamos creando ahora). En servet-class ponemos la clase principal de nuestra aplicación y en url-pattern la dirección desde la cual accederemos al servlet. Para más información consultar la documentación oficial.

Bueno, copiamos nuestra aplicación al directorio $CATALINA_HOME/webapps/ y reiniciamos el Tomcat (usando los scripts shutdown.sh y startup.sh comentados antes). Para comprobar que todo va bien accedemos a http://localhost/prueba/hola (Si habéis usado otro url-pattern u otro servlet-name la dirección general es “http://localhost/$servlet-name/$url-pattern“). Si todo ha ido bien, deberíamos ver el consabido “!Hola Mundo!“.

Aún nos queda algo por hacer. Os habréis fijado que para cargar nuestra aplicación hemos tenido que reiniciar el servidor. Esto no es muy adecuado en la mayoría de los casos. Ahora solucionaremos dicho problema

EL MANAGER DE TOMCAT

El manager es una aplicación para administración del motor Tomcat que usa una interfaz vía web (también se pueden usar mediante transmisiones http, pero no lo trataré en este tutorial). En principio y por razones de seguridad no podemos acceder al manager hasta que creemos un usuario de Tomcat con derecho de administrador. Para crearlo debemos modificar el archivo de configuración de usuarios de Tomcat, que se encuentra en $CATALINA_HOME/conf/tomcat-users.xml. A dicho archivo le tendremos que añadir las siguientes lineas:

<role rolename="manager"/>
<user username="root" password="xxxxxxx" roles="manager"/>

Debido a que es un documento xml, debemos respetar el orden de las etiquetas. Dicho de otro modo, poned la linea <role> debajo de las que ya están y lo mismo para la linea <user>. Con respecto a la linea <user> que hemos añadido, podemos ponerle el username que queramos, no hace falta que sea root (la condición de administrador se define en el atributo role, no en el nombre). Ponedle el password que queráis (si alguien se lo está preguntando, si, el password se guarda como texto plano, con lo que tal vez sea una buena idea de seguridad no llamar al administrador root, pues sería demasiado obvio)

Una vez añadido el usuario, reiniciamos el tomcat (recordad, shutdown.sh, startup.sh) y accedemos, desde nuestro navegador a la dirección http://localhost:8080/manager/html , introducimos los datos (username/password) del usuario recién creado y aparecerá ante nosotros la interfaz del manager. Dicha interfaz consta de 5 partes:

• Message: Aquí se nos mostrará el resultado de las ordenes que le vayamos dando al manager. Pueden ser OK o FAILED.
• Manager: Aquí tenemos 4 opciones. La primera recarga la lista de aplicaciones instaladas actualmente (dicha lista está justo debajo, ahora la veremos con más detenimiento), las dos siguientes nos permiten el acceso a la documentación del manager y la última nos permiten ver el estado del motor de Tomcat.
• Applications: Aquí tenemos la lista de aplicaciones web que está ejecutando Tomcat. Lo que a nosotros nos importa son los commands. Podemos parar (stop), iniciar (start), recargar (reload) o borrar (undeploy) la aplicación. Probad, por ejemplo a parar e iniciar posteriormente vuestra aplicación (acceded a ella con el navegador para ver los resultados). Probad también a modificar vuestra aplicación (haced que diga “Hola bulma!!“, por ejemplo), recompilarla y recargarla.
• Deploy: Desde aquí podemos subir aplicaciones directamente al tomcat, que es justo lo que queríamos. Para ver como funciona, copiad la aplicación de ejemplo a un directorio seguro (al HOME; vamos) y borrarla del servidor (!undeploy!). Ahora en donde pone “WAR or Directory URL“ (el tercer campo) escribir el path hacía la aplicación (ojo, hay que especificar el protocolo, es decir file:/lo_que_sea, en mi caso file:/home/angel/prueba/“). Le damos a deploy y ya tenemos nuestra aplicación funcionando perfectamente. Comprobarlo como es habitual.
• Server information: Pues eso mismo. Tampoco hay mucho que contar.

CONCLUSIóN

Bueno pues eso es todo. Una vez montado el Tomcat, para añadir nuevos servlets solo tenéis que crear la estructura de directorios comentada antes y subirla al servidor (a mano, reiniciando o mediante el manager) Usar el manager puede parecer más inseguro que subir a mano, pero para desarrollar un servlet medianamente complicado se hace casi imprescindible.

Me he dejado varias cosas en el tintero. El uso de los archivos WAR, que no son mas que la anterior estructura de directorios, pero comprimida (son el equivalente en servlets a los archivos JAR normales, la W es de web application).Tampoco he comentado el sistema de hosts virtuales del Tomcat, o los sistemas de seguridad adicionales. Por no mencionar que aparte de Servlets podemos hacer también páginas JSP (Java Server Pages, parecido a PHP o ASP, pero en Java), pero este tutorial es una mera introducción al Tomcat. Para quién quiera profundizar, aquí dejo estos enlaces:

• http://www.programacion.com/java/tutorial/servlets_basico/ : tutorial básico de programación de servlets.
• http://programacion.com/java/tutorial/servlets_jsp/ : Tutorial básico de Servlets y JSP.
• http://java.sun.com/products/servlet/docs.html : Documentación oficial. En inglés por supuesto.
• http://localhost:8080/tomcat-docs : La documentación que tendréis instalada actualmente en vuestro disco tras instalar Tomcat

Buenas, el artículo en general me ha parecido bien y por lo que he ido leyendo en los comentarios hay gente que parecer saber del tema, así que me lanzo con algunas preguntas a ver si hay suerte xD (he estado mirando manuales/tutoriales por internet, pero ninguno me acaba de aclarar) :

-Mi intención era tener el servidor en un directorio distinto al webapps, por lo que creé un nuevo host en server.xml apuntando al nuevo directorio (mantuve el localhost a webapps de momento). Es una buena manera de hacerlo o no es recomendable?

-Con el apache/tomcat tengo problemas (de hecho de momento estoy solo con Tomcat pq no he conseguido solucionarlos). Tengo cargado el jk2_module, pero luego no se q comandos utilizar para redirigir todos los jsp y servlets a tomcat (toda la informacion q encuentro es con versiones anteriores del jk, q tenian otros comandos). Iria bien que alguien explicase en detalle el funcionamiento de los uri: del workers.properties.

Gracias de antemano, ALBERT.

GRACIAS.....

causa raíz

java.lang.NoClassDefFoundError: javax/servlet/http/HttpServlet java.lang.ClassLoader.defineClass1(Native Method) java.lang.ClassLoader.defineClass(ClassLoader.java:620) java.securit y.SecureClassLoader.defineClass(SecureClassLoader.java:124) java.net.URLClassL oader.defineClass(URLClassLoader.java:260) java.net.URLClassLoader.access$100( URLClassLoader.java:56) java.net.URLClassLoader$1.run(URLClassLoader.java:195) java.security.AccessController.doPrivileged(Native Method) java.net.URLClassLoader.findClass(URLClassLoader.java:188) java.lang .ClassLoader.loadClass(ClassLoader.java:306) sun.misc.Launcher$AppClassLoader. loadClass(Launcher.java:268) java.lang.ClassLoader.loadClass(ClassLoader.java: 251) org.apache.catalina.loader.WebappClassLoader.loadClass(WebappClassLoader. java:1247) org.apache.catalina.loader.WebappClassLoader.loadClass(WebappClassL oader.java:1181) org.apache.catalina.valves.ErrorReportValve.invoke(ErrorRepor tValve.java:105) org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAda pter.java:148) org.apache.coyote.http11.Http11Processor.process(Http11Processo r.java:856) org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.pr ocessConnection(Http11Protocol.java:744) org.apache.tomcat.util.net.PoolTcpEnd point.processSocket(PoolTcpEndpoint.java:527) org.apache.tomcat.util.net.Leade rFollowerWorkerThread.runIt(LeaderFollowerWorkerThread.java:80) org.apache.tom cat.util.threads.ThreadPool$ControlRunnable.run(ThreadPool.java:684) java.lang .Thread.run(Thread.java:595) nota La traza completa de la causa de este error se encuentra en los archivos de diario de Apache Tomcat/5.5.9. Apache Tomcat/5.5.9