Raible's Wiki: CreateManager

En el contexto de AppFuse, crearemos lo que se llama una clase Manager. Su principal objetivo es la de servir de puente entre la capa de persistencia DAO y la capa de presentacion. Tambien permite aislar la capa de presentacion de la capa de persistencia(i.e. para aplicaciones Swing ). Ademas, contienen toda la logica de la aplicacion.

Vamos a empezar creando una clase ManagerTest y otra clase Manager en la arquitectura de AppFuse.

Tabla de Contenidos

Crear una nueva clase ManagerTest para ejecutar tests JUnit con relacion a la clase Manager. [#1]

Esta clase debe heredar la clase BaseManagerTestCase|http://raibledesigns.com/downloads/appfuse/api/org/appfuse/service/BaseManagerTestCase.java.html], la cual ya existe en el paquete service . La clase padre (BaseManagerTestCase) tiene un proposito similar a la clase BaseDaoTestCase.

El siguiente codigo es lo que necesitas para una prueba basica de tu clase Manager. A diferencia de la clase DaoTest, esta prueba usa jMock

para aislar la clase Manager de sus dependencias , permitiendo asi una verdadera prueba unitaria. Esto puede ser muy util ya que permite probar la logica sin tener que preocuparnos de las clases dependientes. El codigo simplemente asigna la clase Manager y sus dependencias (como Mocks) para la prueba.




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() throws Exception {

        super.tearDown();

        personManager = null;

    }

}

Ahora que tienes la estructura basica necesitamos hacerlo mas detallado. Vamos a anadir los metodos de prueba para asegurarnos que todo funcionoa como debe ser. A continuacion te muestro un extracto del tutorial DAO Tutorial que te ayudara a entender lo que vamos a implementar.




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

    }

Esta clase no compilara todavia porque no hemos creado la interface PersonManager.

Crear una nueva clase Manager que interaccione con la capa DAO [#2]

Primerament, crearemos la interface PersonManager.java en el directorio src/service/**/service directory y anadiremos las cuatro operaciones basicas (ALAS) que son necesarias para cualquier clase que implemente esta interface. He eliminado las JavaDocs en la clase para mostrarlo mejor. El metodo setPersonDao() no es usado en la mayoria de los casos- solo existe para que la clase PersonManagerTest asigne el DAO en la interface.




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.

Configure Spring for this Manager and Transactions [#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.

The "parent" attribute refers to a bean definition for a TransactionProxyFactoryBean

that has all the basic transaction attributes set.

Run the ManagerTest [#4]

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

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_es

Sobre este tutorial

Tabla de Contenidos

Crear una nueva clase ManagerTest para ejecutar tests JUnit con relacion a la clase Manager. [#1]

Crear una nueva clase Manager que interaccione con la capa DAO [#2]

Configure Spring for this Manager and Transactions [#3]

Run the ManagerTest [#4]