API WS-Addressing

Ce produit fournit des interfaces au niveau de la programmation des applications destinées à permettre aux développeurs d'applications, et notamment aux développeurs d'applications WSRF (Web Services Resource Framework) de créer des références vers des instances de ressource de services Web et de cibler ces instances. Si vous êtes programmeur système, vous pouvez utiliser certaines de ces interfaces avec les interfaces de programmation système Web Services Addressing (WS-Addressing).

API JAX-WS 2.1

Les API JAX-WS 2.1 standard de ce produit sont contenues dans le package javax.xml.ws.wsaddressing. Pour plus d'informations sur ces API, voir la documentation API JAX-WS 2.1.

L'implémentation des API JAX-WS 2.1 standard dans ce produit contient également des interfaces de programmation d'application dans le package com.ibm.websphere.wsaddressing.jaxws21. Ces API sont décrites plus en détails dans la documentation des API générées dans ce centre de documentation. Ces API permettent d'atteindre les objectifs suivants en utilisant des classes spécifiques :
  • Pour représenter des noeuds finaux conformes à la spécification 2004/08 WS-Addressing, utilisez la classe com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference.
  • Pour créer une instance SubmissionEndpointReference pour représenter des noeuds finaux 2004/08 dans des services Web autres que ceux qui génèrent la référence de noeud final, utilisez la classe com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReferenceBuilder.
  • Pour convertir des instances EndpointReference créées en utilisant l'API IBM WS-Addressing en instances W3CEndpointReference ou SubmissionEndpointReference, utilisez la classe com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceCoverter. Cette classe peut être aussi utilisée pour inverser la conversion des instances EndpointReference.
  • Pour activer WS-Addressing sur les clients, utilisez la classe com.ibm.websphere.wsaddressing.jaxws21.SubmissionAddressingFeature et une annotation, @SubmissionAddressing, pour l'activation de WS-Addressing sur les serveurs.

API WS-Addressing propriétaires IBM

Ces interfaces de programmation d'application figurent dans le package com.ibm.websphere.wsaddressing et sont résumées dans le schéma suivant. Ce schéma montre également les classes suivantes d'API JAX-WS 2.1 : com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceConverter, javax.xml.ws.wsaddressing.W3CEndpointReference et com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference.
La classe Java EndpointReferenceManager contient deux méthodes : createEndpointReference et getReferenceParameterFromMessageContext. Elle fait elle-même usage de trois autres classes : EndpointReference (contenant la méthode setReferenceParameter), WSAConstants (comportant la constante WSADDRESSING_DESTINATION_EPR) et ReferenceParameterCreationException. WSAConstants et ReferenceParameterCreationException utilisent tous deux une dernière classe : EndpointReferenceCreationException.
Ces interfaces fournissent les fonctions suivantes :
  • Un mécanisme qui permet de créer, à l'aide de l'interface com.ibm.websphere.EndpointReferenceManager.createEndpointReference, une instance com.ibm.websphere.EndpointReference représentant une référence de noeud final WS-Addressing.
  • Fonction obsolète Fonction obsolète: Une classe dépréciée, com.ibm.websphere.wsaddressing.EndpointReferenceCoverter, pour convertir des instances EndpointReference en classes dépréciées com.ibm.websphere.wsaddressing.W3CEndpointReference ou com.ibm.websphere.wsaddressing.SubmissionEndpointReferences, à utiliser dans des applications JAX-WS.

    Ces classes sont dépréciées en faveur des classes JAX-WS 2.1 du même nom (EndpointReferenceConverter, SubmissionEndpointReference et W3CEndpointReference) contenues dans les packages com.ibm.websphere.wsaddressing.jaxws21 et javax.xml.ws.wsaddressing.jaxws21, comme indiqué sur le schéma.

    depfeat
  • Une méthode, com.ibm.websphere.wsaddressing.EndpointReference.setReferenceParameter, pour vous permettre d'associer des paramètres de référence à une instance EndpointReference.
  • Une interface qui permet à un client de configurer son contexte de demande BindingProvider ou l'objet Stub (raccord) ou Call (appel), à partir d'une instance EndpointReference. Tous les appels sur l'objet BindingProvider, Stub ou Call, sont ainsi dirigés vers le noeud final qui est représenté par l'instance EndpointReference. Pour obtenir ce comportement, paramétrez la propriété com.ibm.websphere.wsaddressing.WSAConstants.WSADDRESSING_DESTINATION_EPR du contexte de demande BindingProvider, ou de l'objet Stub ou Call, sur l'instance EndpointReference appropriée.
  • Un mécanisme d'acquisition des paramètres de référence individuels qui sont associés au contexte du message entrant, afin de corréler le message à une instance de ressource spécifique via l'interface com.ibm.websphere.EndpointReferenceManager.getReferenceParameterFromMessageContext.

Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_wsa_api
Nom du fichier : cwbs_wsa_api.html