Raible's Wiki: CreateManager

At line 8 changed 1 line.

Nel contesto di [AppFuse], questa viene denominata una classe Manager. La sua responsibilità principale è comportarsi da ponte fra il layer di persistenza (DAO) ed il layer web. È anche utile per disaccoppiare il tuo layer di presentazione dal tuo layer database (i.e. per applicazioni Swing). I Manager dovrebbero inoltre essere il luogo deputato nel quale mettere la business logic della tua applicazione.

Nel contesto di [AppFuse], questa viene denominata una classe Manager. La sua responsibilità principale è comportarsi da ponte fra il layer di persistenza (DAO) ed il layer web. È anche utile per disaccoppiare lo strato di presentazione dallo strato database (i.e. per applicazioni Swing). I Manager dovrebbero inoltre essere il luogo deputato nel quale mettere la business logic della tua applicazione.

At line 21 changed 1 line.

In [Part I|CreateDAO], we created a Person object and PersonDao - so let's continue developing this entity. First, let's create a JUnit test for the PersonManager. Create PersonManagerTest in the test/service/**/service directory. We'll want to test the same basic methods (get, save, remove) that our DAO has.

Nella [Parte I|CreateDAO_it], abbiamo creato un oggetto Person ed un PersonDao - pertanto continuiamo a sviluppare questa entità. Per primp, creiamo un test JUnit per il PersonManager. Crea PersonManagerTest nella directory test/service/**/service. Ora vogliamo verificare gli stessi metodi di base (get, save, remove) che possiede il nostro DAO.

At line 23 changed 1 line.

;:''This may seem redundant (why all the tests!), but these tests are GREAT to have 6 months down the road.''

;:''Ciò potrebbe sembrare ridondante (ma perché scrivere tutti i test!), ma è una GRAN cosa avere questi test quando sono passati 6 mesi dall'inizio dello sviluppo.''

At line 25 changed 1 line.

This class should extend [BaseManagerTestCase|http://raibledesigns.com/downloads/appfuse/api/org/appfuse/service/BaseManagerTestCase.java.html], which already exists in the ''service'' package. The parent class (BaseManagerTestCase) serves similar functionality as the BaseDaoTestCase.

Questa classe dovrebbe estendere [BaseManagerTestCase|http://raibledesigns.com/downloads/appfuse/api/org/appfuse/service/BaseManagerTestCase.java.html], che è già presente nel package ''service''. La classe base (BaseManagerTestCase) fornisce funzionalità analoghe al BaseDaoTestCase.

At line 27 changed 1 line.

;:%%(color: blue)''I usually copy (open → save as) an existing test (i.e. UserManagerTest.java) and find/replace [[Uu]ser with [[Pp]erson, or whatever the name of my object is.''%%

;:%%(color: blue)''Di solito io copio (open → save as) un test esistente (i.e. UserManagerTest.java) e faccio un find/replace [[Uu]ser con [[Pp]erson, o quale che sia il nome del mio oggetto.''%%

At line 29 changed 1 line.

The code below is what you need for a basic JUnit test of your Manager. Unlike the DaoTest, this test uses [jMock|http://jmock.org] to isolate the Manager from its dependencies and make it a ''true'' "unit" test. This can be very helpful because it allows you to test your business logic w/o worrying about other dependencies. The code below simply sets up the Manger and its dependencies (as Mocks) for testing.

Il codice qui sotto è tutto ciò di cui hai bisogno per un test JUnit di base del tuo Manager. Diversamente dal DaoTest, questo test usa [jMock|http://jmock.org] per isolare il Manager dalle sue dipendenze e renderlo un ''vero'' "unit" test. Ciò può essere di grande aiuto perché ti permette di verificare la tua business logic senza preoccuparti delle altre dipendenze. Il codice sottostante semplicemente inizializza il Manager e le sue dipendenze (come Mock) per effettuare i test.

At line 64 changed 1 line.

Now that you have the skeleton done for this class, you need to add the meat: the test methods to make sure everything works. Here's a snippet from the [DAO Tutorial|CreateDAO] tutorial to help you understand what we're about to do.

Ora che lo scheletro della classe è fatto, devi aggiungervi la carne: i metodi di test per far sì che tutto funzioni. Qui c'è un frammento tratto dal [Tutorial su DAO|CreateDAO_it] che ti aiuterà a caipre cosa stiamo per fare.

At line 66 changed 1 line.

;:''...we create methods that begin with "test" (all lower case). As long as these methods are public, have a void return type and take no arguments, they will be called by our <junit> task in our Ant build.xml file. Here's some simple tests for testing CRUD. An important thing to remember is that each method (also known as a test), should be autonomous.''

;:''...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.''

At line 68 changed 1 line.

Add the following methods to your PersonManagerTest.java file:

Aggiungi i metodi seguenti al tuo file PersonManagerTest.java:

At line 127 changed 1 line.

This class won't compile at this point because we have not created our PersonManager interface.

A questo punto questa classe non compilerà perché non abbiamo ancora creato la nostra interfaccia PersonManager.

At line 129 changed 1 line.

;:%%(color: blue)''I think it's funny how I've followed so many patterns to allow __extendibility__ in AppFuse. In reality, on most projects I've been on - I learn so much in a year that I don't want to extend the architecture - I want to rewrite it. Hopefully by keeping AppFuse up to date with my perceived best practices, this won't happen as much. Each year will just be an upgrade to the latest AppFuse, rather than a re-write. ;-)''

;:%%(color: blue)''Credo sia divertente il fatto che abbia seguito così tanti pattern per permettere l'__estensibilità__ in AppFuse. In realtà, nella maggior parte dei progetti sui quali sono stato - imparo così tanto in un anno che non voglio estendere l'archiettura - la voglio riscrivere. Sperabilmente mantenendo aggiornato AppFuse con quelle che io ritengo le best practices, ciò non succederà così spesso. Ogni anno sarà solo un aggiornamento alla versione più recente di AppFuse, piuttosto che una sua riscrittura. ;-)''

At line 133 changed 1 line.

First off, create a PersonManager.java interface in the src/service/**/service directory and specify the basic CRUD methods for any implementation classes. ''I've eliminated the JavaDocs in the class below for display purposes.'' The ''setPersonDao()'' method is not used in most cases - its just exists so the PersonManagerTest can set the DAO on the interface.

Per primo, crea un'interfaccia PersonManager.java nella directory src/service/**/service e specifica i metodi CRUD di base in tutte le classi che la implementano. ''Ho rimosso i JavaDoc nella classe sotto per motivi di visualizzazione.'' Il metodo ''setPersonDao()'' nella maggior parte dei casi non è usato - esiste giusto per permettere al PersonManagerTest di poter impostare il DAO sull'interfaccia.

At line 135 changed 1 line.

;:%%(color: blue)''As usual, I usually duplicate (open → save as) an existing file (i.e. UserManager.java).''%%

;:%%(color: blue)''Come sempre, io di solito duplico (apri → registra come) un file esistente (i.e. UserManager.java).''%%

At line 152 changed 1 line.

Now let's create a PersonManagerImpl class that implements the methods in PersonManager. To do this, create a new class in src/service/**/service/impl and name it PersonManagerImpl.java. It should extend BaseManager and implement PersonManager.

Ora creiamo una classe PersonManagerImpl che implementi i metodi in PersonManager. Per far questo, crea una nuova classe in src/service/**/service/impl e chiamala PersonManagerImpl.java. Deve estendere BaseManager ed implementare PersonManager.

At line 183 changed 1 line.

One thing to note is the {{setPersonDao()}} method. This is used by Spring to bind the PersonDao to this Manager. This is configured in the applicationContext-service.xml file. We'll get to configuring that in Step 3[3]. You should be able to compile everything now using "ant compile-service".

Una cosa da notare è il metodo {{setPersonDao()}}. Questo è usato da Spring per legare il PersonDao a questo Manager. Ciò è configurato nel flie applicationContext-service.xml. Arriveremo a configurare quello nel Passo 3[3]. Dovresti riuscire a compilare tutto ora con "ant compile-service".

At line 185 changed 1 line.

Now you need to edit Spring's config file for our services layer so it will know about this new Manager.

Ora devi modificare il file di configurazione di Spring per il nostro strato servizi in modo che sappia dell'esistenza di questo nuovo Manager.

At line 189 changed 1 line.

To notify Spring of this our PersonManager interface and its implementation, open the src/service/**/service/applicationContext-service.xml file. In here, you should see a commented out definition for the "personManager" bean. Uncomment this, or add the following to the bottom of this file.

Per notificare a Spring l'esistenza della nostra interfaccia PersonManager e della relativa implementazione, apri il file src/service/**/service/applicationContext-service.xml. Aggiungi quanto segue al termine di questo file.

At line 193 changed 4 lines.

</property>

At line 200 changed 1 line.

The "parent" attribute refers to a bean definition for a [TransactionProxyFactoryBean|http://www.springframework.org/docs/api/org/springframework/transaction/interceptor/TransactionProxyFactoryBean.html] that has all the basic transaction attributes set.

Questo bean deve avere un nome che termina con "Manager". Deve essere così, in quanto esiste un advice AOP che viene applicato su questo file per tutti i bean *Manager.

{{{<aop:advisor id="managerTx" advice-ref="txAdvice" pointcut="execution(* *..service.*Manager.*(..))" order="2"/>}}} Per ulteriori informazioni sulle transazioni con Spring, vedi [la documentazione di Spring|http://www.springframework.org/docs/reference/transaction.html].

At line 202 removed 1 line.

At line 205 changed 1 line.

Save all your edited files and try running __ant test-service -Dtestcase=PersonManager__.

Registra tutti i file da te modificati e prova ad eseguire __ant test-service -Dtestcase=PersonManager__.

At line 215 changed 1 line.

''Prossima Puntata:'' __Parte III:__ [Creating Actions and JSPs|CreateActions] - A HowTo for creating Actions and JSPs in the AppFuse architecture.

''Prossima Puntata:'' __Parte III:__ [Creare Action e JSP|CreateActions_it] - Un HowTo per la creazione di Action e JSP nell'architettura di AppFuse.

Raible's Wiki

AppFuse

Other Applications

CreateManager_it