Raible's Wiki: CreateManager

No contexto do AppFuse, isto é chamado de classe Manager(Gerente). Sua responsabilidade principal é agir como uma ponte entre a camada de persistência(DAO) e a camada web. O padrão Business Delegate

da Sun dita que estes objetos são úteis para desacoplar a camada de apresentação da camada de dados (i.e. para aplicações Swing). Gerentes(Managers) devem ser colocados onde lógicas de negócio são necessárias.

Vamos começar criando novas classes ManagerTest e Manager na arquitetura AppFuse.

Tabela de Conteúdo

Criar um novo ManagerTest para rodar testes JUnit no Manager [#1]

Esta classe deve estender BaseManagerTestCase

, que já existe no pacote service. A classe pai (BaseManagerTestCase) serve para o mesmo propósito da classe BaseDaoTestCase - carregar um arquivo .properties que possui o mesmo nome de sua classe *Test, assim como inicializar o ApplicationContext do Spring.

O código abaixo é o que precisamos para um teste JUnit básico para nossos Managers. Diferente do DaoTest, este teste utiliza jMock

para isolar o Manager de suas dependências e fazer um teste unitário verdadeiro.




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((PersonDao) personDao.proxy());

    }



    protected void tearDown() {

        super.tearDown();

        personManager = null;

    }

    

}

Agora que temos o framework JUnit configurado para esta classe, vamos ao que interessa: os métodos de teste para nos certificar que tudo funciona no nosso Manager. Aqui está um exemplo do Tutorial DAO para ajudá-lo a entender o que estamos fazendo.




    public void testGetPerson() throws Exception {

        // seta o comportamento esperado no DAO

        personDao.expects(once()).method("getPerson")

            .will(returnValue(new Person()));

        person = personManager.getPerson(personId);

        assertTrue(person != null);

        personDao.verify();

    }



    public void testSavePerson() throws Exception {

        // seta o comportamento esperado no DAO

        personDao.expects(once()).method("savePerson")

            .with(same(person)).isVoid();

        personManager.savePerson(person);

        personDao.verify();

    }



    public void testAddAndRemovePerson() throws Exception {

        person = new Person();



        // seta os campos obrigatórios

        person.setFirstName("firstName");

        person.setLastName("lastName");



        // seta o comportamento esperado no DAO

        personDao.expects(once()).method("savePerson")

            .with(same(person)).isVoid();

        personManager.savePerson(person);

        personDao.verify();



        // reseta o comportamento

        personDao.reset();



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

        personManager.removePerson(personId);

        personDao.verify();



        // reseta o comportamento

        personDao.reset();



        // testa se o método remove retorna uma exceção

        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("O objeto Pessoa com o identificador '"+ 

                personId +"' foi encontrado no banco de dados");

        } catch (ObjectRetrievalFailureException e) {

            assertNotNull(e.getMessage());

        }



        personDao.verify();

    }

Esta classe não compilará neste ponto porque nós não criamos nossa interface PersonManager.

Criar um novo Manager para conversar com o 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.




package org.appfuse.service;



import org.appfuse.model.Person;



import java.util.List;



public interface PersonManager {



    public List getPeople(Person person);



    public Person getPerson(String id);



    public Person savePerson(Object 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 and name it PersonManagerImpl.java. It should extend BaseManager and implement PersonManager.




package org.appfuse.service;



import org.apache.commons.logging.Log;

import org.apache.commons.logging.LogFactory;



import org.appfuse.model.Person;

import org.appfuse.dao.PersonDao;



import java.util.List;



/**

 * @author mraible

 * @version $Revision: $ $Date: May 25, 2004 11:46:54 PM $

 */

public class PersonManagerImpl extends BaseManager implements PersonManager {

    private static Log log = LogFactory.getLog(PersonManagerImpl.class);

    private PersonDao dao;



    public void setPersonDao(PersonDao dao) {

        this.dao = dao;

    }



    public List getPeople(Person person) {

        return dao.getPeople(person);

    }



    public Person getPerson(String id) {

        return dao.getPerson(Long.valueOf(id));

    }



    public Person savePerson(Object person) {

        dao.savePerson(person);

        return (Person) 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"...

Finally, we need to create the PersonManagerTest.properties file in test/service/**/service so that person = (Person) populate(person); will work in our test.

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

Configure Spring for this Manager and Transactions [#3]

To notify Spring of this our PersonManager interface and it's implementation, open the src/service/**/service/applicationContext-service.xml file. In here, you will see an existing configuration for the UserManager. You should be able to copy that and change a few things to get the XML fragment below. Add the following to the bottom of this file.




    <!-- Person Manager -->

    <bean id="personManagerTarget" class="org.appfuse.service.PersonManagerImpl" singleton="false">

        <property name="personDao"><ref bean="personDAO"/></property>

    </bean>

    

    <!-- Transaction declarations for business services.  To apply a generic transaction proxy to

         all managers, you might look into using the BeanNameAutoProxyCreator -->

    <bean id="personManager" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean">

        <property name="transactionManager"><ref bean="transactionManager"/></property>

        <property name="target"><ref local="personManagerTarget"/></property>

        <property name="transactionAttributeSource"><ref local="defaultTxAttributes"/></property>

    </bean>

Note: I had SAX throw an error because defaultTxAttributes was not defined so I replaced the transactionAttributeSource with this instead, which allowed my unit test to run successfully.

Run the ManagerTest [#4]

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

Next Up: Part III: Creating Actions and JSPs - A HowTo for creating Actions and JSPs in the AppFuse architecture.

Raible's Wiki

AppFuse

Other Applications

CreateManager_pt

Sobre este Tutorial

Tabela de Conteúdo

Criar um novo ManagerTest para rodar testes JUnit no Manager [#1]

Criar um novo Manager para conversar com o DAO [#2]

Configure Spring for this Manager and Transactions [#3]

Run the ManagerTest [#4]