Diferencia entre revisiones de «Jboss WebService»
Sin resumen de edición |
|||
| Línea 1: | Línea 1: | ||
= | =Introducción= | ||
Eclipse junto con Jboss Tools nos proveen de las herramientas necesarias para trabajar con WebServices, todo ésto se explica en el desarrollo de la página. | |||
'''Consideraciones Importantes''' | |||
*Se debe tener instalado el JBOssWS, caso contrario ir a [[Instalar JBossWS]] | |||
*En caso de no tener configurado las preferencias del JbossWS, ir a [[Configurar Preferencias]] | |||
*Crear un proyecto que contendrá el Client Sample para consumir el web service, ir a [[Dynamic Project]] | |||
==Creación de cliente para consumir un WebService== | |||
<br>En eclipse ir a '''File''' => '''New''' => Elegir la opción '''Other''' | <br>En eclipse ir a '''File''' => '''New''' => Elegir la opción '''Other''' | ||
*Seleccionar el Wizard => '''Web Service Client''' como se muestra en la imágen | *Seleccionar el Wizard => '''Web Service Client''' como se muestra en la imágen | ||
| Línea 39: | Línea 22: | ||
*En '''Service Definition''' se debe colocar el wsdl al cual deseamos acceder | *En '''Service Definition''' se debe colocar el wsdl al cual deseamos acceder. | ||
Para nuestro ejemplo utilizaremos ésta url pública de internet: http://www.webservicex.net/whois.asmx?WSDL | |||
[[Image:Servicedefinition.png]] | [[Image:Servicedefinition.png]] | ||
*Luego en la sección '''Configuration''' => Seleccionar la opción '''Web service runtime: Apache Axis''' | *Luego en la sección '''Configuration''' => Seleccionar la opción '''Web service runtime: Apache Axis''' | ||
Aparecerá la ventana de '''Client Environment Configuration''', en la sección de '''Web service runtime''' => Elegir la opción '''JBossWS'''. | Aparecerá la ventana de '''Client Environment Configuration''', luego en la sección de '''Web service runtime''' => Elegir la opción '''JBossWS'''. | ||
'''Observación:''' El runtime depende del ambiente de implementación, si se utilizara Jboss entonces se recomienda utilizar Jboss Web Service. | |||
[[Image:clientenvironment.png]] | |||
Hacer click en botón '''OK'''. | Hacer click en botón '''OK'''. | ||
Luego hacer click en la sección '''Client Project''' y allí elegir el proyecto que se creó inicialmente. | Luego hacer click en la sección '''Client Project''' y allí elegir el proyecto dinámico que se creó inicialmente. | ||
Cabe destacar que al crear un proyecto web dinámico, el Eclipse crea y asocia al mismo un proyecto cliente EAR. | |||
[[Image:clientproject.png]] | [[Image:clientproject.png]] | ||
| Línea 61: | Línea 49: | ||
Luego click en '''Next''' | Luego click en '''Next''' | ||
Aparecerá la ventana de '''Jboss Web Service Code Generation Configuration''' como se muestra en la imagen. En la sección de '''Package''' => Colocar el paquete en donde se generará todo lo que se necesita para consumir el WebService. Si no existe el paquete lo crea. | Aparecerá la ventana de '''Jboss Web Service Code Generation Configuration''' como se muestra en la imagen. En la sección de '''Package''' => Colocar el paquete en donde se generará todo lo que se necesita para consumir el WebService. Si no existe el paquete lo crea. Asimismo se debe colocar | ||
[[Image:client.png]] | [[Image:client.png]] | ||
'''Observación:''' Todo este proceso genera un Client Sample con un stub para consumir. | |||
Además se debe tener en cuenta que ésta versión del Jboss Tools generará constructores que ya no existen, y deben ser eliminados. | Además se debe tener en cuenta que ésta versión del Jboss Tools generará constructores que ya no existen, y deben ser eliminados. | ||
| Línea 71: | Línea 60: | ||
[[Image:constructor.png]] | [[Image:constructor.png]] | ||
== | ==Prueba de consumo de webservice== | ||
Para la prueba se puede utilizar la herramienta que nos provee el Eclipse el '''Web Service Explorer (Ésta se encuentra en: Windows => Show View => Other y filtrar la búsqueda por Web Service Tester)''' y crear un host de prueba. | |||
En nuestro Eclipse ir al Client Sample que se encuentra dentro del proyecto que hemos creado inicialmente, | En nuestro Eclipse ir al Client Sample que se encuentra dentro del proyecto que hemos creado inicialmente, | ||
| Línea 81: | Línea 71: | ||
* Dicho nombre de clase debe seguir las convenciones java para clase: Iniciar con letra mayúscula | * Dicho nombre de clase debe seguir las convenciones java para clase: Iniciar con letra mayúscula | ||
Luego editar dejando de la siguiente manera (Con fines de prueba). | Luego editar dejando de la siguiente manera (Con fines de prueba). | ||
[[Image:sample.png]] | [[Image:sample.png]] | ||
En la zona de la imagen que se encuentra pintada, allí se debe pasar como parámetro el host de prueba que creamos. | En la zona de la imagen que se encuentra pintada, allí se debe pasar como parámetro el host de prueba que creamos. | ||
Para la prueba ejecutar | Para la prueba ejecutar dicho Client Sample como una aplicación Java. (Run As => Java Application) | ||
La salida debe ser algo parecido a ésto | La salida debe ser algo parecido a ésto | ||
[[Image:finish.png]] | [[Image:finish.png]] | ||
'''Tener en cuenta que las clases generadas pueden ser reutilizadas''' | |||
== Instalar JBossWS== | |||
*'''En caso que no exista la opción de JBossWS, proceder a su instalación''' | |||
Ir a '''Help''' => '''Install New Software''' y filtrar la búsqueda por '''JBoss WebServices''' | |||
Elegir la opción como muestra en la imágen | |||
[[Image:JBoss WebServices Tools.png]] | |||
Click en '''Finish''' | |||
== Preferencias del JbossWS == | |||
Primeramente se deben configurar las Preferencias del JbossWS, para ello en el Eclipse ir a '''Window''' => '''Preference''' y filtrar la búsqueda por '''JbossWS Preference''' como se muestra a continuación | |||
[[Image:preference.png]] | |||
Click en el botón '''Add''' para crear el JbossWS Runtime, en '''Home Folder''' Examinar y ubicar donde se encuentre nuestro servidor Jboss utilizado, una vez seleccionado el path del servidor el '''Nombre''' se autocompletará automáticamente. Ver la imágen de abajo. | |||
[[Image:runtime.png]] | |||
Click en '''Finish''' y posteriormente click en el botón '''OK''' | |||
==Creando un Proyecto Dinámico== | |||
En Eclipse ir a '''File => New => Dynamic Web Project''' en '''Project Name''' => Colocar el nombre del proyecto(Que es el que permitirá la creación del cliente para WS) | |||
Luego click en '''Finish''' | |||
[[Category:Sistema de Intercambio de Información]] | [[Category:Sistema de Intercambio de Información]] | ||
Revisión del 18:20 9 oct 2012
Introducción
Eclipse junto con Jboss Tools nos proveen de las herramientas necesarias para trabajar con WebServices, todo ésto se explica en el desarrollo de la página.
Consideraciones Importantes
- Se debe tener instalado el JBOssWS, caso contrario ir a Instalar JBossWS
- En caso de no tener configurado las preferencias del JbossWS, ir a Configurar Preferencias
- Crear un proyecto que contendrá el Client Sample para consumir el web service, ir a Dynamic Project
Creación de cliente para consumir un WebService
En eclipse ir a File => New => Elegir la opción Other
- Seleccionar el Wizard => Web Service Client como se muestra en la imágen
Click en el botón Next
- En Service Definition se debe colocar el wsdl al cual deseamos acceder.
Para nuestro ejemplo utilizaremos ésta url pública de internet: http://www.webservicex.net/whois.asmx?WSDL
- Luego en la sección Configuration => Seleccionar la opción Web service runtime: Apache Axis
Aparecerá la ventana de Client Environment Configuration, luego en la sección de Web service runtime => Elegir la opción JBossWS.
Observación: El runtime depende del ambiente de implementación, si se utilizara Jboss entonces se recomienda utilizar Jboss Web Service.
Hacer click en botón OK.
Luego hacer click en la sección Client Project y allí elegir el proyecto dinámico que se creó inicialmente.
Cabe destacar que al crear un proyecto web dinámico, el Eclipse crea y asocia al mismo un proyecto cliente EAR.
Luego click en Next
Aparecerá la ventana de Jboss Web Service Code Generation Configuration como se muestra en la imagen. En la sección de Package => Colocar el paquete en donde se generará todo lo que se necesita para consumir el WebService. Si no existe el paquete lo crea. Asimismo se debe colocar
Observación: Todo este proceso genera un Client Sample con un stub para consumir.
Además se debe tener en cuenta que ésta versión del Jboss Tools generará constructores que ya no existen, y deben ser eliminados.
Prueba de consumo de webservice
Para la prueba se puede utilizar la herramienta que nos provee el Eclipse el Web Service Explorer (Ésta se encuentra en: Windows => Show View => Other y filtrar la búsqueda por Web Service Tester) y crear un host de prueba.
En nuestro Eclipse ir al Client Sample que se encuentra dentro del proyecto que hemos creado inicialmente,
Observación:
- Se recomienda hacer una copia del mismo porque el wizard siempre lo sobreescribe, y colocarle un nombre con el cual pueda asociarse al WSDL consultado.
- Dicho nombre de clase debe seguir las convenciones java para clase: Iniciar con letra mayúscula
Luego editar dejando de la siguiente manera (Con fines de prueba).
En la zona de la imagen que se encuentra pintada, allí se debe pasar como parámetro el host de prueba que creamos.
Para la prueba ejecutar dicho Client Sample como una aplicación Java. (Run As => Java Application)
La salida debe ser algo parecido a ésto
Tener en cuenta que las clases generadas pueden ser reutilizadas
Instalar JBossWS
- En caso que no exista la opción de JBossWS, proceder a su instalación
Ir a Help => Install New Software y filtrar la búsqueda por JBoss WebServices
Elegir la opción como muestra en la imágen
Click en Finish
Preferencias del JbossWS
Primeramente se deben configurar las Preferencias del JbossWS, para ello en el Eclipse ir a Window => Preference y filtrar la búsqueda por JbossWS Preference como se muestra a continuación
Click en el botón Add para crear el JbossWS Runtime, en Home Folder Examinar y ubicar donde se encuentre nuestro servidor Jboss utilizado, una vez seleccionado el path del servidor el Nombre se autocompletará automáticamente. Ver la imágen de abajo.
Click en Finish y posteriormente click en el botón OK
Creando un Proyecto Dinámico
En Eclipse ir a File => New => Dynamic Web Project en Project Name => Colocar el nombre del proyecto(Que es el que permitirá la creación del cliente para WS)
Luego click en Finish