1
Download 4.4 Tutorial de JSP 2.0, JSTL y Jakarta Struts
Document related concepts
no text concepts found
Transcript
4.4 Tutorial de JSP 2.0, JSTL y Jakarta
Struts
JSP 2.0 (1)
¿Qué añade JSP 2.0 frente a JSP 1.x?
Lenguaje de expresiones
“Documentos JSP”
Anteriormente sólo estaba disponible en JSTL
Páginas JSP en sintaxis XML
JSP 1.2 también permitía escribir documentos JSP, pero de una
manera más incómoda
Implementar tags a medida utilizando la propia tecnología
JSP
Se implementan en páginas JSP
Más sencillo que el API de extensión de tags
(javax.servlet.jsp.tagext), pero menos potente
Útil para tags orientados a presentación, para tags que hagan
uso de librerías existentes y para desarrolladores de páginas
JSP que no dispongan de conocimientos de Java
JSP 2.0 (y 2)
Compatibilidad con JSP 1.x
Un contenedor de JSP 2.0 tiene que poder ejecutar
aplicaciones con sintaxis JSP 1.x
Es posible migrar una aplicación JSP 1.x a sintaxis JSP 2.0
página a página
En este apartado, y en los dos siguientes, se ilustran
la sintaxis de los documentos JSP y el lenguaje de
expresiones
Lenguaje de expresiones (1)
En JSP 1.x si se desea dar valor a un atributo de un
tag, es preciso usar una expresión <%= ... %>
Ejemplo
<jsp:useBean id="shoppingCart" scope="session"
class="org.acme.ShoppingCart"/>
<xxx:if test="<%= shoppingCart.getNumberOfProducts() > 0 %>">
...
</xxx:if>
JSP 2.0 proporciona un lenguaje de expresiones para
facilitar su construcción
Ejemplo
<xxx:if test="${sessionScope.shoppingCart.numberOfProducts > 0}">
...
</xxx:if>
Lenguaje de expresiones (2)
Expresiones y literales
Las expresiones tienen que ir rodeadas por ${ y }.
Cualquier valor que no empiece por ${, se considera un
literal
Los literales que incluyen el símbolo ${, han de escaparlo
rodeándolo de ${' y '}
Ejemplo:
<xxx:aTag att="This literal includes ${'${'} character"/>
Acceso a atributos de objetos Java en expresiones
Se puede acceder a las propiedades de un JavaBean, y a
objetos de un Map, List o vector
Lenguaje de expresiones (3)
Acceso a atributos de objetos Java en expresiones
(cont)
Ejemplos
${user.firstName} = user.getFirstName()
${user.address.city} = user.getAddress().getCity()
${user.preferencesMap["shipping"]} =
user.getPreferencesMap().get("shipping")
${user.preferencesList[0]} = user.getPreferencesList().get(0)
Unifica el tratamiento de los operadores . y []
${user.firstName} es
equivalente a ${user["firstName"]}
${user.preferencesMap["shipping"]} es equivalente a
${user.preferencesMap.shipping}
Para determinados casos, es preciso usar el operador []
${user.preferencesMap["book.fiction"]} es equivalente
user.getPreferencesMap().get("book.fiction")
a
${user.preferencesMap[product.category]} es equivalente
user.getPreferencesMap().get(product.getCategory())
a
Lenguaje de expresiones (4)
Objetos implícitos
Entre otros
pageScope (Map)
requestScope (Map)
sessionScope (Map)
applicationScope (Map)
param (Map que mapea nombres de parámetros univaluados a
String)
paramValues (Map que mapea nombres de parámetros
multivaluados a String[])
Cuando se usa un objeto sin especificar su ámbito (el objeto
implícito en el que está contenido), se busca en los ámbitos
page, request, session y application (en este orden)
Ejemplo
<xxx:if test="${shoppingCart.numberOfProducts > 0}">
...
</xxx:if>
Lenguaje de expresiones (y 5)
Literales
Boolean (true y false)
Numéricos
Cadenas de caracteres (entre comillas simples o dobles)
null
Operadores
Aritméticos: +,-, *, /, div, %, mod
Lógicos: &&, and, ||, or, !, not
Relacionales: ==, eq, !=, ne, <, lt, >, gt, <=, le, >=, ge
empty: permite comprobar si un valor es null
Ejemplos
<xxx:if test="${!empty requestScope.previous}">
...
</xxx:if>
<xxx:if test="${sessionScope.shoppingCart.numberOfProducts > 0}">
...
</xxx:if>
Se pueden usar paréntesis
JSTL (1)
En el pasado existían numerosas librerías de tags JSP
que permitían
Iterar sobre colecciones
Imprimir valores de propiedades de JavaBeans de forma
segura
Internacionalización de mensajes, números, fechas, etc.
Generación de URLs aplicando URL rewriting
Acceso a documentos XML
Etc
Por ello, se decidió estandarizar una librería general
de tags, llamada JSTL (JSP Standard Tag Library)
JSTL (2)
Tags en JSTL
Core
I18n (internacionalización)
Control de flujo
Soporte para URLs
Soporte para internacionalización: establecimiento del Locale,
generación de mensajes, formateo de números, cantidades
monetarias, fechas, etc.
XML
Parsing de un documento XML
Flujo de control para recorrer un documento XML (alternativa a
XSL para casos sencillos)
Tags para lanzar transformaciones XSL
JSTL (y 3)
Tags en JSTL (cont)
Acceso a BDs
Funciones
JSP 2.0 define un mecanismo para añadir funciones al
lenguaje de expresiones
JSTL 1.1 define un conjunto de funciones estándar
Permiten lanzar sentencias SQL a BDs relacionales
Sólo deberían usarse para prototipado rápido o
aplicaciones muy simples
length (aplicable a Collection y String), toLowerCase,
toUpperCase, substring, contains, etc
En este apartado y en los dos siguientes se ilustran
parte de los tags de los grupos Core e I18n
¿ Qué es Struts ?
Framework OpenSource para implementar
aplicaciones web con servlets y JSP según el patrón
arquitectónico Model-View-Controller
Subproyecto de Jakarta
Autor original: Craig R. McClanahan
Funciona sobre cualquier servidor de aplicaciones
web que implemente las APIs de servlets y JSP
Ha ganado gran relevancia en el mundo de las
aplicaciones web Java
Versión 1.0 estable en Julio 2001
Posteriormente, surgieron otros framework MVC
¿ Qué proporciona Struts ?
Un framework que da soporte para implementar las
capas controlador y vista de una aplicación web
Servlet Front Controller y clases relacionadas
Sistema de plantillas
Validación de parámetros
Una librería de tags JSP muy completa
El patrón Front Controller en Struts (1)
javax.servlet.http.HttpServlet
org.apache.struts.action.ActionServlet
0..n
# doGet
# doPost
org.apache.struts.action.Action
+ execute
<<use>> <<instantiate>>
org.apache.struts.action.ActionForm
+ reset
+ validate
ActionForm1
Action1
...
...
ActionFormN
<<use>>
ActionN
El patrón Front Controller en Struts (2)
ActionServlet
Servlet Front Controller
En web.xml se especifica que todas las URLs que impliquen
procesamiento (por GET o POST) vayan a este servlet
Clases ActionForm
Si el programador lo desea, puede acceder a los parámetros de la
request a través de un JavaBean que extiende ActionForm
Ej.: las URLs que termine en .do
Especialmente útil en formularios
Clase Action => método execute
Accede a los parámetros de la request, directamente o vía el
ActionForm correspondiente
Realiza la operación invocando un método de un Session
Facade del modelo o una fachada del controlador
Deja el resultado devuelto por el método en la request o en la
sesión
Devuelve un objeto ActionForward, que representa la URL que
hay que visualizar a continuación (sendRedirect o forward)
El patrón Front Controller en Struts (3)
Fichero de configuración
Clases ActionForm que usa nuestra aplicación
Nombre lógico (ej.: loginForm)
Nombre completo de la clase (ej.:
es.udc.fbellas.j2ee.strutstutorial.portal3.http
.view.actionforms.LoginForm)
URLs que implican procesamiento
URL de tipo path relativo a contexto (ej.: /Login)
No llevan el .do final
Nombre completo de la clase Action (ej.:
es.udc.fbellas.j2ee.strutstutorial.portal3.http
.controller.actions.LoginAction)
Nombre lógico de la clase ActionForm asociada
El patrón Front Controller en Struts (y 4)
Fichero de configuración (cont)
Definiciones de nombres lógicos de URLs
Nombre que usan las acciones cuando devuelven un
ActionForward (ej.: ShowMainPage)
sendRedirect o forward
URL a invocar (ej.: /MainPage.jsp)
Cuando el servlet ActionServlet arranca (init), lee el
fichero de configuración
Crea una única instancia de cada clase Action
No se crea una instancia de una clase Action por cada
petición que se recibe
Tienen que ser thread-safe
Misma situación que cuando se trabaja con servlets
La librería de tags de Struts (1)
Bean
Logic
Imprimir el valor de las propiedades de JavaBeans de
manera segura
Soporte para internacionalización de mensajes
No los usaremos, dado que JSTL ofrece una alternativa
estándar
Control de flujo
No los usaremos, dado que JSTL ofrece una alternativa
estándar
HTML
Generación de HTML básico
Campos de entrada en formularios
Enlaces (con URL rewriting)
La librería de tags de Struts (y 2)
Tiles
Caso particular del patrón Composite View
Sistema de plantillas para páginas JSP
Reemplaza a Template
El sistema de plantillas que se usaba con Struts 1.0
Arquitectura MVC con Struts
Modelo
Controlador
Clases independientes de la vista y el controlador
Conjunto de clases Action
Interactúan con el modelo y seleccionan la siguiente vista
(dejándole los datos en uno de los cuatro posibles ámbitos,
normalmente request o session)
Vista
Conjunto de clases ActionForm
Conjunto de páginas JSP
No contienen código Java
Sólo visualizan datos
Usan acciones JSP para recuperar los valores a mostrar y
formatearlos
Demo Portal-3 (1)
Lanzar el navegador
Acceder a Portal-3 main page
Demo Portal-3 (2)
Clic en Login
Clic en el botón “Login”
Demo Portal-3 (3)
Clic en Logout
Terminar y lanzar el navegador dos días más tarde
Acceder a Portal-3 main page
Portal-3 main page
(Welcome to Portal-3)
Demo Portal-3 (4)
Este ejemplo, al igual que los siguientes, usa XHTML
1.0 Estricto y CSS 2.0
XHTML
Versión XML de HTML (ej.: todos los tags tienen que
cerrarse, los valores de los atributos tienen que
entrecomillarse, tags en minúsculas, etc)
CSS
El XHTML generado sólo contiene contenido estructurado
El formato (fuentes, colores, posicionamiento, etc) se
especifica en una hoja (fichero) de estilos CSS
El aspecto gráfico de la aplicación puede cambiarse
modificando la hoja CSS
Demo Portal-3 (y 5)
CSS (cont)
También puede ser interesante tener un conjunto de hojas
CSS con distintos formatos para una misma aplicación web
Visualización en ordenador de sobremesa
Visualización en PDA (ej.: no muestra o resume cabecera,
sidebar y pié de página)
“Printer-friendly pages”
Etc
Se procura huir del uso de tablas, excepto para la
presentación de datos que siempre han de
visualizarse de manera tabular (ej.: las cuentas de un
usuario en una aplicación bancaria)
CSS tiene sus propios mecanismos de posicionamiento
Estructura de paquetes
es.udc.fbellas.j2ee.util.struts.action
es.udc.fbellas.j2ee.strutstutorial.portal3
http
controller
actions
view
actionforms
messages
model
userfacade
delegate
exceptions
jar tvf StrutsTutorial.war (1)
Index.jspx
InternalError.jspx
Login.jspx
MainPage.jspx
css/styles.css
WEB-INF/Struts/struts-config.xml
WEB-INF/lib/jstl.jar
WEB-INF/lib/standard.jar
WEB-INF/lib/antlr.jar
WEB-INF/lib/commons-*.jar
WEB-INF/lib/jakarta-oro.jar
WEB-INF/lib/struts.jar
WEB-INF/lib/StandardUtil.jar
WEB-INF/lib/WebUtil.jar
jar tvf StrutsTutorial.war (y 2)
WEB-INF/classes/es/udc/fbellas/j2ee/strutstutorial/portal3/http/
controller/actions/LoginAction.class
WEB-INF/classes/es/udc/fbellas/j2ee/strutstutorial/portal3/http/
controller/actions/LoginManager.class
WEB-INF/classes/es/udc/fbellas/j2ee/strutstutorial/portal3/http/
controller/actions/LogoutAction.class
WEB-INF/classes/es/udc/fbellas/j2ee/strutstutorial/portal3/http/
controller/actions/MainPageAction.class
WEB-INF/classes/es/udc/fbellas/j2ee/strutstutorial/portal3/http/view/
actionforms/LoginForm.class
WEB-INF/classes/es/udc/fbellas/j2ee/strutstutorial/portal3/model/
userfacade/delegate/UserFacadeDelegate.class
WEB-INF/classes/es/udc/fbellas/j2ee/strutstutorial/portal3/model/
userfacade/exceptions/IncorrectPasswordException.class
WEB-INF/classes/es/udc/fbellas/j2ee/strutstutorial/portal3/http/view/
messages/Messages.properties
WEB-INF/web.xml
Comentarios (1)
Documentos JSP
Existen varios métodos para especificar que una página JSP
es un documento JSP
Quizás la manera más natural consiste en usar un descriptor
de la aplicación web conforme a Servlet 2.4 (como ya
hicimos en anteriores apartados) y usar jspx como
extensión de las páginas JSP que sean documentos JSP
WEB-INF/Struts
struts-config.xml: configuración de Struts para la
aplicación del tutorial
Comentarios (y 2)
WEB-INF/lib
struts.jar, commons-*.jar: Struts
standard.jar, jstl.jar, jakarta-oro.jar,
antlr.jar: Jakarta Standard TagLibs (implementación
OpenSource de JSTL)
StandardUtil.jar y WebUtil.jar: subsistema Util de
J2EE-Examples
WEB-INF/classes/es/.../Messages.properties
Internacionalización de mensajes
WEB-INF/web.xml (1)
<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">
<distributable/>
<!-- =============== Standard TagLibs configuration ============= -->
<context-param>
<param-name>javax.servlet.jsp.jstl.fmt.localizationContext
</param-name>
<param-value>es.udc.fbellas.j2ee.strutstutorial.portal3.http.
view.messages.Messages</param-value>
</context-param>
WEB-INF/web.xml (2)
<!-- ================= Front controller configuration =========== -->
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>org.apache.struts.action.ActionServlet
</servlet-class>
<init-param>
<param-name>config</param-name>
<param-value>/WEB-INF/Struts/struts-config.xml</param-value>
</init-param>
<init-param>
<param-name>debug</param-name>
<param-value>2</param-value>
</init-param>
<init-param>
<param-name>detail</param-name>
<param-value>2</param-value>
</init-param>
<load-on-startup>2</load-on-startup>
</servlet>
WEB-INF/web.xml (y 3)
<!-- ================ Servlet mapping =========================== -->
<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
<!-- ======================== Session =========================== -->
<session-config>
<session-timeout>30</session-timeout>
</session-config>
<!-- ==================== Welcome page ========================== -->
<welcome-file-list>
<welcome-file>Index.jspx</welcome-file>
</welcome-file-list>
</web-app>
Comentarios (1)
context-param
Permite definir un parámetro de configuración global a toda
la aplicación web
Accesible vía
Servlet.getServletConfig().getServletContext
().getInitParameter()
En el ejemplo se utiliza para dar valor al parámetro de
configuración
javax.servlet.jsp.jstl.fmt.localizationContext
Lo usan los tags de internacionalización de mensajes de JSTL
Nombre del fichero de mensajes (sin sufijo .properties)
Debe estar debajo de WEB-INF/classes y usar un nombre
consistente con su ubicación (como si de una clase se tratase)
Comentarios (2)
Servlet org.apache.struts.actions.ActionServlet
Aparecen dos tags que no hemos usado hasta ahora
init-param
Permite definir un parámetro de configuración específico al servlet
y su valor
Accesible vía
Servlet.getServletConfig().getInitParameter()
load-on-startup
Indica que el servlet se debería cargar cuando el servidor
arranque la aplicación web
El valor (opcional) indica el orden relativo de carga con respecto a
otros servlets (cuanto menor sea el valor, antes se carga)
Comentarios (y 3)
Servlet org.apache.struts.actions.ActionServlet
Parámetros de inicialización
config
detail
Path de tipo relativo a contexto del fichero de configuración de
Struts
Nivel de detalle en los mensajes de depuración durante el parsing
de los ficheros de configuración
debug
Nivel de detalle en los mensajes de depuración de
ActionServlet
WEB-INF/Struts/struts-config.xml (1)
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE struts-config PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 1.2//EN"
"http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd">
<struts-config>
<!-- ============ Form Bean Definitions =========================== -->
<form-beans>
<form-bean name="loginForm"
type="es.udc.fbellas.j2ee.strutstutorial.portal3.http.view.
actionforms.LoginForm"/>
</form-beans>
WEB-INF/Struts/struts-config.xml (2)
<!-- ============ Global Forward Definitions ====================== -->
<global-forwards>
<forward name="MainPage" path="/MainPage.do" redirect="true"/>
<forward name="InternalError" path="/InternalError.jspx"
redirect="true"/>
</global-forwards>
<!-- ============ Action Mapping Definitions ====================== -->
<action-mappings>
<action path="/MainPage"
type="es.udc.fbellas.j2ee.strutstutorial.portal3.http.
controller.actions.MainPageAction">
<forward name="ShowMainPage" path="/MainPage.jspx"/>
</action>
<action path="/Login"
type="es.udc.fbellas.j2ee.strutstutorial.portal3.http.
controller.actions.LoginAction"
name="loginForm" scope="request" input="/Login.jspx"
validate="true"/>
WEB-INF/Struts/struts-config.xml (y 3)
<action path="/Logout"
type="es.udc.fbellas.j2ee.strutstutorial.portal3.http.
controller.actions.LogoutAction"/>
<!-- ==============================================================
The standard administrative actions available with Struts.
These must be either omitted or protected by security in a real
application deployment.
================================================================ -->
<action path="/admin/addFormBean"
type="org.apache.struts.actions.AddFormBeanAction"/>
...
</action-mappings>
<!-- ============ Message Resources Definitions =================== -->
<message-resources parameter="es.udc.fbellas.j2ee.strutstutorial.
portal3.http.view.messages.Messages"/>
</struts-config>
Comentarios (1)
En el fichero struts-config.xml se usa
<!DOCTYPE struts-config PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 1.2//EN"
"http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd">
El especificador PUBLIC permite especificar un identificador
y una URI para la ubicación del DTD
El procesador del documento XML (en este caso, Struts)
puede usar el identificador para recuperar un DTD
localmente almacenado, y en consecuencia, no usar la URI
especificada
struts.jar incluye el DTD
Comentarios (2)
Definiciones de nombres lógicos de URLs
Se usan en la implementación de las acciones para devolver
un ActionForward y en algunas acciones JSP
Se especifican con forward
Atributos documentados en JavaDoc de
org.apache.struts.action.ActionForward
name: nombre lógico
path: path relativo a contexto de la URL a la que se invocará
redirect: true (sendRedirect) o false (forward)
false por defecto
Pueden ser globales (global-forwards) o particulares a
una acción (action)
Comentarios (3)
action
Atributos documentados en JavaDoc de
org.apache.struts.config.ActionConfig
type: nombre completo de la clase Action
path: URL (path relativo a contexto) que provocará la
invocación de la acción
name: nombre del ActionForm (definido por form-bean)
que captura los parámetros de la invocación
scope: ámbito (request o session) del ActionForm
¡ Se especifican sin el sufijo .do !
En general, request
input: path relativo a contexto del formulario de entrada
validate: true si el Front Controller tiene que llamar al
método validate del ActionForm
En general, true
Comentarios (y 4)
message-resources
Especifica la ubicación del fichero de mensajes
Actualmente Struts no está integrado con JSTL
WEB-INF/classes/es/.../Messages.properties (1)
Buttons.login=Login
ErrorMessages.loginName.notFound=Login name not found
ErrorMessages.mandatoryField=Mandatory field
ErrorMessages.password.incorrect=Incorrect password
ErrorMessages.retry=Please, check if the operation has been performed, \
and retry if necessary
errors.footer=</span>
errors.header=<span class="errorMessage">
InternalError.title=Internal error
WEB-INF/classes/es/.../Messages.properties (y 2)
Login.loginName=Login name
Login.password=Password
Login.rememberMyPassword=Remember my password (cookies must be enabled)
Login.title=Portal-3 login form
MainPage.hello=Hello
MainPage.login=Login
MainPage.logout=Logout
MainPage.title=Portal-3 main page
MainPage.welcome=Welcome to Portal-3
Comentarios (1)
Asocia pares <identificadorMensaje, mensaje>
Messages.properties
Convenios de nombrado para los identificadores de mensajes
Ordenados alfabéticamente
errors.footer y errors.header son dos identificadores
especiales que entiende la acción html:errors de Struts
Mensajes en el lenguaje por defecto del servidor
Messages_xx.properties
Mensajes en el lenguaje cuyo código ISO es xx
Códigos ISO en
http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt
en: Inglés
es: Español
gl: Gallego
Etc
Comentarios (y 2)
Messages.properties sólo resuelve un aspecto
particular de la internacionalización de aplicaciones:
impresión de mensajes en distintos idiomas
En una aplicación más compleja puede ser necesario tener
trozos de páginas en distintos idiomas (con gran cantidad de
texto estático) y seleccionarlos o incluirlos dinámicamente
en función del idioma
Otros aspectos en internacionalización
Formatear y tratar fechas, horas, números, cantidades
monetarias
JSTL proporciona tags para ello
También paquetes java.text y java.util
Puede requerir tablas para almacenar contenido en distintos
idiomas
Ej.: un servicio de noticias
es.udc.fbellas.j2ee.strutstutorial.portal3.model.userfacade.delegate
UserFac adeDelegate
+ UserFacadeDelegate()
+ login(l oginNam e : S tring, password : S t ri ng, pas swordIsE ncrypte d : boo lean) : void
Simula la fachada del modelo que proporciona las
operaciones relativas a la interacción del usuario con
el portal
es.udc.fbellas.j2ee.util.struts.action
A ction
(from action)
Def aul tA ct io n
+ execute(actionM apping, actionForm , request, response) : A ctionForward
# doE xecute(actionMapping, actionForm , request, response) : A ctionForward
# doOnInternalE rror(actionM apping, actionForm , request, response, internalE rrorE xception) : A ctionForw...
P rope rt yV alidat or
Comentarios
DefaultAction
Problema
Es necesario (1) capturarla, (2) imprimirla en un log (para
depuración) e (3) ir a una página que indique error interno
Las clases Action derivarán de DefaultAction
En general, las clases Action invocarán una operación sobre
un Business Delegate del modelo o una fachada del
controlador, que puede lanzar InternalErrorException
Implementa execute (Template Method) en términos de
doExecute y doOnInternalError
Las clases hijas implementan doExecute, que tiene la misma
signatura que execute, pero puede lanzar adicionalmente
InternalErrorException
PropertyValidator
Clase utilidad para validar campos de entrada comunes
(double, long, String, etc.)
es.udc.fbellas.j2ee.util.struts.action.DefaultAction (1)
package es.udc.fbellas.j2ee.util.struts.action;
import
import
import
import
import
import
import
import
import
java.io.IOException;
javax.servlet.ServletContext;
javax.servlet.http.HttpServletRequest;
javax.servlet.http.HttpServletResponse;
javax.servlet.ServletException;
org.apache.struts.action.Action;
org.apache.struts.action.ActionMapping;
org.apache.struts.action.ActionForm;
org.apache.struts.action.ActionForward;
import es.udc.fbellas.j2ee.util.exceptions.InternalErrorException;
es.udc.fbellas.j2ee.util.struts.action.DefaultAction (2)
public abstract class DefaultAction extends Action {
public ActionForward execute(ActionMapping mapping,
ActionForm form, HttpServletRequest request,
HttpServletResponse response)
throws IOException, ServletException {
try {
return doExecute(mapping, form, request, response);
} catch (InternalErrorException e) {
return doOnInternalErrorException(mapping, form, request,
response, e);
}
}
protected abstract ActionForward doExecute(ActionMapping mapping,
ActionForm form, HttpServletRequest request,
HttpServletResponse response)
throws IOException, ServletException, InternalErrorException;
es.udc.fbellas.j2ee.util.struts.action.DefaultAction (y 3)
protected ActionForward doOnInternalErrorException(
ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response,
InternalErrorException internalErrorException)
throws IOException, ServletException {
/*
* Log error, even with debug level <= 0, because it is a
* severe error.
*/
ServletContext servletContext =
servlet.getServletConfig().getServletContext();
servletContext.log(internalErrorException.getMessage(),
internalErrorException);
/* Redirect to input page. */
return mapping.findForward("InternalError");
}
}
es.udc.fbellas.j2ee.util.struts.action.PropertyValidator (1)
public final class PropertyValidator {
private final static String INCORRECT_VALUE =
"ErrorMessages.incorrectValue";
private final static String MANDATORY_FIELD =
"ErrorMessages.mandatoryField";
private PropertyValidator() {}
public final static long validateLong(ActionErrors errors,
String propertyName, String propertyValue, boolean mandatory,
long lowerValidLimit, long upperValidLimit) {
long propertyValueAsLong = 0;
if (validateMandatory(errors, propertyName, propertyValue,
mandatory)) {
boolean propertyValueIsCorrect = true;
es.udc.fbellas.j2ee.util.struts.action.PropertyValidator (2)
try {
propertyValueAsLong =
new Long(propertyValue).longValue();
if ( (propertyValueAsLong < lowerValidLimit) ||
(propertyValueAsLong > upperValidLimit) ) {
propertyValueIsCorrect = false;
}
} catch (NumberFormatException e) {
propertyValueIsCorrect = false;
}
if (!propertyValueIsCorrect) {
errors.add(propertyName,
new ActionMessage(INCORRECT_VALUE));
}
}
return propertyValueAsLong;
}
es.udc.fbellas.j2ee.util.struts.action.PropertyValidator (y 3)
public final static boolean validateMandatory(ActionErrors errors,
String propertyName, String propertyValue) {
if ((propertyValue == null) || (propertyValue.length() == 0)) {
errors.add(propertyName, new ActionMessage(MANDATORY_FIELD));
return false;
} else {
return true;
}
}
private final static boolean validateMandatory(ActionErrors errors,
String propertyName, String propertyValue, boolean mandatory) {
if (mandatory) {
return validateMandatory(errors, propertyName,
propertyValue);
} else {
return true;
}
}
// Resto de métodos validateXXX => Análogos ...
}
Comentarios
org.apache.struts.action.ActionMapping
Permite acceder a los valores configurados en strutsconfig.xml para la acción en ejecución (inclusive a los forwards
globales)
org.apache.struts.action.ActionErrors
Juega el papel del mapa de errores que hemos empleado en
apartados anteriores
El mensaje de error es un
org.apache.struts.action.ActionMessage, que dispone
de un constructor que permite especificar el identificador del
mensaje de error (en Messages.properties)
ActionMessage se introdujo en Struts 1.2, y reemplaza a
ActionError
org.apache.struts.action.ActionForward
Representa la siguiente URL a la que hay que ir
El Front Controller lo invocará después de llamar al método
execute sobre la acción
es.udc.fbellas.j2ee.strutstutorial.portal3.http.view.actionforms.LoginForm (1)
public class LoginForm extends ActionForm {
private String loginName;
private String password;
private boolean rememberMyPassword;
public LoginForm() {
reset();
}
public String getLoginName() {
return loginName;
}
public void setLoginName(String loginName) {
this.loginName = loginName.trim();
}
es.udc.fbellas.j2ee.strutstutorial.portal3.http.view.actionforms.LoginForm (2)
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public boolean getRememberMyPassword() {
return rememberMyPassword;
}
public void setRememberMyPassword(boolean rememberMyPassword) {
this.rememberMyPassword = rememberMyPassword;
}
es.udc.fbellas.j2ee.strutstutorial.portal3.http.view.actionforms.LoginForm (y 3)
public void reset(ActionMapping mapping, HttpServletRequest request) {
reset();
}
public ActionErrors validate(ActionMapping mapping,
HttpServletRequest request) {
ActionErrors errors = new ActionErrors();
PropertyValidator.validateMandatory(errors, "loginName", loginName);
PropertyValidator.validateMandatory(errors, "password", password);
return errors;
}
private void reset() {
loginName = null;
password = null;
rememberMyPassword = false;
}
}
Comentarios
LoginForm
Juega el mismo papel que la clase vista en el apartado 4.2
Hereda de org.apache.struts.action.ActionForm
Generalmente interesa redefinir reset y validate
reset
El Front Controller lo llama antes de dar valor a las propiedades
validate
Permite validar las propiedades después de que el Front
Controller les haya dado valores
Sólo se invoca si se ha especificado validate="true" para
la acción correspondiente en struts-config.xml
Si devuelve un ActionErrors no vacío, el Front Controller (1)
no invocará el método execute sobre la acción
correspondiente, (2) insertará un atributo con los errores en la
request, y (3) hará un forward a la URL que especifica el
atributo input del action correspondiente en strutsconfig.xml (formulario de entrada)
es.udc.fbellas.j2ee.strutstutorial.portal3.http.controller.actions
Defaul tAc tion
(from ac tion)
M ai nP ageA c t ion
< < us e> >
LoginA c t ion
< <us e>>
LogoutA c tion
< < use> >
LoginM anager
<< us e>>
Us erFacadeDelegate
(from delegate)
es.udc.fbellas.j2ee.strutstutorial.portal3.http.controller.actions.LoginAction (1)
public class LoginAction extends DefaultAction {
public ActionForward doExecute(ActionMapping mapping,
ActionForm form, HttpServletRequest request,
HttpServletResponse response)
throws IOException, ServletException, InternalErrorException {
/* Get data. */
LoginForm loginForm = (LoginForm) form;
String loginName = loginForm.getLoginName();
String password = loginForm.getPassword();
boolean rememberMyPassword = loginForm.getRememberMyPassword();
/* Do login. */
ActionMessages errors = new ActionMessages();
es.udc.fbellas.j2ee.strutstutorial.portal3.http.controller.actions.LoginAction (y 2)
try {
LoginManager.login(request, response, loginName, password,
rememberMyPassword);
} catch (InstanceNotFoundException e) {
errors.add("loginName", new ActionMessage(
"ErrorMessages.loginName.notFound"));
} catch (IncorrectPasswordException e) {
errors.add("password", new ActionMessage(
"ErrorMessages.password.incorrect"));
}
/* Return ActionForward. */
if (errors.isEmpty()) {
return mapping.findForward("MainPage");
} else {
saveErrors(request, errors);
return new ActionForward(mapping.getInput());
}
}
}
Comentarios
Las acciones utilizan el método saveErrors
(heredado de org.struts.apache.action.Action)
para insertar un atributo con los errores en la
request
org.apache.struts.action.ActionMessages
Se introdujo en Struts 1.2
Similar a ActionErrors
Existen dos versiones del método saveErrors, una que
acepta ActionErrors (“deprecated”) y otra que acepta
ActionMessages (el usado en el ejemplo)
es.udc.fbellas.j2ee.strutstutorial.portal3.http.controller.actions.LogoutAction
public class LogoutAction extends DefaultAction {
public ActionForward doExecute(ActionMapping mapping,
ActionForm form, HttpServletRequest request,
HttpServletResponse response)
throws IOException, ServletException, InternalErrorException {
/* Do logout. */
LoginManager.logout(request, response);
/* Return ActionForward. */
return mapping.findForward("MainPage");
}
}
MainPage.jspx (1)
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:jsp="http://java.sun.com/JSP/Page"
xmlns:fmt="http://java.sun.com/jsp/jstl/fmt"
xmlns:html="http://struts.apache.org/tags-html"
xmlns:c="http://java.sun.com/jsp/jstl/core">
<jsp:output doctype-root-element="html"
doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN"
doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
omit-xml-declaration="true" />
<jsp:directive.page contentType="text/html; charset=iso-8859-1" />
<head>
<title><fmt:message key="MainPage.title" /></title>
<c:url var="stylesURL" value="/css/styles.css" />
<link rel="StyleSheet" href="${stylesURL}"
type="text/css" media="all" />
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1" />
</head>
<body>
MainPage.jspx (2)
<!-- Welcome -->
<div id="header">
<c:choose>
<c:when test="${empty sessionScope.loginName}">
<fmt:message key="MainPage.welcome" />
</c:when>
<c:otherwise>
<fmt:message key="MainPage.hello" />
<c:out value=" ${sessionScope.loginName}" />
</c:otherwise>
</c:choose>
</div>
MainPage.jspx (y 3)
<!-- Links to Login or Logout -->
<p>
<c:choose>
<c:when test="${empty sessionScope.loginName}">
<c:url var="loginURL" value="Login.jspx" />
<a href="${loginURL}">
<fmt:message key="MainPage.login" />
</a>
</c:when>
<c:otherwise>
<html:link action="Logout.do">
<fmt:message key="MainPage.logout" />
</html:link>
</c:otherwise>
</c:choose>
</p>
</body>
</html>
Comentarios (1)
La página JSP es un documento XML bien formado
Importación de librerías
En el tag raíz aprovechamos para importar las librerías de
tags que se precisan, especificando sus espacios de nombres
El espacio de nombres por defecto es el correspondiente a
los tags de XHTML (http://www.w3.org/1999/xhtml)
Librerías
http://java.sun.com/JSP/Page (jsp)
http://java.sun.com/jsp/jstl/fmt (fmt)
Tags I18n de JSTL
http://struts.apache.org/tags-html (html)
Tags estándar de JSP (proporcionados por el contenedor)
Tags HTML de Struts
http://java.sun.com/jsp/jstl/core (c)
Tags Core de JSTL
Comentarios (2)
Importación de librerías (cont)
Cuando se importa una librería, el contenedor busca
automáticamente su descriptor (fichero .tld) en
WEB-INF (y sus subdirectorios)
En los ficheros .jar que usa la aplicación
Dentro del fichero .jar busca debajo de META-INF (y sus
subdirectorios)
El descriptor especifica, entre otras cosas,
La URI del espacio de nombres (que es lo que utiliza el
contenedor para saber que éste es el descriptor de la librería)
Los nombres de los tags que proporciona la librería y los
nombres de las clases que los implementan
En el servlet generado por el contenedor, por cada aparición de
un tag de una librería, se crea una instancia la clase
correspondiente y se invocan los métodos necesarios a través
de un interfaz estándar
Comentarios (3)
Importación de librerías (cont)
Cuando el contenedor encuentra un tag no JSP (ej.: html),
que importa librerías JSP (ej.: xlmns:fmt="... "), en la
respuesta generada no incluye los xlmns:xxx
correspondientes
Ej.: Para ...
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:jsp="http://java.sun.com/JSP/Page"
xmlns:fmt="http://java.sun.com/jsp/jstl/fmt"
xmlns:html="http://struts.apache.org/tags-html"
xmlns:c="http://java.sun.com/jsp/jstl/core">
... genera ...
<html xmlns="http://www.w3.org/1999/xhtml">
Comentarios (4)
En MainPage.jspx se utiliza
<jsp:output doctype-root-element="html"
doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN"
doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
omit-xml-declaration="true" />
... lo que genera ...
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
... y se genera en el lugar adecuado, es decir, antes de que
se genere el tag raíz html
omit-xml-declaration="true" provoca que no se
genere la declaración XML
Por defecto, el contenedor añade la declaración XML al
principio del documento generado por un documento JSP
Lo lógico sería generar la declaración XML (dado que todo
documento XML debería tenerla), sin embargo causa
problemas en algunos navegadores
Comentarios (5)
Tags jsp:directive.XXX
Equivalentes a las directivas <%@ XXX ... %>, con sus
mismos atributos
En MainPage.jspx se utiliza
<jsp:directive.page contentType="text/html; charset=iso-8859-1" />
Permite especificar el contentType de la respuesta HTTP
En un documento JSP, el contentType por defecto es
text/xml, lo que provoca que algunos navegadores (ej.:
Internet Explorer) visualicen la respuesta como un documento
XML (y no como una página HTML)
En una página JSP (que no sea un documento JSP), el
contentType por defecto es text/html, y por eso nunca lo
hemos tenido que especificar en los ejemplos anteriores
Comentarios (6)
En el ejemplo se usa
<c:url var="stylesURL" value="/css/styles.css" />
<link rel="StyleSheet" href="${stylesURL}"
type="text/css" media="all" />
Alternativamente se podría haber usado
<link rel="StyleSheet" href="css/styles.css"
type="text/css" media="all" />
Pero esto resultaría tedioso y propenso a errores en una
aplicación web grande con páginas JSP en directorios con
cierto nivel de anidamiento (ej.:
href="../../../css/styles.css")
Usar
<link rel="StyleSheet" href="/css/styles.css"
type="text/css" media="all" />
No funcionaría, dado que la URL /css/styles.css no
existe
Comentarios (7)
Usar
<link rel="StyleSheet" href="/StrutsTutorial/css/styles.css"
type="text/css" media="all" />
Sería una mala idea, dado que el administrador del servidor
de aplicaciones web podría querer instalar la aplicación web
con otro nombre
El ejemplo usa el tag c:url
Aplica URL rewriting si el navegador no acepta cookies
(aunque en este caso no es útil)
Si la URL es de tipo path relativo a contexto (ej.:
/css/styles.css), le antepone el nombre de la
aplicación web, de manera que la URL resultante es de tipo
path absoluto (ej.:.
/StrutsTutorial/css/styles.css)
Comentarios (y 8)
html:link
Genera el enlace HTML (<a href= ... </a>)
Cuando se utiliza el atributo action, aplica URL rewriting si
el navegador no acepta cookies
El atributo action tiene que especificar la URL de una
acción de Struts
NOTA: también dispone (alternativamente) del atributo
href
La URL puede apuntar a cualquier sitio
No se aplica URL rewriting
Login.jspx (1)
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:jsp="http://java.sun.com/JSP/Page"
xmlns:fmt="http://java.sun.com/jsp/jstl/fmt"
xmlns:html="http://struts.apache.org/tags-html"
xmlns:c="http://java.sun.com/jsp/jstl/core">
<jsp:output doctype-root-element="html"
doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN"
doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
omit-xml-declaration="true" />
<jsp:directive.page contentType="text/html; charset=iso-8859-1" />
<head>
<title><fmt:message key="Login.title" /></title>
<c:url var="stylesURL" value="/css/styles.css" />
<link rel="StyleSheet" href="${stylesURL}"
type="text/css" media="all" />
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1" />
</head>
<body>
Login.jspx (2)
<!-- Struts tags must render XHML -->
<html:xhtml/>
<!-- Print login form -->
<html:form action="Login.do">
<!-- Login name -->
<div class="field">
<span class="label">
<fmt:message key="Login.loginName" />
</span>
<span class="entry">
<html:text property="loginName" size="16" maxlength="16" />
<html:errors property="loginName" />
</span>
</div>
Login.jspx (3)
<!-- Password -->
<div class="field">
<span class="label">
<fmt:message key="Login.password" />
</span>
<span class="entry">
<html:password property="password" size="16"
maxlength="16" />
<html:errors property="password" />
</span>
</div>
<!-- Remember my password -->
<div class="field">
<span class="label">
<fmt:message key="Login.rememberMyPassword" />
</span>
<span class="entry">
<html:checkbox property="rememberMyPassword" />
</span>
</div>
Login.jspx (y 4)
<!-- Login button -->
<div class="button">
<html:submit><fmt:message key="Buttons.login" /></html:submit>
</div>
</html:form>
</body>
</html>
Comentarios (1)
html:xhtml
Causa que los tags de Struts de la librería HTML que se usen
en esa página generen XHTML en vez de HTML (por defecto,
algunos tags, como html:text, html:password o
html:checkbox generan los tags sin cerrarlos, mientras
que otros sí los cierran, como por ejemplo, html:link)
html:text, html:password y html:checkbox
recuperan el valor de la propiedad asociada a través
del método getXXX (property="XXX") sobre la
instancia de LoginForm enganchada a la request
(con nombre loginForm)
Saben que el ActionForm asociado se llama loginForm,
dado que el atributo action de html:form es igual a
Login.do
struts-config.xml especifica loginForm como el
nombre del ActionForm para la URL /Login.do
Comentarios (y 2)
html:errors
Imprime el mensaje de error asociado a la propiedad
especificada si figura en el ActionErrors/
ActionMessages enganchado a la request
El mensaje vendrá flanqueado por errors.header y
errors.footer (Messages.properties)
InternalError.jspx (1)
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:jsp="http://java.sun.com/JSP/Page"
xmlns:fmt="http://java.sun.com/jsp/jstl/fmt"
xmlns:c="http://java.sun.com/jsp/jstl/core">
<jsp:output doctype-root-element="html"
doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN"
doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
omit-xml-declaration="true" />
<jsp:directive.page contentType="text/html; charset=iso-8859-1" />
<head>
<title><fmt:message key="InternalError.title" /></title>
<c:url var="stylesURL" value="/css/styles.css" />
<link rel="StyleSheet" href="${stylesURL}"
type="text/css" media="all" />
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1" />
</head>
<body>
InternalError.jspx (y 2)
<p>
<fmt:message key="InternalError.title" />.
<fmt:message key="ErrorMessages.retry" />
</p>
</body>
</html>
Un pequeño problema
Situación
Imaginemos que la página de bienvenida fuese
MainPage.jspx
Un usuario se autentica seleccionando “Remember my
password”
Termina la sesión
Accede dos días después tecleando la URL de la aplicación
en su navegador (ej.: http://www.acme.org/StrutsTutorial)
En realidad es Index.jspx
Se ejecuta MainPage.jspx
La sesión no contendrá el atributo loginName, dado que no
se ha ejecutado LoginManager.getLoginName
Una solución
El navegador nunca invocará a /MainPage.jspx
directamente
Index.jspx
MainPageAction
LoginManager.getLoginName y forward a
/MainPage.jspx
Cuando se haga un sendRedirect a la página principal se
hará siempre con la URL /MainPage.do y nunca con
/MainPage.jspx
Página de bienvenida
Hace un forward a /MainPage.do => se ejecuta
MainPageAction
/MainPage.jspx nunca aparecerá en la caja de diálogo del
navegador, de manera que el usuario nunca hará un bookmark
a esa página, sino a /MainPage.do
En MiniPortal volveremos a discutir este problema
es.udc.fbellas.j2ee.strutstutorial.portal3.http.controller.actions.MainPageAction
public class MainPageAction extends DefaultAction {
public ActionForward doExecute(ActionMapping mapping,
ActionForm form, HttpServletRequest request,
HttpServletResponse response)
throws IOException, ServletException, InternalErrorException {
/*
* "LoginManager.getLoginName" creates an appropriate session
* if the session had expired, or the user had not logged in,
* but he/she had selected "remember my password" in the last
* login.
*/
LoginManager.getLoginName(request);
/* Return ActionForward. */
return mapping.findForward("ShowMainPage");
}
}
Index.jspx
<jsp:forward xmlns:jsp="http://java.sun.com/JSP/Page"
page="MainPage.do" />
