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
- 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
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.
Nombre del parámetro | Valores posibles | Descripción |
---|---|---|
enabled | true (valor predeterminado) |
Si el soporte de WS-Addressing está habilitado. |
required | true |
Si se requieren las cabeceras de WS-Addressing. |
responses | Responses.All (valor predeterminado) |
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.
|
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.