Tema 1: Conceptos básicos de Servlets

1.3. Ejemplos básicos de servlets

1.3.1. Servlet que genera texto plano

El siguiente ejemplo de servlet muestra una página con un mensaje de saludo: "Este es un servlet de prueba". Lo cargamos mediante petición GET.

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

public class ClaseServlet extends HttpServlet
{
	public void doGet(HttpServletRequest request, 
			  HttpServletResponse response) 
	throws ServletException, IOException
	{
		PrintWriter out = response.getWriter();
		out.println ("Este es un servlet de prueba");
	}
}

Se obtiene un Writer para poder enviar datos al usuario. Simplemente se le envía la cadena que se mostrará en la página generada.

1.3.2. Servlet que genera una página HTML

Este otro ejemplo escribe código HTML para mostrar una página web.

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

public class ClaseServletHTML extends HttpServlet
{
	public void doGet(HttpServletRequest request, 
			  HttpServletResponse response) 
	throws ServletException, IOException
	{
		response.setContentType("text/html");
		PrintWriter out = response.getWriter();
		out.println ("<!DOCTYPE HTML PUBLIC \""+
			     "-//W3C//DTD HTML 4.0 " + 
			     "Transitional//EN\">");
		out.println ("<HTML>");
		out.println ("<BODY>");
		out.println ("<h1>Titulo</h1>");
		out.println ("<br>Servlet que genera HTML");
		out.println ("</BODY>");
		out.println ("</HTML>");
	}
}

Para generar una página HTML con un servlet debemos seguir dos pasos:

Indicar que el contenido que se va a enviar es HTML (mediante el método setContentType() de HttpServletResponse):

response.setContentType("text/html");
Esta línea es una cabecera de respuesta, que veremos más adelante cómo utilizar. Hay que ponerla antes de obtener el Writer.

Escribir en el flujo de salida el texto necesario para generar la página HTML. La línea que genera el DOCTYPE no es necesaria, aunque sí muy recomendada para que se sepa qué versión de HTML se está empleando.

1.3.3. Servlet que utiliza parámetros de inicialización

Este otro ejemplo utiliza dos parámetros de inicialización externos:

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

public class ClaseServletInit extends HttpServlet
{
	// Mensaje que se va a mostrar en la pagina
	String mensaje = "";		
	// Numero de veces que se va a repetir el mensaje
	int contador = 1;		

	// Metodo de inicializacion
	
	public void init(ServletConfig conf) 
	throws ServletException
	{
		super.init(conf);	// MUY IMPORTANTE
		
		mensaje = conf.getInitParameter("mensaje");
		if (mensaje == null)
			mensaje = "Hola";
		
		try
		{
			contador = Integer.parseInt(
			   conf.getInitParameter("contador"));
		} catch (NumberFormatException e) {
			contador = 1;
		}
	}

	// Metodo para procesar una peticion GET
	
	public void doGet(HttpServletRequest request, 
			  HttpServletResponse response) 
	throws ServletException, IOException
	{
		response.setContentType("text/html");
		PrintWriter out = response.getWriter();
		out.println ("<!DOCTYPE HTML PUBLIC \""+
			     "-//W3C//DTD HTML 4.0 " + 
			     "Transitional//EN\">");
		out.println ("<HTML>");
		out.println ("<BODY>");
		
		for (int i = 0; i < contador; i++)		
		{
			out.println (mensaje);
			out.println ("<BR>");
		}
		
		out.println ("</BODY>");
		out.println ("</HTML>");
	}
}

Se utiliza el método init() con un parámetro ServletConfig para poder tomar los parámetros externos. Es importante la llamada a super al principio del método.
Mediante el método getInitParameter() de ServletConfig obtenemos dos parámetros: mensaje y contador, que asignamos a las variables del mismo nombre. El primero indica el mensaje que se va a mostrar en la página, y el segundo el número de veces que se va a mostrar.
En doGet() hacemos uso de esos parámetros obtenidos, para mostrar el mensaje las veces indicadas.

1.3.4. Prueba de los ejemplos

Para probar el ejemplo, tendríamos dos posibilidades

Crear un directorio en webapps para el ejemplo (por ejemplo, webapps/ejemplobasico), y dentro de él:
- Definir un directorio WEB-INF
- Dentro de WEB-INF colocar un fichero web.xml descriptor de la aplicación. Podemos mapear los servlets en este fichero descriptor, como veremos a continuación.
- Colocar los servlets en el directorio WEB-INF/classes.
Crear un fichero WAR con la estructura de ficheros y directorios vista en el punto anterior, y copiar dicho fichero WAR en el directorio webapps de Tomcat

Se proporciona un fichero WAR con los tres servlets colocados en la subcarpeta WEB-INF/classes, y un fichero web.xml con 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>ejemplo1_1</servlet-name>
		<servlet-class>ClaseServlet</servlet-class>
	</servlet>
	<servlet>
		<servlet-name>ejemplo1_2</servlet-name>
		<servlet-class>ClaseServletHTML</servlet-class>
	</servlet>
	<servlet>
		<servlet-name>ejemplo1_3</servlet-name>
		<servlet-class>ClaseServletInit</servlet-class>
		<init-param>
			<param-name>
			mensaje
			</param-name>
			<param-value>
			Mensaje de prueba
			</param-value>
		</init-param>
		<init-param>
			<param-name>contador</param-name>
			<param-value>10</param-value>
		</init-param>
	</servlet>

	<servlet-mapping>
		<servlet-name>ejemplo1_1</servlet-name>
		<url-pattern>/ejemploservlet</url-pattern>
	</servlet-mapping>
	<servlet-mapping>
		<servlet-name>ejemplo1_2</servlet-name>
		<url-pattern>/ejemploservletHTML</url-pattern>
	</servlet-mapping>
	<servlet-mapping>
		<servlet-name>ejemplo1_3</servlet-name>
		<url-pattern>/ejemploservletInit</url-pattern>
	</servlet-mapping>
</web-app>

Vemos que se mapean los tres servlets:

ejemplo1_1 es el nombre para el primer servlet ClaseServlet, que se puede referenciar también con /ejemploservlet.
ejemplo1_2 es el nombre para el segundo servlet ClaseServletHTML, que se puede referenciar también con /ejemploservletHTML
ejemplo1_3 es el nombre para el tercer servlet ClaseServletInit, que se puede referenciar también con /ejemploservletInit. En él se definen los parámetros de inicio mensaje y contador, utilizados internamente por el servlet (se definen mediante etiquetas <init-param>, indicando el nombre (param-name) y el valor (param-value)).

Para probar los servlets, copiamos el fichero WAR en el directorio webapps de Tomcat. Para llamar a los servlets, podemos hacerlo de tres formas:

Escribiendo, respectivamente para cada servlet:

http://localhost:8080/ejemplobasico/servlet/ClaseServlet
http://localhost:8080/ejemplobasico/servlet/ClaseServletHTML
http://localhost:8080/ejemplobasico/servlet/ClaseServletInit

Sustituir la clase del servlet por su nombre asociado en el mapeo:

http://localhost:8080/ejemplobasico/servlet/ejemplo1_1
http://localhost:8080/ejemplobasico/servlet/ejemplo1_2
http://localhost:8080/ejemplobasico/servlet/ejemplo1_3

Utilizar el mapeo en el fichero descriptor y llamar a los servlets con su URL asociada:

http://localhost:8080/ejemplobasico/ejemploservlet
http://localhost:8080/ejemplobasico/ejemploservletHTML
http://localhost:8080/ejemplobasico/ejemploservletInit

NOTA: el servlet ClaseServletInit no tomará los parámetros si lo llamamos del primer modo, debido a que se asignan esos parámetros al mapeo.