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 3 changed 1 line.

;:''This tutorial depends on __Part I:__ [Creating new DAOs and Objects in AppFuse|CreateDAO].''

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

At line 5 changed 2 lines.

!!About this Tutorial

This tutorial will show you how to create a Business Facade class (and a JUnit Test) to talk to the [DAO we created in Part I|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].

At line 8 changed 1 line.

In the context of [AppFuse], this is called a Manager class. Its main responsibility is to act as a bridge between the persistence (DAO) layer and the web layer. It's also useful for de-coupling your presentation layer from your database layer (i.e. for Swing apps). Managers should also be where you put any business logic for your application.

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)''I will tell you how I do stuff in the __Real World__ in text like this.''%%

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

At line 12 removed 1 line.

Let's get started by creating a new ManagerTest and Manager in AppFuse's architecture.

At line 14 changed 5 lines.

!Table of Contents

* [1] Create a new ManagerTest to run JUnit tests on the Manager

* [2] Create a new Manager to talk to the DAO

* [3] Configure Spring for this Manager and Transactions

* [4] Run the ManagerTest

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

At line 20 changed 2 lines.

!!Create a new ManagerTest to run JUnit tests on the Manager [#1]

In [Part I|CreateDAO], we created a Person object and PersonDao - so let's continue developing this entity. First, let's create a JUnit test for the PersonManager. Create PersonManagerTest in the test/service/**/service directory. We'll want to test the same basic methods (get, save, remove) that our DAO has.

!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

At line 23 changed 1 line.

;:''This may seem redundant (why all the tests!), but these tests are GREAT to have 6 months down the road.''

!!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 25 changed 1 line.

This class should extend [BaseManagerTestCase|http://raibledesigns.com/downloads/appfuse/api/org/appfuse/service/BaseManagerTestCase.java.html], which already exists in the ''service'' package. The parent class (BaseManagerTestCase) serves similar functionality as the BaseDaoTestCase.

;:''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 27 changed 1 line.

;:%%(color: blue)''I usually copy (open → save as) an existing test (i.e. UserManagerTest.java) and find/replace [[Uu]ser with [[Pp]erson, or whatever the name of my object is.''%%

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 29 changed 1 line.

The code below is what you need for a basic JUnit test of your Manager. Unlike the DaoTest, this test uses [jMock|http://jmock.org] to isolate the Manager from its dependencies and make it a ''true'' "unit" test. This can be very helpful because it allows you to test your business logic w/o worrying about other dependencies. The code below simply sets up the Manger and its dependencies (as Mocks) for testing.

;:%%(color: blue)''Normalmente copio (open → 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.''%%

At line 30 added 3 lines.

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 64 changed 1 line.

Now that you have the skeleton done for this class, you need to add the meat: the test methods to make sure everything works. Here's a snippet from the [DAO Tutorial|CreateDAO] tutorial to help you understand what we're about to do.

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 66 changed 1 line.

;:''...we create methods that begin with "test" (all lower case). As long as these methods are public, have a void return type and take no arguments, they will be called by our <junit> task in our Ant build.xml file. Here's some simple tests for testing CRUD. An important thing to remember is that each method (also known as a test), should be autonomous.''

;:''...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 68 changed 1 line.

Add the following methods to your PersonManagerTest.java file:

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

At line 127 changed 1 line.

This class won't compile at this point because we have not created our PersonManager interface.

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

At line 129 changed 1 line.

;:%%(color: blue)''I think it's funny how I've followed so many patterns to allow __extendibility__ in AppFuse. In reality, on most projects I've been on - I learn so much in a year that I don't want to extend the architecture - I want to rewrite it. Hopefully by keeping AppFuse up to date with my perceived best practices, this won't happen as much. Each year will just be an upgrade to the latest AppFuse, rather than a re-write. ;-)''

;:%%(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 131 changed 1 line.

!!Create a new Manager to talk to the DAO [#2]

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

At line 133 changed 1 line.

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.'' The ''setPersonDao()'' method is not used in most cases - its just exists so the PersonManagerTest can set the DAO on the 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 135 changed 1 line.

;:%%(color: blue)''As usual, I usually duplicate (open → save as) an existing file (i.e. UserManager.java).''%%

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

At line 152 changed 1 line.

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.

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.

At line 183 changed 1 line.

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

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 185 changed 1 line.

Now you need to edit Spring's config file for our services layer so it will know about this new 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 187 changed 1 line.

!!Configure Spring for this Manager and Transactions [#3]

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

At line 189 changed 2 lines.

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.

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 200 changed 1 line.

The "parent" attribute refers to a bean definition for a [TransactionProxyFactoryBean|http://www.springframework.org/docs/api/org/springframework/transaction/interceptor/TransactionProxyFactoryBean.html] that has all the basic transaction attributes set.

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 203 changed 1 line.

!!Run the ManagerTest [#4]

!!Ejecute la clase ManagerTest [#4]

At line 205 changed 1 line.

Save all your edited files and try running __ant test-service -Dtestcase=PersonManager__.

Guarde los ficheros editados y ejecute __ant test-service -Dtestcase=PersonManager__.

At line 213 changed 1 line.

The files that were modified and added to this point are [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].

At line 215 changed 1 line.

''Next Up:'' __Part III:__ [Creating Actions and JSPs|CreateActions] - A HowTo for creating Actions and JSPs in the AppFuse architecture.

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

Raible's Wiki

AppFuse

Other Applications

CreateManager_es