Raible's Wiki: CreateManager

-       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
Articles_pt
CreateDAO_es
SandBox



    




   



   
   JSPWiki v2.2.33 
   



       
           

           

           
           
           


           Hide Menu
+            CreateManager_es
            



  
    Search Wiki:
    
    
  



         
         
            Your trail: 
         
      

      


      

      
         



      
          Difference between 
          version 8 
          and 
          version 1:
          

          
At line 1 changed 1 line.
gsdgsdsa
__Parte II:__ [Creating new Managers|CreateManager] - 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.

;:''Este tutorial depende de  __Part I:__ [Creating new DAOs and Objects in AppFuse|CreateDAO].''

!!Sobre este tutorial
Este tutorial te mostrará cómo crear clases del tipo Business Facada (asi como test unitario ) para  interactuar ,[con la capa DAO creada in Part I|CreateDAO]. 

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.

;:%%(color: blue)''Te voy a decir cómo yo hago las cosas en la práctica.''%%


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

!Tabla de Contenidos
* [1] Crear una nueva clase ManagerTest para ejecutar tests JUnit con relación a la clase Manager.
* [2] Crear una nueva clase Manager que interaccionará con la capa DAO.
* [3] Configurar Spring para la clase Manager y gestión de transacciones.
* [4] Ejecutar la clase ManagerTest

!!Crear una nueva clase ManagerTest para ejecutar tests JUnit con relación a la clase Manager. [#1]
En [Part I|CreateDAO],creamos una clase Person y PersonDao - por lo que vamos a seguir desarrollando esta entidad.  Primero, crearemos una nueva clase de prueba JUnit para probar la clase PersonManager.  Crea la clase PersonManagerTest en el directorio test/service/**/service.  Vamos a probar los métodos básicos (leer, añadir, eliminar) que contiene nuestra clase.  

;:''El hecho de tener tantas clases de prueba puede parecer redundante, sin embargo, verás cómo dentro de 6 meses nos serán de mucha ayuda.''

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.

;:%%(color: blue)''Normalmente copio (open &rarr; save as) una clase prueba existente(i.e. UserManagerTest.java) y encuentro/reemplazo [[Uu]ser por [[Pp]erson, o cualquiera que sea el nombre del objeto a probar.''%%

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|http://jmock.org] 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.

[{Java2HtmlPlugin

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|CreateDAO] que te ayudará a entender lo que vamos a implementar.

;:''...Creamos metodos que empiecen con "test" (en minusculas). Siempre que los metodos sean públicos, devuelvan void y no acepten parámetros de entrada, serán ejecutados a partir de la tarea &lt;junit&gt; task que se encuentra en el fichero Ant build.xml. Acá puedes encontrar sencillas pruebas para operaciones de Añadir/Leer/Actualizar/Suprimir (ALAS). Es importante notar que cada método (también cada test), debe ser autónomo.''

Añade los métodos siguientes a la clase PersonManagerTest.java:

[{Java2HtmlPlugin

    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.

;:%%(color: blue)''Es gracioso ver como he aplicado varios patrones de diseño para permitir la _extensibilidad_ en AppFuse. En realidad,en la mayoria de los proyectos en los que he tomado parte, no quiero extender la arquitectura sino reescribirlo todo. Ojala que con AppFuse todo sea un mejoramiento de la arquitectura y no una reescritura de código ;-)''

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

;:%%(color: blue)''Como de costumbre, normalment duplico  (open &rarr; save as) una clase existente (i.e. UserManager.java).''%%

[{Java2HtmlPlugin

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.

[{Java2HtmlPlugin

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.
[{Java2HtmlPlugin

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

El atributo "parent" se refiere a la definición de bean para [TransactionProxyFactoryBean|http://www.springframework.org/docs/api/org/springframework/transaction/interceptor/TransactionProxyFactoryBean.html]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__.  

''Yeah Baby, Yeah:''
%%(color:green)BUILD SUCCESSFUL\\
Total time: 9 seconds%%

----

Los ficheros que fueron modificados y añadidos en este tutorial se encuentran en  [available for download|https://appfuse.dev.java.net/files/documents/1397/7484/appfuse-tutorial-managers-1.6.zip].

''Siguiente etapa:'' __Parte III:__ [Creacion de Actions y JSPs|CreateActions] - Como crear Actions y JSPs en la arquitectura de AppFuse.


          

      

      

      
      Back to CreateManager_es,
       or to the Page History.
       

      

      

      

      

      

      

      

      Show Menu
-CreateManager_es
+    Search Wiki:
 At line 1 changed 1 line.
-gsdgsdsa
+__Parte II:__ [Creating new Managers|CreateManager] - 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.
+;:''Este tutorial depende de  __Part I:__ [Creating new DAOs and Objects in AppFuse|CreateDAO].''
+!!Sobre este tutorial
+Este tutorial te mostrará cómo crear clases del tipo Business Facada (asi como test unitario ) para  interactuar ,[con la capa DAO creada in Part I|CreateDAO].
+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.
+;:%%(color: blue)''Te voy a decir cómo yo hago las cosas en la práctica.''%%
+Vamos a empezar creando una clase ManagerTest y otra clase Manager en la arquitectura de AppFuse.
+!Tabla de Contenidos
+* [1] Crear una nueva clase ManagerTest para ejecutar tests JUnit con relación a la clase Manager.
+* [2] Crear una nueva clase Manager que interaccionará con la capa DAO.
+* [3] Configurar Spring para la clase Manager y gestión de transacciones.
+* [4] Ejecutar la clase ManagerTest
+!!Crear una nueva clase ManagerTest para ejecutar tests JUnit con relación a la clase Manager. [#1]
+En [Part I|CreateDAO],creamos una clase Person y PersonDao - por lo que vamos a seguir desarrollando esta entidad.  Primero, crearemos una nueva clase de prueba JUnit para probar la clase PersonManager.  Crea la clase PersonManagerTest en el directorio test/service/**/service.  Vamos a probar los métodos básicos (leer, añadir, eliminar) que contiene nuestra clase.
+;:''El hecho de tener tantas clases de prueba puede parecer redundante, sin embargo, verás cómo dentro de 6 meses nos serán de mucha ayuda.''
+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.
+;:%%(color: blue)''Normalmente copio (open &rarr; save as) una clase prueba existente(i.e. UserManagerTest.java) y encuentro/reemplazo [[Uu]ser por [[Pp]erson, o cualquiera que sea el nombre del objeto a probar.''%%
+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|http://jmock.org] 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.
+[{Java2HtmlPlugin
+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|CreateDAO] que te ayudará a entender lo que vamos a implementar.
+;:''...Creamos metodos que empiecen con "test" (en minusculas). Siempre que los metodos sean públicos, devuelvan void y no acepten parámetros de entrada, serán ejecutados a partir de la tarea &lt;junit&gt; task que se encuentra en el fichero Ant build.xml. Acá puedes encontrar sencillas pruebas para operaciones de Añadir/Leer/Actualizar/Suprimir (ALAS). Es importante notar que cada método (también cada test), debe ser autónomo.''
+Añade los métodos siguientes a la clase PersonManagerTest.java:
+[{Java2HtmlPlugin
+    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.
+;:%%(color: blue)''Es gracioso ver como he aplicado varios patrones de diseño para permitir la _extensibilidad_ en AppFuse. En realidad,en la mayoria de los proyectos en los que he tomado parte, no quiero extender la arquitectura sino reescribirlo todo. Ojala que con AppFuse todo sea un mejoramiento de la arquitectura y no una reescritura de código ;-)''
+!!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.
+;:%%(color: blue)''Como de costumbre, normalment duplico  (open &rarr; save as) una clase existente (i.e. UserManager.java).''%%
+[{Java2HtmlPlugin
+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.
+[{Java2HtmlPlugin
+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.
+[{Java2HtmlPlugin
+    <bean id="personManager" parent="txProxyTemplate">
+        <property name="target">
+            <bean class="org.appfuse.service.impl.PersonManagerImpl" autowire="byName"/>
+        </property>
+    </bean>
+}]
+El atributo "parent" se refiere a la definición de bean para [TransactionProxyFactoryBean|http://www.springframework.org/docs/api/org/springframework/transaction/interceptor/TransactionProxyFactoryBean.html]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__.
+''Yeah Baby, Yeah:''
+%%(color:green)BUILD SUCCESSFUL\\
+Total time: 9 seconds%%
+----
+Los ficheros que fueron modificados y añadidos en este tutorial se encuentran en  [available for download|https://appfuse.dev.java.net/files/documents/1397/7484/appfuse-tutorial-managers-1.6.zip].
+''Siguiente etapa:'' __Parte III:__ [Creacion de Actions y JSPs|CreateActions] - Como crear Actions y JSPs en la arquitectura de AppFuse.