Struts 2 proporciona una librería de etiquetas que facilitan, entre otras, las tareas de validación e internacionalización. Estas etiquetas, cuyo TLD podemos encontrar en META-INF/struts-tags.tld, en el jar de struts2-core, pueden utilizarse tanto con JSP como con Velocity o FreeMarker.
A continuación veremos una lista con las distintas etiquetas, una pequeña definición, la clase que las implementa, algunos atributos útiles y, cuando se ha considerado necesario, un pequeño ejemplo (usando JSP). Sin embargo, para evitar repeticiones, comenzaremos primero enumerando algunos atributos comunes a todas las etiquetas de interfaz de usuario:
cssClass
: El atributoclass
de HTML. Indica la clase CSS a utilizar para el elemento HTML generado.cssStyle
: El atributostyle
de HTML. Permite definir el estilo del elemento inline, en lugar de utilizar un archivo CSS externo o una etiquetastyle
.disabled
: Determina si el control está deshabilitado.label
: Etiqueta que acompañará al widget. Genera una clásica etiquetalabel
de HTML.required
: Booleano indicando si el campo es obligatorio. Si es así muestra un asterisco al lado de la etiqueta.tabindex
: El atributotabindex
de HTML. Utilizado para establecer el orden a seguir al recorrer los controles cuando el usuario pulsa la tecla de Tabulacióntemplate
: Plantilla a utilizar.theme
: Tema a utilizar.
Ahora si, las etiquetas son las siguientes:
action
Permite ejecutar una acción desde una vista indicando el nombre de la acción y, opcionalmente, el espacio de nombres. Se puede pasar parámetros utilizando la etiqueta param
.
org.apache.struts2.views.jsp.ActionTag
executeResult
: determina si el resultado de la acción (normalmente otra vista) se debe ejecutar / renderizar también.
ignoreContextParams
: indica si se deben incluir los parámetros de la petición actual al invocar la acción.
name
(requerido): el nombre de la acción a ejecutar.
namespace
: el espacio de nombres de la acción a ejecutar.
index.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> Antes de s:action<br/> <s:action name="Accion" executeResult="true"/><br/> Después de s:action </body> </html>
Accion.java
import com.opensymphony.xwork2.ActionSupport; @SuppressWarnings("serial") public class Accion extends ActionSupport { private String web; public String getWeb() { return web; } public String execute() { web = "mundogeek.net"; return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> Visita <s:property value="web"/>
actionerror
Muestra los errores que se produjeron en las acciones, si es que existen. Podemos añadir errores utilizando el método addActionError(String error)
de la interfaz ValidationAware
, que ActionSupport
implementa. Los métodos y propiedades de ValidationAware
también estarán disponibles en la vista, por lo que es posible en su lugar comprobar si existen errores con el método hasActionErrors()
e iterar directamente sobre la colección actionErrors
.
org.apache.struts2.views.jsp.ui.ActionErrorTag
Accion.java
import com.opensymphony.xwork2.ActionSupport; @SuppressWarnings("serial") public class Accion extends ActionSupport { public String execute() { addActionError("Oh dios mío, ¡un error!"); return ERROR; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:actionerror /> </body> </html>
actionmessage
Similar a actionerror
, pero en lugar de errores en la acción sirve para mostrar mensajes de la acción, los cuales añadimos utilizando el método addActionMessage(String mensaje)
de la interfaz ValidationAware
. Como el anterior, también podríamos utilizar el método hasActionMessages()
para comprobar la existencia de mensajes e iterar sobre la colección de strings actionMessages
.
org.apache.struts2.views.jsp.ui.ActionMessageTag
Accion.java
import com.opensymphony.xwork2.ActionSupport; @SuppressWarnings("serial") public class Accion extends ActionSupport { public String execute() { addActionMessage("Tengo un mensaje para usted."); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:actionmessage/> </body> </html>
a
Crea una etiqueta anchor HTML. Se puede utilizar con el tema ajax para generar llamadas asíncronas al servidor.
org.apache.struts2.views.jsp.ui.AnchorTag
href
: La URL a cargar cuando el usuario pulse sobre el enlace.
title
: Atributo title de HTML.
append
Crea un nuevo iterador a partir de varios iteradores pasados como parámetro en forma de etiquetas param
.
org.apache.struts2.views.jsp.iterator.AppendIteratorTag
var
: el nombre que tendrá el iterador resultante en el ValueStack
.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> registrados; private List<String> vips; public List<String> getRegistrados() { return registrados; } public List<String> getVips() { return vips; } public String execute() { registrados = new ArrayList<String>(); registrados.add("Juan"); registrados.add("Manuel"); vips = new ArrayList<String>(); vips.add("Pedro"); vips.add("María"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:append var="usuarios"> <s:param value="%{registrados}" /> <s:param value="%{vips}" /> </s:append> Usuarios: <ul> <s:iterator value="usuarios"> <li><s:property /></li> </s:iterator> </ul> </body> </html>
bean
Instancia un Java Bean. Se puede pasar valores a las propiedades del bean utilizando etiquetas param
.
org.apache.struts2.views.jsp.BeanTag
name
(requerido): La clase a instanciar.
var
: Nombre con el que se añadirá la instancia a ValueStack
.
Usuario.java
public class Usuario { private String nombre; public String getNombre() { return nombre; } public void setNombre(String nombre) { this.nombre = nombre; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:bean name="Usuario" var="miUsuario"> <s:param name="nombre">Raúl</s:param> </s:bean> Bienvenido <s:property value="#miUsuario.nombre"/> </body> </html>
checkbox
Crea un checkbox HTML. Para una lista de varios checkboxes relacionados podemos utilizar la etiqueta checkboxlist
.
org.apache.struts2.views.jsp.ui.CheckboxTag
value
: Booleano que indica si el checkbox está marcado o no.
index.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form action="Accion"> <s:checkbox label="Aceptar condiciones" name="condiciones" value="true" /> <s:submit value="Enviar" /> </s:form> </body> </html>
Accion.java
import com.opensymphony.xwork2.ActionSupport; @SuppressWarnings("serial") public class Accion extends ActionSupport { private boolean condiciones; public boolean isCondiciones() { return condiciones; } public void setCondiciones(boolean condiciones) { this.condiciones = condiciones; } public String execute() { return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:if test="condiciones"> Muchas gracias. </s:if> <s:else> Pues es una lástima. </s:else> </body>
checkboxlist
Crea una lista de checkboxes relacionados (todos con el mismo atributo name
). Esto implica que el valor del elemento no será un booleano indicando si está marcado o no, como en el caso de checkbox, sino una lista con los valores marcados.
org.apache.struts2.views.jsp.ui.CheckboxListTag
list
(requerido): Iterable con los valores con los que generar la lista.
listKey
: Propiedad de los objetos del iterable del que el checkbox correspondiente tomará su valor.
listValue
: Exactamente igual al anterior, pero en lugar del valor, el contenido.
name
: Nombre de los checkboxes.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lenguajes; public List<String> getLenguajes() { return lenguajes; } public String execute() { lenguajes = new ArrayList<String>(); lenguajes.add("Python"); lenguajes.add("Java"); lenguajes.add("Ruby"); lenguajes.add("C#"); lenguajes.add("C++"); lenguajes.add("Lisp"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <body> <s:form> <s:checkboxlist list="lenguajes" name="lenguajes-preferidos" /> <s:submit value="Enviar" /> </s:form> </body>
combobox
Crea una combinación de select y caja de texto. El valor de la caja de texto se auto rellena según el elemento seleccionado en el select.
org.apache.struts2.views.jsp.ui.ComboBoxTag
emptyOption
: Indica si queremos añadir una opción vacía.
list
(requerido): Iterable con los valores con los que generar la lista.
listKey
: Propiedad de los objetos del iterable del que el checkbox correspondiente tomará su valor.
listValue
: Exactamente igual al anterior, pero en lugar del valor, el contenido.
name
: Nombre a usar para el elemento.
readonly
: Si queremos que el usuario pueda escribir sus propios valores en la caja de texto.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lenguajes; public List<String> getLenguajes() { return lenguajes; } public String execute() { lenguajes = new ArrayList<String>(); lenguajes.add("Python"); lenguajes.add("Java"); lenguajes.add("Ruby"); lenguajes.add("C#"); lenguajes.add("C++"); lenguajes.add("Lisp"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <body> <s:form action="Otro"> <s:combobox list="lenguajes" name="nombre-lenguajes" label="Lenguaje preferido" readonly="true" /> <s:submit value="Enviar" /> </s:form> </body>
date
Permite mostrar una fecha almacenada en una cierta variable indicando opcionalmente el formato a utilizar.
org.apache.struts2.views.jsp.DateTag
format
: Formato a utilizar para mostrar la fecha. Si queremos usar siempre el mismo formato podemos crear un archivo properties con una entrada struts.date.format
. Por defecto se utiliza el formato DateFormat.MEDIUM
.
name
(requerido): Nombre de la variable que contiene la fecha a mostrar.
nice
: Utiliza un formato que facilita la lectura. Por defecto se utiliza inglés para mostrar los mensajes; si queremos traducirlo a algún otro idioma tendremos que recurrir a las funciones de internacionalización de Struts 2. Las claves a traducir son las siguientes:
CLAVE | VALOR POR DEFECTO |
struts.date.format.past |
{0} ago |
struts.date.format.future |
in {0} |
struts.date.format.seconds |
an instant |
struts.date.format.minutes |
{0,choice,1#one minute|1<{0} minutes} |
struts.date.format.hours |
{0,choice,1#one hour|1<{0} hours}{1,choice,0#|1#, one minute|1<, {1} minutes} |
struts.date.format.days |
{0,choice,1#one day|1<{0} days}{1,choice,0#|1#, one hour|1<, {1} hours} |
struts.date.format.years |
{0,choice,1#one year|1<{0} years}{1,choice,0#|1#, one day|1<, {1} days} |
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.Calendar; import java.util.Date; @SuppressWarnings("serial") public class Accion extends ActionSupport { private Date ahora; private Date anyoNuevo; public Date getAhora() { return ahora; } public Date getAnyoNuevo() { return anyoNuevo; } public String execute() { ahora = new Date(); Calendar cal = Calendar.getInstance(); int anyo = cal.get(Calendar.YEAR); cal.set(anyo + 1, Calendar.JANUARY, 1); anyoNuevo = cal.getTime(); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <body> Hoy es <s:date name="ahora" format="d 'de' MMMM 'de' yyyy" /><br/> Año nuevo <s:date name="anyoNuevo" nice="true" /> </body>
debug
Imprime información de depuración (entre otros, el contenido de ValueStack
).
org.apache.struts2.views.jsp.ui.DebugTag
div
Crea un elemento div de HTML.
org.apache.struts2.views.jsp.ui.DivTag
doubleselect
Crea dos elementos select HTML, con el segundo de ellos modificando sus valores dependiendo del valor seleccionado en el primero.
org.apache.struts2.views.jsp.ui.DoubleSelectTag
doubleList
(requerido): Lista con los valores que tendrá el segundo select.
doubleMultiple
: Determina si en el segundo select se pueden seleccionar varios valores o solo uno.
doubleName
(requerido): Nombre del elemento.
list
(requerido): Lista con los valores que tendrá el primer select.
Artista.java
import java.util.List; public class Artista { private String nombre; private List<String> canciones; public Artista(String nombre, List<String> canciones) { this.nombre = nombre; this.canciones = canciones; } public String getNombre() { return nombre; } public List<String> getCanciones() { return canciones; } }
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<Artista> artistas; public List<Artista> getArtistas() { return artistas; } public String execute() { artistas = new ArrayList<Artista>(); List<String> canciones_p = new ArrayList<String>(); canciones_p.add("El equilibro es imposible"); canciones_p.add("Años 80"); canciones_p.add("Promesas que no valen nada"); Artista piratas = new Artista("Los piratas", canciones_p); artistas.add(piratas); List<String> canciones_c = new ArrayList<String>(); canciones_c.add("Viva la vida"); canciones_c.add("Clocks"); canciones_c.add("Life in technicolor"); Artista coldplay = new Artista("Coldplay", canciones_c); artistas.add(coldplay); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <body> <s:form action="Otro"> <s:doubleselect label="Selecciona la canción" list="artistas" listValue="nombre" doubleList="canciones" doubleName="cancion" /> <s:submit value="Enviar" /> </s:form> </body>
fielderror
Muestra los errores que se han detectado al validar los campos del formulario. Por defecto se muestran todos los errores, pero podemos seleccionar que se muestren sólo los relativos a ciertos campos pasándole etiquetas param
. El funcionamiento es parecido al de actionerror
y actionmessage
: podemos añadir errores utilizando el método addFieldError(String fieldName, String errorMessage)
de la interfaz ValidationAware
, que ActionSupport
implementa. Hay que tener en cuenta, no obstante, que si redirigimos al formulario de entrada el propio formulario imprimará estos errores por defecto sin necesidad de añadir esta etiqueta. Los métodos y propiedades de ValidationAware
también estarán disponibles en la vista, por lo que es posible en su lugar comprobar si existen errores con el método hasFieldErrors()
e iterar directamente sobre la colección fieldErrors
.
org.apache.struts2.views.jsp.ui.FieldErrorTag
index.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:fielderror /> <s:form action="Accion"> <s:textfield label="Nombre" name="nombre" /> <s:submit value="Enviar" /> </s:form> </body> </html>
Accion.java
import com.opensymphony.xwork2.ActionSupport; @SuppressWarnings("serial") public class Accion extends ActionSupport { private String nombre; public String getNombre() { return nombre; } public void setNombre(String nombre) { this.nombre = nombre; } public String execute() { if(nombre.length() > 10) { addFieldError("nombre", "El nombre no puede tener más de 10 caracteres."); return ERROR; } return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <body> <s:fielderror /> </body>
file
Muestra un campo file de HTML. Para facilitarnos la vida podemos aprovechar el interceptor fileUpload
que se encuentra en la selección de interceptores por defecto (defaultStack
) y que funciona de forma parecida al interceptor param
. Basta crear setters y getters en la acción para las nuevas propiedades nombre
(el archivo en si), nombreContentType
(el tipo MIME del archivo subido) o nombreFileName
(el nombre del archivo subido) para tener acceso a estos valores en la acción.
org.apache.struts2.views.jsp.ui.FileTag
accept
: atributo del mismo nombre de HTML que permite indicar los tipos MIME que acepta el campo.
index.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form enctype="multipart/form-data" method="POST" action="Accion"> <s:file label="Archivo a enviar" name="archivoTexto" accept="text/txt" /> <s:submit value="Enviar" /> </s:form> </body> </html>
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.io.BufferedReader; import java.io.File; import java.io.FileReader; import java.io.IOException; @SuppressWarnings("serial") public class Accion extends ActionSupport { private File archivoTexto; private String archivoTextoContentType; private String archivoTextoFileName; private String contenido; public String getContenido() { return contenido; } public File getArchivoTexto() { return archivoTexto; } public void setArchivoTexto(File archivoTexto) { this.archivoTexto = archivoTexto; } public String getArchivoTextoContentType() { return archivoTextoContentType; } public void setArchivoTextoContentType(String archivoTextoContentType) { this.archivoTextoContentType = archivoTextoContentType; } public String getArchivoTextoFileName() { return archivoTextoFileName; } public void setArchivoTextoFileName(String archivoTextoFileName) { this.archivoTextoFileName = archivoTextoFileName; } public String execute() throws IOException { BufferedReader input = new BufferedReader(new FileReader(archivoTexto)); String linea = ""; contenido = ""; while ((linea = input.readLine()) != null) contenido = contenido + linea; return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <body> <strong>Archivo</strong>: <s:property value="archivoTextoFileName"/><br/> <strong>Tipo</strong>: <s:property value="archivoTextoContentType"/><br/> <strong>Contenido</strong>: <s:property value="contenido"/> </body>
form
Crea un elemento form de HTML.
org.apache.struts2.views.jsp.ui.FormTag
action
: Acción a la que se enviará la petición con los datos del formulario. También se puede enlazar otras páginas o servlets. Si no utilizamos el atributo para especificar el destino se utiliza la misma página del formulario.
namespace
: Espacio de nombres al que pertenece la acción a la que se enviará la petición. Por defecto se utiliza el espacio de nombres actual.
validate
: Si queremos validar los campos del formulario antes de enviarlos.
component
Utilizado para crear nuestras propias etiquetas sin tener que recurrir a la API de etiquetas de JSP.
org.apache.struts2.views.jsp.ui.ComponentTag
head
Etiqueta auxiliar que se coloca dentro de la etiqueta head de HTML y se encarga de generar distintos elementos necesarios para otras etiquetas, como las etiquetas para la carga de hojas de estilo o scripts.
org.apache.struts2.views.jsp.ui.HeadTag
hidden
Crea un campo oculto.
org.apache.struts2.views.jsp.ui.HiddenTag
i18n
Carga un archivo de recursos adicional con la traducción de nuestros mensajes y los coloca en ValueStack
de forma que puedan ser accedidos fácilmente por el código que se encuentre dentro de la etiqueta.
org.apache.struts2.views.jsp.I18nTag
name
(requerido): Nombre del ResourceBundle
a cargar.
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:i18n name="textos"> <s:text name="bienvenida" /> </s:i18n> </body> </html>
if-elseif-else
La típica sentencia condicional.
org.apache.struts2.views.jsp.IfTag
org.apache.struts2.views.jsp.ElseIfTag
org.apache.struts2.views.jsp.ElseTag
test
(requerido para if
y elseif
): la expresión a comprobar
index.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:if test="ventas < 1000">Comisión del 1%</s:if> <s:elseif test="ventas < 2000">Comisión del 2%</s:elseif> <s:else>Comisión del 3%</s:else> </body> </html>
include
Parecido a action
con el parámetro executeResult
, pero, a diferencia de este, permite incluir cualquier recurso. Como el include
de JSP también se le pueden pasar parámetros para que sea dinámico con etiquetas param
, pero estos valores no se acceden como propiedades de ValueStack
, sino como parámetros de la petición.
org.apache.struts2.views.jsp.IncludeTag
value
(requerido): El recurso a incluir.
header.jsp
<h1>Bienvenido a ${param.web}</h1>
index.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:include value="header.jsp"> <s:param name="web">http://mundogeek.net</s:param> </s:include> Contenido. </body> </html>
inputtransferselect
Crea un componente consistente en un select de selección múltiple, un campo de texto y distintos botones que permiten añadir, eliminar y ordenar los valores.
org.apache.struts2.views.jsp.ui.InputTransferSelectTag
allowRemoveAll
: Determina si se mostrará el botón para eliminar todos los valores.
allowUpDown
: Determina si se mostrarán los botones para subir y bajar los valores en la lista.
downLabel
: Etiqueta del botón que baja los valores.
list
(requerido): Lista con los valores que tendrá el select al comenzar.
removeAllLabel
: Etiqueta del botón que elimina todos los valores.
removeLabel
: Etiqueta del botón que elimina un valor.
upLabel
: Etiqueta del botón que sube los valores.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lenguajes; public List<String> getLenguajes() { return lenguajes; } public String execute() { lenguajes = new ArrayList<String>(); lenguajes.add("Python"); lenguajes.add("Java"); lenguajes.add("Ruby"); lenguajes.add("C#"); lenguajes.add("C++"); lenguajes.add("Lisp"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form> <s:inputtransferselect label="¿Cuáles son tus lenguajes favoritos?" list="lenguajes" /> <s:submit value="Enviar" /> </s:form> </body> </html>
iterator
Para iterar sobre colecciones. En cada iteración el objeto recuperado se coloca en ValueStack
para poder acceder a sus propiedades fácilmente.
org.apache.struts2.views.jsp.IteratorTag
status
: Crea una instancia de IteratorStatus
con el nombre indicado. Este objeto expone algunas propiedades muy útiles como index
(índice del elemento actual), first
(booleano que indica si es el primero elemento), even
(booleano que indica si es impar), last
(booleano que indica si es el último elemento) u odd
(booleano que indica si es par).
value
: Colección sobre la que iterar.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lenguajes; public List<String> getLenguajes() { return lenguajes; } public String execute() { lenguajes = new ArrayList<String>(); lenguajes.add("Python"); lenguajes.add("Java"); lenguajes.add("Ruby"); lenguajes.add("C#"); lenguajes.add("C++"); lenguajes.add("Lisp"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> Tus lenguajes preferidos son: <ul> <s:iterator value="lenguajes"> <li><s:property /></li> </s:iterator> </ul> </body> </html>
label
Crea una etiqueta label de HTML.
org.apache.struts2.views.jsp.ui.LabelTag
merge
Crea un nuevo iterador unión de los distintos iteradores pasados como parámetro mediante etiquetas param
.
org.apache.struts2.views.jsp.iterator.MergeIteratorTag
var
: Nombre que se usará en ValueStack
para el nuevo iterador.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lista1; private List<String> lista2; public List<String> getLista1() { return lista1; } public void setLista1(List<String> lista1) { this.lista1 = lista1; } public List<String> getLista2() { return lista2; } public void setLista2(List<String> lista2) { this.lista2 = lista2; } public String execute() { lista1 = new ArrayList<String>(); lista1.add("Uno"); lista1.add("Dos"); lista1.add("Tres"); lista2 = new ArrayList<String>(); lista2.add("1"); lista2.add("2"); lista2.add("3"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:merge var="nuevaLista"> <s:param value="lista1" /> <s:param value="lista2" /> </s:merge> <ul> <s:iterator value="nuevaLista"> <li><s:property /></li> </s:iterator> </ul> </body> </html>
optgroup
Crea un nuevo elemento HTML optgroup (un grupo de opciones para un elemento select)
org.apache.struts2.views.jsp.ui.OptGroupTag
list
: El objeto del que se tomarán los valores con los que rellenar el elemento.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.HashMap; @SuppressWarnings("serial") public class Accion extends ActionSupport { private HashMap<String, String> registrados; private HashMap<String, String> vips; public HashMap<String, String> getVips() { return vips; } public void setVips(HashMap<String, String> vips) { this.vips = vips; } public HashMap<String, String> getRegistrados() { return registrados; } public void setRegistrados(HashMap<String, String> registrados) { this.registrados = registrados; } public String execute() { registrados = new HashMap<String, String>(); registrados.put("Juan", "Juan Encina"); registrados.put("Manuel", "Manuel Robledo"); vips = new HashMap<String, String>(); vips.put("Pedro", "Pedro Peral"); vips.put("María", "María Manzano"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form> <s:select list="{}"> <s:optgroup label="Registrados" list="registrados" /> <s:optgroup label="VIPs" list="vips" /> </s:select> <s:submit value="Enviar" /> </s:form> </body> </html>
optiontransferselect
Crea un componente consistente en dos selects cuyos elementos pueden traspasarse de uno a otro.
org.apache.struts2.views.jsp.ui.OptionTransferSelectTag
doubleList
(requerido): El iterador con los valores que tendrá el segundo select al comenzar.
doubleName
(requerido): Nombre a utilizar para el elemento.
leftTitle
: Título del primer select.
list
: El iterador con los valores que tendrá el primer select al comenzar.
rightTitle
: Título del segundo select
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.HashMap; @SuppressWarnings("serial") public class Accion extends ActionSupport { private HashMap<String, String> registrados; private HashMap<String, String> vips; public HashMap<String, String> getVips() { return vips; } public void setVips(HashMap<String, String> vips) { this.vips = vips; } public HashMap<String, String> getRegistrados() { return registrados; } public void setRegistrados(HashMap<String, String> registrados) { this.registrados = registrados; } public String execute() { registrados = new HashMap<String, String>(); registrados.put("Juan", "Juan Encina"); registrados.put("Manuel", "Manuel Robledo"); vips = new HashMap<String, String>(); vips.put("Pedro", "Pedro Peral"); vips.put("María", "María Manzano"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form action="Otro"> <s:optiontransferselect list="registrados" leftTitle="Registrados" doubleList="vips" rightTitle="VIPs" doubleName="usuarios" /> <s:submit value="Enviar" /> </s:form> </body> </html>
param
Utilizada para añadir parámetros a otras etiquetas.
org.apache.struts2.views.jsp.ParamTag
name
: Nombre del parámetro.
value
: Valor del parámetro.
password
Crea un elemento password de HTML.
org.apache.struts2.views.jsp.ui.PasswordTag
showPassword
: Indica si queremos que se muestren los caracteres en claro.
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form action="Otro"> <s:textfield label="Nombre" /> <s:password label="Contraseña" /> <s:submit value="Enviar" /> </s:form> </body> </html>
property
Muestra una propiedad de ValueStack
u otro objeto de ActionContext
.
org.apache.struts2.views.jsp.PropertyTag
default
: Valor a mostrar en caso de que el valor pedido sea nulo.
escape
: Determina si queremos que se escape el HTML. Por defecto es true.
value
: Valor a mostrar.
Accion.java
import com.opensymphony.xwork2.ActionSupport; @SuppressWarnings("serial") public class Accion extends ActionSupport { private String web; public String getWeb() { return web; } public void setWeb(String web) { this.web = web; } public String execute() { web = "mundogeek.net"; return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> Visita <s:property value="web" default="google.es" /> </body> </html>
push
Añade el valor especificado a lo alto de la pila.
org.apache.struts2.views.jsp.PushTag
value
(requerido): El valor a añadir.
radio
Crea un conjunto de radio buttons HTML.
org.apache.struts2.views.jsp.ui.RadioTag
list
(requerido): Lista con los valores que tendrá el grupo de radio buttons.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lenguajes; public List<String> getLenguajes() { return lenguajes; } public String execute() { lenguajes = new ArrayList<String>(); lenguajes.add("Python"); lenguajes.add("Java"); lenguajes.add("Ruby"); lenguajes.add("C#"); lenguajes.add("C++"); lenguajes.add("Lisp"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form> <s:radio label="Selecciona tu lenguaje preferido" list="lenguajes" /> <s:submit value="Enviar" /> </s:form> </body> </html>
reset
Crea un botón que borra los datos introducidos en el formulario.
org.apache.struts2.views.jsp.ui.ResetTag
value
: Texto a utilizar para el botón
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form action="Otro"> <s:textfield label="Nombre" /> <s:password label="Contraseña" /> <s:reset value="Borrar" /> <s:submit value="Enviar" /> </s:form> </body> </html>
select
Crea un elemento select.
org.apache.struts2.views.jsp.ui.SelectTag
list
: El iterable con los valores que tendrá el select.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lenguajes; public List<String> getLenguajes() { return lenguajes; } public String execute() { lenguajes = new ArrayList<String>(); lenguajes.add("Python"); lenguajes.add("Java"); lenguajes.add("Ruby"); lenguajes.add("C#"); lenguajes.add("C++"); lenguajes.add("Lisp"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form action="Otro"> <s:select label="Lenguaje preferido" list="lenguajes" /> <s:submit value="Enviar" /> </s:form> </body> </html>
set
Asigna un valor a una variable, opcionalmente indicando el ámbito al que añadirla. El valor se puede indicar utilizando el atributo value
, o encerrando el valor en la propia etiqueta.
org.apache.struts2.views.jsp.SetTag
name
: Nombre a utilizar para la variable.
scope
: Ámbito en el que añadir la variable. Puede ser application
, session
, request
, page
, o action
. Por defecto se utiliza action
.
value
: Valor a asignar.
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:set name="nombre">Raúl</s:set> Hola <s:property value="nombre" /> </body> </html>
submit
Crea un botón para enviar el formulario.
org.apache.struts2.views.jsp.ui.SubmitTag
value
: Texto a utilizar para el botón
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form action="Otro"> <s:textfield label="Nombre" /> <s:password label="Contraseña" /> <s:reset value="Borrar" /> <s:submit value="Enviar" /> </s:form> </body> </html>
text
Muestra un texto localizado de un resource bundle.
org.apache.struts2.views.jsp.TextTag
name
(requerido): La clave a buscar en el resource bundle.
index.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:url id="en" action="Accion"> <s:param name="request_locale">en</s:param> </s:url> <s:url id="fr" action="Accion"> <s:param name="request_locale">fr</s:param> </s:url> <ul> <li><s:a href="Accion">Español</s:a></li> <li><s:a href="%{en}">Inglés</s:a></li> <li><s:a href="%{fr}">Francés</s:a></li> </body> </html>
Accion.properties
mensaje = ¡Hola Mundo!
Accion_en.properties
mensaje = Hello World!
Accion_fr.properties
mensaje = Bonjour le monde!
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:text name="mensaje" /> </body> </html>
textarea
Crea un elemento textarea de HTML.
org.apache.struts2.views.jsp.ui.TextareaTag
cols
: Atributo cols de HTML (número de columnas).
rows
: Atributo rows de HTML (número de filas).
value
: El texto que mostrará el área de texto.
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:textarea cols="40" rows="10" value="Hola mundo" /> </body> </html>
textfield
Crea una caja de texto.
org.apache.struts2.views.jsp.ui.TextFieldTag
maxlength
: Atributo maxlength
de HTML (número máximo de caracteres permitidos)
readonly
: Determina si el campo será de solo lectura.
size
: Atributo size
de HTML (tamaño de la caja de texto en caracteres)
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:textfield label="Nombre" maxlength="10" size="10" /> </body> </html>
token
Añade un token oculto al formulario para ayudar a los interceptores token
y tokenSession
a evitar que el usuario mande la misma petición varias veces por error.
org.apache.struts2.views.jsp.ui.TokenTag
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form action="Comprar"> <ul> <li>The Pragmatic Programmer … 50€</li> <li>Code Complete … 50€</li> </ul> <s:token /> <s:submit value="Comprar" /> </s:form> </body> </html>
url
Crea una URL. Se pueden añadir parámetros a la URL usando etiquetas param
.
org.apache.struts2.views.jsp.URLTag
action
: Acción a la que llama la URL. Si queremos pasar una URL directamente se utiliza value
.
encode
: Indica si queremos hacer reescritura de URLs para mantener sesiones si el usuario tiene las cookies deshabilitadas.
value
: URL base.
updownselect
Crea un select con botones para ordenar los elementos según el gusto del usuario.
org.apache.struts2.views.jsp.ui.UpDownSelectTag
list
: El iterable con los valores que tendrá el select.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.List; import java.util.ArrayList; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lenguajes; public List<String> getLenguajes() { return lenguajes; } public String execute() { lenguajes = new ArrayList<String>(); lenguajes.add("Python"); lenguajes.add("Java"); lenguajes.add("Ruby"); lenguajes.add("C#"); lenguajes.add("C++"); lenguajes.add("Lisp"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:form action="Otro"> <s:updownselect label="Lenguaje preferido" list="lenguajes" /> <s:submit value="Enviar" /> </s:form> </body> </html>
generator
Genera un nuevo iterador. Los valores se obtienen dividiendo la cadena val
usando como separador el caracter indicado en separator
.
org.apache.struts2.views.jsp.iterator.IteratorGeneratorTag
converter
: Objeto de tipo Converter
con el que realizar las distintas operaciones que sean necesarias con cada valor.
count
: Número máximo de elementos que queremos generar.
separator
(requerido): Separador utilizado para transformar la cadena en los distintos valores del iterador.
val
(requerido): La cadena de la que se generarán.
var
: Nombre con el que se almacenará el nuevo iterador.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import org.apache.struts2.util.IteratorGenerator.Converter; @SuppressWarnings("serial") public class Accion extends ActionSupport { private String lenguajes; private Converter aMayusculas; public Converter getAMayusculas() { return aMayusculas; } public String getLenguajes() { return lenguajes; } public String execute() { aMayusculas = new Converter() { public Object convert(String cadena) throws Exception { return cadena.toUpperCase(); } }; lenguajes = "Python,Java,Ruby,C#,C++,Lisp"; return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:generator separator="," val="lenguajes" converter="aMayusculas" var="listaLenguajes" /> <ul> <s:iterator value="listaLenguajes"> <li><s:property /></li> </s:iterator> </ul> </body> </html>
sort
Ordena una lista
org.apache.struts2.views.jsp.iterator.SortIteratorTag
comparator
(requerido): Objeto Comparator
a utilizar para comparar los valores de la lista.
source
: Lista a ordenar.
var
: Nombre con el que almacenar la nueva lista. Se almacenará como atributo de page context.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.ArrayList; import java.util.Comparator; import java.util.List; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lenguajes; private Comparator<String> compararString; public List<String> getLenguajes() { return lenguajes; } public Comparator<String> getCompararString() { return compararString; } public String execute() { compararString = new Comparator<String>() { public int compare(String valor1, String valor2) { return valor1.compareTo(valor2); } }; lenguajes = new ArrayList<String>(); lenguajes.add("Python"); lenguajes.add("Java"); lenguajes.add("Ruby"); lenguajes.add("C#"); lenguajes.add("C++"); lenguajes.add("Lisp"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:sort comparator="compararString" source="lenguajes" var="lenguajesOrd" /> <ul> <s:iterator value="#attr.lenguajesOrd"> <li><s:property /></li> </s:iterator> </ul> </body> </html>
subset
Obtiene un subconjunto de un iterador.
org.apache.struts2.views.jsp.iterator.SubsetIteratorTag
count
: Número máximo de elementos que queremos obtener.
decider
: Objeto Decider
que determinará si el elemento debe incluirse en el nuevo iterador.
source
: Iterador inicial.
var
: Nombre con el que se almacenará el nuevo iterador en page context.
Accion.java
import com.opensymphony.xwork2.ActionSupport; import java.util.ArrayList; import java.util.List; import org.apache.struts2.util.SubsetIteratorFilter.Decider; @SuppressWarnings("serial") public class Accion extends ActionSupport { private List<String> lenguajes; private Decider decisor; public List<String> getLenguajes() { return lenguajes; } public Decider getDecisor() { return decisor; } public String execute() { decisor = new Decider() { public boolean decide(Object elemento) throws Exception { String cadena = ((String) elemento); return cadena.startsWith("C"); } }; lenguajes = new ArrayList<String>(); lenguajes.add("Python"); lenguajes.add("Java"); lenguajes.add("Ruby"); lenguajes.add("C#"); lenguajes.add("C++"); lenguajes.add("Lisp"); return SUCCESS; } }
resultado.jsp
<%@ taglib uri="/struts-tags" prefix="s"%> <html> <body> <s:subset decider="decisor" source="lenguajes" var="lenguajesSub" /> <ul> <s:iterator value="#attr.lenguajesSub"> <li><s:property /></li> </s:iterator> </ul> </body> </html>
Uys hay novedades en cuanto a las etiquetas de Struts1, me gusta el doble-select.
Una vez que empiezas a usarl las custom tags.. no puedes vivir sin ellas.
A mi me encanta, y siempre la uso, DisplayTag:
http://displaytag.sourceforge.net/1.2/
@deckerix me suena la web, creo que la he visitado alguna vez. No tiene mala pinta.
Zootropo, siento el offtopic pero te recuerdo que ya ha salido la nueva película de Futurama, Futurama Into the Wild Green Yonder.
Un saludo
@CaLaBeRa para este tipo de cosas siempre son bienvenidos los offtopics 😀 ¡No me acordaba para nada!
Me voy a Amazon directo a ver si la tienen 🙂
Gracias 😉
Y dale con Futurama
Excelente, desde ahora me mudo a struts 2, es muy bueno
Excelente Blog !!! unicamente si podrias subir el poryecto web con los ejemplos !!! Muchas gracias
No he visto mejor blog que este 😉 ….felicitaciones, siempre he necesitado algo asi, ya que hago proyectos, y siempre me las he arreglado xD …. pero con esto aprenderemos a usar cada tag en su mejor potencial 😉 …
man excelente aporte
me sirvio demasiado
sigue asi !!!!!!!!!!!!
La verdad es que es un how-to excelente, aqui les dejo un ejemplo de de como pasar parametros por la url en struts 2
http://www.serunix.com/2009/03/18/una-forma-de-direccionar-parametros-por-medio-de-la-url-en-struts-2%E2%80%A6-rediect-actionparam%E2%80%A6
Hola
Realizando una aplicación con struts 2 necesito solicitar un año (que puede ser de 1900 al 2010) y había pensado en poner un
Pero al ejecutarlo me sale un 0 por defecto en el campo de texto…
¿Como puedo evitar que salga ese 0? ¿Me recomiendas otra opcion para solicitar el año?
GRACIAS por adelantado y muy bueno el post.
Saludos
Hola Muy bueno!!
Pero tengo un problemilla, necesito mostrar la información de un objeto que es atributo de un action y no se como. Porque con
me muestra los atributos del ation, pero si mi atributo es un objeto y quiero ver un atributo de este objeto no se como hacerlo.
Muy buen tutorial…. excelentemente bien explicado y claro.
Tengo una duda de casualidad sabras como cambiar la apariencia de un mensaje el cual recuperas de tu archivo Action.properties?
Como por ejemplo que este mensaje te aparezca en color rojo…
muy buen blog muy completo buenos ejemplos felicitaciones!!!! si hubiera encontrado este blog cuando empezaba con Struts 2…
Gracias….
Un gran trabajo..
Podrias detallar un poco mas la parte de internalizacion(i18n), no me quedo muy claro lo del ejemplo expuesto.
podrias mostrar el ejecutable de la aplicacion web y ver el resultado
me encantó todo. Estoy empesando con strut2 y por fin, despues de tanto buscar , encontré por fin un tutorial para las etiquetas de Strust. Gracias
Te agradeceria mucho si tuvieras algun documento para poder estudiar como aplicarle diseño a las paguinas jsp de netbeasn con struts 2 /struts-tags
Muy amable
es un buen tutorial gracias y no tendras uno con conexiones a base de datos.
Hola que tal, tengo un problema con esto:
me tira error, he leido en varios lugares que ponen los .tld en WEB-INF, yo queria donde puedo conseguir esos archivos ?
Hola.
He comenzado con Struts 2 y buscando información me he topado con esta entrada. Felicidades, puesto que está todo comentado y es una guía de referencia para los que empezamos en este mundillo.
Tengo una consulta que no he logrado resolver ni encontrar en ningún sitio. Ojalá podáis ayudarme.
Quiero comprobar que un objeto de sesión es nulo y he probado de varias formas distintas, pero no me funciona nada.
Y la siguiente línea de código me da un error porque el TLD no admite expresiones (cosa que si permitía Struts 1).
¿Sabéis cómo puedo hacerlo?. Un saludo y Muchas gracias.
Veo que no han salido las líneas de código, las pongo de nuevo quitando las paerturas y cierres.
Las siguientes son las que no funcionan bien (no hacen lo que deben hacer correctamente).
s:if test=»%{user == null}»
s:if test=»%{session.user == null}»
s:if test=»#session.user == null»
Y la siguiente es la que me da el error porque el TLD no admite expresiones.
s:if test=»${user == null}»
Solucionado. El problema estaba en que previamente a la carga de la jsp hacía un «request.getSession().invalidate();». Eso sí, las únicas opciones válidas para hacer la comprobación en la jsp con tag de Struts 2 que me han funcionado son (sin los signos de apertura y cierre):
s:if test=»%{user == null}»
s:if test=»#session.user == null»
Saludos.
Excelente!
gracias x la información, muy útil para alguién q recién comienza como yo.
Gracias por esta aportación, me ha sido de gran utilidad
Gracias! intento iniciarme con struts 2, no me es fácil…
Hola gente,
a ver ,estoy trabajando con APPFUSE, que a su vez usa Maven para llamar distintos frameworks , como puede ser STRUTS, JSP O HIBERNATE.
Mi pregunta es la siguiente, esto trabajando con una base de datos creada en MySql , y quisiera añadir un SELECT que guarde la opcion elegida en una columna de dicha base de datos. No se si ¿me sirve el select que viene en este tutorial?
Siempre y cuando sepas trabajar con el valor dentro de tu aplicación web, por supuesto que te conviene. Honestamente no veo en que influye el uso de una u otra Base de Datos.
Saludos!