manual de usuario del arquetipo webservice
Contents
1. Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService Para la ejecuci n de los tests JMeter desde el m dulo test mvn clean install Pjmeter Para la generaci n y despliegue de los artefactos adicionales con los javadocs y el c digo fuente del proyecto mvn clean install Dadditional_artifacts true Para probar la ejecuci n de este arquetipo puede comprobar en la URL donde se listan los servicios desplegados y sus documentos WSDL http lt host gt lt puerto gt lt contexto gt services listServices 2 6 EJECUCION TEST Para la ejecuci n de los test es necesario haber levantado previamente el servicio web en el servidor de aplicaciones que en local puede ser el propio jetty 2 6 1 Ejecuci n de test unitarios Los test unitarios se encuentran en el m dulo lib en la carpeta src test java xxxx client Antes de ejecutarlos es necesario editarlos y quitar o comentar la anotaci n lIgnore ya que de lo contrario no se van a ejecutar Esta etiqueta se ha incluido por que si se compila ejecutando los test y no est levantado el servidor de aplicaciones con el servicio web lo test no van a funcionar Para comprobar la correcta implementaci n de la comunicaci n entre cliente y servidor con el servidor del servicio web arrancado se deber ejecutar la siguiente sentencia desde el directorio lib del proyecto Tambi n se pueden ejecutar cada test de Junit desde e2. conf applicationContext database xml excepto que en ning n caso debe localizar el datasource por JNDI del servidor de aplicaciones puesto que en la fase de test no tenemos acceso a dicho servidor gt src Ruta donde se generar n los recursos necesarios para la parte web de la L2 main aplicaci n gt webapp index html Fichero de acceso principal que redirige al listado de servicios del web service 13 axis2 meb P gina de entrada que muestra un listado listServices jsp de servicios y un enlace a sus documentos WSDL a H gt WEB INF X services ml Descriptor de despliegue de servicios de Axis2 CA ed web xml Descriptor web de la aplicaci n La mweblogic lt ml Descriptor adicional para el servidor de aplicaciones Weblogic X jetty context xml Ch X jetty env xml Descriptores adicionales para el servidor de aplicaciones Jetty L AROS ___a_ jm 11 de 21 it Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService 2 generador X hibernate cho emt Directorio para herramienta de generaci n X hibernate reveng xml autom tica de c digo 2 3 2 Estructura del M dulo lib El m dulo lib tiene la siguiente estructura de directorios y ficheros El gt lib Fichero de configuraci n de maven del m dulo lib Normalmente las dependencias no se incluyen en este fichero sino en el fichero pom xml del proyec
3. ejpl_app En E g Ep SR PIDEN y 3 EN JS ejol_app_lib e LG srofmainfiava del Descomentar estas l neas y elimina a secci n lt parent gt de abajo Si at d pa E sE F a se parent z LS DG src mainfresources 3 S o o G G srcftestiava O cartifactidratlastrmarquetipos padre Jar lt artifactid gt J d y f 7 lt groupld gt atlasirmx groupld gt 8 L I src test resources ES ER R ES a lt version 1 1 2 lt version gt DIS DE System Library JavaSE 1 6 e 9 parent H S Maven Dependencies Ku Ee j LUS Di jar SC BL src SR t parent gt target P bom lt artifactid gt ejpl app lt artifactid gt lt groupld gt e3p1 lt groupld gt D E ejol_app test 3 3 JE lt version gt 1 0 0 lt version gt E ejpl app web 8 rent gt el HH iere e de erro LE PERET a O E y D T Despu s de eliminar a Go ge L E E WV Package Ex ech h Hierarchy Ju JUnit ee H ha ejpl_app_libpom xml d K JW ejol_app_test pom xm ans ca z0 E B 1 lt 2xm1 version 1 0 encoding DTF 8 2 gt on ject xmins kttp mave E 1 apache org POM 4 0 0 xmins xsi e en _app o RI Gi 5 e ejol_app lib parenti oi D C src main aus i a a e e E GE srcimain resources a lt artifactidratlasftrmarquetipos padre jar lt artifactid gt H E ercftest java E lt groupld gt atlasfrm lt groupld gt 7 version gt 1 1 2 lt verslon gt 1 L I erc testfresources e En dad D lt parent gt ER System Li
4. para inicio de proyecto Arquetipo para m dulos de tipo web Arquetipo para m dulos de tipo jar Arquetipo para m dulos de tipo webservice o servicios web Arquetipo para m dulos de tipo batch Arquetipo para m dulos de gesti n documental documentum El Arquetipo WebService genera un proyecto modular con un m dulo maven de tipo war para el servicio web listo para ser desplegado y un m dulo de tipo jar para el cliente de dicho servicio Est preparado para publicar un servicio de Spring a trav s de Axis2 sin generaci n de c digo intermedio El proyecto viene preconfigurado para acceder a base de datos a trav s de Hibernate y publica como webservices una serie de servicios de ejemplo Se incluye un ejemplo de servicio sin seguridad otro seguro a nivel de transporte y otro securizado con webservice security Para m s informaci n sobre estos tipos de seguridad consultar el manual ATLAS _MUS Servicios Web 1 1 AUDIENCIA OBJETIVO Este documento est dirigido a desarrolladores de proyectos java para ICM en los que se desee crear una aplicaci n que publique un Servicio Web utilizando el framework de desarrollo Atlas 1 2 CONOCIMIENTOS PREVIOS Para un completo entendimiento del documento el lector deber tener conocimientos previos sobre las siguientes tecnolog as Java Eclipse Maven Spring Framework Axis2 y SoapUl Adem s es necesario haber le do y seguido los pasos d
5. s0ap Header z soap Body gt Raw AML Raw mL lt serctalterar serctargsD gt x d cadenal ejenplo de lt xsd limiter 1 lt x d lim lt fsercargsD gt lt fserctalterar lt fsoap Body soap Envelope gt Request 1 416 UTF 8 http Aocalhost 3 WSS Password Type WGG TimeToLive soapUI log http Jop jettylog errorlog wsrmlog memory log Para ejecutar esta petici n hay que pulsar el icono al Con esto se enviar la petici n al servicio y se presentar la respuesta u a nd 19 de 21 cm Agencia de Framework Atlas Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService kk kk kx A xk iC SO ss F HE Ze WWW NKWWWWWI Ei oe aml LE l m a LI ee ee ee SE KS SUD ze TS Lg soap Envelope mins soap soaperv Envelope xmlns soapeny soapeno Bodi gt lt s0ap Header gt ns alterarRfesponse xmlins ns http services ejp so0ap Body gt Raw hal serctalterar ns return xsi type axz d DatosSalida xmlnms ax d cadenaEntrada eJjemplo de cadena de e ad cadenasalida ejemplo cadena entrada d Zaxz dcidLlamada 0 axzdcidLlamada sertargs O gt lt xsd cadenal ejenplo de cadena de entra lt xsd limite gt 1 x 8d limite lt fsertargsD gt fs return lt fsercalterar lt fn scalterarfesponse soap BEodi gt lt fsoapent Body gt lt so0ap Envelope lt fsoaperi Envelope gt XML Petici n XML Respu
6. se crear la implementaci n del servicio web e Test M dulo con proyectos de SoapUl preparados para realizar pruebas de llamada sobre el servicio web Contiene un proyecto SoapUl para cada uno de los ejemplos de servicio incluidos Este m dulo no generar ning n producto empaquetado como los otros dos m dulos paquete war el m dulo web y paquete jar el m dulo lib 2 3 Estructura de directorios y archivos Una vez generado el proyecto se generan una serie de directorios a estilo maven donde ubicaremos los fuentes y recursos de las partes de java test y aplicaci n A continuaci n se describe la estructura de cada uno de los dos m dulos del proyecto 2 3 1 Estructura del M dulo web El m dulo web tiene la siguiente estructura de directorios y ficheros srcimainjjava De esta ruta cuelga la estructura de paquetes con el c digo fuente del proyecto El paquete ra z va a llamarse igual que el nombre del m dulo que se est desarrollando Inicialmente el paquete ra z se llamar con el c digo de proyecto equivalente al groupld Adicionalmente en el subpaquete services residir n las implementaciones de los servicios web a publicar En los ejemplos inferiores se ha tomado como paquete ra z ejpl kx NV 9 de 21 d Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService C H ejol webservice services Implementaci n del servicio web E JI
7. ATLAS MANUAL DE USUARIO DEL ARQUETIPO WEBSERVICE Versi n 1 8 rea de Aplicaciones Especiales y Arquitectura de Software d ab ab ell em Agencia de Inform tica y Comunicaciones de la Comunidad de Madrid c Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService Hoja de Control T tulo Manual de usuario del Arquetipo WebService SAME NORMATIVA ATLAS L D D Responsable Area de Aplicaciones Especiales y Arquitectura de Software Versi n Fecha Versi n 01 03 2013 Registro de Cambios Versi n Causa del Cambio Responsable del Cambio Fecha del Cambio rea de Integraci n y Arquitectura de 1 0 Versi n inicial del documento 25 05 2010 Aplicaciones Nueva configuraci n de Arquetipo Web Service headel EE j e i i rea de Integraci n rquitectura de Incluida creaci n previa del arquetipo ce 9 y Arq 16 09 2010 Nueva nomenclatura de paquetes 12 Modificaciones para versi n 1 1 0 de E EiUTanEE 46 02 2011 ATLAS Aplicaciones Re preguntas TAPERNE rea de Aplicaciones Especiales y consultar n en el portal de 05 07 2011 arquitectura Arquitectura de Software Se modificad el nombre del rea T Nueva arquitectura modular de rea de Aplicaciones Especiales y EE l Arquitectura de Software 1 5 Nuevo m dulo test con proyectos de ANGA US APULSCIOnES EES 21 11 2011 SoapUl 4 0 1 Arquitectura de Software Se a aden las clases BaseServi
8. EjemploServicelmol java Las interfaces del servicio web deben crearse en el m dulo lib I ES secfmainfresources Ruta donde se generar n los recursos del proyecto normalmente son ficheros de configuraci n y ficheros de propiedades En nuestro caso contiene los siguientes ficheros environment properties Fichero de propiedades que contiene y todas las variables de configuraci n cuyo valor puede ser diferente en distintos entornos de ejecuci n local desarrollo producci n etc Antes de desplegar un proyecto en los entornos de ICM este fichero ser sustituido por su hom logo correspondiente al entorno en el que se vaya a desplegar E kot ol i Fichero de configuraci n de log4ij lleva adem s configuraci n de los m dulos de trazas y monitorizaci n application properties Fichero de propiedades que contiene mediante clave y valor todos los valores particulares de la aplicaci n que no son susceptibles de ser modificados o configurados entre diferentes entornos de ejecuci n Ej applicationContext dao xml Fichero de configuraci n de Spring para la carga en el contexto de Spring de todos los DAOs clases de acceso a datos X applicationContext database xml Fichero de configuraci n de Spring que lleva la configuraci n del dataSource sessionManager y transactionManager que integra Hibernate con Spring Inicialmente el datasource ser configurado mediante las propiedades ubicadas en el fichero conf jdbc pro
9. OS ICM 12 de 21 Agencia de Framework Atlas Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService CB ejpl webservice client Tests unitarios para comprobar la D LI ClienteEjemploServiceTest java correcta implementaci n de los D UI ClienteEjemploServiceWSS iTest java clientes del servicio web E ClienteEjemploServiceWWSS2Test java J E srcftestiresources Ruta donde se generar n los recursos para realizar las pruebas de test normalmente son ficheros de configuraci n y ficheros de propiedades En nuestro caso contiene los siguientes ficheros environment properties Fichero de propiedades que a contiene mediante clave y valor todos los valores susceptibles de ser modificados o configurados entre diferentes entornos de ejecuci n Este fichero solamente es para la ejecuci n de los test fk log4ij xml Fichero de configuraci n de log4j lleva adem s configuraci n de los m dulos de trazas y monitorizaci n IX application Context test xml Contiene la configuraci n b sica de un bean de Spring de ejemplo para ejecutar el test de JUnit que viene preconfigurado application properties Fichero de propiedades que contiene mediante clave y valor todos los valores particulares de la aplicaci n que no son susceptibles de ser modificados o configurados entre diferentes entornos de ejecuci n El jar environment properties Directorios de uso interno de ICM kx adicional para la configu
10. RUCTURA DEL MODULO E EN 12 SKS ESTRUCTURA DEL MODULO TE WEEN 13 2 4 CONFIGURACI N DEL DESCRIPTOR DE SERVICIOS SERVICES XML cooccoocnnonnncnnonnnonnncnnonnnocnnnnnnnn nn rro nnnnn nn rra nnnrn nar nnannnnnnnns 14 2 4 1 EE 14 2 4 2 Con oracion para Senmi daN ee 15 2 5 DESPLIEGUE Y EJECUCI N DE LA APLICACHION tretet narran narran nan nn rra nnncnnannns 15 2 6 FIECCCION TEST E 17 2 6 1 EJECUCION DE TEST UNITARIOS E 17 2 6 2 EJECUCI N KIC e Ce hehe CA e RR iia 17 3 VALIDACI N DE LA NORMATIVA Y GENERACI N DE LA DOCUMENTACI N EE 20 4 PREGUNTAS MAS FRECUENTES seess see ENKER RER E NEE E REENEN RENE E RENE KEE R ENEE E NEE E ENKER ENEE R ENEE KEREN RER E NEEN 20 S ENLACES RELACIONADOS until 21 kk kk KAR 4 de 21 d Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService 4 INTRODUCCI N Los arquetipos son las plantillas para la generaci n de los distintos proyectos dentro del Framework Atlas Estos arquetipos utilizan el plugin archetype de maven para generar la estructura de ficheros y directorios necesarios para nuestro proyecto gestionando las librer as que le indiquemos as como las dependencias Todas las librer as ser n incluidas durante el empaquetado del proyecto por lo que para generar y compilar un arquetipo debe estar conectado al repositorio de artefactos de la Comunidad de Madrid Artifactory El framework Atlas consta de los siguientes arquetipos Arquetipo
11. ServiceWss 1 wsdl servicio web 2 EjemploServicewss 3 wsdl J E srcitestijawa Ruta donde se generar n el c digo fuente para los test de nuestro proyecto Este m dulo no tiene c digo java de tests unitarios J E sroftestiresources Ruta donde se generar n los recursos para realizar las pruebas de test normalmente son ficheros de configuraci n y ficheros de propiedades Este m dulo no tiene recursos para los tests java 2 4 Configuraci n del descriptor de servicios services xml Toda la configuraci n que se muestra a continuaci n se realiza seg n marca la documentaci n de Axis2 por lo que para cualquier consulta adicional puede consultarlo en la web http axis apache org axis2 j ava core docs axis2config html 2 4 1 Configuraci n b sica El arquetipo genera el fichero services xml en el m dulo web con una configuraci n v lida que despliega un bean del contexto de Spring como WebService Si necesitamos editar dicho fichero lo podremos hacer de la siguiente manera e service etiqueta que especifica un servicio podemos publicar tantos servicios como deseemos siempre L AROS jm 14 de 21 Agencia de Framework Atlas Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService que tengan un nombre diferente par metro name Inicialmente se pone como nombre de servicio el nombre de la aplicaci n e ServiceObjectSupplier especifica que clase nos proporciona los objetos que vamo
12. brary Java5E 1 6 M Y D Si Maven Dependencies 10 lt modelYersion gt 4 0 0 lt modelVersion ER H Lex jar el E eer H E ert A A wig hi a4apdade73pL o L URLi EE 12 lt artifactid gt ejpl app lib lt artifactld gt As cal 13 version gt 1 0 0 lt version Koob e SA eid Ss ve 14 lt packagingrjar lt packaginqag gt GE 15 lt name gt ejpl app lib lt name gt WW EZ ES ejpl_app_web SEENEN e oC Kui Una vez configurado el proyecto general y el subproyecto m dulo de tipo aplicaci n servicioweb ya podemos seguir viendo la estructura del subproyecto para la aplicaci n que acabamos de generar u a 8 de 21 d Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService 2 2 Estructura del arquetipo Este arquetipo genera un proyecto maven multimodular con un proyecto padre cuyo pom llevar la configuraci n general del resto de subproyectos El proyecto consta de tres m dulos e Lib M dulo de tipo jar donde se implementa el cliente del servicio web Aqu se crear n las interfaces de servicio y los objetos de datos de intercambio Es adem s una dependencia del proyecto Web ya que el webservice implementado tendr necesariamente que hacer uso de los objetos definidos en este m dulo e Web M dulo de tipo war configurado para utilizar Spring Hibernate Axis2 y seguridad y preparado para desplegar el servicio web en un servidor de aplicaciones Aqu
13. ce y BaseServicelmpl as como los servicios y DAOs para EstadoCivil rea de Aplicaciones Especiales y Se a ade a la estructura del m dulo Ara 24 02 2012 e i rquitectura de Software web la carpeta generador Se a aden las clases de test agrupadas por servicio Se elimina las clases para la fachada ee rea de Aplicaciones Especiales y sentido Internamente se ha modificado 29 10 2012 la versi n de axis por lo tanto esta Arquitectura de Software versi n del arquetipo utilizada esta nueva versi n AAA ICM 2 de 21 it Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService Versi n Causa del Cambio Responsable del Cambio Fecha del Cambio Revisi n completa del documento por rea de Aplicaciones Especiales y 1 8 nueva estructura de arquetipo en ote da Sara 27 02 2013 ATLAS 1 2 3 q WV 3 de 21 a Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService ndice 1 TMNERODUCCION tes 5 1 1 SR RTR AVIS Eer CH TIO T rra iccocabess 5 1 2 CONOCINTENTOS PREVIOS sora rosa rr acosa 5 2 INFORMACI N SOBRE EL NS 6 2 1 CREACI N DE UNA APLICACI N PARTIENDO DEL ARQUETIPO oooccconcccnnnnccononoccnnnnoccnnnnornnonrrnnnnnrononnrrnnonnrrnnnnnrnnonnricnnnirinnns 6 22 ESTRUCTURA DELARQUETIPO E 9 2 3 ESTRUCTURA DE DIRECTORIOS Y ARCHIVOS ic 9 2 3 1 ESTRUCTURA DEL MODULO WEB len 9 E dp EST
14. dor jar atlasfrm arquetipos generador proyecto atlasfrm arquetipos generador servicdioweb atlastfrm arquetipos generador neb atlasfim arguetipos generador servicioyeb http gestiona madrid org artifactor y atlas show the last version of Archetype anly k Advanced configure Version 11 2 Li 1 1 2 LLJ LE Li include snapshot archetypes Add Archetype Cancel u a it Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService A continuaci n se nos mostrar una pantalla para indicar cu les son los par metros con los que vamos a crear nuestro proyecto av geng a ATENCION NOMENCLATURA 7 New Maven Project Es muy importante utilizar en esta New Maven project Zo pantalla los valores que cumplan la Specify Archetype parameters normativa de Atlas groupld Nombre del proyecto Group Id en Gi Normalmente es de 4 caracteres y es un c digo que se le da a un proyecto Todos los m dulos de un proyecto PS 1 0 0 la tendr n el mismo groupld y se SS E Se corresponder con el nombre del Package ein ag clientes K proyecto Artifact Id ejpl_ws_acceso Properties available from archetype artifactld Nombre del m dulo En el caso de servicios web el nombre del m dulo ser xxxx_ws yyyy donde xxxx se corresponde con el groupld indicado y yyyy el texto que identifique a este modulo y lo diferencie de otros Ejempl
15. el manual ATLAS MUS Preparacion Entorno Desarrollo para tener el entorno de desarrollo preparado k ZC EEGENEN 5 de 21 E Agencia de Te Inform tica y Comunicaciones de la Comunidad de Madrid 2 INFORMACI N SOBRE EL ARQUETIPO 2 1 Creaci n de una aplicaci n partiendo del arquetipo NOTA IMPORTANTE Antes de generar un arquetipo es IMPRESCINDIBLE haber generado un arquetipo para Framework Atlas Arquetipo WebService albergar el proyecto consultar ATLAS MUS Preparacion_Entorno_Desarrollo para ver c mo crear un arquetipo de proyecto Cualquier arquetipo posterior ser incluido como un m dulo de ste Crear un proyecto de Servicios Web a partir de un arquetipo es similar a la creaci n de un proyecto Web modificando el nombre del arquetipo a utilizar Para crear un proyecto a partir de un arquetipo maven puede consultar la gu a paso a paso que se indica en el documento ATLAS MUS Preparacion_Entorno_Desarrollo seg n se indica en el apartado Creaci n de una aplicaci n Web desde cero sustituyendo atlas arquetipos generador web por atlas arquetipos generador servicioweb MO New Maven Project New Maven project Select an Archetype Catalog Arquetipos ATLAS Filter Group Id atlasfm atlastfrm atlasfm atastm atlasfrm atlastfrm Artifact Id atlasfrm arguetipos generador batch atlasfrm arquetipos generador documentumnweb atlasfrm arquetipos genera
16. esta Header Attadimen Waa WS E JMs Headers 4 Attachments 0 response time 811ms 935 bytes Para comprobar cualquier otro m todo de este proyecto o del proyecto de cliente seguro debe seguirse el mismo procedimiento 3 VALIDACI N DE LA NORMATIVA Y GENERACI N DE LA DOCUMENTACI N Los arquetipos vienen preparados para autom ticamente generar un web site con la informaci n de la aplicaci n incluyendo lava javadoc informaci n de dependencias etc Tambi n se ejecuta una herramienta autom tica que valida el cumplimiento de la normativa de Atlas que genera un informe sobre los posibles incumplimientos de dicha normativa Para m s informaci n sobre dicha herramienta consultar el documento ATLAS MUS Preparacion_Entorno_Desarrollo 4 PREGUNTAS MAS FRECUENTES La lista de preguntas frecuentes se encuentra en el portal de arquitectura ARA 20 de 21 cm Vd Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService 5 ENLACES RELACIONADOS Producto URL http ws apache org axis2 Configuraci n htto axis apache org axis2 j ava core docs axis2config html Services xml Apache Maven http maven apache org Log4J http logging apache orqg log4j SoapUl http www soapui org RS KRK jm 21 de 21
17. l propio Eclipse como se ejecuta cualquier clase de tipo Junit 2 6 2 Ejecuci n de los tests de SoapUl SoapUl es una aplicaci n para realizar llamadas a servicios web Esta aplicaci n es utilizada normalmente para comprobar la correcta ejecuci n de los servicios web Los proyectos de prueba incluidos en el m dulo de test se han generado con la versi n 4 0 1 de SoapUl Esta aplicaci n puede ser descargada desde el siguiente enlace http sourceforge net projects soapul files soapui 4 0 1 k ZC jm 17 de 21 cc Agencia de Framework Atlas Cl Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService Para realizar una prueba de llamada al servicio web primero debe levantarse el servidor jetty tal y como se especifica en el apartado anterior A continuaci n ejecutar SoapUl 3 soapUl 4 0 1 soapUl log httplog jettylog errorlog wsrmlog memory log E Cer a ml Ki EjemploserviceWS552 soapui project xml Una vez cargado el proyecto desplegar el elemento EjemploServiceSoap12Binding tambi n puede probarse el a L i UL 18 de 21 cc Agencia de o Framework Atlas e Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService Soap11Binding y el m todo alterar Hacer doble click en Request 1 Con esto tendremos desplegado un XML de petici n al servicio web soapUl 4 0 1 ER Si EjemploService ERR e EE soap Envelope xmlns lt
18. lt service gt lt a adir aqu mas servicios si se desea lt service name nuevoServicio gt lt service gt gt lt serviceGroup gt 2 4 2 Configuraci n para seguridad Para obtener informaci n m s detallada de la aplicaci n de seguridad en el servicio web as como del contenido y operativa de los m dulos debe consultarse el documento ATLAS MUS Servicios Web doc 2 5 Despliegue y Ejecuci n de la aplicaci n El arquetipo WebService es una aplicaci n web preparada para la publicaci n de alguno de sus servicios mapeados en Spring como servicio web Axis2 Para construir el proyecto debe ejecutarse el siguiente comando desde el POM padre del proyecto generado mvn clean install Si Vi fa 15 de 21 ICM AA kk ffad Agencia de o Te Inform tica y Comunicaciones de la Comunidad de Madrid Framework Atlas Arquetipo WebService Por defecto al ejecutar Maven con los par metros clean install se genera el paquete jar correspondiente al cliente del servicio web y el war correspondiente a la aplicaci n web que contiene este Para desplegar el war en nuestro servidor de aplicaciones podemos coger el fichero de la carpeta en la que se ha generado web target nombreFichero war o podemos utilizar un servidor Jetty local que viene preconfigurado en el arquetipo Para ejecutar directamente un servidor jetty con nuestro proyecto desplegado debemos ejecutar la siguiente l nea de comandos desde el directori
19. o ejp _ws_acceso Mame Value El car cter de separaci n a utilizar debe ser el gui n bajo e Advanced Version La primera versi n ser 1 0 0 package El nombre del paquete java ser el groupld seguido de un punto y el nombre del bloque funcional dentro d de la aplicaci n para aplicaciones Finish Cancel S BEE grandes se crear n varios bloques funcionales Todos los nombres deben ir en min sculas Al pulsar Finish se crea el nuevo proyecto ATENCION Las clases que se incluyen de ejemplo son simplemente eso y deben ser eliminadas del proyecto cuando no se necesiten u a 7 de 21 d Agencia de Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService Antes de comenzar a visualizar la estructura del nuevo proyecto generado debemos realizar un ajuste en el fichero pom xml del nuevo proyecto creado Para ello debemos abrir el fichero weblpom xml liblpom xmTF y testlipom xml eliminar la secci n lt parent gt existente y descomentar la secci n lt parent gt que aparece comentada Antes de eliminar ACE SCI AE A El es eg H Package Ex gt de Hierarchy H JUnit 0 m ejpl_app_lib pom To dh Je ejpl_app_test pom ml na ejol_app_web pom xml gl E E a 1 lt 2xm1 version 1 0 enc oding UTF 8 2 gt mn le lt project x mins http maven apache org POM 4 0 0 xmlins xsi http wet HE Dk
20. o web de nuestro proyecto la siguiente l nea de comandos mvn jetty run Esto arranca un servidor jetty en el puerto 9080 de nuestra m quina en el que se encuentra desplegado el war de nuestra aplicaci n Introduciendo la siguiente URL en un navegador se podr ver un listado de los servicios desplegados Esta URL solo es v lida para el servidor Jetty local la composici n de esta URL para un servidor Weblogic se lista m s abajo en este documento http llocalhost 9080 services listServices En el caso de los ejemplos securidados el acceso es por https localhost 9443 services listServices Si en lugar de un servidor jetty queremos construir y desplegar en un servidor WebLogic definido por el usuario es necesario primero configurar en el fichero environment properties los par metros del servidor a utilizar Configuraci n para depliegue en weblogic local weblogic adminServer hostName localhost weblogic hostName localhost weblogic weblogic port 7001 weblogic weblogic weblogic weblogic weblogic adminServer protocol t3 adminServer port 7001 servlet port 7001 user weblogic password contrase a weblogic weblogic weblogic upload false serverName NombreServidor targetNames NombreTarget remote false Posteriormente puede ejecutarse la siguiente sentencia de maven desde el directorio web del proyecto mvn clean install deploy Pweblogic local L AROS __a__ jm 16 de 21 d
21. perties se generan de forma autom tica con maven aunque para el paso a integraci n deben configurarse localizando por jndi al datasource del servidor de aplicaciones X applicationContext general xml Fichero de configuraci n de Spring para la carga de las propiedades ubicadas en application properties y resto de archivos de propiedades necesarios X applicationContext services xml Fichero de configuraci n de Spring para la carga de todas las clases de Servicios kk kk xk xk jm 10 de 21 id Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService ES srcitestijava Ruta donde se generar n el c digo fuente para los test de nuestro proyecto Este c digo nunca deber estar incluido en el jar final Ei ejpl webservice Paquete para los tests unitarios En el m dulo web no hay tests implementados por defecto Se srcitest iresources Ruta donde se generar n los recursos para realizar las pruebas de test normalmente son ficheros de configuraci n y ficheros de propiedades En nuestro caso contiene los siguientes ficheros cl ssl Ficheros de configuraci n por si Lat keystore keystore se desea acceder a la aplicaci n al truststore keystore por ssl conf Lleva la configuraci n del X applicationContext database test xml dataSource sessionManager y transactionManager que integra Hibernate con Spring Este fichero es un espejo del fichero
22. raci n de la E E entregas aplicaci n en los distintos entornos Los ficheros environment properties GER mantenimiento de estos directorios solamente se e utilizan para la ejecuci n de los test E e preproducci n la librer a es independiente del ES produccion entorno Di validacion Si se incluye una nueva variable en src main resources environment pro perties se ha de incluir tambi n en todos estos D Gs formacion 2 3 3 Estructura del M dulo test L AROS jm 13 de 21 a Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Arquetipo WebService El m dulo test tiene la siguiente estructura de directorios y ficheros Fichero de configuraci n de maven del m dulo test Normalmente las dependencias no se incluyen en este fichero sino en el fichero pom xml del proyecto padre H GI seclmainfjava De esta ruta cuelga la estructura de paquetes con el c digo fuente En este m dulo no se incluye c digo fuente J E seclmainfresources Ruta donde se generar n los recursos del proyecto En nuestro caso contiene los siguientes ficheros El soapui X EjemploService soapui project xml Proyectos SoapUl para los X EjemploServiceWSS 1 soapui project xml servicios de ejemplo IX EjemploServiceWS52 soapui project xml client_ssl jks Almacenes de certificados para dent Ze las pruebas con SoapUl B E wsdl 2 EjemploService wsdl Descriptores del ejemplo de 8 Ejemplo
23. s a publicar en nuestro caso Spring Este par metro no se debe modificar e SpringBeanName Nombre del bean que vamos a publicar ubicado en el contexto de Spring applicationContext services xml e ServiceClass Interfaz de la clase que se va a publicar Se debe especificar la interfaz del servicio que queremos publicar para que Axis2 sepa como generar el WSDL correspondiente de lo contrario podemos tener problemas por que las clases est n interceptadas por Spring AOP y esto falsee su interfaz en ejecuci n Esta clase debe crearse en el m dulo cliente lib aunque se referencie en este m dulo A continuaci n se muestra un ejemplo de configuraci n del fichero services xml del m dulo web que publica un servicio Services xml lt xml version 1 0 encoding UTF 8 gt lt serviceGroup gt lt service name EjemploService gt lt parameter name ServiceO0bjectSupplier gt org apache axis2 SpringServletContextO0bJectSupplier lt parameter gt lt parameter name SpringBeanName gt EjemploService lt parameter gt lt parameter name ServiceClass gt eJpl webservice services EjemploService lt parameter gt lt messageReceivers gt lt messageReceiver mep http www w3 org 2004 08 wsdl in out class org apache axis2 rpc receivers RPCMessageReceiver gt lt messageReceiver mep http www w3 org 2004 08 wsdl in only class org apache axis2 rpc receivers RPCInOnlyMessageReceiver gt lt messageReceivers gt
24. to padre H LI srcimain java De esta ruta cuelga la estructura de paquetes con el c digo fuente del proyecto cliente El paquete ra z va a llamarse igual que el nombre del m dulo que se est desarrollando Inicialmente el paquete ra z se llamar con el c digo de proyecto equivalente al groupld Adicionalmente para cada bloque funcional de nuestra aplicaci n debe crearse un subpaquete B S ejol webservice domain Entidades de entrada salida del API D DatosEntrada java del webservice ES D DatossSalida java C H ejpl webservice services Interfaces de los servicios web que H UI EjemploService java ser n publicados E ejol webservice client Implementaciones de cliente de las D LU ClienteEjemploService java interfaces de los servicios web H E ClienteEjemploServiceW S5 1 java ES E ClienteEjemploservice 552 java 2 srcimain resources Ruta donde se generar n los recursos del proyecto normalmente son ficheros de configuraci n y ficheros de propiedades En nuestro caso contiene los siguientes ficheros LX applicationContext ejol_vws_lib xml Fichero de configuraci n de los servicios de cliente publicados HS META INF i politicaWSSFirmado xml Ficheros de pol tica de seguridad X politicaWWSSFirmadoCifrado xml a aplicar si el servicio web es seguro 1 sroltestijava Ruta donde se generar n el c digo fuente para los test de nuestro proyecto Este c digo nunca deber estar incluido en el jar final L AR
Download Pdf Manuals
Related Search