Struts2 Setup – Ghid rapid de utilizare (Getting started with Struts 2 / Struts 2 fast setup guide)

Mai intai, downloadati o distributie de la http://struts.apache.org/download

Ce se gaseste in arhiva
Struts 2 este un framework java, deci un set de jar-uri.

1 Jar-urile
Unde gasim jar-urile? In directorul WEB-INF/lib.

Extrageti ce este in arhiva, si veti gasi un director apps care contine aplicatiile sample. Pentru a construi cea mai simpla aplicatie struts va fi nevoie doar de jar-urile folosite de aplicatia struts2-blank. Redenumiti fisierul struts2-blank.war astfel incat sa aiba extensia zip, extrageti continutul si veti gasi jar-urile ce compun frameworkul struts 2 in directorul WEB-INF\lib al arhivei tocmai extrase.

2 Xml-urile.
In interiorul directorului WEB-INF\src veti gasi in afara de sursele java, niste fisiere xml (struts.xml si example.xml).
struts.xml este fisierul unde ar trebui centralizate toate linkurile aplicatiei.
Asadar, in loc sa aveti asa ceva in multe locuri in pagini diferite, si anume
calea directa catre resursa :
< a href="/WEB-INF/resources/mypictures/pictureofme.html">My picture< / a >
veti avea asa ceva :
< a href="/pictures/gotomypicture.xhtml">My picture < /a >
calea catre “actiunea” struts.

In struts.xml trebuie sa se regaseasca ceva cam asa :

< ?xml version="1.0" encoding="UTF-8" ?>
< !DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
< struts>
< constant name="struts.action.extension" value="xhtml/">
< package name="default " namespace="/" extends="struts-default">

< action name="gotomypicture" class="mypackage.MyClass" method="aMethod">
< result name="success">/WEB-INF/resources/mypicture/pictureofme.html< /result>
< /action>
< /package>
< /struts>

Ce inseamna asta mai concret, este ca atunci cand linkul este accesat se cauta o actiune cu acelasi nume in struts.xml, este apelat codul metodei aMethod din clasa mypackage.MyClass; daca metoda intoarce stringul “succcess”, pagina va fi directata catre resursa pictureofme.html. Asadar, inainte de a schimba ceva prin click pe un buton sau un link, se poate executa ceva din logica aplicatiei, precum verificari de drepturi sau incarcari de tabele etc. Plus, totul este centralizat intr-un singur fisier.

3 Sursele
Sursele devin actiuni Struts 2 daca extind clasa ActionSupport. Pentru fiecare actiune ceva.xhtml, trebuie sa existe o metoda, intr-o clasa care extinde ActionSupport care sa fie apelata si in functie de ce returneaza sa se directeze spre o resursa sau alta.
In pachetul src exista exemplul standard.

In urmatoarea interventie vom analiza cum se poate integra rapid o aplicatie simpla Struts 2 cu Eclipse si Apache Ant.