manual de usuario aplicación base para el desarrollo en j2ee
Contents
1. 6 4 4 Actuaciones en la JSP del formulario y validaciones en cliente Para la Validaci n en cliente existen varias posibilidades dependiendo de c mo se construya la p gina Si existe tag lt html submit gt se debe e A adir en el tag lt html form gt el atributo onsubmit validateNombreFormulario this e A adir justo despu s del tag lt html form el tag lt html Javascript formName NombreFormulario gt Si no existe tag lt html submit gt se debe e Revisar todos los m todos javaScript donde exista la sentencia document forms 0 submit o alguna otra equivalente y a adir a la l gica que tuviese si se cree conveniente hacer la validaci n en cliente en vez de la sentencia anterior lo siguiente if validateNombreFormulario document forms 0 document forms 0 submit e Adem s como en el caso anterior justo despu s del tag lt html form gt el tag siguiente lt html javascript formName NombreFormulario gt Y Recuerda que P gina 27 de 37 UY MANUAL DE USUARIO APLICACI N BASE PARA EL DESARROLLO EN J2EE V1 4 E Junta de Castilla y Le n e Debes comprobar en el fichero WEB INF nombreAplicaci n config xml que el formulario con el que estas trabajando se valide con Struts e indicar la p gina JSP en la cual retornar en caso de no superar la validaci n Esto es tener los valores validate true e input pagina jsp Ejemplo lt a2. a y gt Generador de OT y OAD 2 Selecciona tablas No generar Si generar SEGU_EXT_FUNCIONES SEGU_APLICACIONES SEGU_FUNCIONES SEGU_ASIGNACION FUNCIONES SEGU_GRUPO_USUARIOS a SEGU_ASIGNACION_ USUARIOS Nombre Aplic SEGU_NOTIFICACIONES usuario Bo SEGU_NOTIFICACIONES_HIST SEGU_PARAM_APLICACIONES E Password BI SEGU_PARAM_GRUPOS gt cat Conex p SEGU_PARAM_USUARIOS m Conex ecu TP_MENUS me Driver JDBC SEGU_USUARIOS lt Esquema BD ES Dir Destino Paquete E Iniciando ger a 3 2 3 NOVEDAD Extensi n Modulo GIS Como modulo opcional puede a adir al esqueleto b sico de aplicaci n la extensi n GIS Esta extensi n consiste en un amplio conjunto de acciones y elementos de programaci n debidamente configurados que le ayudar n a la hora de construir un aplicativo GIS para la Junta de Castilla y Le n Los detalles de este modulo y su uso puede consultarse en el documento APPBASE ConfigGISX_X pdf P gina 12 de 37 Castilla y Le n MANUAL DE USUARIO BY Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE V 1 4 3 0 G152_1012 E i Application Sources E 19 es jcyl sic gis actionforms 0 es jcyl sic gis actions 19 es jcyl sic ois oad nA es SE sic gis utiles a a Qj ess E O gis css imagenes F javascript E BExplota04 html E BLocalidades04 html 8 BMunicipio04 html 8 BMunicipio2_04 html 8 B
3. definidos en la B D Un ejemplo de ejecuci n es el siguiente P gina 17 de 37 MANUAL DE USUARIO BY Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V 1 4 Ab Junta de Castilla y Le n Usuario Nombre Apellido1 Apellido2 ADM X Cerrar Sesion Bienvenido a Mediante esta herramienta Para comenzar seleccione uno de los elementos de men Junta de Castilla y Le n P gina de inicio Figura 5 Aplicaci n Generada P gina 18 de 37 E MANUAL DE USUARIO Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 6 DESCRIPCI N DE LOS COMPONENTES PRINCIPALES DISPONIBLES 6 1 Personalizaci n en la secuencia de arranque La versi n actual del proyecto ofrece la clase es jcyl framework JCYLConfiguracion Esta clase se estaba distribuyendo empaquetada en versiones anteriores al jcylfw 1 3 jar La secuencia de pasos de arranque la cual se recomienda encarecidamente no alterar est implementado en el m todo public static void inicializar Servlet servlet La intenci n de esta mejora es hacer la secuencia de arranque mas transparente a los desarrolladores y mostrar el caso pr ctico de uso del nuevo componente GestorConfiguracion Para a adir operaciones especificas de inicializacion y finalizaci n globales de la aplicaci n se recomienda seguir usando la clase XXXXConfigApp 6 1 1 Ejecuci n de c digo al inicio o fin
4. setCancelada true 0JO esto es fundamental puesto que sino se puede bloquear el planificador ya que est a la espera que la tarea finalice correctamente o bien que se haya indicado que la cancelaci n se ha ejecutado return Como se puede ver tambi n se debe indicar que la tarea ha finalizado para permitir al planificador continuar con otras ejecuciones puesto que sino quedar a la espera de la finalizaci n de la tarea y esto no se producir nunca Cuando se llama al m todo cancelar se detiene la ejecuci n del planificador hasta que la tarea haya finalizado o se haya llegado a un punto de control y se haya cancelado Ejemplo de una Tarea public class TareaEjemplo extends JCYLTarea public TareaEjemplo super protected void ejecutar JCYLPlanificadorTareas log Tarea 3 this timed 1 try Thread sleep 40000 catch InterruptedException e e printStackTrace P gina 21 de 37 MANUAL DE USUARIO 4D Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 if comprobarSalir JCYLPlanificadorTareas log Tarea cancelada setCancelada true return try 1 Thread sleep 40000 catch InterruptedException e e printStackTrace JCYLPlanificadorTareas log Tarea 3 this finalizada public void setParametros String parametros P gina 22 de
5. 37 7 MANUAL DE USUARIO sE Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 6 3 Sistema de Log Est ndar log4j La aplicaci n base incorpora un sistema de Log basado en el componente log4j La primera y una de las mayores ventajas de cualquier API de logging sobre el tradicional System out printin es la capacidad de habilitar y deshabilitar ciertos logs mientras otros no sufren ninguna alteraci n Esto se realiza categorizando los mensajes de logs de acuerdo al criterio del programador Log4J tiene por defecto 5 niveles de prioridad para los mensajes de Log e DEBUG Se utiliza para escribir mensajes de depuraci n este log no debe estar activado cuando la aplicaci n se encuentre en producci n e INFO Se utiliza para mensajes similares al modo verbose en otras aplicaciones e WARN Se utiliza para mensajes de alerta sobre eventos que se desea mantener constancia pero que no afectan el correcto funcionamiento del programa e ERROR Se utiliza en mensajes de error de la aplicaci n que se desea guardar estos eventos afectan al programa pero lo dejan seguir funcionando como por ejemplo que alg n par metro de configuraci n no es correcto y se carga el par metro por defecto e FATAL Se utiliza para mensajes cr ticos del sistema generalmente luego de guardar el mensaje el programa abortar Adicionalmente a estos niveles de log existen 2 niveles extras que solo se utilizan en el
6. MANUAL DE USUARIO Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n v1 4 aplicaci n desee leer un par metro de configuraci n lo har especificando el contexto en que se encuentra La configuraci n de la aplicaci n como tal se encuentra repartida en uno o varios ficheros siempre asociados a un contexto Este componente soporta los tradicionales ficheros properties y ficheros XML Esquem ticamente puede verse el conjunto en este diagrama t ZA Contexto app confic default fichero p Repositorio de Contexto configuraciones pdf parame Contexto web wet GestorConfiguracion P gina 32 de 37 MANUAL DE USUARIO S Junta de Castilla y Le n APLICACI N BASE PARA EL DESARROLLO EN J2EE V 1 4 Un ejemplo sencillo del fichero que define el repositorio se representa a continuaci n lt xml version 1 0 encoding I S0 8859 1 gt lt configurations version 1 0 xmlns xsi http www w3 org 2001 XMLSchema instance xsi noNamespaceSchemalocation xsd ConfigurationRepository xsd gt lt Configuraciones globales gt lt gl obals gt lt Ruta base para todos los ficheros de configuraci n gt lt initialPath value web inf directory config gt lt Propiedades globales gt lt properties gt lt property name mi ni mumCheckDel ay value lt property
7. definen las caracter sticas necesarias para el correcto funcionamiento del framework struts seg n el est ndar DTD Struts Configuration 1 1 definido en http jakarta apache org struts dtds struts config_1_1 dtd WEB INFiconfigWog xml que especifica la configuraci n del sistema de Log basado en el componente logaj WEB INFiconfiglog4jfw properties que especifica la configuraci n del log interno al sistema WEB INF configlapp config properties donde se puede parametrizar la aplicaci n a desarrollar mediante la especificaci n de par metros en forma nombre valor en un archivo properties propio de java WEB INFiconfiglJCYLPlanificador properties que especifica la configuraci n de las tareas que se deseen planificar en el tiempo y sus caracter sticas WEB INFtiles def xml donde se definen la organizaci n de las p ginas jsp en el caso de utilizar Tiles Struts opcional y no utilizado de momento WEB INFvalidation xml donde definir las reglas de validaci n usado en el formulario de Login WEB INFvalidator rules xml definici n de las reglas de validaci n en cliente basadas en javascript WEB INFiconfigiConfigurationRepository xml que contiene la referencia a todos los ficheros de configuraci n de la aplicaci n al que llamamos repositorio de configuraci n P gina 7 de 37 mo MANUAL DE USUARIO sE Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 3 GENERAR APLICACI N BASE En este apar
8. name contextTime0ut value 100 lt properties gt 10000 ws 00 gt lt globals gt lt Lista de contextos de la aplicaci n gt lt contexts gt lt Configuraci n de la aplicaci n gt lt context id default name Configuraci n de la aplicaci n gt lt configurationFile id application name Par metros generales de la aplicaci n location pruebas config prueba properties gt lt context gt lt l e del m dulo de PDF gt lt context id pdf name Componente de generaci n de documentos PDF gt a ll recado id application name Par metros del componente location pdf xml gt lt context gt lt contexts gt lt configurations gt Este repositorio contiene los siguientes elementos e Una lista de propiedades globales que permiten la parametrizaci n del propio gestor de configuraciones lt Configuraciones globales gt lt gl obals gt lt Ruta base para todos los ficheros de configuraci n gt lt initialPath value web inf directory config gt lt Propiedades globales gt lt properties gt lt property name minimumCheckDelay value 10000 gt lt property name contextTime0ut value 10000 gt lt properties gt lt gl obals gt e Un contexto default que para la configuraci n b sica de la arquitectura de la aplicaci n Contiene un nico fichero de configuraci n basado en un fichero d
9. posee un conjunto de caracter sticas que son la aplicaci n de los est ndares de desarrollo Web corporativo en la Junta de Castilla y Leon as como un amplio n mero de recursos y herramientas que permiten mejorar la productividad a la hora de afrontar un desarrollo Web a medida y de calidad Las aplicaciones generadas a partir de este esqueleto base est n asociadas con un completo sistema de seguridad que autorizan la interacci n nicamente a los usuarios especificados y a las acciones previamente descritas Adem s asegura que cumplen con los est ndares corporativos de desarrollo Web se beneficiar n de disponer de Una gesti n eficiente de los ficheros de configuraci n Un Escritura en los ficheros de log Una Organizaci n del proyecto en directorios y ficheros Una calidad en la organizaci n y estilos de la capa de presentaci n Una arquitectura interna escalable y f cilmente de mantener P gina 5 de 37 E Junta de Castilla y Le n MANUAL DE USUARIO APLICACI N BASE PARA EL DESARROLLO EN J2EE V1 4 2 ESTRUCTURA DE LA PROPUESTA 2 1 Estructura de la aplicaci n base La propuesta contiene la estructura propia de una aplicaci n Web generada con los est ndares de la JCYL 2 Deploy El E Documentos E 1 Fuentes E 5 DEMO El A dasses 2 deploy 5 Entradas 2 model 2 Salidas E B sre E O es 5 META INF E 1 web D ss 5 imagenes O javascript 2 Q WEB INF 3 config O l
10. rs getString D_PROV datos setCProvld rs getString C_PROV_ID listado add datos if i cuantos break while catch SQLException ex throw ex finally JCYLGestionTransacciones close con getAutoCommit try catch return listado P gina 37 de 37
11. tema P gina 15 de 37 7 MANUAL DE USUARIO E Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 4 4 Otras consideraciones e No se puede hacer una llamada directa a una p gina jsp e Para las aplicaciones de acceso publico NOVEDAD solamente se requiere especificar las nuevas propiedades TIPO_LOGIN_DEFECTO USUARIO_PUBLICO y PASSWORD_PUBLICO e En la clase que realice el login la que sustituya a es Jcyl consejeria NombreAplicacion actions NombreAplicacionLogin Action no debe alterarse el c digo que se presenta sin embargo puede a adirse el c digo que se estime necesario e Se incorpora en c digo fuente la clase JCYLConfiguracion java dentro del paquete es jcyl framework Esta clase que se distribu a en versiones anteriores dentro de jcylfwx_x jar se ofrece para consultar los pasos seguidos en arranque b sico de una aplicaci n y el uso de las capacidades del componente ConfigurationRepository Se recomienda no cambiar 5 CARACTER STICAS DE LA APLICACI N GENERADA Una vez ejecutada la aplicaci n y hechos todos los cambios indicados podemos entrar en JDeveloper y abrir el workspace generado Este se encuentra dentro del directorio de la aplicaci n fuentes Existen un fichero jws workspace asociado a las distintas versiones de JDeveloper 9 0 3 y 9 0 5 o 10g Es aconsejable renombrar el fichero ws y jpr eliminando la etiqueta de la versi n del JDeveloper desde dentro de la
12. tiposDependencias gt lt arg0 key gt lt field gt lt form gt lt formset gt 333 Cada formulario tendr su secci n lt form name que se desee validar gt lt form gt por cada formulario Tambi n tendr una secci n y un lt field gt lt field gt por cada campo del formulario que se desee validar Teniendo en cuenta que los tiposDependecias pueden ser varios y deben ir separados por comas Los tipos de dependencias son las siguientes required minlength maxlength invalid byte short integer long float double date range creditcard email mask Para m s informaci n de c mo configurar este fichero fijarse en los ejemplos dados en el validation xml de la aplicaci n base o en el documento mencionado anteriormente Struts in Action En resumen este fichero es en el que se configuraran todos los campos de todos los formularios donde se quiera hacer validaciones y las validaciones que se deseen asociar a cada campo 6 4 3 Actuaciones en los ActionsForms y AplicacionResources properties En los ActionsForms hay que indicarles que usen estas reglas de validaci n Para eso es necesarios revisar 1 Hacer que los Form que se deseen validar en la parte servidora hereden de org apache struts validator ValidatorForm en vez de org apache struts action ActionForm Pa validaci n en servidor 2 Comprobar que la clase compila revisando las entradas import impo
13. valores no los nombres de las propiedades que vienen incluidas por defecto en el mismo 4 2 1 Propiedades generales de la aplicaci n El Descripci n Ejemplo de Valor SISTEMA Debe especificarse la clave de 4 Caracteres que identifica GECE la aplicaci n y que es la utilizada en el sistema de seguridad TITULO Etiqueta de T tulo la aplicaci n que aparece en la pantalla de login TIEMPO_REFRESCO_ Tiempo en segundos para volver a refrescar el fichero de LOGS_ SEGUNDOS logs de la aplicaci n log xml ClaseConfiguracion Clase que inicializa la configuraci n propia de la aplicaci n Aparece rellena por defecto 4 2 2 Propiedades relativas al sistema de seguridad Propiedad Descripci n Ejemplo de Valor SEGU_HOST Maquina Direcci n IP o DNS donde reside el servidor OC4J que contiene los componentes de Seguridad Acceso REMOTO SEGU_PORT Puerto para acceder al servidor OC4J como administrador Acceso REMOTO SEGU_USER Identificaci n ante el servidor OC4J Acceso REMOTO SEGU_PASSWORD Palabra clave Acceso REMOTO SEGU_APP_SEGURIDAD Nombre de la aplicaci n en el servidor donde ha sido desplegado el componente P gina 14 de 37 MANUAL DE USUARIO APLICACI N BASE PARA EL DESARROLLO EN J2EE Junta de Castilla y Le n V14 SEGU_POOL Repositorio de Datos de Segu por defecto SEGU_REFRESCO Indica si al crear una nueva Sesion hay que refrescar el HastTable de funciones accesibles Valores posibles
14. xml facilitados con la distribuci n de la aplicaci n base 1 2 o posteriores Nota Para obtener estos ficheros se debe generar una aplicaci n base vac a en un directorio temporal con el mismo nombre de aplicaci n que la que se est desarrollando y obtener los ficheros indicados 2 Del fichero validation xml eliminar si no se desea utilizar la informaci n relacionada con las validaciones de los formularios LoginForm lt form name LoginForm gt lt form gt y CambioPasswordForm lt form name CambioPasswordForm gt lt form gt Se pueden consultar para ver como est implementado en la aplicaci n base 3 Insertar en WEB INF nombreAplicaci n config xml inmediatamente antes del tag lt struts config gt se debe introducir el tag siguiente lt plug in className org apache struts validator ValidatorPlugln gt lt set property property pathnames value WEB INF validator rules xml WEB INF validation xml gt lt plug in gt 4 A adir en el validation xml una secci n lt formset gt por locale idioma como formularios se quieran validar introduciendo entre los tag lt form validation gt lt form validation gt un c digo equivalentes al siguiente lt formset gt lt form name nombreFormulario gt P gina 25 de 37 E MANUAL DE USUARIO sE Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 lt field property nombrePropiedad depends
15. Descripci n Manual de uso sobre la herramienta que genera una aplicaci n base si como una descripci n del producto que genera tal herramienta Indicando las modificaciones introducidas Elaborado por Diego Garc a Carrera Fecha Marzo 2006 Juan Antonio Barras Garc a Fecha Mayo 2006 Ooo Fecha A A CCCCICI2I25S Fecha Aprobado por _ Juan Antonio Barras Garc a Fecha Mayo 2006 Lista de distribuci n del documento Nombre Localizaci n 7 MANUAL DE USUARIO sE Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 Indice 1 INTRODUCCION asinina aba ara 5 1 1 Objetivo del doce scaricare id 5 2 ESTRUCTURA DE LA PROPUESTA snsninicaniininarinnacnacinaannan ni 6 2 1 Estructura de la aplicaci n base serenidad ion ci 6 3 GENERAR APLICACI N BASE ccccccccinninnmincniiicananaanaanc nr nora nr rra 8 3 1 Consideraciones Pre VIS siii Oasis 8 3 2 Ejecuci n de la HeraMenta isis 8 3 2 1 Creaci n del esqueleto base de la aplicaci n ooooooccccinnncccccnnnnccccccnnoccncnonanannnnnnnns 8 3 2 2 Generaci n de Objetos Valor y Objetos de acceso a datOS ooooooccccccccccccnccannnnos 10 3 2 3 NOVEDAD Extensi n Modulo GIS isis inicio 12 4 PERSONALIZAR LA APLICACI N BASE oocccmncncinnniiimcnnaniniincncnnananananes 13 4 1 Sistema de Logs Cambios en WEB INF config log Xml ooocococccnnnncocccononaccccnonanancncnnno 13 4 2 Propiedades de la aplicaci n Cambios en WEB INAco
16. Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 6 4 Validaciones basadas en Struts A partir de la versi n 1 2 se han implementado los cambios necesarios en la Aplicaci n Base para poder utilizar las posibilidades de validaci n avanzada de formularios mediante Struts Este sistema de validaci n Struts Validator ya estaba disponible en la versi n de Struts utilizada en la aplicaci n base Struts 1 1 por lo que el siguiente apartado se encargar nicamente de documentar a grandes rasgos como usarlo Para mas detalles de las capacidades de Struts Validator se recomienda consultar el documento de Struts in Action apartado 4 9 Configuring the Struts Validator y en el apartado 12 Validating user input se van describir los pasos a realizar para implantar dicha soluci n 6 4 1 Pasos para aplicar la validaci n basada en Struts Se van describir los pasos a realizar para implantar dicha soluci n para la validaci n de campos tanto en la parte cliente como en la parte servidora ambas validaciones son independientes por lo que en los puntos se indicaran cuales pertenecen a la validaci n cliente y cuales a la validaci n de servidor y cuando no se indique nada es que pertenecen a las dos 6 4 2 Actuaciones en los XML con las reglas de validaci n Los pasos a seguir a adir una validaci n basada en reglas con Struts son los siguientes 1 A adir en WEB INF los ficheros validator rules xml y validation
17. Permite gestionar de forma transparente m ltiples ficheros de configuraci n Los par metros pueden estar en uno o varios ficheros que pueden agruparse por contextos o tratarse de forma centralizada e La aplicaci n tiene acceso a los cambios realizados en los ficheros de configuraci n sin necesidad de reiniciar la ejecuci n recarga en caliente e La memoria ocupada por las colecciones de par metros de una aplicaci n se optimiza siempre al m ximo gracias a un mecanismo din mico de carga y desalojo de contextos de configuraci n El acceso a los ficheros de configuraci n y la gesti n de los mismos se realiza gracias a las librer as proporcionadas por el proyecto commons configuration del proyecto Jakarta http jakarta apache org commons configuration 6 6 2 Gu a R pida de uso En este apartado se presenta un ejemplo sencillo de utilizaci n del componente de configuraci n La referencia detallada puede consultarse en el manual espec fico del componente 6 6 2 1 Elementos para configuraci n de la aplicaci n Para que una aplicaci n haga uso del sistema de configuraci n debe incorporar un fichero denominado repositorio de configuraciones que contiene la referencia a todos los ficheros de configuraci n de la aplicaci n Para desacoplar la aplicaci n de la forma de ubicar los ficheros este repositorio define el concepto de contexto como una agrupaci n de ficheros de configuraci n Cuando la P gina 31 de 37
18. Sigpac04 html 8 ConfigCapas jsp E Coordenadas04 html E Datos htm 8 DatosGPS jsp 3 Distancias04 html 18 errorpage jsp 3 FMunicipios html WE Frames html 8 FuncionesGPS htrml 12 FuncionesGPS jsp E GAlta04 htrnl 2 GAltad4 jsp 8 GAlta2 04 htrl 8 G lta2 04 jsp E GBaja04 html 2 GBaja04 jsp A E E E E WEB INF E config lib 3 logs E aplicacion log E aplicacion log 1 E auditoria log E framework log E framework log 1 Readme txt 1 en _1 dtd a tiles config_1_1 dtd E tiles def xml E validation_1_1 dtd a validation xml EN validator rules_1_1 dtd bottomLoain isp El detalle 4 PERSONALIZAR LA APLICACI N BASE Una vez generada nuestra aplicaci n base es necesario revisar y adaptarla a nuestras necesidades Para ello se deben configurar los siguientes apartados 4 1 Sistema de Logs Cambios en WEB INF config log xml P gina 13 de 37 Ag MANUAL DE USUARIO BY Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V 1 4 Debe actualizarse el nombre y las rutas de los ficheros de logs que se desee crear en la aplicaci n Por defecto nos los dejar en WEB INF logs Para m s informaci n leer ESCRITURA EN FICHEROS DE LOGS 4 2 Propiedades de la aplicaci n Cambios en WEB INF config app config properties En este archivo se deben modificar los valores s lo los
19. archivo de configuraci n estos son e ALL este es el nivel m s bajo posible habilita todos los logs e OFF este es el nivel m s alto posible deshabilita todos los logs La aplicaci n base usa tres ficheros para almacenar informaci n de tres tipos aplicaci n auditoria y framework Estos archivos se encontrar n en el mismo directorio que tengamos definido en el fichero log xml Si no lo hemos modificado estar en WEB INHlogs El fichero aplicaci n contiene todos los mensajes de log que nosotros hayamos definido dentro de nuestra aplicaci n Elfichero auditoria contiene las opciones accedidas por cada usuario El fichero framework contiene informaci n sobre el funcionamiento interno del framework 6 3 1 Uso del sistema de Log en la aplicaci n base En toda clase en la que deseemos usarlo debemos importar la clase P gina 23 de 37 mo MANUAL DE USUARIO E Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 import es jcyl nombreconsejeria nombreaplicacion config NOMBREAPLICACIONConfigApp Cuando queramos invocarlo debemos hacerlo de la siguiente manera NOMBREAPLICACIONConfigApp logger error mensaje Error puede sustituirse por debug info etc Tambi n podemos a adir todos los appenders a mayores que queramos Para mas informaci n sobre como usar el componente log4j consultar el documento log4j doc P gina 24 de 37 E MANUAL DE USUARIO
20. cation setAttribute CONSEJERIAS consejerias consejerias null ln null 6 2 Planificador de tareas Se ha incluido en el framework base un reducido gestor de tareas Este componente se ha dise ado tratando de reducir el trabajo del programador a la hora de generar y planificar tareas Este componente se ha dise ado tratando de reducir el trabajo del programador a la hora de generar las nuevas tareas En este apartado se va a comentar la forma de crear una nueva tarea para que pueda ser utilizada por el planificador Toda tarea que se cree debe extender de la clase JCYLTarea e implementar los dos m todos abstractos de esta clase ejecutar y setParametros para realizar las acciones para las que se cree la tarea M todo ejecutar En este m todo se lleva a cabo todo el trabajo de la tarea Se debe tener en cuenta que si la tarea es interrumpible debe ser el programador el que establezca puntos de control en los que se compruebe si se ha solicitado la cancelaci n de la tarea en cuyo caso se anotar en el log y no se continuar con la ejecuci n del m todo Si la tarea no es interrumpible aunque se definan estos mismos puntos de control nunca se activar n puesto que los m todos de la clase padre consideran esta posibilidad Metodo setParametros En este m todo es donde se debe incluir el c digo necesario por la tarea para hacer uso de los par metros definidos en el fichero de propiedades Si no se
21. ction path DEMOSolVacacionesAl type es Jcyl uic demo actions DEMOSolVacaciones input DEMOSolVacaciones gt Jsp name DEMOFormularioForm scope request validate true gt lt forward name exito path DEMOSolVacaciones do gt lt action gt e Comprobar que en la p gina JSP del formulario est n las tags donde presentar los mensajes de error definidos en la validaci n como por ejemplo lt Propiedad DNombre gt lt tr gt lt td class textoTituloGris align left gt DNombre lt td gt lt td align left gt lt html text property DNombre gt lt html errors property DNombre gt lt td gt lt tr gt P gina 28 de 37 E Junta de Castilla y Le n MANUAL DE USUARIO APLICACI N BASE PARA EL DESARROLLO EN J2EE V 1 4 6 5 Gesti n de transacciones en aplicaci n Base El objetivo principal de sta nueva propuesta es mejorar la Gesti n de transacciones entre objetos OAD s Con ella se pretende no tener que ir pasando la conexi n y el usuario por toda las clase de l gica de negocio y OAD s que involucren a una transacci n La filosof a propuesta para conseguir esto es asociar tanto la conexi n como el usuario al thread que se esta utilizando que en una transacci n siempre es el mismo En su implementaci n se han modificado clases generadas en la aplicaci n base como nuevas versiones y nuevas clases de las librer as internas al
22. de la aplicaci n Clase XXXConfigApp La aplicaci n base generada mediante esta herramienta nos define un entorno en el cual podemos definir que programa o c digo queremos que se ejecute tanto iniciar la aplicaci n como justo antes de la finalizaci n del mismo Para ese prop sito se ha definidos los m todos inicializar y finalizar de la clase es jcyl consejeria nombreaplicacion config NOMBREAPLICACIONConfigApp java El siguiente ejemplo ilustra como incluir c digo a ejecutar al inicio de la aplicaci n Este mismo ejemplo lo detallaremos dentro del ANEXO ll public void inicializar ServletContext application throws Exception logger JCYLConfiguracion getlLogger JCYLConfiguracion LOG_APLICACION logger debug getClass getName inicializar Cargar lista de Provincias y almacenarlas en el contexto de la aplicaci n DEMOConfigLN ln new DEMOConfiglN Java util ArrayList provincias_cyl l1n RecuperarListaProvincias application setAttribute PROVINCIAS_CYL provincias_cyl logger debug Guardardo en Aplicacion Provincia provincias_cyl toString provincias_cyl null Cargar lista de Consejerias y almacenarlas en el contexto de la aplicaci n Jjava util Arraylist consejerias l1n RecuperarlListaConsejerias P gina 19 de 37 mo MANUAL DE USUARIO E Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 appli
23. e propiedades est ndar denominado prueba properties lt Configuraci n de la aplicaci n gt lt context id default name Configuraci n de la aplicaci n gt A a application lomas generales de la aplicaci n location pruebas config prueba properties gt lt context gt P gina 33 de 37 a MANUAL DE USUARIO X lt B Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n v1 4 e Un contexto pdf para la configuraci n de un componente para generaci n de ficheros en formato pdf Contiene un nico fichero de configuraci n basado en xml denominado pdf xml lt Configuraci n del m dulo de PDF gt lt context id pdf name Componente de generaci n de documentos PDF gt lt configurationFile id application name Par metros del componente location pdf xml gt lt context gt 6 6 2 2 Acceso a la configuraci n desde la aplicaci n Para permitir que la aplicaci n localice el fichero con el repositorio de configuraciones debe ser inicializada indicando la ruta del fichero Este proceso debe realizarse una nica vez durante la ejecuci n de la aplicaci n Obs rvese que el uso del componente GestorConfiguraci n se realiza mediante m todos est ticos por lo que no es necesario almacenar ninguna referencia al mismo 6 6 2 3 Inicializaci n para aplicaciones web En el caso de aplicaciones web basta con a adir una nueva entrada en e
24. e gt gt gt gt z y an Castilla y Le n MANUAL DE USUARIO APLICACI N BASE PARA EL DESARROLLO EN J2EE Edici n V 1 4 Autor Unidad de Inform tica Corporativa Area de Desarrollo y Mantenimiento Fecha Mayo 2006 MANUAL DE USUARIO ED unta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n v1 4 Versi n 1 0 Versi n 1 2 Versi n 1 3 Versi n 1 4 Historia del Documento Versi n Beta Descripci n Manual de uso sobre la herramienta que genera una aplicaci n base si como una descripci n del producto que genera tal herramienta Fecha Diciembre 2003 Fecha Diciembre 2003 Fecha Diciembre 2003 Descripci n Manual de uso sobre la herramienta que genera una aplicaci n base si como una descripci n del producto que genera tal herramienta Fecha Febrero 2004 Fecha Marzo 2004 Fecha Mayo 2004 Descripci n Manual de uso sobre la herramienta que genera una aplicaci n base si como una descripci n del producto que genera tal herramienta Indicando las modificaciones introducidas con nuevos anexos Fecha Enero 2005 Fecha Enero 2005 Fecha Enero 2005 Descripci n Manual de uso sobre la herramienta que genera una aplicaci n base si como una descripci n del producto que genera tal herramienta Indicando las modificaciones introducidas Elaborado por Fecha Febrero 2005 Juan Antonio Barras Garc a Fecha Febrero 2005 FUN Fecha Febrero 2005
25. e queremos generar la aplicaci n Deber estar vac o e Nombre corto consejer a Iniciales de la consejer a min sculas necesario para el nombrado de los paquetes java del c digo fuente generado Ej cf gss ce etc e Nombre largo consejer a Nombre completo descriptivo para mostrarlo en las p ginas de la aplicaci n e Seguridad en BD ncluir las librer as de acceso y ficheros necesarios del sistema de seguridad en la versi n Base de Datos e Seguridad en XML ncluir las librer as de acceso y ficheros necesarios del sistema de seguridad en la versi n XML e Incorporar Modulo GIS Casilla opcional para a adir al esqueleto el m dulo GIS A continuaci n debemos pulsar el bot n Generar y cuando el proceso haya acabado nos mostrar una ventana indic ndolo 3 2 2 Generaci n de Objetos Valor y Objetos de acceso a datos Opcionalmente pero siempre despu s de tener generada la aplicaci n podemos ejecutar la generaci n de OT y OAD desde el bot n GenerarOTyOAD o mediante la siguiente instrucci n en l nea de comandos java jar GenerarAplicacionJ2EEX_X jJar Pulsando el bot n Generar OT y OAD Ahora nos mostrar la siguiente pantalla P gina 10 de 37 MANUAL DE USUARIO APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n v1 4 ENT ET gt Generador de OT y OAD oN DB Junta de Castilla y Le n Nombre Aplicaci n m
26. eption ex throw ex finally JCYLGestionTransacciones close con getAutoCommit try catch return filas Funcion de listado para la tabla lt I gt PROVINCIAS lt I gt returns Un ArrayList con OT con el contenido de la tabla Gthrows SQLException En caso de error con la Base de Datos t XA A AA O gt param inicio Registro a partir del cual devolver lt I gt 1 lt 1 gt para primero param cuantos Numero de registros a devolver lt I gt 1 lt 1 gt para todos public ArrayList listadoProvincias int inicio int cuantos throws SQLException PreparedStatement st null ResultSet rs null Connection con JCYLGestionTransacciones getConnection ArrayList listado null try String sql SELECT A_ABREV_PR A ABREV_CA D_PROV C_PROV_ID FROM PROVINCIAS st con prepareStatement sql ResultSet TYPE_SCROLL_INS ResultSet CONCUR_UPDATABL rs st executeQueryl y Posicionar el cursor antes de inicio if inicio gt 1 ENSITIVE P gina 36 de 37 MANUAL DE USUARIO E Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 rs absolute inicio 1 listado new ArrayList int i 0 while rs next ProvinciasOT datos new ProvinciasO0T datos setAAbrevPr rs getString A_ABREV_PR datos setAAbrevCa rs getString A_ABREV_CA datos setDProv
27. f a 1 Realizar una clase de l gica de negocio gen rica que se encarga de abrir y cerrar transacci n y en medio de estas llamadas invocar a las distintas l gicas de negocio involucradas 2 Que sea el action el que se encarga de abrir y cerrar transacci n y en medio de estas llamadas invocar a las distintas l gicas de negocio involucradas en la transacci n P gina 30 de 37 E MANUAL DE USUARIO sE Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 6 6 NOVEDAD Gesti n din mica de configuraci n de la aplicaci n 6 6 1 Introducci n Todas las aplicaciones tienen la necesidad de almacenar par metros operativos de forma externa al c digo con el objetivo de facilitar su despliegue en entornos de producci n y permitir la adecuada integraci n con elementos externos servidores de correo de ficheros otras aplicaciones etc El framework de desarrollo para aplicaciones J2EE de la Junta de Castilla y Le n gestiona la configuraci n de una forma centralizada mediante el componente GestorConfiguraci n descrito en este documento En esta versi n se ofrecen ya configurado el componente de forma que tenga un comportamiento y ubicaci n equivalente a las que ten a en versiones anteriores Las principales caracter sticas que relacionan este componente son e Permite a las aplicaciones almacenar su configuraci n tanto en ficheros de propiedades properties como en ficheros en xml e
28. framework jeylfw 1 1 jar jcylutiles 1 1 jar jeyldb 1 0 jar o posteriores El detalle de esas actuaciones es e Relacionado con la asociaci n del usuario al thread O es jcyl framework JCYLUsuario Encargada de asociar al thread el usuario es jcyl framework JCYLRequestProcessor Encargada de asociar el usuario que se encuentra en la sesi n al thread actual NombreAplicacionLoginAction Encarga de asociar el usuario que se encuentra introduce en la sesi n por primera vez al thread actual NombreAplicacionConexionDB Encarga de realizar la auditoria si fuese necesario para todo tipo de conexi n e Relacionado con la asociaci n de la conexi n al thread O NombreAplicacionPruebaAccesoBDOAD se ha convertido a patr n singelton y se controlan las transacciones bas ndose en el clase JCYLGestionTransacciones NombreAplicacionPruebaAccesoBDLN no se ha convertido a patron singelton pero es recomendable hacerlo por eficiencia y se controlan las transacciones bas ndose en el clase JCYLGestionTransacciones NombreAplicacionConexionDB se controlan las conexiones bas ndose en el clase JCYLGestionTransacciones Para ello se han creado las siguientes clases del framework e Relacionado con la asociaci n del usuario al thread O es jcyl framework utiles JCYLGestionUsuario es la que se utilizara para obtener el usuario asociado al thread donde nos encontramos e Relacionado con la asociaci n de la conexi n al th
29. herramienta de desarrollo P gina 16 de 37 e a A MANUAL DE USUARIO m kade APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V 1 4 9 Applications AAEN 1012 3 0 DEMO_1012 E IS Application Sources 13 es cyl framework 9 es cyluic demo 9 es cyl uic demo actionforms 13 es jcyl uic demo actions 9 es jcyl uic demo config 9 es cyl uic demo db 9 es cyl uic demo In 9 es cyl uic demo oad D es cyl uic demo ot Web Content Css imagenes javascript 09 WEB INF config app config properties E 3 ConfigurationRepository ml B ga ConfigurationRepository xsd E JOYLPlanificador properties 23 log xml E log ifw properties ib 23 logs tlds K DEMO config mnl 23 struts config_1_1 dtd E tiles config_1_1 dtd JEX tiles def xml E validation_1_1 dtd 23 validation ml ra validator rules_1_1 dtd i 23 validator rules xml i F web xml e bottom jsp 8 bottomLogin jsp 2 cabecera jsp TC ii 3 Applications 29 Connections 18 Run Manager e e ooo o o ono Figura 4 Proyecto Generado La aplicaci n est lista para ejecutar Si ejecutamos entraremos en la pantalla de login y despu s de introducir un usuario password de la aplicaci n nos mostrar la pantalla de men s si estos ya est n
30. ib 2 logs O META_INF O tds O Programador _1 O Programador _n 3 GestionCalidad 5 Modelo El 1 PaginaWeb E E Pruebas Figura 1 Estructura Aplicaci n Base Componentes de presentaci n o hojas de estilo en el directorio css im genes en el directorio imagenes o scripts de procesamiento en cliente en el directorio javascript o p ginas HTML y p ginas JSP a partir del directorio base de la aplicaci n O Librer as necesarias en el directorio lib Se incluyen las librer as de struts versi n 1 1 librer a de log 4j y librer as propias de la aplicaci n base jcylfw X X jar jcylutiles X X jar jcylbd 1 0 jar que contiene las clases propias del framework en su versi n correspondiente y SistSegu X X X jar librer a del sistema de seguridad usando la versi n correspondiente Clases java de la aplicaci n base en el directorio src e Archivos de configuraci n P gina 6 de 37 MANUAL DE USUARIO E Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 o WEB INFweb xml para definir la aplicaci n Web seg n el est ndar DTD Web Application 2 3 definido en http java sun com dtd web app 2 3 dtd WEB INF config ConfigurationRepository xml que contiene la referencia a todos los ficheros de configuraci n de la aplicaci n al que llamamos repositorio de configuraci n Mas detalles en el apartado correspondiente WEB INFinombreAplicacion config xml donde se
31. l fichero de despliegue web xml de su aplicaci n indicando la ruta donde se encuentra lt env entry gt lt env entry name gt configurationRepository lt env entry name gt lt env entry value gt applications demo demo WEB INF config ConfigurationRepository xml lt env entry value gt lt env entry type gt java lang String lt env entry type gt lt lenv entry gt Desde la aplicaci n debe obtener este valor y emplearlo para inicializar el componente GestorConfiguracion II Obtiene la ruta al configuration repository String ruta getEnvEntry configurationRepository IT Inicializa GestorConfiguracion a partir de la ruta donde se encuentra GestorConfiguracion initial el ruta 7 1 EJEMPLO 1 Pasos para utilizar PreparedStatement en los OAD s Por temas de seguridad se recomienda sustituir la llamada al m todo createStatement por prepareStatement P gina 34 de 37 MANUAL DE USUARIO Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 A continuaci n se muestra c mo quedar an el OAD s de ejemplo que se encuentra al desplegar la aplicaci n base para m s informaci n se recomienda tener en cuenta las indicaciones del documento anteriormente citado package es Jcyl uic demo oad import jJava sql import java util import java util Date import es jcyl uic demo ot import es jcyl cf seguridad util Usuario import org apache log43 Logger import e
32. mos tener instalado JDK 1 3 o superior Consta de los siguientes ficheros GenerarAplicacionJ2EE1_4 jar GenerarAplicacionJ2E E properties GesiSeguXMLv1 exe NombreAplicacion zip P gina 8 de 37 aay MANUAL DE USUARIO E Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V 1 4 SeguridadBD zip SeguridadXML zip VariablesGenerarWin properties WebApp zip WebGiIS zip Para ejecutar el programa deber teclear en l nea de comandos lo siguiente siendo X_X Versi n actual java jar GenerarAplicacionJ2EEx_x jJar Nos mostrar la siguiente pantalla y nos pedir una serie de par metros Generaci n de aplicaci n base J2EE Versi n 1 4 Al EX gt 39 PE x T unta de Generador de Aplicaciones Castilia y Le n Nombre de la aplicaci n Directorio destino Nombre corto consejeria Nombre largo consejeria 1 O Seguridad en XML Incorporar Modulo GIS 8 Seguridad en BD Mensajes de la aplicac Figura 2 Generador de Aplicaciones J2EE Par metros necesarios todos los campos son obligatorios P gina 9 de 37 mo MANUAL DE USUARIO sE Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 e Nombre de la aplicaci n Nombre corto de 4 letras May sculas utilizado como identificador de la aplicaci n que debe coincidir con el introducido en el sistema de seguridad e Directorio destino Directorio dond
33. nResources properties 26 6 4 4 Actuaciones en la JSP del formulario y validaciones en cliente 27 6 5 Gesti n de transacciones en aplicaci n BaS6 oooooccccnnonociccnononcconcnnancnnnnnancncnnnannnncnnnnns 29 6 6 NOVEDAD Gesti n din mica de configuraci n de la aplicaci n ooooconnnccicnnnnn cccn 31 6 6 1 INTO cd 31 6 6 2 Gu a R pida de USO casino dto 31 P gina 3 de 37 MANUAL DE USUARIO sE Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 T ANEXO dina 34 7 1 EJEMPLO 1 Pasos para utilizar PreparedStatement en los OAD s P gina 4 de 37 mo MANUAL DE USUARIO Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 1 INTRODUCCI N 1 1 Objetivo del documento La Aplicaci n Base para el desarrollo de aplicaciones Web en J2EE se trata de una esqueleto de aplicaci n que incorpora por defecto funcionalidades b sicas y el comportamiento est ndar que deben seguir las aplicaciones J2EE elaboradas seg n los est ndares de la JCyL El objetivo que se pretende alcanzar con este desarrollo es que las aplicaciones de gesti n se puedan construir a partir de esta aplicaci n base sin m s que ampliar la funcionalidad espec fica De esta manera todas las aplicaciones se construir n sobre la misma arquitectura lo que garantizar que ciertos comportamientos sean homog neos para todas las aplicaciones Este proyecto
34. necesita utilizar par metros este m todo puede estar vac o pero siempre hay que implementarlo Una vez creada una nueva tarea y por tanto implementados los m todos anteriores se debe incluir la informaci n de la tarea en el fichero de propiedades del planificador para que ste la pueda utilizar Este est ubicado en WEB INFiconfigWJCYLPlanificador properties y en el se definen los siguiente aspectos Activar Desactivar el planificador Definir la lista de tareas clases java con sus aspectos de ejecuci n P gina 20 de 37 mm MANUAL DE USUARIO E Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 o Intervalo de tiempo entre ejecuciones unidades de tiempo minutos o Tarea activa o desactiva por defecto o Tarea interrumpible o no o N m ximo de ejecuciones o Relaci n de par metros que necesite le tare Si se ha decidido que la tarea puede ser interrumpida durante su ejecuci n se deben insertar puntos de control a lo largo del m todo ejecutar de forma que se comprueba si se ha solicitado la cancelaci n de la tarea y si es as se registra en el log y se sale del m todo permitiendo al planificador continuar con otras tareas Para comprobar si se ha indicado cancelar se puede utilizar el m todo de la clase padre comprobarSalir A continuaci n se muestra el c digo ejemplo que se puede utilizar if comprobarSalir JCYLPlanificadorTareas log Tarea cancelada
35. nfigl app config properties 14 4 2 1 Propiedades generales de la aplicaci n oooocnnncccnnnnoccccccnononccnnnnnarccnnnnanannnos 14 4 2 2 Propiedades relativas al sistema de Seguridad cooooocococccccnnnoccccnonanannnnnnnnnnnnnnnns 14 e e A o Pe rrtt trnseerrn nert nen esene rneeenn e 15 4 2 4 A adir propiedades a nuestra aplicaci n ooooocccccnnnccccnnonccncccnnanrncnnnnanccnnnannnccn 15 4 3 Descriptor de controlador Struts Archivo WEB INF struts config Xml ooooococccnnnccccccco 15 4 4 Otras CONSI TACONES cto loci dd 16 5 CARACTER STICAS DE LA APLICACI N GENERADA coicicciicciccnnncscacas 16 6 DESCRIPCI N DE LOS COMPONENTES PRINCIPALES DISPONIBLES 19 6 1 Personalizaci n en la secuencia de arranque cooooccccnnnnccccnnnonoccnonnnannconnnnannncnnnnnnannnnnnns 19 6 1 1 Ejecuci n de c digo al inicio o fin de la aplicaci n Clase XXXConfigApp 19 6 2 Planificador de Id sta coa 20 6 3 Sistema de Log Estandar 004 sics 23 6 3 1 Uso del sistema de Log en la aplicaci n base ooonocccccinnccccccnnoccccccnnnncncononannnnnnns 23 6 4 Validaciones basadas en Struts oooonocccc nonccccnnnnannccnnnannnnnnnnnnn nono ncnnnnnnnn non nn nn nn nnnnnnnnnns 25 6 4 1 Pasos para aplicar la validaci n basada en StrutS ccccconnnocconccccnnnnnnoninnnonoss 25 6 4 2 Actuaciones en los XML con las reglas de validaci N oooocconiccccnncoccconnnnccccnos 25 6 4 3 Actuaciones en los ActionsForms y Aplicacio
36. read O es jcyl framework db JCYLDataBase es la que se utilizara para basada en el patr n Proxy obtener la conexi n y la asocia al thread en el que se encuentre a trav s de la clase JCYLGestionTransacciones P gina 29 de 37 mo MANUAL DE USUARIO sE Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 o es jcyl framework db JCYLGestionTransacciones es la que se utilizara para controlar las transacciones asociadas al thread en el que nos encontramos Adem s se ha modificado el generador de OAD s para que incluya las modificaciones oportunas para implantar lo explicado como se indica en el apartado siguiente La filosof a de de esta soluci n se basa en asociar objetos al thread que se este ejecutando usuario para auditorias conexi n para transacciones y con ello no hace falta pasarlos a las clases de l gica de negocio ni a los OAD s por tanto si dentro de una misma clase de l gica de negocio se quiere realizar una transacci n al principio del m todo de esta l gica de negocio se abre la transacci n open y al final del m todo se realiza el commit si ha ido bien la transacci n o rollback si ha fallado la transacci n y se cierra la transacci n close mientras que en los OAD s se obtiene la conexi n que ha sido abierta en la l gica de negocio y se utiliza Si la transacci n es tan compleja que implica a varias l gicas de negocio existen dos posibles soluciones bas ndonos en esta filoso
37. rt org apache struts validator ValidatorForm 3 Comprobar que al menos existe el siguiente c digo en el m todo validate ActionMapping mapping HttpServletRequest request del Form Pa2 validaci n en servidor ActionErrors errores super validate mapping request if errores null errores new ActionErrors INICIO Aqu se introducir el c digo con los controles P gina 26 de 37 mm MANUAL DE USUARIO Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 a adidos que se deseen realizar FIN return errores 4 Comprobar que en el fichero AplicationResources properties los mensajes asociados a las validaciones introducidos en el validation xml o si se quieren usar los de por defecto introducir la lista siguiente Struts Validator Basic Error Messages errors required 0 is required errors minlength 0 cannot be less than 1 characters errors maxlength 0 cannot be greater than 1 characters errors invalid 0 is invalid errors byte 0 must be a byte errors short 0 must be a short errors integer 0 must be an integer errors long 0 must be a long errors float 0 must be a float errors double 0 must be a double errors date 0 is not a date errors range 0 is not in the range 1 through 2 errors creditcard 0 is not a valid credit card number errors email 0 is not a valid e mail address
38. s jcyl uic demo config DEMOConfigApp import es jcyl framework db Clase objeto de acceso a datos para la tabla Provincias Hay que verificar en futuras versiones si nos interesa que las funciones sean estaticas public class Provincias0AD public static Logger logger DEMOConfigApp logger private static ProvinciasO0AD instance public static ProvinciasO0AD getInstance if instance null instance new ProvinciasOAD return instance private ProvinciasOAD super P gina 35 de 37 EET ID Junta de MANUAL DE USUARIO APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V 1 4 Funcion de alta para la tabla lt I gt PROVINCIAS lt I gt fparam datos OT con los datos a insertar returns int El numero de filas insertadas 1 en caso correcto throws SQLException En caso de error con la Base de Datos e public int altaProvincias ProvinciasOT datos throws SQLException PreparedStatement st null Connection con JCYLGestionTransacciones getConnection int filas 0 try String sql INSERT INTO PROVINCIAS A_ABREV_PR A_ABREV_CA D_PROV C_PROV_ID VALUES st con prepareStatement sql st setString 1 datos getAAbrevPr st setString 2 datos getAAbrevCa st setString 3 datos getDProv st setString 4 datos getCProvlId filas st executeUpdate catch SQLExc
39. tado describiremos paso por paso como comenzar a desarrollar una nueva aplicaci n J2EE a partir de esta aplicaci n base 3 1 Consideraciones Previas Para poder ejecutar el resultado generado por la herramienta descrita posteriormente se debe tener en cuenta que tal producto se basa o utiliza el sistema de seguridad para aplicaciones J2EE Este sistema se basa en un repositorio de datos independiente donde alojar los usuarios permisos y descripci n de la aplicaci n as como unos componentes de acceso al mismo Por lo tanto en este sistema de seguridad estar dados de alta al menos los elementos b sicos de los que se compone la aplicaci n que son 1 Registro con el nombre de la aplicaci n 2 Datos de un Usuario con acceso a esta aplicaci n con un Rol de acceso 3 Al menos una funci n que pertenezca a esta aplicaci n y accesible por el usuario de entrada al sistema El almacenamiento de estos objetos puede estar basado en Base de Datos o en ficheros XML El Sistema de Seguridad principal es el basado en Base de Datos La versi n en ficheros XML est disponible para facilitar el desarrollo sin tener instalada la infraestructura completa de Seguridad Para conocer en que consiste este sistema tanto versi n BD como XML consultar el Manual de Usuario del Sistema de Seguridad 3 2 Ejecuci n de la herramienta 3 2 1 Creaci n del esqueleto base de la aplicaci n Esta aplicaci n se debe ejecutar desde la l nea de comandos debe
40. tip Usuario BD mtip Password BD ES Cad Conex BD jdbc oracle thin desum 2 cf jcyl es 1522 0EN jadbc oracle thin phost puerto SID Driver JDBC oracle jdbc driver OracleDriver Esquema BD MTIP Dir Destino CiframeworkimtipiFuentesiMTIPisre C Seleccionar Paquete es jcyl cf mtip EA sar Figura 3 Generador de OT y OAD Los datos que debemos introducir son e Nombre de la aplicaci n Nombre corto de 4 letras May sculas utilizado como identificador de la aplicaci n que debe coincidir con el introducido en el sistema de seguridad Adem s debe coincidir con lo introducido en el apartado anterior e Usuario BD C digo de Usuario de acceso a los datos de las tablas e Password BD Clave de acceso e Cad Conex BD Cadena JDBC para especificar las caracteristicas de conexi n e Driver JDBC Driver de acceso por defecto driver de Oracle e Esquema BD Esquema de base de datos May sculas donde residen las tablas e Dir destino Se refiere al directorio src Debemos indicar donde se encuentra e Paquete Debemos indicarlo de la siguiente forma es jcyl nombreconsejeria nombreaplicacion Una vez introducidos los par metro de conexi n nos mostrar las tablas del esquema para poder elegir sobre cual generar las clases OAD y OT P gina 11 de 37 a MANUAL DE USUARIO Junta de APLICACI N BASE PARA EL DESARROLLO EN J2EE Castilla y Le n V1 4 DAA a Junta de Le n
41. true Entrada rapida sin refrescar las funciones fase Actualiza cada entrada en Sesion 4 2 3 Otras propiedades Propiedad Descripci n Ejemplo de Valor CON_AUDITORIA Activar Destactivar la AUDITORIA DE ORACLE 9i Valores posibles SI NO NOMBRE_DATASOURCE Nombre del pool DataSource utilizado jdbc DEMOPooIDS TIPO_LOGIN_DEFECTO Tipo de autenticaci n que va a utilizar la password aplicaci n Valores posibles publico password certificado USUARIO_PUBLICO Cuenta de usuario usada para autenticarse en el caso de acceso p blico PASSWORD_PUBLICO Contrase a usada para autenticarse en el anonimo caso de acceso p blico TRIPLEDES Clave del algoritmo TripleDes para Autenticaci n por certificado URL_AUTENTIFICACION_ CERTIFICADO URL del servidor de autentificaci n para validaci n con certificado 4 2 4 A adir propiedades a nuestra aplicaci n Adem s pueden a adirse cuantos par metros se desee Posteriormente se podr acceder a los mismos a trav s del m todo String valor JCYLConfiguracion getValor lt NOMBRE_PROPIEDAD 4 3 Descriptor de controlador Struts Archivo WEB INFstruts config xml En este archivo se deben definir los elementos form bean y action a medida que se vaya construyendo la aplicaci n Si se desea introducir el control de validaci n de Struts se deben tener en cuenta las indicaciones del documento APPBASE_NotasNuevaVersionX_X doc X_X versi n actual de este documento relativas a este
Download Pdf Manuals
Related Search