Raible's Wiki: CreateManager

At line 1 changed 1 line.

__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 gestion de transacciones.

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

At line 6 changed 1 line.

Este tutorial te mostrara como crear clases del tipo Business Facada (asi como test unitario ) para interactuar ,[con la capa DAO creada in Part I|CreateDAO].

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

At line 8 changed 1 line.

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.

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.

At line 10 changed 1 line.

;:%%(color: blue)''Te voy a decir como yo hago las cosas en la __Vida Real__ en texto como este.''%%

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

At line 16 changed 3 lines.

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

* [2] Crear una nueva clase Manager que interaccionara con la capa DAO.

* [3] Configurar Spring para la clase Manager y gestion de transacciones.

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

At line 21 changed 2 lines.

!!Crear una nueva clase ManagerTest para ejecutar tests JUnit con relacion 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 metodos basicos (leer, anadir, eliminar) que contiene nuestra clase.

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

At line 24 changed 1 line.

;:''El hecho de tener tantas clases de prueba puede parecer redundante, sin embargo, veras como dentro de 6 meses nos seran de mucha ayuda.''

;:''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.''

At line 26 changed 1 line.

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.

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.

At line 30 changed 2 lines.

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

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.

At line 66 changed 1 line.

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

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.

At line 68 changed 1 line.

;:''...Creamos metodos que empiecen con "test" (en minusculas). Siempre que los metodos sean publicos, devuelvan void y no acepten parametros de entrada, seran ejecutados a partir de la tarea <junit> task que se encuentra en el fichero Ant build.xml. Aca puedes encontrar sencillas pruebas para operaciones de Anadir/Lectura/Actualizacion/Supresion (ALAS). Es importante notar que cada metodo (tambien cada test), debe ser autonomo.''

;:''...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 <junit> 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.''

At line 70 changed 1 line.

Anade los metodos siguientes a la clase PersonManagerTest.java:

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

At line 129 changed 1 line.

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

Esta clase no compilará todavia porque no hemos creado la interface PersonManager.

At line 131 changed 1 line.

;:%%(color: blue)''Es gracioso ver como he aplicado varios patrones de diseno 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 solo un mejoramiento de la arquitectura y no una reescritura de codigo ;-)''

;:%%(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 ;-)''

At line 135 changed 2 lines.

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

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.

At line 155 changed 1 line.

Ahora crearemos la clase PersonManagerImpl que implementa los metodos de la interface PersonManager. Para ello, creamos una nueva clase

Ahora crearemos la clase PersonManagerImpl que implementa los métodos de la interface PersonManager. Para ello, creamos una nueva clase

At line 187 changed 1 line.

Un aspecto a notar es el metodo {{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".

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

At line 189 changed 1 line.

Ahora necesita editar el fichero de configuracion de Spring para que la capa de servicios se actualice con la recien creada clase Manager.

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.

At line 191 changed 1 line.

!!Configurar Spring para este Manager y gestion de transacciones [#3]

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

At line 193 changed 1 line.

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

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.

At line 203 changed 1 line.

El atributo "parent" se refiere a la definicion de bean para [TransactionProxyFactoryBean|http://www.springframework.org/docs/api/org/springframework/transaction/interceptor/TransactionProxyFactoryBean.html]que contiene todos los atributos basicos para la gestion de transacciones.

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.

At line 216 changed 1 line.

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

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

Raible's Wiki

AppFuse

Other Applications

CreateManager_es