Raible's Wiki: CreateDAO

At line 1 changed 1 line.

__Parte I:__ [Creare nuovi DAO ed Object in AppFuse|CreateDAO] - Un HowTo su come creare Java Object (che rappresentino tabelle) e creare classi Java per rendere persistenti tali oggetti nel database.

__Parte I:__ [Creare nuovi DAO ed Object in AppFuse|CreateDAO_it] - Un HowTo su come creare Java Object (che rappresentino tabelle) e classi Java per rendere persistenti tali oggetti nel database.

At line 46 changed 1 line.

Generate your getters and setters using your favorite IDE:

Genera i tuoi getter e setter usando il tuoi IDE preferito:

At line 48 changed 1 line.

Right-click -> Source -> Generate Getters and Setters

Pulsante Destro -> Source -> Generate Getters and Setters

At line 53 changed 1 line.

Questa classe deve estendere [BaseObject|http://raibledesigns.com/downloads/appfuse/api/org/appfuse/model/BaseObject.java.html], che ha 3 metodi astratti: (equals(), hashCode() e toString()) che dovrai implementarre per la classe Person. I primi due sono richiesti da Hibernate. Il modo più facile per farlo è usare [Commonclipse|http://commonclipse.sf.net]. Ulteriori informazioni sull'uso di questo strumento si possono trovare sul [sito di Lee Grey|http://www.leegrey.com/hmm/2004/09/29/1096491256000.html]. Un altro Plugin di Eclipse che puoi usare è [Commons4E|http://commons4e.berlios.de/]. Non l'ho usato, per cui non posso fare commenti sulle sul suo funzionamento.

Questa classe deve estendere [BaseObject|http://raibledesigns.com/downloads/appfuse/api/org/appfuse/model/BaseObject.java.html], che ha 3 metodi astratti: (equals(), hashCode() e toString()) che dovrai implementare per la classe Person. I primi due sono richiesti da Hibernate.

Se intendi mettere questo oggetto nella sessione dell'utente o esporlo tramite un web service, dovresti implementare anche {{java.io.Serializable}}.

At line 56 added 2 lines.

Il modo più facile per farlo è usare [Commonclipse|http://commonclipse.sf.net]. Ulteriori informazioni sull'uso di questo strumento si possono trovare sul [sito di Lee Grey|http://www.leegrey.com/hmm/2004/09/29/1096491256000.html]. Un altro Plugin di Eclipse che puoi usare è [Commons4E|http://commons4e.berlios.de/]. Non l'ho usato, per cui non posso fare commenti sulle sul suo funzionamento.

At line 71 changed 1 line.

Devi aggiungere anche un mapping per la primary key o XDoclet ti vomiterà addosso una serie di errori durante la generazione del file di mapping. Nota che tutti quei tag @hibernate.* devono essere posti all'interno del Javadoc dei __getter__ dei tuoi POJO.

Devi aggiungere anche un mapping per la primary key o XDoclet ti riempirà di errori durante la generazione del file di mapping. Nota che tutti quei tag @hibernate.* devono essere posti all'interno del Javadoc dei __getter__ dei tuoi POJO.

At line 96 changed 1 line.

Se vuoi dare un'occhio al file {{Person.hbm.xml}} che ti genera Hibernate, guarda nella directory {{build/dao/gen/**/model}}. Ecco il contenuto di {{Person.hbm.xml}} (finora):

Se vuoi dare un'occhiata al file {{Person.hbm.xml}} che ti genera Hibernate, guarda nella directory {{build/dao/gen/**/model}}. Ecco il contenuto di {{Person.hbm.xml}} (finora):

At line 170 changed 1 line.

Ora c'è da creare un DaoTest per verificare che il tuo DAO funzioni. "Aspetta un momento," mi dirai, "Io non ho creato un DAO!" Ed hai ragione. Tuttavia, ho scoperto che il [Test-Driven Development|http://www.artima.com/intv/testdriven.html] permette di tirar su codice di miglior qualità. Per anni ho pensato che lo __scrivere i test prima delle classi__ fosse una sonora boiata. É che mi sembrava stupido e basta. Poi ho provato a farlo ed ho scoperto che invece funziona alla grande. L'unico motivo per cui ora faccio tutto questa roba test-driven è perché ho scoperto che accelera in tempi brevi il processo di sviluppo software.

Ora c'è da creare un DaoTest per verificare che il tuo DAO funzioni. "Aspetta un momento," mi dirai, "Io non ho creato un DAO!" Ed hai ragione. Tuttavia, ho scoperto che il [Test-Driven Development|http://www.artima.com/intv/testdriven.html] permette di scrivere codice di miglior qualità. Per anni ho pensato che __scrivere i test prima delle classi__ fosse una sonora boiata. É che mi sembrava stupido e basta. Poi ho provato a farlo ed ho scoperto che invece funziona alla grande. L'unico motivo per cui ora faccio tutto questa roba test-driven è perché ho scoperto che accelera e riduce i tempi del processo di sviluppo software.

At line 192 changed 1 line.

Il codice che vedi qui sopra è tutto quello che ti server per un test di integrazione di base con Spring che inizializzi e configuri un'implementazione di PersonDao. Spring useraà l'autowiring byType per richiamare il metodo ''setPersonDao()'' ed impostare il bean "personDao" come dipendenza di questa classe.

Il codice che vedi qui sopra è tutto quello che ti server per un test di integrazione di base con Spring che inizializzi e configuri un'implementazione di PersonDao. Spring userà l'autowiring byType per richiamare il metodo ''setPersonDao()'' ed impostare il bean "personDao" come dipendenza di questa classe.

At line 194 changed 1 line.

Ora devi verificare che i metodi CRUD (create, retrieve, update, delete) funzionino nel tuo DAO. Per farlo crea dei metodi che inizino con "test" (tutto minuscolo). Se questi metodi sono pubblici, hanno un valore di ritorno {{void}} e non prendono argomenti, verranno richiamati dal task <junit> task nel build.xml. Qui sotto ci sono alcuni semplici test per verificare il CRUD. Una cosa importante da ricordare è che ogni metodo (noto anche come test), deve essere autonomo. Aggiungi i seguenti metodi al tuo file {{PersonDaoTest.java}}:

Ora devi verificare che i metodi CRUD (create, retrieve, update, delete) funzionino nel tuo DAO. Per farlo crea dei metodi che inizino con "test" (tutto minuscolo). Se questi metodi sono pubblici, hanno un valore di ritorno {{void}} e non prendono argomenti, verranno richiamati dal task <junit> del build.xml di Ant. Qui sotto ci sono alcuni semplici test per verificare il CRUD. Una cosa importante da ricordare è che ogni metodo (noto anche come test), deve essere autonomo. Aggiungi i seguenti metodi al tuo file {{PersonDaoTest.java}}:

At line 286 changed 1 line.

Prima di tutto, crea un'interfaccia PersonDao.java nella directory {{src/dao/**/dao}} e specifica i metodi CRUD basilari per tutte le classi di implementazione.

Prima di tutto, crea un'interfaccia PersonDao.java nella directory {{src/dao/**/dao}} e specifica i metodi CRUD principali per tutte le classi di implementazione.

At line 301 changed 1 line.

Notice in the class above there are no exceptions on the method signatures. This is due to the power of [Spring|http://www.springframework.org] and how it wraps Exceptions with RuntimeExceptions. At this point, you should be able to compile all the source in {{src/dao}} and {{test/dao}} using __ant compile-dao__. However, if you try to run __ant test-dao -Dtestcase=PersonDao__, you will get an error: <span style="color: red">No bean named 'personDao' is defined</span>. This is an error message from Spring - indicating that you need to specify a bean named ''personDao'' in {{applicationContext-hibernate.xml}}. Before you do that, you need to create the PersonDao implementation class.

Nota bene che nella classe qui sopra non ci sono eccezioni nelle firme dei metodi. Ciò è dovuto alla potenza di [Spring|http://www.springframework.org] e a come maschera le Exception con RuntimeException. A questo punto, dovresti essere in grado di compilare tutto il sorgente in {{src/dao}} e {{test/dao}} usando __ant compile-dao__. Tuttavia, se provi ad eseguire __ant test-dao -Dtestcase=PersonDao__, otterrai un errore: <span style="color: red">No bean named 'personDao' is defined</span>. Questo è un messaggio di errore provenienta da Spring - il quale indica che devi specificare un bean denominato ''personDao'' in {{applicationContext-hibernate.xml}}. Prima di farlo però, devi creare la classe di implementazione di PersonDao.

At line 303 changed 1 line.

;:''The ant task for running dao tests is called __test-dao__. If you pass in a testcase parameter (using __-Dtestcase=name__), it will look for {{**/*${testcase}*}} - allowing us to pass in Person, PersonDao, or PersonDaoTest - all of which will execute the PersonDaoTest class.''

;:''Il task ant per eseguire i test sui dao si chiama __test-dao__. Se passi un parametro testcase (using __-Dtestcase=name__), cercherà {{**/*${testcase}*}} - permettendoci di passare su Person, PersonDao, o PersonDaoTest - i quali eseguiranno tutti la classe PersonDaoTest.''

At line 305 changed 1 line.

Let's start by creating a PersonDaoHibernate class that implements the methods in PersonDao and uses Hibernate to get/save/delete the Person object. To do this, create a new class in {{src/dao/**/dao/hibernate}} and name it {{PersonDaoHibernate.java}}. It should extend [BaseDaoHibernate|http://raibledesigns.com/downloads/appfuse/api/org/appfuse/dao/BaseDAOHibernate.java.html] and implement PersonDao. ''Javadocs eliminated for brevity.''

Iniziamo con il creare una classe PersonDaoHibernate che implementi i metodi in PersonDao e usi Hibernate per ottenere/registrare/eliminare l'oggetto Person. Per far questo, crea una nuova classe in {{src/dao/**/dao/hibernate}} e chiamala {{PersonDaoHibernate.java}}. Dovrebbe estendere [BaseDaoHibernate|http://raibledesigns.com/downloads/appfuse/api/org/appfuse/dao/BaseDAOHibernate.java.html] ed implementare PersonDao. ''Javadoc eliminati per brevità.''

At line 338 changed 1 line.

Now, if you try to run __ant test-dao -Dtestcase=PersonDao__, you will get the same error. We need to configure Spring so it knows that PersonDaoHibernate is the implementation of PersonDao, and you also need to tell it about the Person object.

Ora, se provi ad eseguire __ant test-dao -Dtestcase=PersonDao__, otterrai lo stesso errore. Dobbiamo configurare Spring in modo che sappia che PersonDaoHibernate è l'implementazione di PersonDao, e dobbiamo dirgli anche qualcosa sull'oggetto Person.

At line 340 changed 1 line.

!!Configure Spring for the Person object and PersonDao [#5]

!!Configurare Spring per l'oggetto Person e il PersonDao [#5]

At line 342 changed 1 line.

First, you need to tell Spring where the Hibernate mapping file is located. To do this, open {{src/dao/**/dao/hibernate/applicationContext-hibernate.xml}} and add {{"Person.hbm.xml"}} to the following code block.

Innanzitutto, devi dire a Springdove si trova il file di mapping di Hibernate. Per farlo, apri {{src/dao/**/dao/hibernate/applicationContext-hibernate.xml}} ed aggiungi {{"Person.hbm.xml"}} al blocco di codice seguente.

At line 355 changed 1 line.

Now you need to add some XML to this file to bind PersonDaoHibernate to PersonDao. To do this, add the following at the bottom of the file:

Ora devi aggiungere un po' di XML a questo file per collegare PersonDaoHibernate a PersonDao. Per far questo, aggiungi quanto segue alla fine del file:

At line 359 changed 1 line.

At line 368 added 2 lines.

%%note __NOTA:__ Non dimenticare di correggere il nome del package nell'attributo "class" qui sopra se hai indicato un package diverso da org.appfuse quando hai creato il tuo progetto.%%

At line 374 changed 1 line.

''Next Up:'' __Part II:__ [Creating new Managers|CreateManager] - A HowTo for creating Business Facades, which are similar to [Session Facades|http://java.sun.com/blueprints/patterns/SessionFacade.html], but don't use EJBs. These facades are used to provide communication from the front-end to the DAO layer.

''Prossima Puntata:'' __Parte II:__ [Creare nuovi Manager|CreateManager_it] - Un HowTo sulla creazione di Business Façade, che sono simili alle [Session Façade|http://java.sun.com/blueprints/patterns/SessionFacade.html], ma non usano gli EJB. Queste façade sono usate per fornire un modalità di comunicazione dal front-end allo strato DAO.

Raible's Wiki

AppFuse

Other Applications

CreateDAO_it