Manual de Desarrollo de Aplicaciones J2EE

124 Pages·2008·0.42 MB·Spanish

Manual de Desarrollo
de Aplicaciones J2EE
Manual de Desarrollo de Aplicaciones J2EE
Versión 1.5
publicado 26-Junio-2006
Copyright © Gobierno del Principado de Asturias 2005

Tabla de contenidos
1. Presentación de openFWPA .............................................................................................. 1
Introducción .............................................................................................................. 1
Visión General de openFWPA ...................................................................................... 2
Empaquetamiento de openFWPA .......................................................................... 4
Requerimientos técnicos y de sistema ..................................................................... 5
Lista completa de funcionalidades ......................................................................... 5
Lista de componentes de terceras partes .................................................................. 6
Arquitectura de referencia ............................................................................................ 8
Desarrollo de aplicaciones .......................................................................................... 10
Estructura de directorios ..................................................................................... 10
Compilación y despliegue del sistema ................................................................... 11
Pruebas unitarias ............................................................................................... 11
Instalación de la aplicación de ejemplo (Sample App) .............................................. 11
2. Arquitectura Modelo -Vista- Controlador con openFWPA ..................................................... 13
MVC ...................................................................................................................... 13
Desarrollo de la Vista ................................................................................................ 14
Aspecto corporativo de las aplicaciones del Principado de Asturias ............................. 14
Cascading Style Sheets (CSS) ............................................................................. 14
Desarrollo del Controlador ......................................................................................... 16
Declaración de Actions ...................................................................................... 16
Jerarquía de Actions .......................................................................................... 17
Action Forms ............................................................................................. 29
Desarrollo de lógica de negocio .................................................................................. 31
Service Locator ................................................................................................ 31
Session EJBs .................................................................................................... 31
Value Objects .................................................................................................. 31
Excepciones ..................................................................................................... 32
Utilidades ........................................................................................................ 33
Otras clases de utilidad .............................................................................................. 33
PrincastMessageFmtter ............................................................................ 33
PrincastUtils ............................................................................................ 33
ParameterCaster ........................................................................................ 33
ServletPathUtils ...................................................................................... 33
DateDecorator ............................................................................................ 34
PrincastPathResolver .............................................................................. 34
PrincastOSCacheInterceptor .................................................................. 35
Providers ......................................................................................................... 35
3. Implementación de la Arquitectura de Referencia con openFWPA .......................................... 37
Inversión de Control en la Arquitectura de Referencia ..................................................... 37
Introducción al manejo de la Arquitectura con Spring ...................................................... 37
Estableciendo el Datasource ........................................................................................ 38
Enlazando con los DAOs ........................................................................................... 39
Enlazando con los Managers ....................................................................................... 40
Gestión de transacciones ............................................................................................ 41
Enlazado con los Delegates ........................................................................................ 42
Enlazado con las Actions ........................................................................................... 42
Acceso directo al ApplicationContext ................................................................. 43
BeanDoc para obtener la gráfica de arquitectura ............................................................. 43
Plugin SpringIDE para Eclipse .................................................................................... 43
4. Componentes para acceso a datos ..................................................................................... 45
Acceso a Bases de Datos Relacionales .......................................................................... 45
iv
Manual de Desarrollo
de Aplicaciones J2EE
El patrón DAO ................................................................................................. 45
Loggeo de las Excepciones en los DAO ................................................................ 47
Listas clave/valor .............................................................................................. 47
LookupPropertyBean .................................................................................. 49
Providers ......................................................................................................... 49
Generadores de Secuencia .................................................................................. 49
Pools de conexiones .......................................................................................... 50
5. Construccion de informes con openFWPA ......................................................................... 51
Generación de Informes ............................................................................................. 51
Creación de los diseños XML. ............................................................................ 51
Clases en el openFWPA para la renderización de informes. ...................................... 57
6. Operaciones ................................................................................................................. 61
Sistema de Inicialización y Arranque ............................................................................ 61
Declaración de objetos inicializables .................................................................... 61
Desarrollo de objetos inicializables ...................................................................... 62
Arranque de aplicaciones web ............................................................................. 63
Arranque manual .............................................................................................. 63
Sistema de Configuración de Aplicaciones .................................................................... 63
Implementación de objetos configurables .............................................................. 64
Plugins de Configuración ................................................................................... 66
Logging .................................................................................................................. 72
Log4J. Componentes ......................................................................................... 72
Configuración ................................................................................................... 74
Componentes del openFWPA para Logging. .......................................................... 75
Pista de auditoría .............................................................................................. 76
Pista de Rendimiento ......................................................................................... 77
Ficheros de Configuración .......................................................................................... 77
web.xml ........................................................................................................ 77
struts-config.xml .................................................................................... 79
Filtros web .............................................................................................................. 83
Filtros del openFWPA. PrincastFilter. ......................................................... 83
Configuración del filtro GZIPFilter ................................................................. 85
Configuración del filtro SecurityFilter ......................................................... 85
Filtro de navegación .......................................................................................... 85
Filtro de activación ........................................................................................... 86
Filtros de Activación ......................................................................................... 87
Consola de gestión .................................................................................................... 88
7. Seguridad en aplicaciones con openFWPA ......................................................................... 90
Seguridad ................................................................................................................ 90
Autentificación básica ........................................................................................ 90
Autentificación basada en formulario .................................................................... 90
Autentificación basada en el Filtro de Seguridad del openFWPA ............................... 90
Single Sign On ............................................................................................... 103
8. Integración de Sistemas ................................................................................................ 104
Tecnologías de Integración ....................................................................................... 104
XML Genérico: Configuración .......................................................................... 104
9. Pruebas ...................................................................................................................... 106
Pruebas unitarias ..................................................................................................... 106
Jerarquía de clases para las pruebas unitarias ........................................................ 106
Convenciones a seguir ..................................................................................... 107
Ejecución de las pruebas unitarias ...................................................................... 107
Consultando los resultados de los tests ................................................................ 107
Pruebas unitarias de objetos que acceden a bases de datos. ...................................... 108
Pruebas unitarias de Spring Beans ...................................................................... 112
v
Manual de Desarrollo
de Aplicaciones J2EE
Pruebas unitarias de objetos Configurables .................................................... 112
Pruebas unitarias en contenedor ......................................................................... 113
Pruebas unitarias de informes ............................................................................ 114
Más información sobre la implementación de pruebas unitarias ................................ 115
Pruebas de Rendimiento ........................................................................................... 116
Modo de Prueba de Rendimiento ....................................................................... 116
vi
Lista de figuras
1.1. Estructura de openFWPA ............................................................................................... 2
1.2. Arquitectura de Referencia ............................................................................................. 8
1.3. Estructura de directorios del proyecto Sample App. ........................................................... 10
2.1. Modelo Vista Controlador ............................................................................................ 13
2.2. Ciclo petición-acción-jsp de Struts ................................................................................. 13
2.3. Estructura de capas de las aplicaciones web con openFWPA ............................................... 14
2.4. Aspecto corporativo del portal princast.es ................................................................ 14
2.5. Aspecto de la aplicación de ejemplo (Sample App) ........................................................... 14
2.6. Jerarquía de Actions .................................................................................................... 17
2.7. Maquinaria de Estados de PrincastAction ................................................................ 18
2.8. Almacenamiento de la Action .................................................................................... 21
2.9. Esquema de la PrincastDispatchAction del ejemplo ............................................... 25
2.10. Esquema de las Actions para listados ............................................................................ 28
2.11. Estructura de la capa Modelo ...................................................................................... 31
2.12. Diagrama de Value Objects ........................................................................................ 32
2.13. Jerarquía de Excepciones ............................................................................................ 32
3.1. Ficheros de configuración de Beans ............................................................................... 37
3.2. Ejemplo de gráfica generada con BeanDoc ...................................................................... 43
3.3. Spring IDE para visualizar ficheros de Spring .................................................................. 44
4.1. Ejemplo de necesidad de lookup .................................................................................... 49
4.2. Navegación de una relación en BD con un LookupPropertyBean ......................................... 49
5.1. Proceso de generación de informes ................................................................................ 51
6.1. Estructura del sistema de configuración .......................................................................... 64
6.2. Jerarquía de Plugins .................................................................................................... 68
6.3. Estados del Sistema de Logging .................................................................................... 74
7.1. Esquema del sistema de autenticación ............................................................................ 91
9.1. Set de pruebas unitarias disponibles .............................................................................. 106
9.2. Autowiring de DAOs y DataSources ............................................................................ 110
vii
Lista de tablas
1.1. Componentes necesarios para la ejecución del openFWPA ................................................... 7
1.2. Capas de la Arquitectura de Referencia de openFWPA ........................................................ 9
viii
Capítulo 1. Presentación de openFWPA
Introducción
openFWPA es el framework de desarrollo libre para sistemas de administración electrónica y gobierno
electrónico desarrollado por el Gobierno del Principado de Asturias. Está basado en la tecnología J2EE y
su objetivo es facilitar el diseño, implementación, implantación y mantenimiento de las aplicaciones.
openFWPA es Software Libre / Open Source y está publicado bajo una doble licencia: LGPL 3.0 (o
superior) y EUPL 1.0 (o superior). La Licencia Pública General Menor del proyecto GNU (LGPL) es
una de las licencias desarrolladas y promovidas por la Free Software Foundation (FSF), y da permisos de
reproducción, distribución, modificación y redistribución con copyleft, aunque no se impide la utilización
de componentes privativos dentro del sistema. La Licencia Pública de la Unión Europea (EUPL) es una
licencia de software libre con copyleft creada y apoyada por la Unión Europea para el impulso del Software
Libre en las administraciones públicas.
Los dos grandes objetivos del framework son:
• Simplificación y homogeneización del proceso de desarrollo de aplicaciones. Para ello openFWPA
proporciona una arquitectura reutilizable y un conjunto de herramientas y librerías que implementan
algunos de los componentes más habituales, y de escritura más tediosa, en aplicaciones web. Todo ello
debiera redundar en un menor coste total de propiedad (TCO) de las soluciones desarrolladas sobre
openFWPA.
• Definición de estándares de desarrollo, calidad y aceptación. Se trata de un conjunto de directrices, de
obligado cumplimiento, para exigir y garantizar unos niveles mínimos de calidad en las aplicaciones
J2EE [1]. Estos estándares son internos al Principado de Asturias, y son por tanto aplicables solamente
dentro de aquellos proyectos desarrollados dentro del Principado de Asturias.
El openFWPA posee las siguientes características:
• Uso de software libre. Hay una serie de proyectos del mundo del software libre que poseen una excelente
calidad, lo que los habilita para participar en aplicaciones de misión crítica.
• Uso de patrones de diseño. El openFWPA promueve el uso de patrones de diseño, en dos sentidos
importantes. En primer lugar, el framework está diseñado y construido sobre patrones. Por otro lado,
las aplicaciones que se desarrollan sobre el framework hacen uso asimismo de patrones. Entre otros,
las aplicaciones desarrolladas sobre openFWPA siguen una arquitectura Modelo2 , el estándar en
aplicaciones web (se trata de una adaptación del famoso MVC).
• Uso de estándares. En el diseño del openFWPA se ha promovido la utilización e incorporación de
estándares (por ejemplo, XHTML [4] + CSS [14], etc.). El uso tanto de patrones de diseño como
de estándares proporciona importantes ventajas en cuanto a la adaptabilidad y longevidad de las
aplicaciones que los utilizan, al ser más fácilmente mantenidas, extendidas o reutilizadas.
• Aspecto corporativo. Otra característica importante es que las aplicaciones deben integrarse con el resto
de aplicaciones del Principado de Asturias, tanto a nivel funcional como de aspecto (look & feel). El
openFWPA incluye un conjunto de plantillas y componentes para construir la capa de presentación de
acuerdo a las guías de estilo corporativo del Principado de Asturias. En la versión publicada en portal,
estas plantillas pueden modificarse de acuerdo a las necesidades de cada proyecto. Sin embargo, los
proyectos internos han de seguir las directrices de estilo corporativo.
• Integración de aplicaciones. La nueva funcionalidad, añadida al openFWPA en las últimas versiones,
facilita la integración de las aplicaciones con otros sistemas del Principado de Asturias (sistema de
seguridad, comunicaciones, bases de datos corporativas, sistemas de seguridad, sistemas de CRM, etc.).
1
Presentación de openFWPA
Esta funcionalidad solo está disponible para los proyectos internos, al carecer de interés en aplicaciones
desarrolladas fuera de la organización.
• Ciclo de vida. Las aplicaciones poseen un ciclo de vida más allá de su desarrollo y puesta en producción.
Éstas han de ser configuradas, migradas y operadas en los diversos entornos. Por ejemplo, el framework
proporciona piezas con una funcionalidad importante que facilita el soporte a la operación. Los
componentes del framework están preparados para ser gestionados “en caliente” desde una consola
de operaciones, y ofrece componentes para aspectos críticos de operación (como gestión adecuada de
logging, pistas de auditoría, estadísticas de rendimiento y uso). En general, estos aspectos se incorporan
al framework de manera transparente a las aplicaciones. Asimismo, se ofrece (opcionalmente) una serie
de APIs avanzadas que permiten a las aplicaciones publicar funcionalidad en la consola de operaciones.
Visión General de openFWPA
El framework de desarrollo J2EE del Principado de Asturias posee la siguiente estructura. Dentro de cada
elemento se muestran los artefactos más relevantes:
Figura 1.1. Estructura de openFWPA
A continuación, se muestran en más detalle los diversos elementos que lo componen.
Aceptación Las aplicaciones desarrolladas con el framework para uso interno
del Principado de Asturias deben pasar por una serie de controles
de calidad. A tal efecto, se han desarrollado una serie de guías que
deben seguirse para el desarrollo de estas aplicaciones. Dentro de
esta guía de aceptación se define una arquitectura reutilizable que
debieran seguir las aplicaciones.
Entorno de desarrollo El framework de desarrollo es agnóstico en cuanto al entorno de
desarrollo. Éste debiera poseer los siguientes elementos:
• Entorno Integrado de desarrollo. Ofrece un entorno donde los
desarrolladores pueden desarrollar, compilar, depurar y probar el
software en construcción.
• Herramientas de despliegue. Permite el despliegue de las
aplicaciones en los distintos entornos (máquina local, máquinas
del entorno de desarrollo, etc.).
• Diseño de informes. Permite la construcción de informes en
distintos formatos.
• Gestión de la configuración. Permite la gestión del cambio de
los distintos elementos del sistema (código fuente, scripts de
construcción, pruebas, etc.). Se trata de un sistema de control de
versiones.
• Entorno de integración (semi) continua. El entorno de desarrollo
debiera ofrecer funcionalidad avanzada de integración continua
o semi-continua.
Los proyectos arrancados dentro del Principado de Asturias deben
poseer las herramientas definidas en el puesto estándar. Estas
2