Etiquetas Struts 2

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 atributo class de HTML. Indica la clase CSS a utilizar para el elemento HTML generado.
  • cssStyle: El atributo style de HTML. Permite definir el estilo del elemento inline, en lugar de utilizar un archivo CSS externo o una etiqueta style.
  • disabled: Determina si el control está deshabilitado.
  • label: Etiqueta que acompañará al widget. Genera una clásica etiqueta label de HTML.
  • required: Booleano indicando si el campo es obligatorio. Si es así muestra un asterisco al lado de la etiqueta.
  • tabindex: El atributo tabindex de HTML. Utilizado para establecer el orden a seguir al recorrer los controles cuando el usuario pulsa la tecla de Tabulación
  • template: 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>

Struts 2 etiqueta checkboxlist

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>

Struts 2 etiqueta combobox

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>

Struts 2 etiqueta doubleselect

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>

Struts 2 etiqueta file

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>

Struts 2 etiqueta inputtransferselect

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>

Struts 2 etiqueta optgroup

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>

Struts 2 etiqueta optiontransferselect

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>

Struts 2 etiqueta password

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>

Struts 2 etiqueta reset

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>

Struts 2 etiqueta select

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>

Struts 2 etiqueta textarea

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>

Struts 2 etiqueta textfield

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>

Struts 2 etiqueta updownselect

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>



28 comentarios en «Etiquetas Struts 2»

  1. 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

  2. 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 😉 …

  3. 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

  4. 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.

  5. 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…

  6. 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

  7. 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 ?

  8. 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.

  9. 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}»

    1. 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.

  10. 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?

    1. 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!

Responder a malditosan Cancelar respuesta

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.