Raible's Wiki

Raible Designs
Wiki Home
News
Recent Changes

AppFuse

Homepage
  - Korean
  - Chinese
  - Italian
  - Japanese

QuickStart Guide
  - Chinese
  - French
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish
  - Japanese

User Guide
  - Korean
  - Chinese

Tutorials
  - Chinese
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish

FAQ
  - Korean

Latest Downloads

Other Applications

Struts Resume
Security Example
Struts Menu

Set your name in
UserPreferences


Referenced by
Articles
CreateActions_it
CreateDAO_it
SpringControllers_it




JSPWiki v2.2.33

[RSS]


Hide Menu

CreateManager_it


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


Parte II: Creare nuovi Manager - Un HowTo sulla creazione di Business Façade che parlino con il livello del database (DAO) e si occupino della gestione delle transazioni.
Questo tutorial dipende da Parte I: Creare nuovi DAO ed Object in AppFuse.

Informazioni su questo Tutorial

Questo tutorial ti mostrerà come creare una classe di Business Façade (ed un Test JUnit) per parlare con il DAO che abbiamo creato nella Parte I.

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.

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

Iniziamo con il creare un nuovo ManagerTest ed un nuovo Manager nell'architettura di AppFuse.

Indice

  • [1] Crea un nuovo ManagerTest per eseguire test JUnit sul Manager
  • [2] Crea un nuovo Manager per parlare con il DAO
  • [3] Configura Spring per questo Manager e relative Transaction
  • [4] Esegui il ManagerTest

Crea un nuovo ManagerTest per eseguire test JUnit sul Manager [#1]

Nella Parte I, 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.
Ciò potrebbe sembrare ridondante (perché tutti i test!), but these tests are GREAT to have 6 months down the road.

Questa classe dovrebbe estendere BaseManagerTestCase, che è già presente nel package service. La classe base (BaseManagerTestCase) fornisce funzionalità analoghe al BaseDaoTestCase.

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.

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 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.


package org.appfuse.service;

import java.util.List;
import java.util.ArrayList;

import org.appfuse.dao.PersonDao;
import org.appfuse.model.Person;
import org.appfuse.service.impl.PersonManagerImpl;

import org.jmock.Mock;
import org.springframework.orm.ObjectRetrievalFailureException;

public class PersonManagerTest extends BaseManagerTestCase {
    private final String personId = "1";
    private PersonManager personManager = new PersonManagerImpl();
    private Mock personDao = null;
    private Person person = null;

    protected void setUp() throws Exception {
        super.setUp();
        personDao = new Mock(PersonDao.class);
        personManager.setPersonDao((PersonDaopersonDao.proxy());
    }

    protected void tearDown() throws Exception {
        super.tearDown();
        personManager = null;
    }
}

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 che ti aiuterà a caipre cosa stiamo per fare.

...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.

Add the following methods to your PersonManagerTest.java file:


    public void testGetPerson() throws Exception {
        // set expected behavior on dao
        personDao.expects(once()).method("getPerson")
            .will(returnValue(new Person()));
        person = personManager.getPerson(personId);
        assertTrue(person != null);
        personDao.verify();
    }

    public void testSavePerson() throws Exception {
        // set expected behavior on dao
        personDao.expects(once()).method("savePerson")
            .with(same(person)).isVoid();

        personManager.savePerson(person);
        personDao.verify();
    }    

    public void testAddAndRemovePerson() throws Exception {
        person = new Person();

        // set required fields
        person.setFirstName("firstName");
        person.setLastName("lastName");

        // set expected behavior on dao
        personDao.expects(once()).method("savePerson")
            .with(same(person)).isVoid();
        personManager.savePerson(person);
        personDao.verify();

        // reset expectations
        personDao.reset();

        personDao.expects(once()).method("removePerson").with(eq(new Long(personId)));
        personManager.removePerson(personId);
        personDao.verify();

        // reset expectations
        personDao.reset();
        // remove
        Exception ex = new ObjectRetrievalFailureException(Person.class, person.getId());
        personDao.expects(once()).method("removePerson").isVoid();            
        personDao.expects(once()).method("getPerson").will(throwException(ex));
        personManager.removePerson(personId);
        try {
            personManager.getPerson(personId);
            fail("Person with identifier '" + personId + "' found in database");
        catch (ObjectRetrievalFailureException e) {
            assertNotNull(e.getMessage());
        }
        personDao.verify();
    }

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

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. ;-)

Crea un nuovo Manager per parlare con il DAO [#2]

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.

As usual, I usually duplicate (open → save as) an existing file (i.e. UserManager.java).


package org.appfuse.service;

import org.appfuse.model.Person;
import org.appfuse.dao.PersonDao;

public interface PersonManager {
    public void setPersonDao(PersonDao dao);
    public Person getPerson(String id);
    public void savePerson(Person person);
    public void removePerson(String id);
}

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.


package org.appfuse.service.impl;

import org.appfuse.model.Person;
import org.appfuse.dao.PersonDao;
import org.appfuse.service.PersonManager;

public class PersonManagerImpl extends BaseManager implements PersonManager {
    private PersonDao dao;

    public void setPersonDao(PersonDao dao) {
        this.dao = dao;
    }

    public Person getPerson(String id) {
        return dao.getPerson(Long.valueOf(id));
    }

    public void savePerson(Person person) {
        dao.savePerson(person);
    }

    public void removePerson(String id) {
        dao.removePerson(Long.valueOf(id));
    }
}

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".

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

Configura Spring per questo Manager e relative Transaction [#3]

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.


    <bean id="personManager" parent="txProxyTemplate">
        <property name="target">
            <bean class="org.appfuse.service.impl.PersonManagerImpl" autowire="byName"/>
        </property>
    </bean>

The "parent" attribute refers to a bean definition for a TransactionProxyFactoryBean that has all the basic transaction attributes set.

Esegui il ManagerTest [#4]

Save all your edited files and try running ant test-service -Dtestcase=PersonManager.

Yeah Baby, Yeah: BUILD SUCCESSFUL
Total time: 9 seconds


I file che sono stati modificati ed aggiunti fino a questo punto sono disponibili in download.

Prossima Puntata: Parte III: Creating Actions and JSPs - A HowTo for creating Actions and JSPs in the AppFuse architecture.



Go to top   More info...   Attach file...
This particular version was published on 06-Nov-2006 13:52:56 MST by MarcelloTeodori.