Puede desarrollar un servicio web JAX-WS (Java™ API for XML-Based Web Services) accesible de HTTP, si ya tiene un objeto JavaBeans existente para habilitarlo como un servicio web.
Antes de empezar
Debe tener un objeto JavaBeans JAX-WS anotado para habilitarlo como un servicio
web. De forma opcional, puede ejecutar el mandato wsgen para crear un archivo
WSDL (Web Services Description Language) a partir del componente JavaBeans JAX-WS anotado. Debe especificar la opción -wsdl con el mandato wsgen para crear el archivo WSDL.
Para obtener información sobre cómo desarrollar un servicio web JAX-WS que use anotaciones, consulte información sobre el desarrollo de artefactos Java para aplicaciones JAX-WS utilizando JavaBeans.
Acerca de esta tarea
El servidor de aplicaciones tiene soporte para el uso de HTTP para transportar
solicitudes de clientes de servicios web. Con HTTP, los servidores y clientes de servicios web pueden comunicarse mediante
mensajes SOAP. SOAP es el protocolo de comunicación subyacente que se utiliza en los servicios web que soportan las especificaciones de los servicios web para Java EE (Java Platform, Enterprise Edition) y la API JAX-WS (Java API for XML-Based Web Services).
HTTP es el transporte que se utiliza generalmente para los servicios web.
Procedimiento
- Añada un enlace HTTP y una dirección SOAP al archivo WSDL.
El archivo WSDL de un servicio web debe incluir un enlace HTTP y una dirección
SOAP, que especifica una serie de URL de punto final HTTP, a la que se puede acceder en el transporte HTTP. Un enlace HTTP es un elemento wsdl:binding que contiene un elemento soap:binding con un atributo de transporte que finaliza en soap/http.
Además del enlace HTTP, un elemento wsdl:port que haga referencia al enlace
HTTP debe incluirse en el elemento wsdl:service del archivo WSDL.
El elemento wsdl:port contiene un elemento soap:address con un atributo de ubicación que especifica una serie URL de punto final HTTP.
Cuando desarrolle el servicio web, puede utilizar un espacio reservado como, por ejemplo, file:ubicación_no_especificada para la serie URL de punto final.
Nota: Si despliega un componente JavaBeans JAX-WS como un servicio web sin un archivo WSDL, se genera automáticamente un archivo WSDL para el componente.
- Para aplicaciones de servicios web JAX-WS, no es necesaria ninguna configuración de transporte
HTTP. El servidor de aplicaciones genera automáticamente los valores del transporte HTTP. El archivo WAR (web Archive) sólo necesita el objeto JavaBeans junto con el archivo WSDL opcional instalado.
- Despliegue la aplicación de servicios web.
- Configure la seguridad para el transporte HTTP.
Para configurar un transporte HTTP seguro, conecte la política SSLTransport a la aplicación.
Para especificar la señal de transporte de la autenticación básica, utilice la consola de administración para establecer los atributos de ID de usuario y contraseña en el enlace HTTPTransport.
- (Opcional) Configure la gestión de sesiones
HTTP.
La gestión de sesiones HTTP permite a las aplicaciones de servicios web
JAX-WS aparecer de forma dinámica para los usuarios de aplicaciones.
- (Opcional) Configure
un escucha de respuestas asíncronas para los clientes JAX-WS.
Puede utilizar un escucha de respuestas asíncronas en los entornos de cliente ligero
para JAX-WS y de cliente de aplicación para recibir respuestas a solicitudes que se han
invocado de forma asíncrona.
- Configure
la información de URL de punto final para los enlaces HTTP.
El editor WSDL
utiliza esta serie URL parcial para generar el URL de HTTP real para cada componente de puerto definido
en el archivo EAR (Enterprise Archive). Los clientes que necesiten invocar el servicio web pueden utilizar el archivo WSDL
publicado.
Resultados
Dispone de un objeto JavaBeans que utiliza HTTP para transportar solicitudes de clientes de servicios web JAX-WS.