Habilitación de soporte de direccionamiento de servicios web para aplicaciones JAX-WS usando características de direccionamiento

Para aplicaciones JAX-WS, puede habilitar el soporte de WS-Addressing durante el desarrollo de una aplicación cliente, utilizando en el código las funciones de direccionamiento.

Acerca de esta tarea

Utilice una de las clases de funciones de direccionamiento siguientes en el código de cliente:
  • AddressingFeature - utilice esta clase si quiere enviar mensajes que incluyen cabeceras WS-Addressing que cumplen la especificación 2005/08 WS-Addressing
  • SubmissionAddressingFeature - utilice esta clase si quiere enviar mensajes que incluyen cabeceras WS-Addressing que cumplen la especificación 2004/08 WS-Addressing
Si utiliza ambas clases de características, la especificación que se utiliza depende del tipo de referencia de punto final que también haya especificado. Por ejemplo, si especifica un objeto W3CEndpointReference, la especificación que se utiliza es la especificación 2005/08. Si especifica una referencia de punto final cuyo tipo entra en conflicto con lo que se indica en la clase de característica, por ejemplo un objeto W3CEndpointReference con una instancia SubmissionAddressingFeature, se genera un error. Si no especifica una referencia de punto final, la especificación predeterminada es la especificación 2005/08.
Especifique hasta tres parámetros opcionales por cada instancia de función de direccionamiento:
Tabla 1. Parámetros para la función de direccionamiento. En la tabla se enumeran los diversos parámetros de la función de direccionamiento 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 para la clase SubmissionAddressingFeature.
Nota: Puede utilizar las clases de características de direccionamiento sólo con un SOAP (1.1 ó 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

Cree una instancia de una o más clases de funciones de direccionamiento, con los parámetros necesarios. Por ejemplo, para especificar que WS-Addressing está habilitado y es obligatorio y que se utilizan la especificación 2005/08 y el patrón de intercambio de mensajes asíncrono, utilice el código siguiente:
AddressingFeature feat = new AddressingFeature(true, true, AddressingFeature.Responses.NON_ANONYMOUS);
Para especificar que WS-Addressing está inhabilitado para la especificación 2004/08, utilice el código siguiente:
SubmissionAddressingFeature feat = new SubmissionAddressingFeature(false);

Resultados

Si especifica que WS-Addressing está habilitado, el cliente incluye cabeceras WS-Addressing en mensajes SOAP. Las cabeceras cumplen la especificación de WS-Addressing indicada por el tipo de clase de característica utilizado. Si el servidor no utiliza anotaciones, o utiliza conjuntos de políticas para habilitar WS-Addressing, el servidor aceptará especificaciones 2005/08 y 2004/08.

Si especifica que WS-Addressing es obligatorio y el cliente recibe un mensaje que no incluye cabeceras WS-Addressing, el cliente devolverá un error.

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_feat
File name: twbs_wsa_dep_jaxws_feat.html