Etiquetas Struts 2

Zootropo — Fri, 13 Feb 2009 19:57:23 +0000

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"%>



Antes de s:action



Después de s:action

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

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"%>

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"%>

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 registrados;
	private List vips;

	public List getRegistrados() {
		return registrados;
	}

	public List getVips() {
		return vips;
	}

	public String execute() {
		registrados = new ArrayList();
		registrados.add("Juan");
		registrados.add("Manuel");

		vips = new ArrayList();
		vips.add("Pedro");
		vips.add("María");

		return SUCCESS;
	}
}

resultado.jsp

<%@ taglib uri="/struts-tags" prefix="s"%>




	
	


Usuarios:

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"%>




	Raúl


Bienvenido

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"%>

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"%>




Muchas gracias.


Pues es una lástima.

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 lenguajes;

	public List getLenguajes() {
		return lenguajes;
	}

	public String execute() {
		lenguajes = new ArrayList();
		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"%>

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 lenguajes;

	public List getLenguajes() {
		return lenguajes;
	}

	public String execute() {
		lenguajes = new ArrayList();
		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"%>

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"%>




Hoy es 

Año nuevo

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 canciones;

	public Artista(String nombre, List canciones) {
		this.nombre = nombre;
		this.canciones = canciones;
	}

	public String getNombre() {
		return nombre;
	}

	public List 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 artistas;

	public List getArtistas() {
		return artistas;
	}

	public String execute() {
		artistas = new ArrayList();

		List canciones_p = new ArrayList();
		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 canciones_c = new ArrayList();
		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"%>

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"%>

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"%>

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"%>

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"%>




Archivo: 

Tipo: 

Contenido:

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"%>

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"%>




Comisión del 1%
Comisión del 2%
Comisión del 3%

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

Bienvenido a ${param.web}

index.jsp

<%@ taglib uri="/struts-tags" prefix="s"%>




	http://mundogeek.net

Contenido.

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 lenguajes;

	public List getLenguajes() {
		return lenguajes;
	}

	public String execute() {
		lenguajes = new ArrayList();
		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"%>

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 lenguajes;

	public List getLenguajes() {
		return lenguajes;
	}

	public String execute() {
		lenguajes = new ArrayList();
		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"%>



Tus lenguajes preferidos son:

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 lista1;
	private List lista2;

	public List getLista1() {
		return lista1;
	}

	public void setLista1(List lista1) {
		this.lista1 = lista1;
	}

	public List getLista2() {
		return lista2;
	}

	public void setLista2(List lista2) {
		this.lista2 = lista2;
	}

	public String execute() {
		lista1 = new ArrayList();
		lista1.add("Uno");
		lista1.add("Dos");
		lista1.add("Tres");

		lista2 = new ArrayList();
		lista2.add("1");
		lista2.add("2");
		lista2.add("3");

		return SUCCESS;
	}
}

resultado.jsp

<%@ taglib uri="/struts-tags" prefix="s"%>

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 registrados;
	private HashMap vips;

	public HashMap getVips() {
		return vips;
	}

	public void setVips(HashMap vips) {
		this.vips = vips;
	}

	public HashMap getRegistrados() {
		return registrados;
	}

	public void setRegistrados(HashMap registrados) {
		this.registrados = registrados;
	}

	public String execute() {
		registrados = new HashMap();
		registrados.put("Juan", "Juan Encina");
		registrados.put("Manuel", "Manuel Robledo");

		vips = new HashMap();
		vips.put("Pedro", "Pedro Peral");
		vips.put("María", "María Manzano");

		return SUCCESS;
	}
}

resultado.jsp

<%@ taglib uri="/struts-tags" prefix="s"%>

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 registrados;
	private HashMap vips;

	public HashMap getVips() {
		return vips;
	}

	public void setVips(HashMap vips) {
		this.vips = vips;
	}

	public HashMap getRegistrados() {
		return registrados;
	}

	public void setRegistrados(HashMap registrados) {
		this.registrados = registrados;
	}

	public String execute() {
		registrados = new HashMap();
		registrados.put("Juan", "Juan Encina");
		registrados.put("Manuel", "Manuel Robledo");

		vips = new HashMap();
		vips.put("Pedro", "Pedro Peral");
		vips.put("María", "María Manzano");

		return SUCCESS;
	}
}

resultado.jsp

<%@ taglib uri="/struts-tags" prefix="s"%>

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"%>

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"%>




Visita

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 lenguajes;

	public List getLenguajes() {
		return lenguajes;
	}

	public String execute() {
		lenguajes = new ArrayList();
		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"%>

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"%>

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 lenguajes;

	public List getLenguajes() {
		return lenguajes;
	}

	public String execute() {
		lenguajes = new ArrayList();
		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"%>

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"%>



Raúl
Hola

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"%>

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"%>




	en



	fr



	Español
	Inglés
	Francés

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"%>

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"%>

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"%>

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"%>




	
		The Pragmatic Programmer … 50€
		Code Complete … 50€

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 lenguajes;

	public List getLenguajes() {
		return lenguajes;
	}

	public String execute() {
		lenguajes = new ArrayList();
		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"%>

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"%>

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 lenguajes;
	private Comparator compararString;

	public List getLenguajes() {
		return lenguajes;
	}

	public Comparator getCompararString() {
		return compararString;
	}

	public String execute() {
		compararString = new Comparator() {
			public int compare(String valor1, String valor2) {
				return valor1.compareTo(valor2);
			}
		};

		lenguajes = new ArrayList();
		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"%>

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 lenguajes;
	private Decider decisor;

	public List 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();
		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"%>

Mundo Geek » etiquetas

Etiquetas Struts 2

action

actionerror

actionmessage

a

append

bean

checkbox

checkboxlist

combobox

date

debug

div

doubleselect

fielderror

file

form

component

head

hidden

i18n

if-elseif-else

include

Bienvenido a ${param.web}

inputtransferselect

iterator

label

merge

optgroup

optiontransferselect

param

password

property

push

radio

reset

select

set

submit

text

textarea

textfield

token

url

updownselect

generator

sort

subset

Etiquetas ID3 de los MP3s en el menú contextual de Nautilus