Raible's Wiki: CreateManager

Parte II: Creating new Managers - Instrucciones para crear Fachadas de Logica de Negocios (Business Facades) que interaccionan con la capa de acceso a datos (DAO) y manejan todo lo relacionado con la gestión de transacciones.

Sobre este tutorial

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 presentación. También permite aislar la capa de presentación de la capa de persistencia(i.e. para aplicaciones Swing ). Además, contienen toda la lógica de la aplicación.

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 relación a la clase Manager. [#1]

Esta clase debe heredar de 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 propósito similar a la clase BaseDaoTestCase.

El siguiente código es lo que necesitas para una prueba básica 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 útil ya que permite probar la lógica sin tener que preocuparnos de las clases dependientes. El código 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 básica necesitamos hacerlo más detallado. Vamos a añadir los métodos de prueba para asegurarnos que todo funciona como debe ser. A continuación te muestro un extracto del tutorial DAO Tutorial que te ayudará 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 compilará todavia porque no hemos creado la interface PersonManager.

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

Primeramente, crearemos la interface PersonManager.java en el directorio src/service/**/service directory y añadiremos las cuatro operaciones básicas (ALAS) que son necesarias para cualquier clase que implemente esta interface. He eliminado las JavaDocs en la clase para mostrarlo mejor. El método setPersonDao() no es usado en la mayoría de los casos- sólo 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);

}

Ahora crearemos la clase PersonManagerImpl que implementa los métodos de la interface PersonManager. Para ello, creamos una nueva clase PersonManagerImpl.java en el subdirectorio src/service/**/service/impl. Debe heredar de la clase BaseManager e implementar 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));

    }

}

Un aspecto a notar es el método setPersonDao() el cual es usado para "enganchar" la clase PersonDao a este Manager. Esto es configurado en el fichero applicationContext-service.xml. Configuraremos este aspecto en el paso 3[3]. Ahora todo debe compilar sin problemas usando la linea de comandos "ant compile-service".

Ahora necesita editar el fichero de configuración de Spring para que la capa de servicios se actualice con la recién creada clase Manager.

Configurar Spring para este Manager y gestión de transacciones [#3]

Para notificar a Spring de la presencia de la interface PersonManager y su implementación, editemos el fichero src/service/**/service/applicationContext-service.xml file. Alli debe ver la definicion del bean "personManager" comentada. Elimine el comentario o añada lo siguiente al final del fichero.

El atributo "parent" se refiere a la definición de bean para TransactionProxyFactoryBean

que contiene todos los atributos básicos para la gestión de transacciones.

Ejecute la clase ManagerTest [#4]

Guarde los ficheros editados y ejecute ant test-service -Dtestcase=PersonManager.

Los ficheros que fueron modificados y añadidos en este tutorial se encuentran en available for download

Siguiente etapa: Parte III: Creacion de Actions y JSPs - Como crear Actions y JSPs en la arquitectura de AppFuse.

Raible's Wiki

AppFuse

Other Applications