# Servelts y JSP

# Manejar Datos de Formularios

1. Introducción
2. Ejemplo: Leer Tres Parámetros
3. Ejemplo: Listar Todos los Datos del Formulario

## 1. Introducción

Si alguna vez has usado un motor de búsqueda Web, visitado un tienda de libros on-line, etc., probablemente habrás encontrado URLs de búsqueda divertidas como http://host/path?user=Marty+Hall&origin=bwi&dest=lax. La parte posterior a la interrogación (user=Marty+Hall&origin=bwi&dest=lax) es conocida como datos de formulario, y es la forma más común de obtener datos desde una página Web para un programa del lado del servidor. Puede añadirse al final de la URL después de la interrogación (como arriba) para peticiones GET o enviada al servidor en una línea separada, para peticiones POST.

Extraer la información necesaria desde estos datos de formulario es tradicionalmente una de las partes más tediosas de la programación CGI.

Primero de todo, tenemos que leer los datos de una forma para las peticiones GET (en CGI tradicional, esto se hace mediante QUERY_STRING), y de otra forma para peticiones POST (normalmente leyendo la entrada estándard).

Segundo, tenemos que separar las parejas de los ampersands, luego separar los nombres de los parámetros (a la izquierda de los signos igual) del valor del parámetro (a la derecha de los signos igual).

Tercero, tenemos que decodificar los valores. Los valores alfanuméricos no cambian, pero los espacios son convertidos a signos más y otros caracteres se convierten como %XX donde XX es el valor ASCII (o ISO Latin-1) del carácter, en hexadecimal. Por ejemplo, si alguien introduce un valor de "~hall, ~gates, y ~mcnealy" en un campo de texto con el nombre "users" en un formulario HTML, los datos serían enviados como "users=%7Ehall%2C+%7Egates%2C+and+%7Emcnealy".

Finalmente, la cuarta razón que hace que el análisis de los datos de formulario sea tedioso es que los valores pueden ser omitidos (por ejemplo, param1=val1&param2=&param3=val3) y un parámetro puede tener más de un valor y que el mismo parámetro puede aparecer más de una vez (por ejemplo: param1=val1&param2=val2&param1=val3).

Una de las mejores características de los servlets Java es que todos estos análisis de formularios son manejados automáticamente. Simplemente llamamos al método getParameter de HttpServletRequest, y suministramos el nombre del parámetro como un argumento. Observa que los nombres de parámetros son sensibles a la mayúsculas. Hacemos esto exactamente igual que cuando los datos son enviados mediante GET o como si los enviaramos mediante POST. El valor de retorno es un String correspondiente al valor uudecode de la primera ocurrencia del parámetro. Se devuelve un String vacío si el parámetro existe pero no tiene valor, y se devuelve null si no existe dicho parámetro. Si el parámetro pudiera tener más de un valor, como en el ejemplo anterior, deberíamos llamar a getParameterValues en vez de a getParameter. Este devuelve un array de strings. Finalmente, aunque en aplicaciones reales nuestros servlets probablemente tengan un conjunto específico de nombres de parámetros por los que buscar. Usamos getParameterNames para esto, que devuelve una Enumeration, cada entrada puede ser forzada a String y usada en una llamada a getParameter.

## 2. Ejemplo: Leer Tres Parámetros

Aquí hay un sencillo ejemplo que lee tres parámetros llamados param1, param2, y param3, listando sus valores en una lista marcada. Observamos que, aunque tenemos que especificar selecciones de respuesta (content type, status line, otras cabeceras HTTP) antes de empezar a generar el contenido, no es necesario que leamos los parámetros de petición en un orden particular.

También observamos que podemos crear fácilmente servlets que puedan manejar datos GET y POST, simplemente haciendo que su método doPost llame a doGet o sobreescribiendo service (que llama a doGet, doPost, doHead, etc.). Esta es una buena práctica estándard, ya que requiere muy poco trabajo extra y permite flexibilidad en el lado del cliente. Si hemos usado la aproximación CGI tradicional cuando leemos los datos POST mediante la entrada estándard. deberíamos observa que hay una forma similar con los servelts llamando primero a getReader o getInputStream sobre HttpServletRequest. Esto es una mala idea para parámetros normales, pero podría usarse para ficheros descargados o datos POST que están siendo enviados por clientes personales en vez de formularios HTML. Observa, sin embargo, que si leemos los datos POST de esta manera, podrían no ser encontrados por getParameter.

### 2.1 ThreeParams.java

También puedes descargar el código fuente. Nota: también usa ServletUtilities.java, mostrado anteriormente.

>     package hall;

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

>     public class ThreeParams extends HttpServlet {
>       public void doGet(HttpServletRequest request,
>                         HttpServletResponse response)
>           throws ServletException, IOException {
>         response.setContentType("text/html");
>         PrintWriter out = response.getWriter();
>         String title = "Reading Three Request Parameters";
>         out.println(ServletUtilities.headWithTitle(title) +
>                     "<BODY>\n" +
>                     "<H1 ALIGN=CENTER>" + title + "</H1>\n" +
>                     "<UL>\n" +
>                     "  <LI>param1: "
>                     + request.getParameter("param1") + "\n" +
>                     "  <LI>param2: "
>                     + request.getParameter("param2") + "\n" +
>                     "  <LI>param3: "
>                     + request.getParameter("param3") + "\n" +
>                     "</UL>\n" +
>                     "</BODY></HTML>");
>       }

>       public void doPost(HttpServletRequest request,
>                          HttpServletResponse response)
>           throws ServletException, IOException {
>         doGet(request, response);
>       }
>     }

### 2.2 Salida de ThreeParams

## 3. Ejemplo: Listar todos los Datos del Formulario

Aquí hay un ejemplo que busca todos los nombres de parámetros que fueron enviados y los pone en una tabla. Ilumina los parámetros que tienen valor cero así como aquellos que tienen múltiples valores.

Primero busca todos los nombres de parámetros mediante el método getParameterNames de HttpServletRequest. Esto devuelve una Enumeration. Luego, pasa por la Enumeration de la forma estándard, usando hasMoreElements para determinar cuando parar y usando nextElement para obtener cada entrada. Como nextElement devuelve un Object, fuerza el resultado a String y los pasa a getParameterValues, obteniendo un array de Strings. Si este array sólo tiene una entrada y sólo contiene un string vacío, el parámetro no tiene valores, y el servlet genera una entrada "No Value" en itálica. Si el array tiene más de una entrada, el parámetro tiene múltiples valores, y se muestran en una lista bulleteada. De otra forma, el único valor principal se sítua en la tabla.

### 3.1 ShowParameters.java

También puedes descargar el código fuente. Nota: también usa ServletUtilities.java, mostrado anteriormente.

>     package hall;

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

>     /** Shows all the parameters sent to the servlet via either
>      *  GET or POST. Specially marks parameters that have no values or
>      *  multiple values.
>      *
>      *  Part of tutorial on servlets and JSP that appears at
>      *  http://www.apl.jhu.edu/~hall/java/Servlet-Tutorial/
>      *  1999 Marty Hall; may be freely used or adapted.
>      */

>     public class ShowParameters extends HttpServlet {
>       public void doGet(HttpServletRequest request,
>                         HttpServletResponse response)
>           throws ServletException, IOException {
>         response.setContentType("text/html");
>         PrintWriter out = response.getWriter();
>         String title = "Reading All Request Parameters";
>         out.println(ServletUtilities.headWithTitle(title) +
>                     "<BODY BGCOLOR=\"#FDF5E6\">\n" +
>                     "<H1 ALIGN=CENTER>" + title + "</H1>\n" +
>                     "<TABLE BORDER=1 ALIGN=CENTER>\n" +
>                     "<TR BGCOLOR=\"#FFAD00\">\n" +
>                     "<TH>Parameter Name<TH>Parameter Value(s)");
>         Enumeration paramNames = request.getParameterNames();
>         while(paramNames.hasMoreElements()) {
>           String paramName = (String)paramNames.nextElement();
>           out.println("<TR><TD>" + paramName + "\n<TD>");
>           String[] paramValues = request.getParameterValues(paramName);
>           if (paramValues.length == 1) {
>             String paramValue = paramValues[0];
>             if (paramValue.length() == 0)
>               out.print("<I>No Value</I>");
>             else
>               out.print(paramValue);
>           } else {
>             out.println("<UL>");
>             for(int i=0; i<paramValues.length; i++) {
>               out.println("<LI>" + paramValues[i]);
>             }
>             out.println("</UL>");
>           }
>         }
>         out.println("</TABLE>\n</BODY></HTML>");
>       }

>       public void doPost(HttpServletRequest request,
>                          HttpServletResponse response)
>           throws ServletException, IOException {
>         doGet(request, response);
>       }
>     }

### 3.2 ShowParameters

Aquí tenemos un formulario hTML que envía un número de parámetros a este servlet. Pulsa con el botón derecho sobre el enlace al código fuente para descargar el HTML.

Usa POST para enviar los datos (como deberían hacerlo todos los formularios que tienen entradas PASSWORD), demonstrando el valor de que los servlets incluyan tanto doGet como doPost.

### PostForm.html

>     <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
>     <HTML>
>     <HEAD>
>       <TITLE>A Sample FORM using POST</TITLE>
>     </HEAD>

>     <BODY BGCOLOR="#FDF5E6">
>     <H1 ALIGN="CENTER">A Sample FORM using POST</H1>

>     <FORM ACTION="/servlet/hall.ShowParameters"
>           METHOD="POST">
>       Item Number:
>       <INPUT TYPE="TEXT" NAME="itemNum"><BR>
>       Quantity:
>       <INPUT TYPE="TEXT" NAME="quantity"><BR>
>       Price Each:
>       <INPUT TYPE="TEXT" NAME="price" VALUE="$"><BR>
>       <HR>
>       First Name:
>       <INPUT TYPE="TEXT" NAME="firstName"><BR>
>       Last Name:
>       <INPUT TYPE="TEXT" NAME="lastName"><BR>
>       Middle Initial:
>       <INPUT TYPE="TEXT" NAME="initial"><BR>
>       Shipping Address:
>       <TEXTAREA NAME="address" ROWS=3 COLS=40></TEXTAREA><BR>
>       Credit Card:<BR>
>         <INPUT TYPE="RADIO" NAME="cardType"
>                          VALUE="Visa">Visa<BR>
>         <INPUT TYPE="RADIO" NAME="cardType"
>                          VALUE="Master Card">Master Card<BR>
>         <INPUT TYPE="RADIO" NAME="cardType"
>                          VALUE="Amex">American Express<BR>
>         <INPUT TYPE="RADIO" NAME="cardType"
>                          VALUE="Discover">Discover<BR>
>         <INPUT TYPE="RADIO" NAME="cardType"
>                          VALUE="Java SmartCard">Java SmartCard<BR>
>       Credit Card Number:
>       <INPUT TYPE="PASSWORD" NAME="cardNum"><BR>
>       Repeat Credit Card Number:
>       <INPUT TYPE="PASSWORD" NAME="cardNum"><BR><BR>
>       <CENTER>
>         <INPUT TYPE="SUBMIT" VALUE="Submit Order">
>       </CENTER>
>     </FORM>

>     </BODY>
>     </HTML>

### 3.3 Resultados del envío

Ozito