Recepción de cabeceras SOAP implícitas con JAX-RPC

Puede habilitar un cliente de servicios web JAX-RPC (API de Java™ para RPC basado en XML) existente para recibir valores de las cabeceras SOAP implícitas. Si se modifica el código de cliente para recibir cabeceras SOAP implícitas, puede recibir información específica de una respuesta de servicio web entrante.

Antes de empezar

Para completar esta tarea, es necesario disponer de un cliente de servicios web que pueda habilitar la recepción de cabeceras SOAP implícitas.

Una cabecera SOAP implícita es una cabecera SOAP que encaja en una de las descripciones siguientes:
  • Una parte del mensaje que se declara como cabecera SOAP en el enlace del archivo WSDL (Web Services Description Language), pero no es el elemento portType del archivo WSDL el que hace referencia a la definición del mensaje.
  • Un elemento que no está incluido en el archivo WSDL.

Los manejadores y los puntos finales de servicio pueden manipular cabeceras SOAP implícitas o explícitas utilizando el modelo de datos SAAJ (SOAP with Attachments API for Java).

No puede manipular cabeceras SOAP protegidas. Una cabecera SOAP que se declara protegida por su propio componente, por ejemplo, Web Services Security, no es accesible en aplicaciones de cliente. Se produce una excepción si intenta manipular cabeceras SOAP protegidas.

Acerca de esta tarea

La aplicación cliente establece propiedades en el objeto Stub o Call para enviar y recibir cabeceras SOAP implícitas.

Procedimiento

  1. Cree un objeto java.util.HashMap
  2. Añada una entrada al objeto HashMap para cada cabecera SOAP implícita que desea que reciba el cliente. La clave de entrada HashMap es el QName de la cabecera SOAP. El valor de la entrada de HashMap es null.
  3. Establezca la entrada de HashMap en el objeto Stub o Call. El nombre de la propiedad es com.ibm.websphere.webservices.Constants.RESPONSE_SOAP_HEADERS. El valor de la propiedad es HashMap.
  4. Emita llamadas de método remoto a través del objeto Stub o Call. El motor de servicios web extrae las cabeceras de respuesta especificadas desde el mensaje de respuesta de los servicios web y las inserta en HashMap. Después de que vuelva el método remoto, se puede acceder a las cabeceras de respuestas desde el objeto HashMap.
    Se puede producir un error JAXRPCException si se cumple alguna de estas condiciones:
    • HashMap contiene una clave que no es un QName.
    • HashMap contiene una clave que representa una cabecera SOAP que se declara protegida por el propio componente.

Resultados

Dispone de un cliente de servicios web JAX-RPC que puede recibir valores de las cabeceras SOAP implícitas.


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_retrievesoaphead
File name: twbs_retrievesoaphead.html