Habilitación de soporte de direccionamiento de servicios web para aplicaciones JAX-WS usando anotaciones de direccionamiento

Para aplicaciones JAX-WS, puede habilitar el soporte de WS-Addressing durante el desarrollo de una aplicación de servicio, utilizando en el código las anotaciones de direccionamiento. También puede utilizar este método en una aplicación cliente que utilice una referencia de proxy de servicio web inyectado.

Acerca de esta tarea

Utilice una de las anotaciones de direccionamiento siguientes en el código de servidor:
  • Addressing - utilice esta anotación si quiere utilizar la especificación 2005/08 WS-Addressing.
  • SubmissionAddressing - utilice esta anotación si quiere utilizar la especificación 2004/08 WS-Addressing
En los clientes, utilice sólo la anotación de direccionamiento; no hay soporte para la anotación SubmissionAddressing. Debe especificar la anotación de direccionamiento junto con la anotación WebServiceRef. La anotación WebServiceRef especifica una referencia al proxy de servicio web que el contenedor de cliente inyecta.

Los valores de anotación prevalecen sobre los valores en el documento WSDL. Los valores de anotación pueden ser distintos de los valores WSDL si crea el documento WSDL manualmente en vez de generarlo desde el código.

Especifique hasta tres parámetros opcionales por cada anotación:
Tabla 1. Parámetros para las anotaciones de direccionamiento. En la tabla se enumeran los diversos parámetros con sus posibles valores y una descripción de cada uno.
Nombre del parámetro Valores posibles Descripción
enabled

true (valor predeterminado)
false

Si el soporte de WS-Addressing está habilitado.
required

true
false (valor predeterminado)

Si se requieren las cabeceras de WS-Addressing.
responses

Responses.All (valor predeterminado)
Responses.ANONYMOUS
Responses.NON_ANONYMOUS

Indica si debe utilizarse un patrón de intercambio de mensajes síncrono o asíncrono. Especifique Responses.ANONYMOUS para enviar mensajes en un patrón de mensaje síncrono; utilice Responses.NON_ANONYMOUS para enviar mensajes en un patrón de intercambio de mensajería asíncrona.
Nota: Este parámetro no tiene soporte en la anotación SubmissionAddressing.
Nota: Puede utilizar la anotación Addressing sólo con un SOAP (1.1 o 1.2) a través de enlaces HTTP. Si utiliza la clase con otro enlace, como XML sobre HTTP, se emite una excepción en los clientes, y en los servidores, el servicio web no se despliega.

Procedimiento

Resultados

Si utiliza una anotación de direccionamiento en la aplicación de servicio, el servidor procesa las cabeceras WS-Addressing que se ajustan a esta especificación de relevancia en los mensajes SOAP de entrada. Si especifica que WS-Addressing es necesario, y un mensaje SOAP de entrada no incluye cabeceras WS-Addressing o incluye cabeceras WS-Addressing que no cumplen la especificación indicada por la anotación, el servidor devuelve un mensaje de error. Por ejemplo, si un cliente envía un mensaje que incluye cabeceras 2004/08 WS-Addressing, y el servidor precisa cabeceras 2005/08, el servidor devuelve un mensaje de error.

Si utiliza la anotación Addressing y genera un documento WSDL desde el código, en el documento WSDL se creará un elemento UsingAddressing y aserciones WS-Policy. Los clientes que utilicen este documento WSDL incluirán información de WS-Addressing en sus mensajes. Las herramientas actuales de generación de WSDL no entienden la anotación SubmissionAddressing. No obstante, el documento WSDL no distingue entre las especificaciones 2005/08 y 2004/08, por consiguiente, si desea generar un documento WSDL a partir de código que contiene una anotación SubmissionAddressing, utilice ambas anotaciones Addressing y SubmissionAddressing juntas.

Si especifica el atributo de respuestas, se utilizará el patrón de intercambio de mensajes correspondiente.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wsa_dep_jaxws_annot
File name: twbs_wsa_dep_jaxws_annot.html