Clase 11 12-tags struts2

Tags en Struts2

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

http://mundogeek.net/archivos/2009/02/08/struts-2/

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

1. <%@ taglib uri="/struts-tags" prefix="s"%> 2. 3. <html>

4. <body>

5. Antes de s:action 

6. <s:action name="Accion" executeResult="true"/> 7. Después de s:action 8. </body>

9. </html>

Accion.java

1. import com.opensymphony.xwork2.ActionSupport; 2. 3. @SuppressWarnings("serial")

4. public class Accion extends ActionSupport {

5. private String web; 6. 7. public String getWeb() {

8. return web; 9. } 10. 11. public String execute() {

12. web = "mundogeek.net";

13. return SUCCESS; 14. } 15. }

resultado.jsp

1. <%@ taglib uri="/struts-tags" prefix="s"%> 2. 3. 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 interfazValidationAware,

que ActionSupport implementa. Los métodos y propiedades deValidationAware 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



5. public String execute() {

6. addActionError("Oh dios mío, ¡un error!");

7. return ERROR; 8. } 9. }

resultado.jsp


4. <body>

5. <s:actionerror />

6. </body>

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



5. public String execute() {

6. addActionMessage("Tengo un mensaje para usted.");


resultado.jsp


4. <body>

5. <s:actionmessage/>

6. </body>

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

1. import com.opensymphony.xwork2.ActionSupport;

2. import java.util.List;

3. import java.util.ArrayList; 4. 5. @SuppressWarnings("serial")


7. private List<String> registrados;

8. private List<String> vips; 9. 10. public List<String> getRegistrados() {

11. return registrados; 12. } 13. 14. public List<String> getVips() {

15. return vips; 16. } 17. 18. public String execute() {

19. registrados = new ArrayList<String>();

20. registrados.add("Juan");

21. registrados.add("Manuel"); 22. 23. vips = new ArrayList<String>();

24. vips.add("Pedro");

25. vips.add("María"); 26. 27. return SUCCESS; 28. } 29. }

resultado.jsp


4. <body>

5. <s:append var="usuarios">

6. <s:param value="%{registrados}" />

7. <s:param value="%{vips}" />

8. </s:append> 9. 10. Usuarios: 11. <ul>

12. <s:iterator value="usuarios">

13. <li><s:property /></li>

14. </s:iterator>

15. </ul>

16. </body>

17. </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

1. public class Usuario {

2. private String nombre; 3. 4. public String getNombre() {

5. return nombre; 6. } 7. 8. public void setNombre(String nombre) {

9. this.nombre = nombre; 10. } 11. }

resultado.jsp


4. <body>

5. <s:bean name="Usuario" var="miUsuario">

6. <s:param name="nombre">Raúl</s:param>

7. </s:bean> 8. 9. Bienvenido <s:property value="#miUsuario.nombre"/>

10. </body>

11. </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


4. <body>

5. <s:form action="Accion">

6. <s:checkbox label="Aceptar condiciones" name="condiciones" value="true" />

7. <s:submit value="Enviar" />

8. </s:form>

9. </body>

10. </html>

Accion.java



5. private boolean condiciones; 6. 7. public boolean isCondiciones() {

8. return condiciones; 9. } 10. 11. public void setCondiciones(boolean condiciones) {

12. this.condiciones = condiciones; 13. } 14. 15. public String execute() {


resultado.jsp

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

3. <html>

4. <body>

5. <s:if test="condiciones"> 6. Muchas gracias. 7. </s:if>

8. <s:else> 9. Pues es una lástima. 10. </s:else>

11. </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





7. private List<String> lenguajes; 8. 9. public List<String> getLenguajes() {

10. return lenguajes; 11. } 12. 13. public String execute() {

14. lenguajes = new ArrayList<String>();

15. lenguajes.add("Python");

16. lenguajes.add("Java");

17. lenguajes.add("Ruby");

18. lenguajes.add("C#");

19. lenguajes.add("C++");

20. lenguajes.add("Lisp");


resultado.jsp


4. <body>

5. <body>

6. <s:form>

7. <s:checkboxlist list="lenguajes" name="lenguajes-preferidos" />


9. </s:form>

10. </body>

COMBOBOX

Crea una combinación de select y caja de texto. El valor de la caja de texto se auto rellena

según el elemento seleccionado en el select.

org.apache.struts2.views.jsp.ui.ComboBoxTag

emptyOption: Indica si queremos añadir una opción vacía.

list (requerido): Iterable con los valores con los que generar la lista.

listKey: Propiedad de los objetos del iterable del que el checkbox correspondiente tomará su

valor.

listValue: Exactamente igual al anterior, pero en lugar del valor, el contenido.

name: Nombre a usar para el elemento.

readonly: Si queremos que el usuario pueda escribir sus propios valores en la caja de texto.

Accion.java

resultado.jsp


4. <body>

5. <body>

6. <s:form action="Otro">

7. <s:combobox list="lenguajes" name="nombre-lenguajes"

8. label="Lenguaje preferido" readonly="true" />


10. </s:form>

11. </body>

DATE

Permite mostrar una fecha almacenada en una cierta variable indicando opcionalmente el

formato a utilizar.

org.apache.struts2.views.jsp.DateTag

format: Formato a utilizar para mostrar la fecha. Si queremos usar siempre el mismo formato

podemos crear un archivo properties con una entrada struts.date.format. Por defecto se

utiliza el formato DateFormat.MEDIUM.

name (requerido): Nombre de la variable que contiene la fecha a mostrar.

nice: Utiliza un formato que facilita la lectura. Por defecto se utiliza inglés para mostrar los

mensajes; si queremos traducirlo a algún otro idioma tendremos que recurrir a las funciones de

internacionalización de Struts 2. Las claves a traducir son las siguientes:

CLAVE VALOR POR DEFECTOstruts.date.format.past {0} agostruts.date.format.future in {0}struts.date.format.seconds an instantstruts.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

1. import com.opensymphony.xwork2.ActionSupport; 2. 3. import java.util.Calendar;

4. import java.util.Date; 5. 6. @SuppressWarnings("serial")


8. private Date ahora;

9. private Date anyoNuevo; 10. 11. public Date getAhora() {

12. return ahora; 13. } 14. 15. public Date getAnyoNuevo() {

16. return anyoNuevo; 17. } 18. 19. public String execute() {

20. ahora = new Date(); 21. 22. Calendar cal = Calendar.getInstance(); 23. int anyo = cal.get(Calendar.YEAR);

24. cal.set(anyo + 1, Calendar.JANUARY, 1);

25. anyoNuevo = cal.getTime(); 26. 27. return SUCCESS; 28. } 29. }

resultado.jsp


4. <body>

5. <body>

6. Hoy es <s:date name="ahora" format="d 'de' MMMM 'de' yyyy" /> 

7. Año nuevo <s:date name="anyoNuevo" nice="true" />

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

1. import java.util.List; 2. 3. public class Artista {

4. private String nombre;

5. private List<String> canciones; 6. 7. public Artista(String nombre, List<String> canciones) {

8. this.nombre = nombre;

9. this.canciones = canciones; 10. } 11. 12. public String getNombre() {

13. return nombre; 14. } 15. 16. public List<String> getCanciones() {

17. return canciones; 18. } 19. }

Accion.java





7. private List<Artista> artistas; 8. 9. public List<Artista> getArtistas() {

10. return artistas; 11. } 12. 13. public String execute() {

14. artistas = new ArrayList<Artista>(); 15. 16. List<String> canciones_p = new ArrayList<String>();

17. canciones_p.add("El equilibro es imposible");

18. canciones_p.add("Años 80");

19. canciones_p.add("Promesas que no valen nada");

20. Artista piratas = new Artista("Los piratas", canciones_p); 21. artistas.add(piratas);

22. 23. List<String> canciones_c = new ArrayList<String>();

24. canciones_c.add("Viva la vida");

25. canciones_c.add("Clocks");

26. canciones_c.add("Life in technicolor");

27. Artista coldplay = new Artista("Coldplay", canciones_c); 28. artistas.add(coldplay); 29. 30. return SUCCESS; 31. } 32. }

resultado.jsp


4. <body>

5. <body>

6. <s:form action="Otro">

7. <s:doubleselect label="Selecciona la canción" list="artistas"

8. listValue="nombre" doubleList="canciones" doubleName="cancion" />


10. </s:form>

11. </body>

FIELDERROR

Muestra los errores que se han detectado al validar los campos del formulario. Por defecto se

muestran todos los errores, pero podemos seleccionar que se muestren sólo los relativos a

ciertos campos pasándole etiquetas param. El funcionamiento es parecido al

de actionerror y actionmessage: podemos añadir errores utilizando el

método addFieldError(String fieldName, String errorMessage) de la

interfazValidationAware, 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


4. <body>

5. <s:fielderror /> 6. 7. <s:form action="Accion">

8. <s:textfield label="Nombre" name="nombre" />


10. </s:form> 11. 12. </body>

13. </html>

Accion.java



5. private String nombre; 6. 7. public String getNombre() {

8. return nombre; 9. } 10. 11. public void setNombre(String nombre) {

12. this.nombre = nombre; 13. } 14. 15. public String execute() {

16. if(nombre.length() > 10) {

17. addFieldError("nombre", "El nombre no puede tener más de 10 caracteres.");

18. return ERROR; 19. } 20. 21. return SUCCESS; 22. } 23. }

resultado.jsp


4. <body>

5. <body>

6. <s:fielderror />

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


4. <body> 5. 6. <s:form enctype="multipart/form-data" method="POST" action="Accion">

7. <s:file label="Archivo a enviar" name="archivoTexto"

8. accept="text/txt" />


10. </s:form> 11. 12. </body>

13. </html>

Accion.java


2. import java.io.BufferedReader;

3. import java.io.File;

4. import java.io.FileReader;

5. import java.io.IOException; 6. 7. @SuppressWarnings("serial")


9. private File archivoTexto;

10. private String archivoTextoContentType;

11. private String archivoTextoFileName;

12. private String contenido; 13. 14. public String getContenido() {

15. return contenido; 16. } 17. 18. public File getArchivoTexto() {

19. return archivoTexto; 20. } 21. 22. public void setArchivoTexto(File archivoTexto) {

23. this.archivoTexto = archivoTexto; 24. } 25. 26. public String getArchivoTextoContentType() {

27. return archivoTextoContentType; 28. } 29. 30. public void setArchivoTextoContentType(String archivoTextoContentType) {

31. this.archivoTextoContentType = archivoTextoContentType; 32. } 33. 34. public String getArchivoTextoFileName() {

35. return archivoTextoFileName; 36. } 37. 38. public void setArchivoTextoFileName(String archivoTextoFileName) {

39. this.archivoTextoFileName = archivoTextoFileName; 40. } 41. 42. public String execute() throws IOException {

43. BufferedReader input = new BufferedReader(new FileReader(archivoTexto)); 44. 45. String linea = "";

46. contenido = "";

47. while ((linea = input.readLine()) != null)

48. contenido = contenido + linea; 49. 50. return SUCCESS; 51. } 52. }

resultado.jsp


4. <body>

5. <body>

6. Archivo: <s:property value="archivoTextoFileName"/> 

7. Tipo: <s:property value="archivoTextoContentType"/>

8. Contenido: <s:property value="contenido"/>

9. </body>

FORM

Crea un elemento form de HTML.

org.apache.struts2.views.jsp.ui.FormTag

action: Acción a la que se enviará la petición con los datos del formulario. También se puede

enlazar otras páginas o servlets. Si no utilizamos el atributo para especificar el destino se utiliza

la misma página del formulario.

namespace: Espacio de nombres al que pertenece la acción a la que se enviará la petición. Por

defecto se utiliza el espacio de nombres actual.

validate: Si queremos validar los campos del formulario antes de enviarlos.

COMPONENT

Utilizado para crear nuestras propias etiquetas sin tener que recurrir a la API de etiquetas de

JSP.

org.apache.struts2.views.jsp.ui.ComponentTag

HEAD

Etiqueta auxiliar que se coloca dentro de la etiqueta head de HTML y se encarga de generar

distintos elementos necesarios para otras etiquetas, como las etiquetas para la carga de hojas

de estilo o scripts.

org.apache.struts2.views.jsp.ui.HeadTag

HIDDEN

Crea un campo oculto.

org.apache.struts2.views.jsp.ui.HiddenTag

I18N

Carga un archivo de recursos adicional con la traducción de nuestros mensajes y los coloca

en ValueStack de forma que puedan ser accedidos fácilmente por el código que se encuentre

dentro de la etiqueta.

org.apache.struts2.views.jsp.I18nTag

name (requerido): Nombre del ResourceBundle a cargar.


4. <body> 5. 6. <s:i18n name="textos">

7. <s:text name="bienvenida" />

8. </s:i18n> 9. 10. </body>

11. </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


4. <body> 5. 6. <s:if test="ventas < 1000">Comisión del 1%</s:if>

7. <s:elseif test="ventas < 2000">Comisión del 2%</s:elseif>

8. <s:else>Comisión del 3%</s:else> 9. 10. </body>

11. </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

1. <h1>Bienvenido a ${param.web}</h1>

index.jsp


4. <body>

5. <s:include value="header.jsp">

6. <s:param name="web">http://mundogeek.net</s:param>

7. </s:include> 8. Contenido. 9. </body>

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

1. import com.opensymphony.xwork2.ActionSupport; 2. import java.util.List; 3. import java.util.ArrayList; 4. 5. @SuppressWarnings("serial") 6. public class Accion extends ActionSupport { 7. private List<String> lenguajes; 8. 9. public List<String> getLenguajes() {

10. return lenguajes; 11. } 12. 13. public String execute() { 14. lenguajes = new ArrayList<String>(); 15. lenguajes.add("Python"); 16. lenguajes.add("Java"); 17. lenguajes.add("Ruby"); 18. lenguajes.add("C#"); 19. lenguajes.add("C++"); 20. lenguajes.add("Lisp"); 21. return SUCCESS; 22. } 23. }

resultado.jsp


4. <body>

5. <s:form>

6. <s:inputtransferselect label="¿Cuáles son tus lenguajes favoritos?"

7. list="lenguajes" />


9. </s:form>

10. </body>

11. </html>

ITERATOR

Para iterar sobre colecciones. En cada iteración el objeto recuperado se coloca

enValueStack 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















resultado.jsp


4. <body> 5. Tus lenguajes preferidos son: 6. <ul>

7. <s:iterator value="lenguajes">


9. </s:iterator>

10. </ul>

11. </body>

12. </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





7. private List<String> lista1;

8. private List<String> lista2; 9. 10. public List<String> getLista1() {

11. return lista1; 12. } 13. 14. public void setLista1(List<String> lista1) {

15. this.lista1 = lista1; 16. } 17. 18. public List<String> getLista2() {

19. return lista2; 20. } 21. 22. public void setLista2(List<String> lista2) {

23. this.lista2 = lista2; 24. } 25. 26. public String execute() {

27. lista1 = new ArrayList<String>();

28. lista1.add("Uno");

29. lista1.add("Dos");

30. lista1.add("Tres"); 31. 32. lista2 = new ArrayList<String>();

33. lista2.add("1");

34. lista2.add("2");

35. lista2.add("3"); 36. 37. return SUCCESS; 38. } 39. }

resultado.jsp


4. <body> 5. 6. <s:merge var="nuevaLista">

7. <s:param value="lista1" />

8. <s:param value="lista2" />

9. </s:merge> 10. 11. <ul>

12. <s:iterator value="nuevaLista">


14. </s:iterator>

15. </ul>

16. </body>

17. </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

1. import com.opensymphony.xwork2.ActionSupport; 2. 3. import java.util.HashMap; 4. 5. @SuppressWarnings("serial")


7. private HashMap<String, String> registrados;

8. private HashMap<String, String> vips; 9. 10. public HashMap<String, String> getVips() {

11. return vips; 12. } 13. 14. public void setVips(HashMap<String, String> vips) {

15. this.vips = vips; 16. } 17.

18. public HashMap<String, String> getRegistrados() {

19. return registrados; 20. } 21. 22. public void setRegistrados(HashMap<String, String> registrados) {

23. this.registrados = registrados; 24. } 25. 26. public String execute() {

27. registrados = new HashMap<String, String>();

28. registrados.put("Juan", "Juan Encina");

29. registrados.put("Manuel", "Manuel Robledo"); 30. 31. vips = new HashMap<String, String>();

32. vips.put("Pedro", "Pedro Peral");

33. vips.put("María", "María Manzano"); 34. 35. return SUCCESS; 36. } 37. }

resultado.jsp


4. <body> 5. 6. <s:form>

7. <s:select list="{}">

8. <s:optgroup label="Registrados" list="registrados" />

9. <s:optgroup label="VIPs" list="vips" />

10. </s:select>


12. </s:form> 13. 14. </body>

15. </html>

OPTIONTRANSFERSELECT

Crea un componente consistente en dos selects cuyos elementos pueden traspasarse de uno a

otro.

org.apache.struts2.views.jsp.ui.OptionTransferSelectTag

doubleList (requerido): El iterador con los valores que tendrá el segundo select al comenzar.

doubleName (requerido): Nombre a utilizar para el elemento.

leftTitle: Título del primer select.

list: El iterador con los valores que tendrá el primer select al comenzar.

rightTitle: Título del segundo select

Accion.java

1. import com.opensymphony.xwork2.ActionSupport; 2. 3. import java.util.HashMap; 4. 5. @SuppressWarnings("serial")


7. private HashMap<String, String> registrados;

8. private HashMap<String, String> vips; 9. 10. public HashMap<String, String> getVips() {

11. return vips; 12. } 13. 14. public void setVips(HashMap<String, String> vips) {

15. this.vips = vips; 16. } 17. 18. public HashMap<String, String> getRegistrados() {

19. return registrados; 20. } 21. 22. public void setRegistrados(HashMap<String, String> registrados) {

23. this.registrados = registrados; 24. } 25. 26. public String execute() {

27. registrados = new HashMap<String, String>();

28. registrados.put("Juan", "Juan Encina");

29. registrados.put("Manuel", "Manuel Robledo"); 30. 31. vips = new HashMap<String, String>();

32. vips.put("Pedro", "Pedro Peral");

33. vips.put("María", "María Manzano"); 34. 35. return SUCCESS; 36. } 37. }

resultado.jsp


4. <body> 5. 6. <s:form action="Otro">

7. <s:optiontransferselect list="registrados" leftTitle="Registrados"

8. doubleList="vips" rightTitle="VIPs" doubleName="usuarios" />


10. </s:form> 11. 12. </body>

13. </html>

PARAM

Utilizada para añadir parámetros a otras etiquetas.

org.apache.struts2.views.jsp.ParamTag

name: Nombre del parámetro.

value: Valor del parámetro.

PASSWORD

Crea un elemento password de HTML.

org.apache.struts2.views.jsp.ui.PasswordTag

showPassword: Indica si queremos que se muestren los caracteres en claro.

resultado.jsp



7. <s:textfield label="Nombre" />

8. <s:password label="Contraseña" />


10. </s:form> 11. 12. </body>

13. </html>

PROPERTY

Muestra una propiedad de ValueStack u otro objeto de ActionContext.

org.apache.struts2.views.jsp.PropertyTag

default: Valor a mostrar en caso de que el valor pedido sea nulo.

escape: Determina si queremos que se escape el HTML. Por defecto es true.

value: Valor a mostrar.

Accion.java



5. private String web; 6. 7. public String getWeb() {

8. return web; 9. } 10. 11. public void setWeb(String web) {

12. this.web = web; 13. } 14. 15. public String execute() {

16. web = "mundogeek.net";


resultado.jsp


4. <body> 5. 6. Visita <s:property value="web" default="google.es" />

7. </body>

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















resultado.jsp


4. <body>

5. <s:form>

6. <s:radio label="Selecciona tu lenguaje preferido" list="lenguajes" />


8. </s:form>

9. </body>

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





9. <s:reset value="Borrar" />


11. </s:form> 12. 13. </body>

14. </html>

SELECT

Crea un elemento select.

org.apache.struts2.views.jsp.ui.SelectTag

list: El iterable con los valores que tendrá el select.

Accion.java





7. private List<String> lenguajes;

8. 9. public List<String> getLenguajes() {










resultado.jsp



7. <s:select label="Lenguaje preferido" list="lenguajes" />


9. </s:form> 10. 11. </body>

12. </html>

SET

Asigna un valor a una variable, opcionalmente indicando el ámbito al que añadirla. El valor se

puede indicar utilizando el atributo value, o encerrando el valor en la propia etiqueta.

org.apache.struts2.views.jsp.SetTag

name: Nombre a utilizar para la variable.

scope: Ámbito en el que añadir la variable. Puede

ser application, session, request,page, o action. Por defecto se utiliza action.

value: Valor a asignar.

resultado.jsp


4. <body>

5. <s:set name="nombre">Raúl</s:set>

6. Hola <s:property value="nombre" />

7. </body>

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





9. <s:reset value="Borrar" />

11. </s:form> 12. 13. </body>

14. </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


4. <body>

5. <s:url id="en" action="Accion">

6. <s:param name="request_locale">en</s:param>

7. </s:url> 8. 9. <s:url id="fr" action="Accion">

10. <s:param name="request_locale">fr</s:param>

11. </s:url> 12. 13. <ul>

14. <li><s:a href="Accion">Español</s:a></li>

15. <li><s:a href="%{en}">Inglés</s:a></li>

16. <li><s:a href="%{fr}">Francés</s:a></li>

17. </body>

18. </html>

Accion.properties

mensaje = ¡Hola Mundo!

Accion_en.properties

mensaje = Hello World!

Accion_fr.properties

mensaje = Bonjour le monde!

resultado.jsp


4. <body>

5. <s:text name="mensaje" />

6. </body>

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


4. <body>

5. <s:textarea cols="40" rows="10" value="Hola mundo" />

6. </body>

7. </html>

TEXTFIELD

Crea una caja de texto.

org.apache.struts2.views.jsp.ui.TextFieldTag

maxlength: Atributo maxlength de HTML (número máximo de caracteres permitidos)

readonly: Determina si el campo será de solo lectura.

size: Atributo size de HTML (tamaño de la caja de texto en caracteres)

resultado.jsp


4. <body>

5. <s:textfield label="Nombre" maxlength="10" size="10" />

6. </body>

7. </html>

TOKEN

Añade un token oculto al formulario para ayudar a los interceptores token ytokenSession a

evitar que el usuario mande la misma petición varias veces por error.

org.apache.struts2.views.jsp.ui.TokenTag

resultado.jsp


4. <body>

5. <s:form action="Comprar">

6. <ul>

7. <li>The Pragmatic Programmer … 50€</li>

8. <li>Code Complete … 50€</li>

9. </ul>

10. <s:token />

11. <s:submit value="Comprar" />

12. </s:form>

13. </body>

14. </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















resultado.jsp

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

3. <html>


7. <s:updownselect label="Lenguaje preferido" list="lenguajes" />


9. </s:form> 10. 11. </body>

12. </html>

GENERATOR

Genera un nuevo iterador. Los valores se obtienen dividiendo la cadena val usando como

separador el caracter indicado en separator.

org.apache.struts2.views.jsp.iterator.IteratorGeneratorTag

converter: Objeto de tipo Converter con el que realizar las distintas operaciones que sean

necesarias con cada valor.

count: Número máximo de elementos que queremos generar.

separator (requerido): Separador utilizado para transformar la cadena en los distintos valores

del iterador.

val (requerido): La cadena de la que se generarán.

var: Nombre con el que se almacenará el nuevo iterador.

Accion.java


2. import org.apache.struts2.util.IteratorGenerator.Converter; 3. 4. @SuppressWarnings("serial")

6. private String lenguajes;

7. private Converter aMayusculas; 8. 9. public Converter getAMayusculas() {

10. return aMayusculas; 11. } 12. 13. public String getLenguajes() {


18. aMayusculas = new Converter() {

19. public Object convert(String cadena) throws Exception {

20. return cadena.toUpperCase(); 21. } 22. }; 23. 24. lenguajes = "Python,Java,Ruby,C#,C++,Lisp";


resultado.jsp


4. <body> 5. 6. <s:generator separator="," val="lenguajes" converter="aMayusculas"

7. var="listaLenguajes" /> 8. 9. <ul>

10. <s:iterator value="listaLenguajes">


12. </s:iterator>

13. </ul>

14. </body>

15. </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


2. import java.util.ArrayList;

3. import java.util.Comparator;

4. import java.util.List; 5. 6. @SuppressWarnings("serial")



9. private Comparator<String> compararString; 10. 11. public List<String> getLenguajes() {

12. return lenguajes; 13. } 14. 15. public Comparator<String> getCompararString() {

16. return compararString; 17. } 18. 19. public String execute() {

20. compararString = new Comparator<String>() {

21. public int compare(String valor1, String valor2) {

22. return valor1.compareTo(valor2); 23. } 24. }; 25. 26. lenguajes = new ArrayList<String>();






32. lenguajes.add("Lisp"); 33. 34. return SUCCESS; 35. } 36. }

resultado.jsp

4. <body> 5. 6. <s:sort comparator="compararString" source="lenguajes"

7. var="lenguajesOrd" /> 8. 9. <ul>

10. <s:iterator value="#attr.lenguajesOrd">


12. </s:iterator>

13. </ul>

14. </body>

15. </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


2. import java.util.ArrayList;

3. import java.util.List; 4. 5. import org.apache.struts2.util.SubsetIteratorFilter.Decider; 6. 7. @SuppressWarnings("serial")



10. private Decider decisor; 11. 12. public List<String> getLenguajes() {

13. return lenguajes; 14. } 15. 16. public Decider getDecisor() {

17. return decisor; 18. }

19. 20. public String execute() {

21. decisor = new Decider() {

22. public boolean decide(Object elemento) throws Exception {

23. String cadena = ((String) elemento);

24. return cadena.startsWith("C"); 25. } 26. }; 27. 28. lenguajes = new ArrayList<String>();






34. lenguajes.add("Lisp"); 35. 36. return SUCCESS; 37. } 38. }

resultado.jsp


4. <body> 5. 6. <s:subset decider="decisor" source="lenguajes" var="lenguajesSub" /> 7. 8. <ul>

9. <s:iterator value="#attr.lenguajesSub">


11. </s:iterator>

12. </ul>

13. </body>

14. </html>

Páginas con más información respecto a Struts2:

http://struts.apache.org/2.0.14/docs/tag-reference.html

http://www.roseindia.net/struts/struts2/struts2uitags/index.shtml

http://www.vaannila.com/struts-2/struts-2-tutorial/struts-2-tutorial.html

http://www.vaannila.com/struts-2/struts-2-tutorial/struts-2-tutorial.html

http://www.roseindia.net/struts/struts2/struts2uitags/index.shtml

http://struts.apache.org/2.0.14/docs/tag-reference.html

Clase 11 12-tags struts2

Documents

Transcript of Clase 11 12-tags struts2