ValidationAndList_it

This is version 5. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

Questo tutorial dipende da Parte III: Creare Action e JSP.

Informazioni su questo Tutorial

Ti dirò come fare le cose nel Mondo Reale in un testo come questo.

Indice

• [1] Aggiungi i tag Validator di XDoclet a Person.java
• [2] Visualizza la JSP con la validazione aggiunta ed effettua un test
• [3] Aggiungi i metodi testGetPeople ai Test di DAO e Manager
• [4] Aggiungi i metodi getPeople a PersonDao e Manager
• [5] Aggiungi il metodo testSearch al Test della Action
• [6] Aggiungi il metodo search alla Action
• [7] Crea personList.jsp ed il test Canoo
• [8] Aggiungi un collegamento al menu

Aggiungi i tag Validator di XDoclet a Person.java [#1]

Grazie ad XDoclet, è molto più semplice - devi solo aggiungere un paio di tag @struts.validator alla classe Person. Apri (src/dao/**/model/Person.java) e modifica i metodi getFirstName() e getLastName() in modo da includere i tag @struts.validator type="required".

Puoi anche aggiungere un attributo msgkey a questo tag per fare l'override della chiave di default relativa al messaggio associato a questo errore.

La chiave di default per type="required" è già errors.required, pertanto io di solito la lascio al valore di default. Questa chiave viene specificata in web/WEB-INF/classes/ApplicationResources_*.properties. Come avrai notato, stiamo mettendo questi tag nei getter di questa classe per quanto la documentazione di XDoclet dica di metterli nei setter. Questo perché stiamo generando il nostro PersonForm.java - il file del modello (metadata/template/struts_form.xdt) si preoccupa di mettere questi tag sui setter nel file generato.

Ora se registri Person.java ed esegui ant clean webdoclet, verrà generato un file validation.xml in build/appfuse/WEB-INF/. Il suo contenuto dovrebbe includere una voce per "personForm".

La validazione lato-client è attivata per default in personForm.jsp. C'è un tag JSP <html:javascript> ed uno script in fondo alla pagina che lo attiva. Ciò che segue dovrebbe esser già presente (grazie ad AppGen) - ma potresti aver bisogno di rimuovere il commento se avevi commentato il blocco nel file nel tutorial precedente.

<html:javascript formName="personForm" cdata="false"
    dynamicJavascript="true" staticJavascript="false"/>
<script type="text/javascript" 
    src="<html:rewrite page="/scripts/validator.jsp"/>"></script>

NOTA: Se hai oggetti innestati con regole di validazione, verrano presi e messi nel validation.xml. Ciò avviene in quanto un tag @struts.validator viene aggiunto al setter dell'oggetto innestato quando viene generato il form (usando metadata/templates/struts_form.xdt). Se hai relazioni molti-a-molti bidirezionali fra oggetti, ciò potrebbe essere un problema. Ci sono due soluzioni per risolvere la questione. La prima è eliminare il tag @struts.validator tag da struts_form.xdt e posizionarlo a mano sul setter nel tuo POJO. La seconda viene descritta qui.

Visualizza la JSP con la validazione aggiunta ed effettua un test [#2]

Ora che hai configurato la Validazione per questo form, ogni volta che questo form viene usato in un action-mapping con validate="true", verranno applicate queste regole. Nell'ultimo tutorial, abbiamo aggiunto l'action-mapping "savePerson" per la PersonAction. I tag XDoclet per questo action-mapping erano:

Pertanto ora, se la tua web/pages/personForm.jsp ha un <html:form action="savePerson">, dovrebbe intervenire la validazione ogni volta che proviamo ad inviare questo form. Esegui ant db-load deploy, avvia Tomcat e vai a http://localhost:8080/appfuse/editPerson.html?id=1.

Se cancelli i valori nei campi firstName e lastName e fai clic sul pulsante registra, dovresti ottenere il seguente alert JavaScript.

Per assicurarti che le cose funzionino davvero come previsto, puoi spegnere JavaScript e verificare se la validazione lato-server sta funzionando. Ciò è semplice in Firefox (il mio browser preferito), basta che vai in Strumenti → Preferenxe → Contenuto e deselezioni "Abilita JavaScript". Ora se cancelli i campi e invii il form, dovresti vedere il messaggio seguente:

se non vedi questi errori di validazione, ci sono un paio di possibilità:

• Il form registra cin un messaggio di successo, ma i campi firstName e lastName sono ora vuoti.

Questo perché l'<html:form> in web/pages/personForm.jsp ha action="editPerson" - controlla che abbia action="savePerson".

• Fai clic su registra, ma compare una pagina vuota.

La pagina vuota indica che l'attributo "input" del tuo forward "savePerson" non è stato configurato correttamente. Controlla se si riferisca ad un action-forward locale o globale. In questo esempio, dovrebbe essre input="edit", che punta alla definizione del tile .personDetail. Dalla mia esperienza, il valore di input dovrebbe essere un forward, non un path ad una action.

Aggiungi i metodi testGetPeople ai Test di DAO e Manager [#3]

Apri test/dao/**/dao/PersonDaoTest.java ed agiungi un metodo testGetPeople:

Il motivo per cui sto passando un oggetto person al metodo getPeople è per permettere in futuro di filtrare il risultato (basandomi come criterio sui valori presenti in person). Aggiungere questo parametro alla firma del tuo metodo getPeople() è opzionale, ma il resto di questo tutorial assume tu lo abbia fatto.

Ora apri test/service/**/service/PersonManagerTest.java ed aggiungi un metodo testGetPeople:

Affinché questi test compilino, devi aggiungere il metodo getPeople() alle interfacce PersonDao e PersonManager, nonché alle relative implementazioni.

Aggiungi i metodi getPeople a PersonDao e Manager [#4]

Ora aggiungi la medesima firma di metodo a src/service/**/service/PersonManager.java. Registra tutti i tuoi file e correggi gli import nei tuoi test. Come passo successivo devi implementare il metodo getPeople() nelle tue classi di implementazione. Apri src/dao/**/dao/hibernate/PersonDaoHibernate.java ed aggiungi il metodo seguente:

Noterai qui che che nulla è stato fatto con il parametro person. Per il momento è solo un segnaposto - nel futuro potresti voler filtrare in base alle sue proprità usando il Linguaggio di Query di Hibernate (HQL) o le Query per Criteri.

Un esempio che usa le Query per Criteri:

// filter on properties set in the person object     HibernateCallback callback = new HibernateCallback() {         public Object doInHibernate(Session session) throws HibernateException {             Example ex = Example.create(person).ignoreCase().ignoreZeroes()                                 .enableLike(MatchMode.ANYWHERE);             return session.createCriteria(Person.class).add(ex).list();         }     };     return (List) getHibernateTemplate().execute(callback);

Ora implementa il metodo getPeople() in src/service/**/impl/PersonManagerImpl.java:

Dopo aver registrato tutte le tue modifiche, dovresti essere in grado di eseguire entrambi i test eseguendo i seguenti comandi:

• ant test-dao -Dtestcase=PersonDao
• ant test-service -Dtestcase=PersonManager

Se funziona tutto - ottimo lavoro! Ore devi aggiungere questa funzionalità di recupera tutto allo strato web.

Aggiungi il metodo testSearch al Test della Action [#5]

Questa classe non compilerà finché non aggiungi la variabile PERSON_LIST al file src/dao/**/Constants.java.

Di solito io copio una variabile analoga già esistente in questo file - i.e. USER_LIST.

Ora registra tutte le tue modifiche. Non puoi ancora eseguire ant test-web -Dtestcase=PersonAction in quanto PersonAction.search() non esiste (per il momento).

Aggiungi il metodo search alla Action [#6]

Ora aggiungi il metodo search all'interno dell classe PersonAction.

Ho utilizzato UserAction.search() come modello per questo metodo.

Esegui ant test-web -Dtestcase=PersonAction.

Bene! BUILD SUCCESSFUL
Total time: 1 minute 26 seconds

Crea personList.jsp ed il test Canoo [#7]

<display:setProperty name="paging.banner.items_name" value="persons"/>

Modificala in:

<display:setProperty name="paging.banner.items_name" value="people"/>

Infine, aggiungi le chiavi per titolo ed intestazione (personList.title e personList.heading) a web/WEB-INF/classes/ApplicationResources.properties. Apri questo file ed aggiungi quanto segue:

# -- person list page --
personList.title=Person List
personList.heading=All People

Come promemoria, il personList.title è ciò che finisce nella barra del titolo del tuo browser (il tah <title>) e personList.heading verrà messo in un tag <h1> prima di qualsiasi contenuto della pagina.

A questo punto, dovresti essere in grado di eseguire ant clean deploy, avvia Tomcat e vedi la pagina nel tuo browser su http://localhost:8080/appfuse/editPerson.html?method=Search.

Ora che abbiamo un Schermata Elenco, modifichiamo le pagine che sono visualizzate all'aggiunta di una nuova Person e alla sua eliminazione. In src/web/**/action/PersonAction.java, modifica il mapping.findForward("mainMenu") nei metodi save, delete e cancel in modo che diventi:

Devi anche modificare verifyForward("mainMenu") in verifyForward("viewPeople") nel metodo testRemove di test/web/**/action/PersonActionTest.java. Per ultimo, i test Canoo "AddPerson" e "DeletePerson" devono essere aggiornati. Apri test/web/web-tests.xml e modifica la seguente riga nel target "AddPerson":

<verifytitle description="Main Menu appears if save successful" 
    text=".*${mainMenu.title}.*" regex="true"/>

in:

<verifytitle description="Person List appears if save successful" 
    text=".*${personList.title}.*" regex="true"/>

Poi nel target "DeletePerson", modifca la seguente riga:

<verifytitle description="display Main Menu" 
    text=".*$(mainMenu.title}.*" regex="true"/>

in:

<verifytitle description="display Person List" text=".*${personList.title}.*" regex="true"/>

Infine, dichiara il forward viewPeople in metadata/web/global-forwards.xml dopo viewUsers come qui sotto:

<forward name="viewPeople" path="/editPerson.html?method=Search"/>

Il nome "viewPeople" viene usato al posto di "list" in modo che venga eseguito il metodo search, invece di effettuare un semplice forward alla personForm.jsp (cui punta il forward "list").

Per verificare che la visualizzazione di questa pagina funzioni, crea un nuovo test JSP in test/web/web-tests.xml:

Vorrai anche aggiungere il target "SearchPeople" al target "PersonTests" in modo che venga eseguito insieme agli altri test relativi a person.

Ora puoi eseguire ant test-canoo -Dtestcase=SearchPeople (o ant test-jsp se Tomcat non è in esecuzione) e sperabilmente otterrai come risultato un "BUILD SUCCESSFUL". Se è così - ottimo lavoro!

Aggiungi un collegamento al menu [#8]

Dove menu.viewPeople è una voce nel file web/WEB-INF/classes/ApplicationResources.properties.

menu.viewPeople=View People

Un'alternativa (più probabile) è che tu voglia aggiungere questa voce al menu. Per far questo, aggiungi quanto segue a web/WEB-INF/menu-config.xml:

Controlla che l'XML su indicato si trovi all'interno del tag <Menus>, ma non dentro un altro tag <Menu>. Poi aggiungi questo nuovo menu a to web/common/menu.jsp - che ora dovrebbe presentarsi in questo modo:

Ora se esegui ant clean deploy, avvi Tomcat e vai a http://localhost:8080/appfuse/mainMenu.html, dovresti vedere qualcosa di simile alla schermata qui sotto.

Nota che c'è un nuovo collegamento sul lato sinistro (da mainMenu.jsp) e sulla destra nel nostro menu (da menu.jsp).

È tutto!

Buona Giornata!

new-menu-item.png		9138 bytes
validation-required.png		10049 bytes
validation-required-nojs.png		9277 bytes