El asistente de servicio Web le ayuda a crear servicios Web nuevos, configurarlos
para su despliegue y desplegar el servicio Web en un servidor.
Una vez que el servicio Web esté
desplegado, este asistente le ayuda a generar el proxy de cliente y la aplicación de muestra para
probar el servicio Web. Cuando haya terminado las pruebas, puede publicar el servicio Web
en un UDDI Business Registry utilizando el asistente de exportación.
Requisitos previos:
- Si utiliza el contenedor de servlets Apache Jakarta Tomcat
como el servidor, debe instalarlo, configurar una instancia de éste y crear un proyecto
Web orientado a él como se describe en el apartado Creación de servidores Apache Tomcat y de proyectos Web
- Cree o importe un bean a la carpeta de código fuente Java del proyecto Web.
Para crear un servicio Web a partir de un bean con el entorno de ejecución de
Apache Axis:
- Cambie a la perspectiva J2EE (Ventana > Abrir perspectiva
> J2EE).
- En la vista Explorador de proyectos, seleccione el bean que ha creado
o importado en la carpeta de código fuente del proyecto Web.
- Pulse Archivo > Nuevo > Otros. Seleccione Servicios Web para visualizar los
distintos asistentes de servicio Web.
Seleccione el asistente Servicio Web. Pulse Siguiente.
- Página Servicios Web: seleccione Servicio Web de bean Java
descendente como tipo de servicio Web y especifique el URI al
archivo WSDL, WSIL o HTML que se utilizará para generar el servicio.
- Seleccione las etapas de desarrollo de servicios Web que desea realizar mediante el
graduador:
- Desarrollo: creará el código de servicio
- Ensamblado:
- Despliegue: creará el código de despliegue del servicio
- Instalación: instalará el servicio en el servidor elegido
- Inicio: iniciará el servidor una vez que el servicio se ha instalado en él
- Prueba: proporcionará varias opciones para probar el servicio
- Seleccione el servidor: se visualizará el servidor predeterminado. Si desea
desplegar el servicio en otro servidor, pulse el enlace destinado a especificar
otro
servidor.
- Seleccione el entorno de ejecución: se visualizará el entorno de ejecución
predeterminado. Si desea desplegar el servicio en otro entorno de ejecución, pulse
el
enlace destinado a especificar otro entorno de ejecución.
- Seleccione el proyecto de servicio: se visualizará el proyecto que contiene
el
proyecto seleccionado en el espacio de trabajo. Para seleccionar otro proyecto y EAR,
pulse el enlace de proyecto. Asegúrese de que el proyecto seleccionado como Proyecto Web del cliente es distinto
del Proyecto Web de servicio o los artefactos generados del cliente sobrescribirán el
servicio.
- Si desea crear un cliente, seleccione el tipo de proxy que debe generarse y repita
los pasos anteriores para el cliente.
- Publicar el servicio Web: lanzará Web Services Explorer para publicar el
servicio Web en un registro
UDDI.
- Supervisar el servicio Web: enviará el tráfico del servicio Web mediante el
Supervisor TCP/IP, que permite observar el tráfico SOAP generado por el servicio Web y
probar si este tráfico se ajusta a WS-I. Como alternativa, puede configurar manualmente
un supervisor TCP/IP como se describe en el apartado
Utilización
del Supervisor TCP/IP para probar servicios Web
- Página Identidad de bean
Java
del servicio Web: indicará el nombre del WSDL del servicio Web. Tiene las opciones siguientes:
- Seleccione los métodos que desea exponer.
- Seleccione el estilo de codificación. El estilo de codificación recomendado para el
entorno de ejecución Axis es RPC/Encoded. Este método de codificación no es compatible con WS-I.
- Seleccione si desea personalizar las correlaciones de paquetes con espacios de nombres.
Pulse Siguiente
- Página Correlación de paquete con espacio de nombres de servicio Web:
si ha seleccionado Definir correlación personalizada entre
espacio de nombres y paquete en el panel anterior, en este
panel puede pulsar Añadir para especificar los
pares de correlación personalizados.
- Página Prueba de servicio Web: si ha determinado probar el servicio Web, seleccione el recurso
de prueba para el servicio Web generado. Esto abrirá el servicio Web en Web Services Explorer. Seleccione la operación que desea probar, especifique la información necesaria
y pulse Ir.
Se mostrará el resultado en el panel Estado. Pulse Siguiente.
- Página Proxy de servicio Web: si ha seleccionado generar un proxy,
determine si desea personalizar las correlaciones de paquetes con espacios
de nombres.
- Página Prueba de cliente de servicio Web: utilice esta página para
seleccionar las opciones siguientes:
- Seleccione el recurso de prueba. Puede probar el proxy generado en el Explorador de
servicios Web o generar un JSP de servicio Web de ejemplo.
- Si ha determinado probar el proxy mediante un JSP, puede seleccionar
la carpeta donde se ubicará el JSP y seleccionar los métodos que se
incluirán en el JSP.
- Seleccione Ejecutar prueba en el servidor para
que el servidor se inicie automáticamente.
- Página Publicación de servicio Web: seleccione si desea publicar o no
este servicio Web en un registro UDDI. Pulse Finalizar. Nota: puede aparecer un aviso que indica Error al generar WSDL a partir de Java. ClassNotFound: <nombre de bean>. Este error se puede pasar por alto con seguridad.
Después de que se ha creado el servicio Web, podría ocurrir lo siguiente en función de las opciones seleccionadas:
- Si ha determinado probar el proxy generado con los JSP de servicio Web,
se iniciará el proxy en un navegador Web en la siguiente dirección URL: http://localhost: puerto/ProyectoWebClient/sampleNombreBean/ NombreServicioWeb/TestClient.jsp.
Puede utilizar esta aplicación de ejemplo para probar el servicio Web, para ello,
seleccione un método, especifique un valor para el método y pulse Invocar. El método resultante se
mostrará en el panel de resultado.
- Si ha determinado probar el servicio Web con Web Services Explorer, se abrirá
el Explorador. Seleccione la operación que desea probar, especifique la información necesaria
y pulse Ir. Se mostrará el resultado en el panel Estado.
- Si ha seleccionado publicar el servicio Web, se iniciará Web Services Explorer que
mostrará la página necesaria para publicar el servicio Web. Siga las instrucciones en Publicar el servicio Web para completar esta tarea.
Importante: si los métodos contienen tipos no admitidos
por este ejemplo, como matrices, propiedades indexadas y colecciones, se omitirán los
métodos del ejemplo y recibirá un mensaje de aviso.