Soporte de Web Services Addressing
El soporte de WS-Addressing (Web Services Addressing) de este producto proporciona el entorno para los servicios web que utilizan las especificaciones W3C (World Web Consortium) de WS-Addressing. Esta familia de especificaciones proporcionan mecanismos neutrales de transporte para direccionar los servicios web y facilitar el direccionamiento de extremo a extremo.
- Un desarrollador de servicios web que necesita utilizar las API de WS-Addressing para crear referencias de punto final dentro de una aplicación y, a continuación, utilizarlas para tomar como destino las instancias de recurso de servicio web.
- Un programador del sistema que necesita utilizar las SPI (interfaces de programación de sistema) de WS-Addressing propiedad de IBM para realizar operaciones de WS-Addressing más avanzadas, por ejemplo especificar propiedades de direccionamiento de mensajes en los mensajes de servicio web.
- Un administrador que configura conjuntos de políticas para aplicaciones JAX-WS.
El soporte de WS-Addressing para desarrolladores consta de dos conjuntos de interfaces de programación: las interfaces JAX-WS 2.1 estándar y la implementación propiedad de IBM de la especificación WS-Addressing.
Características del soporte de WS-Addressing JAX-WS
Este producto proporciona soporte para las API de WS-Addressing JAX-WS, que se pueden utilizar para realizar funciones de direccionamiento básicas, por ejemplo crear una referencia de punto final, habilitar soporte de WS-Addressing y especificar los URI de acción asociados a las operaciones WSDL del servicio web. Utilice estas API si desea llevar a cabo funciones de WS-Addressing simples y crear aplicaciones JAX-WS que sean portables.
- Representaciones Java™ de referencias de punto final de WS-Addressing.
- Puede crear instancias de referencia de punto final de Java para el punto final de la aplicación, u otros puntos finales de la misma aplicación, durante el tiempo de ejecución. No tiene que especificar el URI de la referencia de punto final.
- Puede crear instancias de referencia de punto final de Java para los puntos finales de otras aplicaciones, especificando el URI de referencia del punto final.
- En los servicios, puede utilizar las anotaciones para especificar si se da soporte a WS-Addressing, si es necesario y el tipo de intercambio de mensajes que deben utilizarse (síncrono, asíncrono o ambos).
- En los clientes, puede utilizar características para especificar si el soporte de WS-Addressing está habilitado y si es necesario.
- Puede configurar el proxy del cliente o los objetos de asignación utilizando las referencias del punto final.
- Soporte Java para las referencias de punto final que representan a las instancias de WS-Resource (Web Services Resource).
- Puede asociar los parámetros de referencia con una referencia de punto final durante el tiempo de creación para correlacionarla con una instancia de recurso determinada.
- En los servicios web de destino, puede extraer los parámetros de referencia de un mensaje de entrada para que el servicio web pueda direccionar el mensaje a la instancia de WS-Resource adecuada.
- Puede especificar información de enlace adicional dentro de los metadatos de una referencia de punto final como parte de la especificación JAX-WS 2.2. Esta funcionalidad se añadió a WebSphere Application Server en la Versión 7, pero como no formaba parte de la especificación JAX-WS 2.1, podría haber experimentado problemas de incompatibilidad al interoperar con servidores que no son WebSphere Application Server que no admitían metadatos adicionales en las referencias de punto final. JAX-WS 2.2 soporta los metadatos WSDL en las referencias de punto final, por lo tanto, las aplicaciones serán compatibles con otras implementaciones de esta especificación. Consulte el tema "Visión general de Web Services Addressing" para ver información adicional.
- Puede habilitar y configurar WS-Addressing en un cliente o servicio añadiendo aserciones WS-Policy en el documento WSDL. WebSphere Application Server procesa la información de WS-Addressing mantenida en el aspecto WS-Policy de un documento WSDL y la utiliza en la configuración de esa aplicación. Consulte el tema "Habilitación del soporte de Web Services Addressing para aplicaciones JAX-WS utilizando WS-Policy" si desea información adicional.
- Puede especificar si es necesario un patrón de intercambio de mensajes síncrono o asíncrono para una aplicación de servicio web utilizando la anotación de direccionamiento o AddressingFeature. Utilice el parámetro responses en las anotaciones de direccionamiento o la clase AddressingFeature en el código. Consulte el tema "Habilitación del soporte de Web Services Addressing para aplicaciones JAX-WS utilizando anotaciones de direccionamiento" y el tema "Habilitación del soporte de Web Services Addressing para aplicaciones JAX-WS utilizando las características de direccionamiento" para ver información adicional.
- Puede configurar WS-Addressing utilizando los descriptores de despliegue. Añada un elemento <addressing>y elementos hijo opcionales al archivo de descriptor de despliegue de la aplicación. Consulte el tema "Habilitación del soporte de Web Services Addressing para aplicaciones JAX-WS utilizando descriptores de despliegue" para ver información adicional.
- Puede generar código a partir de un documento WSDL y WebSphere Application Server inserta automáticamente las anotaciones @Action y @FaultAction en el código Java generado. Consulte el tema "Anotaciones de Web Services Addressing" para ver información adicional.
Características del soporte de WS-Addressing propiedad de IBM
Este producto proporciona una implementación propiedad de IBM de la especificación WS-Addressing, que se puede utilizar con aplicaciones JAX-RPC así como con aplicaciones JAX-WS, para llevar a cabo funciones más avanzadas, por ejemplo crear referencias de punto final que representan objetos altamente disponibles o establecer directamente propiedades de direccionamiento de mensajes en la cabecera SOAP. Utilice estas API y SPI si desea crear aplicaciones de JAX-RPC que utilicen direccionamiento o si desea llevar a cabo funciones más avanzadas que no son posibles con las API de JAX-WS.
- Puede crear fácilmente las instancias de referencia del punto final de Java para representar cualquier punto final del servidor, en función del entorno de despliegue de la aplicación. No tiene que especificar el URI de la referencia de punto final. Asimismo, las referencias de punto final pueden representar objetos gestionados de carga de trabajo o de alta disponibilidad.
- Puede configurar los objetos de contexto de solicitud BindingProvider de JAX-WS de cliente, o los objetos Stub o Call de JAX-RPC de cliente, con una referencia de punto final de WS-Addressing. Las futuras invocaciones de estos objetos se dirigen al punto final que se representa mediante una referencia de punto final. Las invocaciones también se ajustan automáticamente a la especificación de WS-Addressing (espacio de nombres) asociada con esa referencia de punto final.
- Razonamiento y manipulación de las referencias de punto final más
allá de lo que está disponible en el nivel de programación de la
aplicación.
- Puede manipular el contenido de la referencia de punto final como se indica en la especificación de WS-Addressing.
- Puede asociar un espacio de nombres de WS-Addressing y, por lo tanto, el comportamiento de especificación, con una referencia de punto final.
- Representaciones Java de las propiedades de direccionamiento de mensajes de WS-Addressing.
- Puede especificar las propiedades de direccionamiento de mensajes de WS-Addressing para los mensajes de servicio web salientes. En el servicio web de destino, puede extraer las propiedades de direccionamiento de mensajes de los mensajes de servicio web de entrada.
- Puede especificar el espacio de nombres de WS-Addressing de un mensaje de WS-Addressing de salida, aunque en la mayor parte de los casos el espacio de nombres se deriva automáticamente basándose en la referencia de punto final de destino. En un servicio web de destino, puede adquirir el espacio de nombres de WS-Addressing de un mensaje de entrada.
Soporte para las especificaciones e interoperatividad de WS-Addressing
De forma predeterminada, este producto da soporte a las especificaciones principales W3C WS-Addressing 1.0 y de enlaces SOAP identificadas mediante el espacio de nombres http://www.w3.org/2005/08/addressing. A menos que se indique lo contrario, la semántica de WS-Addressing que se describe en esta documentación hace referencia a estas especificaciones.
Para la interoperatividad, se da soporte a otros niveles de especificación en esta versión del producto; en concreto, la presentación a W3C de WS-Addressing con el espacio de nombres http://schemas.xmlsoap.org/ws/2004/08/addressing.
Para aplicaciones JAX-WS, este producto da soporte a la especificación identificada por el espacio de nombres http://www.w3.org/2007/05/addressing/metadata. Esta especificación reemplaza la especificación de enlaces WSDL (Web Services Description Language) de WS-Addressing identificada por el espacio de nombres http://www.w3.org/2006/05/addressing/wsdl.
- El elemento de extensión wsaw:UsingAddressing, sólo en el elemento de enlace WSDL. Los espacios de nombres soportados para este elemento son el espacio de nombres http://www.w3.org/2006/05/addressing/wsdl y el espacio de nombres http://www.w3.org/2006/02/addressing/wsdl (en desuso).
- El elemento de extensión wsaw:Action. Los espacios de nombres soportados para este elemento son el espacio de nombres http://www.w3.org/2006/05/addressing/wsdl, el espacio de nombres http://www.w3.org/2006/02/addressing/wsdl (en desuso) y el espacio de nombres http://schemas.xmlsoap.org/ws/2004/08/addressing.