Manual BÃ¡sico de Struts

La View comprende las JSP (principalmente) y los servlets involucrados en la generaciï¿½n de la interfaz de usuario o con otros Sistemas. Struts provee soporte para construir aplicaciones multi-idioma, interacciï¿½n con formularios y otras utilidades mediante la utilizaciï¿½n de Tags especiales (TagLibraries).

ï¿½Internacionalizaciï¿½n

Lo podemos abreviar en la siguiente receta:

Crear un archivo de texto (ej: MiAplicacion.properties) en el directorio donde se encuentren las clases de la aplicaciï¿½n (ej: d:\com\empresa\aplicacion) donde se contengan las claves y valores con el formato clave.subclave=texto de los textos que pertenezcan al idioma principal. Ejemplo:

...
application.title= Demo de Struts en APLICACION
index.header=Bienvenido a la Demo de Struts en APLICACION
...

Para cada idioma alternativo se crearï¿½ un archivo nuevo que se llame igual pero que termine en "_xx.properties" siendo xx el cï¿½digo ISO de idioma (ej: MiAplicaciï¿½n_en.properties).
En struts-config.xml se debe configurar el Tag /servlet/init-param/param-name application y ponerle como param-value la localizaciï¿½n del archivo con el idioma principal. Ejemplo:

<servlet>
    <servlet-name>action</servlet-name>
    ...
    <init-param>
      <param-name>application</param-name>
      <param-value>com.empresa.aplicacion.MiAplicacion</param-value>
    </init-param>
    ...

En web.xml deberemos inclur:

<web-app>
  ...
  <taglib>
    <taglib-uri>/WEB-INF/struts-bean.tld</taglib-uri>
    <taglib-location>/WEB-INF/struts-bean.tld</taglib-location>
  </taglib>
  ...
</web-app>

En las JSPs donde utilicemos la internacionalizaciï¿½n deberemos incluir al comienzo:

...
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
...

para declarar que utilizaremos la TagLibrary struts-bean con el prefijo bean y definida en /WEB-INF/struts-bean.tld

Y finalmente, utilizaremos el Tag <bean:message key="clave.subclave"/> donde clave y subclave corresponden al texto por el que se reemplazarï¿½ segï¿½n el idioma del usuario. Ejemplo

...
<TITLE><bean:message key="application.title"/></TITLE>
...

Por defecto Struts asigna a cada usuario el idioma principal de la aplicaciï¿½n. Si se utiliza el tag <html:html locale="true"> (reemplaza a "<html>" y debe cerrarse con "</html:html>") entonces se utilizarï¿½ el primero de los idiomas soportados por la aplicaciï¿½n que se encuentre en el header "Accept-Language" enviado por su navegador. Pero si se desea proponerle al usuario una lista de idiomas entonces ï¿½ste podrï¿½ cambiarse mediante session.setAttribute( Action.LOCALE_KEY, new java.util.Locale(country, language)) donde country y language serï¿½n el string del paï¿½s e idioma a establecer.

Ademï¿½s de texto podran incluirse variables (al igual que se hace en los println) y hasta formato de datos. Para mï¿½s informaciï¿½n ver la documentaciï¿½n oficial de Sun disponible en http://java.sun.com/j2se/1.3/docs/guide/intl/

ï¿½Forms

Una de las tareas que durante el desarrollo de una aplicaciï¿½n insume mucho trabajo (aunque en realidad no lo merezcan) es la interacciï¿½n con formularios, ya sea para editar u obtener nueva informaciï¿½n. Las comprobaciones, la gestiï¿½n de errores, el volver a presentarle el mismo form al usuario con los valores que puso y los mensajes de error y un largo etcï¿½tera estï¿½n soportadas por Struts a fines de hacernos la vida un poco mï¿½s fï¿½cil.

La idea es la siguiente: todo el trabajo de comprobaciones y generaciï¿½n de mensajes de error se implementa en los ActionForm y todo el trabajo de generaciï¿½n de interfaz en la/s JSP.

Veamos la receta:

Crear el ActionForm (ver la secciï¿½n Model / ActionForm Beans)
Crear la pï¿½gina JSP del formulario utilizando los Tags que provee Struts (ver la secciï¿½n View / Tags). Ejemplo:

...
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
...
<html:html>
...
   <html:form action="/logon" focus="username">
...
     <h1><bean:message key="logon.header"/></h1>
     <html:form action="/logon" focus="username">
     <h5><html:errors/></h5>
     <h3><bean:message key="logon.mainText"/></h3>
     <p><bean:message key="logon.username"/>
           <html:text property="username" size="16" maxlength="16"/></p>
     <p><bean:message key="logon.password"/>
           <html:password property="password" size="16" maxlength="16" redisplay=false/></p>
     <p><html:submit property="submit" value="Submit"/></p>
     <p><html:reset/></p>
...
   </html:form>
...   
</html:html>

Declarar el ActionForm en struts-config.xml agregando en /struts-config/form-beans el tag <form-bean name="nombreForm" type="paquete.clase"/> y en la declaraciï¿½n del Action (ver la secciï¿½n Controller / Action Beans) agregar los atributos name="nombreForm", scope="(request ï¿½ session)", e input="paginaForm.jsp". Ejemplo:

<struts-config>
  ...
  <form-beans>
  ...
   <form-bean  name="logonForm" type="com.empresa.aplicacion.LogonForm"/>
  ...
  </form-beans>
  ...
  <action-mappings>
  ...
   <action path="/logon" type="com.empresa.aplicacion.LogonAction" name="logonForm" 
               scope="request" input="/logon.jsp">
    ...
   </action>
   ...
  <action-mappings>
  ...
</struts-config>

ï¿½Tags

Bï¿½sicamente, un Tag de JSP consiste en un Tag con formato <prefijoTagLib:nombreTag atributo=valor ... > que cuando la JSP se compila es sustituï¿½do por una llamada a la clase TagHandler que se encarga de resolver su funcionalidad.

El TagHandler extiende BodyTagSupport o TagSupport (segï¿½n si es un tag que tiene body), que implementa su funcionalidad en los mï¿½todos doStartTag(), doEndTag(),doInitBody(), doAfterBody() (los dos ï¿½ltimos sï¿½lo en las que extienden BodyTagSupport), ademï¿½s de los getters y setters correspondientes a sus atributos. Esta clase se define en un Tag Library Definition (archivo xml con extensiï¿½n TLD donde se define el nombre del tag, la clase TagHandler que lo atiende, la definiciï¿½n de sus atributos, si tiene body, etc.) que a su vez se debe declarar en el web.xml (dentro de <web-app> se pone <taglib> <taglib-uri> nombreTagLib </taglib-uri> <taglib-location>/directorios/nombreArchivo.tld </taglib-location> </taglib>) y en la JSP donde se utilizarï¿½ (<%@ taglib uri="nobreTagLib" prefix="prefijoTagLib" %>). Finalmente, el Tag que se usa en la JSP consiste en <prefijoTagLib:nombreTag atributo=valor ... >. Para mï¿½s info, ver la pï¿½gina oficial de Sun sobre TagLibraries en http://java.sun.com/products/jsp/taglibraries.html.

La funcionalidad de los Tags incluï¿½dos en Struts se encuentran documentados en:

Las clases TagHandlers que implementan dicha funcionalidad estï¿½n documentadas en: