Jboss WebService

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