Mundo Geek » struts 2

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

Struts 2

Zootropo — Sun, 08 Feb 2009 16:32:25 +0000

Struts 2 es, como el nombre sugiere, la nueva versión del popular framework de desarrollo web en Java Apache Struts. Sin embargo, contrariamente a lo que cabría esperar, el código de ambos tiene poco que ver, dado que Struts 2 no se basa en el código de Struts 1.x, sino en el de otro framework de desarrollo web en Java llamado WebWork, un framework que el creador de Struts consideraba superior a Struts 1.x en varios aspectos.

Struts 2 está basado en el patrón MVC (Modelo-Vista-Controlador), una arquitectura que busca reducir el acoplamiento dividiendo las responsabilidades en 3 capas claramente diferenciadas:

El modelo, que hace referencia a los datos que maneja la aplicación y las reglas de negocio que operan sobre ellos y que se traducen en Struts 2 en las acciones.
La vista, encargada de generar la interfaz con la que la aplicación interacciona con el usuario. En Struts 2 equivale a los resultados.
El controlador, que comunica la vista y el modelo respondiendo a eventos generados por el usuario en la vista, invocando cambios en el modelo, y devolviendo a la vista la información del modelo necesaria para que pueda generar la respuesta adecuada para el usuario. El controlador se implementa en Struts 2 mediante el filtro FilterDispatcher

Por supuesto, podríamos utilizar JSP y servlets para crear una aplicación utilizando el patrón MVC: en una aplicación con JSP y servlets clásica se suelen utilizar páginas JSP para la vista, un servlet como controlador (patrón front controller) y POJOs (Plain Old Java Objects) para el modelo. El modelo, a su vez, suele estar dividido en dos subcapas siguiendo el patrón DAO (Data Access Object).

Sin embargo no tiene sentido reinventar la rueda cuando podemos recurrir a un framework, como Struts 2, para que se encargue de obtener y transformar los parámetros de las peticiones del cliente, validar los datos, buscar qué acción se debe realizar en el modelo según la petición, buscar la página a mostrar al usuario según la respuesta del modelo, proporcionar los datos del modelo a la vista, ocuparse de la internacionalización, etc.

Veamos cómo crear un pequeño “Hola mundo” con Struts 2. O mejor aún: un hola algo.

Como IDE utlizaremos Eclipse. También necesitaremos un servidor de aplicaciones o un contenedor web, como Tomcat. Para ver cómo integrar tu servidor en Eclipse puedes consultar la entrada Eclipse y Tomcat, adaptando los pasos necesarios en caso de utilizar un servidor distinto.

Por supuesto también necesitaremos descargar Struts 2 desde su página web. En principio basta con descargar las librerías que componen Struts 2 y sus dependencias (Essential Dependencies Only) aunque también os puede interesar descargar la versión completa (Full Distribution) que incluye además la documentación, el código fuente, y distintas aplicaciones de ejemplo.

En todo caso una vez hemos descargado Struts 2, Eclipse y Tomcat ya está todo listo para comenzar a trabajar.

Abrimos Eclipse y nos dirigimos a File -> New -> Dynamic Web Project para crear un nuevo proyecto para web dinámica. En Project name introducimos el nombre que queramos utilizar para el proyecto, por ejemplo, hola. Pulsamos Finish.

Copiamos las librerías básicas a la carpeta WebContent\WEB-INF\lib. Estas son commons-fileupload, commons-logging, freemarker, ognl, struts2-core y xwork. Hacemos clic con el botón derecho sobre el proyecto, y seleccionamos Refresh para que Eclipse las vea.

Editamos el descriptor de despliegue (web.xml) para añadir el filtro que sirve a Struts 2 a modo de punto de entrada a la aplicación: FilterDispatcher. Hacemos doble clic sobre “Deployment Descriptor: hola” y sustituimos el contenido por el siguiente:



    hola

    
        index.jsp
    

    
        struts
        org.apache.struts2.dispatcher.FilterDispatcher
    

    
        struts
        /*

Como vemos lo único que estamos haciendo es indicar al contenedor web (Tomcat en este caso) que toda petición, tenga esta la URL que tenga, debe pasar por el filtro FilterDispatcher. FilterDispatcher es en realidad el controlador de nuestra aplicación; nosotros sólo tendremos que ocuparnos de la vista y el modelo, llamados resultados y acciones en la terminología de Struts 2.

Ahora vamos a crear la página de inicio de nuestra aplicación. Como en el descriptor de despliegue hemos indicado que index.jsp es uno de los “archivos de bienvenida” (welcome-file), cuando en la URL no se especifique el archivo a mostrar dentro del directorio se mostrará por defecto index.jsp; de esta forma tanto http://localhost:8080/hola/index.jsp como http://localhost:8080/hola/ mostrarán nuestra nueva página.

Hacemos clic con el botón derecho sobre WebContent y seleccionamos New -> JSP, en File name escribimos index.jsp y pulsamos Finish. El contenido de la página será el siguiente:

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

Como vemos se utiliza la directiva taglib de JSP para indicar al contenedor que queremos usar la librería de etiquetas struts-tags, para las que se usará el prefijo “s”. Los nombres de las etiquetas de struts-tags que utilizamos son bastante descriptivos: estamos creando un formulario () con un campo de texto () y un botón de enviar (), que mandará los datos a la acción Hola (campo action del formulario).

Veamos ahora el código de la acción Hola. Las acciones en Struts 2 son clases Java que suelen implementar la interfaz Action o extender la clase ActionSupport (suelen, porque no es obligatorio). Creamosla haciendo clic con el botón derecho sobre Java Resources:src y seleccionando New -> Class; en Name, introducimos Hola y pulsamos Finish. Al crear el WAR de la aplicación el archivo .class acabará en WebContent/WEB-INF/classes. El código de la acción es el siguiente:

import com.opensymphony.xwork2.ActionSupport;

@SuppressWarnings("serial")
public class Hola extends ActionSupport {
    private String nombre;

    public String getNombre() {
        return nombre;
    }

    public void setNombre(String nombre) {
        this.nombre = nombre;
    }

    public String execute() {
        System.out.println(nombre);
        return SUCCESS;
    }
}

El código a ejecutar por nuestra acción está contenido en un método execute(). Como vemos la funcionalidad es bastante pobre, una simple excusa para utilizar una acción, ya que podríamos haber prescindido totalmente de ella. Sin embargo este código tan sencillo, que imprime en la consola el nombre que el usuario introdujo en el formulario, pone de manifiesto algo bastante interesante y es que no aparece por ningún lado un objeto HttpServletRequest ni similar del que obtener el valor del parámetro nombre del formulario, luego, ¿de dónde sale la propiedad nombre?

Lo cierto es que Struts 2 (o más bien el interceptor param de Struts 2) nos tiene preparada una sorpresa, y es que basta con crear getters y setters con los nombres de los campos de los formularios para que estos se rellenen auto mágicamente, incluso aunque las propiedades no sean cadenas y sea necesaria una sencilla conversión. Este es el trabajo del interceptor param, como hemos dicho.

Los interceptores son unos de los elementos más importantes de Struts 2. Se trata de objetos que ejecutan código antes y después de una cierta acción, de forma que podamos añadir nueva funcionalidad no relacionada directamente con el modelo de forma modular. Tenemos interceptores para logging, para validación, para capturar excepciones, etc.

Como vemos el método execute devuelve un string indicando el resultado de la acción. En este caso se devuelve SUCCESS, que es una constante proveniente de la clase que extendemos, ActionSupport, y cuyo valor es “success”. ¿Y de qué sirve esto? Pues para que Struts 2 sepa a qué página redirigir, según el mapping que definimos en el archivo de configuración de Struts 2 struts.xml.

Vamos a crear este archivo. Hacemos clic con el botón derecho sobre Java Resources:src, seleccionamos New -> XML, pulsamos Next y seleccionamos como nombre struts.xml y como directorio de destino src. Este archivo acabará en WebContent/WEB-INF/classes al crear el WAR de la aplicación. Su contenido debe ser el siguiente:





    
        
            /hola.jsp

En este caso lo que estamos haciendo es indicar al framework que queremos que se ejecute el código de la clase Hola cuando llegue una petición a Hola.action, y que se muestre la página hola.jsp como resultado cuando el valor devuelto sea “success”.

Vamos a ver por último el código de hola.jsp. Hacemos clic con el botón derecho sobre WebContent y seleccionamos New -> JSP; en File name escribimos hola.jsp y pulsamos Finish. El contenido del archivo es el siguiente:

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



Hola

En esta página lo único que hacemos es utilizar la etiqueta para mostrar la propiedad nombre de la acción, que se toma de una pila de valores llamada ValueStack.

Solo resta probar el código de nuestra aplicación. Arrastramos el proyecto sobre nuestra instancia de Tomcat en la pestaña Servers, e iniciamos el servidor haciendo clic con el botón derecho sobre él y seleccionando Start. Si abrimos la URL http://localhost:8080/hola/ en nuestro navegador y todo funciona correctamente, deberíamos ver algo como esto: