NF3 - Framework JSP (15h)

STRUTS2

Struts2 és framework d'aplicacions web populars basada en el patró de disseny MVC. Struts2 no és només la propera versió de Struts 1, però és una reescriptura completa de l'arquitectura Struts.

Característiques

• Formes POJO i accions POJO - Struts2 ha acabat amb les formes d'acció que van ser una part integral del marc de treball Struts. Amb Struts2, es pot utilitzar qualsevol POJO per rebre el formulari d'entrada. De la mateixa manera, ara es pot veure qualsevol POJO com una classe d'Acció.

• Compatible amb etiquetes - Struts2 ha millorat les etiquetes de formulari i les noves etiquetes permeten als desenvolupadors escriure menys codi.

• Suport AJAX - Struts2 ha integrat AJAX en el framework mitjançant la creació d'etiquetes d'AJAX, que funciona de manera molt similar a les etiquetes estàndard struts2.

• Fàcil integració - Integració amb altres frameworks com Spring i SiteMesh.

• Plantilles - Suport per utilitzar plantilles.

• Suport Plugin - El comportament de Struts2 pot ser millorada utilitzant plugins. Existeixen una sèrie molt variada de plugins que estan disponibles per Struts2.

• Entorns - Struts2 ofereix l'entorn per depurar i l'entorn de l'aplicació. A més d'això, Struts també ofereix depuració integrada amb l'ajuda de eines de depuració.

• Fàcil modificar etiquetes - Els Tag Struts2 poden ser ajustats utilitzant plantilles Freemarker.

Instal·lació i configuració de Struts amb Netbeans

Per instal·lar els plugins de Stuts2 en Netbeans pots seguir aquesta mini guia: M7-UF2-Guia-Instalacio-Struts2-Netbeans

Arquitectura Struts2

Struts2 és un framework basat en el patró de disseny pull-MVC (o MVC2). El patró Model-View-Controller en Struts2 es realitza amb els següents cinc components bàsics:

• Interceptors
• Actions
• Value Stack / OGNL
• Results / Result types
• View technologies

Struts 2 és lleugerament diferent d'un marc MVC tradicional. L'acció es troba al model més que en el controlador i existeix un cert solapament.

El controlador s'implementa amb un filtre de servlet dispatch Struts2 així com interceptors, el model s'implementa amb accions, i la vista com una combinació de tipus de resultats i els resultats. La Value Stack / OGNL proporcionen fil comú, que uneix i permet la integració entre els altres components.

A més dels components anteriors, hi haurà una gran quantitat d'informació referent configuració del framework amb els components anteriors.

Aquest és el panorama arquitectònic del patró MVC Struts 2.

Cicle de vida

Basat en el digrama anterior, es pot explicar el cicle de petició vida de l'usuari en Struts 2 com segueix:

• L'usuari envia una petició al servidor per sol·licitar algun recurs (és a dir, pàgines).

• El FilterDispatcher mira la sol·licitud i determina l'acció apropiada.

• S'apliquen els interceptores configurats (ex: validació, càrrega d'arxius, etc.)

• S'executa l'acció seleccionada per realitzar l'operació sol·licitada.

• S'apliquen els interceptors configurats per fer qualsevol processament posterior, si es requereix.

• Finalment el resultat es prepara per la vista i es retorna a l'usuari.

Interceptors

Els interceptors són classes que s'empren per especificar el cicle de vida d'una petició, i estan pensades per afegir funcionalitat extra a les actions. Podríem dir que un interceptor és semblat a un filtre de J2EE tret que el seu ús és més localitzat i es pot fer dependre de actions concrets i no que s'executi de forma global. Per configurar-los es fa de forma declarativa.

Els interceptors es solen usar per realitzar validacions, workflows, etc..., i quan es defineixen sobre un action, s'executen com els filtres, és a dir, de forma consecutiva com una cadena.

Actions

Els actions són POJOs (Plain Old Java Object). Qualsevol classe java amb un mètode execute() pot actuar com un Action. Així no es fa necessari implementar cap interfície.

package exemple;

import com.opensymphony.xwork2.ActionSupport;
import java.util.Date;

public class HolaMon extends ActionSupport {
	public static final String MESSAGE = "Hola a tots";
	private String message;

	public String execute() throws Exception {
		setMessage(MESSAGE);
		return SUCCESS;
	}

	public void setMessage(String message){
		this.message = message;
	}
	
	public String getMessage() {
		return message;
	}
	
	public String getCurrentTime(){
		return new Date().toString();
	}
}

Result

Totes les Actions han de retornar el Result a utilitzar per tal de renderitzar la JSP apropiada. Aquest Result s'identifica amb una cadena que s'utilitza en el fitxer struts.xml per associar-lo amb la pàgina JSP apropiada. En el cas que la cadena sigui la constant SUCCESS s'utilitzarà el result per defecte (el que no té un nom assignat). Los Results estàndards que es poden enviar son:

• SUCCESS
• ERROR (pàgina jsp d'error)
• INPUT (pàgina jsp de validació dels inputs d'un formulari)

Configuració: struts.xml

El gestor de la configuració és l'element encarregat de llegir el fitxer de control (struts.xml), analitzar-ho i en el cas que sigui correcte desplegar aquells elements que es referencien.

Exemple de configuració (struts.xml):

<struts>
    <include file="exemple.xml"/>
    <!-- Configuration for the default package. -->
    <package name="default" extends="struts-default">
    </package>
</struts>

##i el fitxer exemple.xml:
<struts>
    <package name="exemple" namespace="/exemple" extends="struts-default">
        <action name="HolaMon" class="exemple.HolaMon">
	    <result name="error">/exemple/error.jsp</result>
            <result>/exemple/HolaMon.jsp</result>
        </action>
    </package>
</struts>

## Els dos fitxers, struts.xml i exemple.xml han de estar en el mateix directori.

Per aclarir idees i mostrar com és l'arquitectura de Struts 2 s'afegeix un diagrama en el qual es pot veure de forma gràfica quina elements són els que intervenen dins del processament d'una petició HTTP, distingint-se quins són elements d'estàndards de J2EE, quins són elements propis de Struts 2 i quins són creats per l'usuari.

Exercici Hola Mon

La pàgina de benvinguda ha de mostrar el text: "hola a tots. Benvinguts a la pàgina de M7" i a més a més, ha de mostrar la data actual.

1. Creació del Package exemple
2. Crea el controlador (Action).
3. Creació de la vista (HolaMon.jsp) en el directori pages:
4. Creació del fitxer de configuració

Com funciona l'aplicació HolaMon?

El navegador envia una petició al servidor web mitjançant la adreça:

http://ip-server/struts2/HolaMon.action.

• El servidor intenta buscar el recurs HolaMon.action. Struts 2 configura el web.xml de tal forma que envia les peticions al filtre org.apatxe.struts2.dispatcher.FilterDispatcher.

El fitxer de configuració web.xml conté el següent:

<filter>
	<filter-name>struts2</filter-name>
	<filter-class>
		org.apache.struts2.dispatcher.FilterDispatcher
	</filter-class>
</filter>

<filter-mapping>
	<filter-name>struts2</filter-name>
	<url-pattern>/*</url-pattern>
</filter-mapping>

• El framework busca el action HelloWorld utilitzant el fitxer struts.xml. En trobar una definició de action que correspon amb el patró de la url, crea una instància de la classe corresponent que apareix en el attribute class. Utilitzant el API d'introspecció realitza la crida al mètode execute() de l'objecte.
• A continuació el mètode execute fixa el missatge i retorna SUCCESS.
• El framework determina què pàgina es carrega en el cas que SUCCESS sigui retornat. Per a això identifica que si es retorna SUCCESS buscarà en el xml l'etiqueta action result que no tingui cap name. En el nostre cas, el servidor carrega la pàgina HolaMon.jsp.

El Fitxer de configuració struts.xml

El framework Struts 2 utilitza un fitxer de configuració anomenat struts.xml per inicialitzar els recursos, com poden ser:

• Interceptors que poden processar, abans o després, una petició.
• Actions que modifiquen la lògica de negoci i accedeixen a les dades
• Results que poden preparar les vistes utilitzant JavaServer o FreeMarker.

El fitxer struts.xml és el fitxer central de la configuració del framework i ha d'estar en el classpath de l'aplicació web.

Les seves característiques son les següents:

• Permet la seva descomposició en petits fitxers de configuració xml que han d'estar inclosos en el principal.

Exemple:

<struts>
	.....
	......
	<include file="file1.xml"/>
	<include file="file2.xml"/>
	.....
	.....
</struts>

Un error en qualsevol d'aquests fitxers produeix que l'aplicació no es pugui carregar.

En aquest enllaç podeu trobar el DTD del fitxer de configuració struts.xml DTD-struts2

L'etiqueta Package

Els paquets s'utilitzen per agrupar actions, results, type results, interceptors i interceptors stack. Els paquets son similars als objectes de manera que poden heretar (extends) uns dels altres.

El tag <package /> s'utilitza per agrupar les configuracions que tinguin atributs en comú (interceptors o namespaces).

El package té els següents atributs:

1. name: ha d'identificar de manera única un paquet. Aquest atribut és l'únic obligatori.
2. extends: Identifica el nom del paquet del que heretarà tota la informació de configuració, incloent la configuració dels action. D'aquesta manera, tota la configuració del paquet estarà disponible en un nou paquet, sota un nou nom.
3. namespace: s'afegeix el namespace a les URL del paquet. Por exemple, per dos paquets diferents, con noms “pack1” i “pack2”, la URL te la següent forma: “/webApp/pack1/my.action” i “/webAppl/pack2/my.action”.
4. abstract: si el valor d'aquest atribut és true, el paquet és una agrupació de configuracions i actions que no serán accesibles vía el

nom del paquet. Es important assegurar-se de que se algún altre paquet l'hereta per a que la seva configuració esté disponible.

L'etiqueta include

El tag <include /> s'utilitza per modularitzar una aplicació struts2. Només conté un atribut file amb el nom del fitxer que s'inclourà. Els fitxers tenen la mateixa estructura que struts.xml Exemple:

<struts>
<include file="invoices-config.xml" />
<include file="admin-config.xml" />
<include file="reports-config.xml" />
</struts>

L'etiqueta Bean

Aquesta etiqueta ens permet definir Beans globals, però no es sol necessitar en la majoria d'aplicacions. Es necessiten

1. class:És l'unic atribut obligatori. Identifica la classe que implementa el Bean.
2. type:Interface que implementa el Bean.
3. name:Nom del bean per a que poguem recuperar-lo en les pàgines.
4. scope:Àmbit del bean. Aquest pot ser: Default, singleton, request, session o thread.

Exemple:

<struts>
	...
<bean type="net.ObjectFactory" name="factory" class="sample.MyObjectFactory" />
	...
</struts>

L'etiqueta constant

Les constants realitzen dos funcions:

1. Representar les dades, ex: MAX_FILESIZE: mida màxima d'un fitxer que es pot penjar.
2. Especificar el Bean escollit, d'entre les múltiples implementacions que poden existir.

Les constants es poden declarar en múltiples fitxers, el frmework de struts els cercarà en el següent ordre:

• struts-default.xml
• struts-plugin.xml
• struts.xml
• struts.properties
• web.xml

Exemple:

<struts>
	...
	<constant name="struts.devMode" value="true" />
	...
</struts>

Exercici Login

Es vol fer la validació, mitjançant un formulari, d'un usuari. Els volrs del usuari no es trobaran emmagatzemats en una base de dades, si no, que es trobaran en el mateix Action. Funcionament:

1. La pàgina de login mostrarà el formulari d'entrada.
2. L'usuari introduirà el nom i la paraula de pas, i clicarà en el botó de login.
3. La validació del usuari es realitzarà en el action.
   1. Nom usuari: admin
   2. Paraula de pas:admin
4. Si la validació és correcta, es mostrarà una pàgina que indiqui que ha entrat a l'aplicació.
5. Si la validació és incorrecta, es veurà una pàgina d'error amb un missatge que indiqui el problema