1. Introducción
2. Sumario de síntaxis
3. Plantilla de Texto (HTML estático)
4. Elementos de Script JSP: Expresiones, Scriptlets, y Declaraciones
5. Directivas JSP
6. Ejemplo: usar Elementos de Script y Directivas
7. Variables Predefinidas
8. Acciones JSP
   • 8.1 jsp:include
   • 8.2 jsp:useBean (introducción)
   • 8.3 jsp:useBean (detalles)
   • 8.4 jsp:setProperty
   • 8.5 jsp:getProperty
   • 8.6 jsp:forward
   • 8.7 jsp:plugin
9. Convenciones sobre comentarios y caracteres de Escape en JSP

1. Introducción

Thanks for ordering 
<I><%= request.getParameter("title") %></I>

Además de el HTML normal, hay tres tipos de construcciones JSP que embeberemos en una página: elementos de script, directivas y acciones. Los elementos de script nos permiten especificar código Java que se convertirá en parte del servlet resultante, las directivas nos permiten controlar la estructura general del servlet, y las acciones nos permiten especificar componentes que deberían ser usuados, y de otro modo controlar el comportamiento del motor JSP. Para simplificar los elementos de script, tenemos acceso a un número de variables predefinidas como request del fragmento de código anterior.

Nota: este tutorial cubre la versión 1.0 de la especificación JSP 1.0.

2. Sumario de Síntaxis

<%= expression %>

<% code %>

<%! code %>

<%@ page att="val" %>

<%@ include file="url" %>

<%-- comment --%>

<jsp:include
    page="relative URL"
    flush="true"/>

<jsp:useBean att=val*/> 
      o
<jsp:useBean att=val*>
...
</jsp:useBean> 

<jsp:setProperty att=val*/>

<jsp:getProperty
    name="propertyName"
    value="val"/>

<jsp:forward
    page="relative URL"/>

<jsp:plugin
    attribute="value"*>
  ...
</jsp:plugin>

3. Plantilla de Texto: HTML estático

La única excepción a la regla de que "la plantilla de texto se pasa tal y como es" es que, si queremos tener "<%" en la salida, necesitamos poner "<\%" en la plantilla de texto.

4. Elementos de Script JSP

1. Expresiones de la forma <%= expresión %> que son evaluadas e insertadas en la salida.
2. Scriptlets de la forma <% codido %> que se insertan dentro del método service del servlet, y
3. Declaraciones de la forma <%! codigo %> que se insertan en el cuerpo de la clase del servlet, fuera de cualquier método existente.

4.1 Expresiones JSP

<%= expresión Java %>

Current time: <%= new java.util.Date() %>

• request, el HttpServletRequest;
• response, el HttpServletResponse;
• session, el HttpSession asociado con el request (si existe), y
• out, el PrintWriter (una versión con buffer del tipo JspWriter) usada para envíar la salida al cliente.

Your hostname: <%= request.getRemoteHost() %>

<jsp:expression>
Expresión Java
</jsp:expression>

4.2 Scriptlets JSP

<% Código Java  %>

<% 
String queryData = request.getQueryString();
out.println("Attached GET data: " + queryData); 
%>

<% if (Math.random() < 0.5) { %>
Have a <B>nice</B> day!
<% } else { %>
Have a <B>lousy</B> day!
<% } %>

if (Math.random() < 0.5) { 
  out.println("Have a <B>nice</B> day!");
} else { 
  out.println("Have a <B>lousy</B> day!");
}

<jsp:scriptlet>
Código
</jsp:scriptlet>

4.3 Declaraciones JSP

<%! Código Java%>

<%! private int accessCount = 0; %>
Accesses to page since server reboot: 
<%= ++accessCount %>

<jsp:declaration>
Código
</jsp:declaration>

5. Directivas JSP

<%@ directive attribute="value" %>

<%@ directive attribute1="value1" 
              attribute2="value2"
              ...
              attributeN="valueN" %>

5.1 La directiva page

• import="package.class" o import="package.class1,...,package.classN".
  Esto nos permite especificar los paquetes que deberían ser importados. Por ejemplo:
  <%@ page import="java.util.*" %>
  El atributo import es el único que puede aparecer múltiples veces.

• contentType="MIME-Type" o
  contentType="MIME-Type; charset=Character-Set"
  Esto especifica el tipo MIME de la salida. El valor por defecto es text/html. Por ejemplo, la directiva:
  <%@ page contentType="text/plain" %>
  tiene el mismo valor que el scriptlet
  <% response.setContentType("text/plain"); %>

• isThreadSafe="true|false".
  Un valor de true (por defecto) indica un procesamiento del servlet normal, donde múltiples peticiones pueden procesarse simultáneamente con un sólo ejemplar del servlet, bajo la suposición que del autor sincroniza las variables de ejemplar. Un valor de false indica que el servlet debería implementar SingleThreadModel, con peticiones enviadas serialmente o con peticiones simultáneas siendo entregadas por ejemplares separados del servelt.

• session="true|false".
  Un valor de true (por defecto) indica que la variable predefinida session (del tipo HttpSession) debería unirse a la sesión existente si existe una, si no existe se debería crear una nueva sesión para unirla. Un valor de false indica que no se usarán sesiones, y los intentos de acceder a la variable session resultarán en errores en el momento en que la página JSP sea traducida a un servlet.

• buffer="sizekb|none".
  Esto especifica el tamaño del buffer para el JspWriter out. El valor por defecto es específico del servidor, debería ser de al menos 8kb.

• autoflush="true|false".
  Un valor de true (por defecto) indica que el buffer debería desacargase cuando esté lleno. Un valor de false, raramente utilizado, indica que se debe lanzar una excepción cuando el buffe se sobrecargue. Un valor de false es ilegal cuando usamos buffer="none".

• extends="package.class".
  Esto indica la superclase del servlet que se va a generar. Debemos usarla con extrema precaución, ya el servidor podría utilizar una superclase personalizada.

• info="message".
  Define un string que puede usarse para ser recuperado mediante el método getServletInfo.

• errorPage="url".
  Especifica una página JSP que se debería procesar si se lanzará cualquier Throwable pero no fuera capturado en la página actual.

• isErrorPage="true|false".
  Indica si la página actual actúa o no como página de error de otra página JSP. El valor por defecto es false.

• language="java".
  En algunos momentos, esto está pensado para especificar el lenguaje a utilizar. Por ahora, no debemos precuparnos por él ya que java es tanto el valor por defecto como la única opción legal.

<jsp:directive.TipoDirectiva atributo=valor />

<%@ page import="java.util.*" %>

<jsp:directive.page import="java.util.*" />

5.2 La directiva include JSP

<%@ include file="url relativa" %>

Por ejemplo, muchas sites incluyen una pequeña barra de navegación en cada página. Debido a los problemas con los marcos HTML, esto normalmente se implementa mediante una pequeña tabla que cruza la parte superior de la página o el lado izquierdo, con el HTML repetido para cada página de la site. La directiva include es una forma natural de hacer esto, ahorrando a los desarroladores el mantenimiento engorroso de copiar realmente el HTML en cada fichero separado. Aquí tenemos un código representativo:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Servlet Tutorial: JavaServer Pages (JSP) 1.0</TITLE>
<META NAME="author" CONTENT="webmaster@somesite.com">
<META NAME="keywords" CONTENT="...">
<META NAME="description" CONTENT="...">
<LINK REL=STYLESHEET
      HREF="Site-Styles.css"
      TYPE="text/css">
</HEAD>

<BODY>
<%@ include file="/navbar.html" %>

<!-- Part specific to this page ... -->

</BODY>
</HTML>

6. Ejemplo: Usar Elementos de Script y Directivas

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Using JavaServer Pages</TITLE>

<META NAME="author" CONTENT="Marty Hall -- hall@apl.jhu.edu">
<META NAME="keywords"
      CONTENT="JSP,JavaServer Pages,servlets">
<META NAME="description"
      CONTENT="A quick example of the four main JSP tags.">
<LINK REL=STYLESHEET
      HREF="My-Style-Sheet.css"
      TYPE="text/css">
</HEAD>

<BODY BGCOLOR="#FDF5E6" TEXT="#000000" LINK="#0000EE"
      VLINK="#551A8B" ALINK="#FF0000">

<CENTER>
<TABLE BORDER=5 BGCOLOR="#EF8429">
  <TR><TH CLASS="TITLE">
      Using JavaServer Pages</TABLE>
</CENTER>
<P>

Some dynamic content created using various JSP mechanisms:
<UL>
  <LI><B>Expression.</B><BR>
      Your hostname: <%= request.getRemoteHost() %>.
  <LI><B>Scriptlet.</B><BR>
      <% out.println("Attached GET data: " +
                     request.getQueryString()); %>
  <LI><B>Declaration (plus expression).</B><BR>
      <%! private int accessCount = 0; %>
      Accesses to page since server reboot: <%= ++accessCount %>
  <LI><B>Directive (plus expression).</B><BR>
      <%@ page import = "java.util.*" %>
      Current date: <%= new Date() %>
</UL>


</BODY>
</HTML>

7. Variables Predefinidas

7.1 request

7.2 response

7.3 out

7.4 session

7.5 application

7.6 config

7.7 pageContext

7.8 page

8. Accciones

• jsp:include - Incluye un fichero en el momento de petición de esta página. Ver la Sección 8.1.

• jsp:useBean - Encuentra o ejemplariza un JavaBean. Ver la Sección 8.2 para una introducción, y la Sección 8.3 para los detalles.

• jsp:setProperty - Selecciona la propiedad de un JavaBean. Ver la Sección 8.4.

• jsp:getProperty - Inserta la propiedad de un JavaBean en la salida. Ver la Sección 8.5.

• jsp:forward - Reenvía al peticionario a una nueva página. Ver la Sección 8.6.

• jsp:plugin - Genera código específico del navegador que crea una etiqueta OBJECT o EMBED para el plug-in Java. Ver la Sección 8.7.

8.1 Acción jsp:include

<jsp:include page="relative URL" flush="true" />

WhatsNew.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>What's New</TITLE>
<LINK REL=STYLESHEET
      HREF="My-Style-Sheet.css"
      TYPE="text/css">
</HEAD>

<BODY BGCOLOR="#FDF5E6" TEXT="#000000" LINK="#0000EE"
      VLINK="#551A8B" ALINK="#FF0000">

<CENTER>
<TABLE BORDER=5 BGCOLOR="#EF8429">
  <TR><TH CLASS="TITLE">
      What's New at JspNews.com</TABLE>
</CENTER>
<P>

Here is a summary of our four most recent news stories:
<OL>
  <LI><jsp:include page="news/Item1.html" flush="true"/>
  <LI><jsp:include page="news/Item2.html" flush="true"/>
  <LI><jsp:include page="news/Item3.html" flush="true"/>
  <LI><jsp:include page="news/Item4.html" flush="true"/>
</OL>
</BODY>
</HTML>

8.2 Acción jsp:useBean

<jsp:useBean id="name" class="package.class" />

Ahora, una vez que tenemos un bean, podemos modificar sus propiedades mediante jsp:setProperty, o usando un scriptlet y llamando a un método explícitamente sobre el objeto con el nombre de la variable especificada anteriormente mediante el atributo id. Recuerda que con los beans, cuando decimos "este bean tiene una propiedad del tipo X llamada foo", realmente queremos decir "Esta clase tiene un método getFoo que devuelve algo del tipo X, y otro método llamado setFoo que toma un X como un argumento". La acción jsp:setProperty se describe con más detalle en la siguiente sección, pero ahora observemos que podemos suministrar un valor explícito, dando un atributo param para decir que el valor está derivado del parámetro de la petición nombrado, o sólo lista las propiedades para indicar que el valor debería derivarse de los parámetros de la petición con el mismo nombre que la propiedad. Leemos las propiedades existentes en una expresión o scriptlet JSP llamando al método getXxx, o más comunmente, usando la acción jsp:getProperty.

Observa que la clase especifica por el bean debe estar en el path normal del servidor, no en la parte reservada que obtiene la recarga automática cuando se modifican. Por ejemplo, en el Java Web Server, él y todas las clases que usa deben ir en el directorio classes o estar en un fichero JAR en el directorio lib, no en el directorio servlets.

Aquí tenemos un ejemplo muy sencillo que carga un bean y selecciona y obtiene un sencillo parámetro String.

BeanTest.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Reusing JavaBeans in JSP</TITLE>
<LINK REL=STYLESHEET
      HREF="My-Style-Sheet.css"
      TYPE="text/css">
</HEAD>

<BODY>

<CENTER>
<TABLE BORDER=5>
  <TR><TH CLASS="TITLE">
      Reusing JavaBeans in JSP</TABLE>
</CENTER>
<P>

<jsp:useBean id="test" class="hall.SimpleBean" />
<jsp:setProperty name="test" 
                 property="message" 
                 value="Hello WWW" />
             
<H1>Message: <I>
<jsp:getProperty name="test" property="message" />
</I></H1>
             
</BODY>
</HTML>

SimpleBean.java

package hall;

public class SimpleBean {
  private String message = "No message specified";

  public String getMessage() {
    return(message);
  }

  public void setMessage(String message) {
    this.message = message;
  }
}

8.3 Más detalles de jsp:useBean

<jsp:useBean id="name" class="package.class" />

<jsp:useBean ...> 
Body 
</jsp:useBean>

Atributo	Uso
id	Da un nombre a la variable que referenciará el bean. Se usará un objeto bean anterior en lugar de ejemplarizar uno nuevo si se puede encontrar uno con el mismo id y scope.
class	Designa el nombre completo del paquete del bean.
scope	Indica el contexto en el que el bean debería estar disponible. Hay cuatro posibles valores: page, request, session, y application. El valor por defecto, page, indica que el bean estará sólo disponible para la página actual (almacenado en el PageContext de la página actual). Un valor de request indica que el bean sólo está disponible para la petición actual del cliente (almacenado en el objeto ServletRequest). Un valor de session indica que el objeto está disponible para todas las páginas durante el tiempo de vida de la HttpSession actual. Finalmente, un valor de application indica que está disponible para todas las páginas que compartan el mismo ServletContext. La razón de la importancia del ámbito es que una entrada jsp:useBean sólo resultará en la ejemplarización de un nuevo objeto si no había objetos anteriores con el mismo id y scope. De otra forma, se usarán los objetos existentes, y cualquier elemento jsp:setParameter u otras entradas entre las etiquetas de inicio jsp:useBean y la etiqueta de final, serán ignoradas.
type	Especifica el tipo de la variable a la que se referirá el objeto. Este debe corresponder con el nombre de la clase o ser una superclase o un interface que implemente la clase. Recuerda que el nombre de la variable se designa mediante el atributo id.
beanName	Da el nombre del bean, como lo suministraríamos en el método instantiate de Beans. Esta permitido suministrar un type y un beanName, y omitir el atributo class.

8.4 Acción jsp:setProperty

<jsp:useBean id="myName" ... />
...
<jsp:setProperty name="myName" 
                 property="someProperty" ... />

<jsp:useBean id="myName" ... >
  ...
  <jsp:setProperty name="myName" 
                   property="someProperty" ... />
</jsp:useBean>

Aquí tenemos los cuatro atributos posibles de jsp:setProperty:

Atributo	Uso
name	Este atibuto requerido designa el bean cuya propiedad va a ser seleccionada. El elemento jsp:useBean debe aparecer antes del elemento jsp:setProperty.
property	Este atributo requerido indica la propiedad que queremos seleccionar. Sin embargo, hay un caso especial: un valor de "*" significa que todos los parámetros de la petición cuyos nombres correspondan con nombres de propiedades del Bean serán pasados a los métodos de selección apropiados.
value	Este atributo opcional especifica el valor para la propiedad. Los valores string son convertidos automáticamente a números, boolean, Boolean, byte, Byte, char, y Character mediante el método estándard valueOf en la fuente o la clase envolvente. Por ejemplo, un valor de "true" para una propiedad boolean o Boolean será convertido mediante Boolean.valueOf, y un valor de "42" para una propiedad int o Integer será convertido con Integer.valueOf. No podemos usar value y param juntos, pero si está permitido no usar ninguna.
param	Este parámetro opcional designa el parámetro de la petición del que se debería derivar la propiedad. Si la petición actual no tiene dicho parámetro, no se hace nada: el sistema no pasa null al método seleccionador de la propiedad. Así, podemos dejar que el bean suministre los valores por defecto, sobreescribiendolos sólo cuando el parámetro dice que lo haga. Por ejemplo, el siguiente código dice "selecciona el valor de la propiedad numberOfItems a cualquier valor que tenga el perámetro numItems de la petición, si existe dicho parámetro, si no existe no se hace nada" <jsp:setProperty name="orderBean" property="numberOfItems" param="numItems" /> Si omitimos tanto value como param, es lo mismo que si suministramos un nombre de parámetro que corresponde con el nombre de una propiedad. Podremo tomar esta idea de automaticidad usando el parámetro de la petición cuyo nombre corresponde con la propiedad suministrada un nombre de propiedad de "*" y omitir tanto value como param. En este caso, el servidor itera sobre las propiedades disponibles y los parámetros de la petición, correspondiendo aquellas con nombres idénticos.

Aquí tenemos un ejemplo que usa un bean para crear una tabla de números primos. Si hay un parámetro llamado numDigits en los datos de la petición, se pasa dentro del bean a la propiedad numDigits. Al igual que en numPrimes.

JspPrimes.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Reusing JavaBeans in JSP</TITLE>
<LINK REL=STYLESHEET
      HREF="My-Style-Sheet.css"
      TYPE="text/css">
</HEAD>

<BODY>

<CENTER>
<TABLE BORDER=5>
  <TR><TH CLASS="TITLE">
      Reusing JavaBeans in JSP</TABLE>
</CENTER>
<P>

<jsp:useBean id="primeTable" class="hall.NumberedPrimes" />
<jsp:setProperty name="primeTable" property="numDigits" />
<jsp:setProperty name="primeTable" property="numPrimes" />

Some <jsp:getProperty name="primeTable" property="numDigits" /> 
digit primes: 
<jsp:getProperty name="primeTable" property="numberedList" />

</BODY>
</HTML>

8.5 Acción jsp:getProperty

<jsp:useBean id="itemBean" ... />
...
<UL>
  <LI>Number of items: 
      <jsp:getProperty name="itemBean" property="numItems" />
  <LI>Cost of each:
      <jsp:getProperty name="itemBean" property="unitCost" />
</UL>

8.6 Acción jsp:forward

<jsp:forward page="/utils/errorReporter.jsp" />
<jsp:forward page="<%= someJavaExpression %>" />

8.7 Acción jsp:plugin

9. Convenciones de Comentarios y Caracteres de Escape

Síntaxis	Propósito
<%-- comment --%>	Un comentario JSP. Ignorado por el traductor JSP-a-scriptlet. Cualquier elemento de script, directivas o acciones embebidas son ignorados.
<!-- comment -->	Un comentario HTML. Se pasa al HTML resultante. Cualquier elemento de script, directivas o acciones embebidas se ejecutan normalmente.
<\%	Usado en plantillas de texto (HTML estático) donde realmente queremos "<%".
%\>	Usado en elementos de script donde realmente queremos "%>".
\'	Una sola comilla en un atributo que usa comillas simples. Sin embargo, recuerda que podemos usar comillas dobles o simples, y que otros tipos de comillas serán caracteres regulares.
\"	Una doble comilla un un atributo que usa comillas dobles. Sin embargo, recuerda que podemos usar comillas dobles o simples, y que otros tipos de comillas serán caracteres regulares.
%\>	%> en un atributo.
<\%	<% en un atributo.

Ozito