WS-Addressing-APIs

Dieses Produkt stellt Schnittstellen auf Anwendungsprogrammierungsebene bereit, mit denen Anwendungsentwickler, darunter auch Entwickler von WSRF-Anwendungen (Web Services Resource Framework), Referenzen auf Web-Service-Ressourceninstanzen erstellen und diese adressieren können. Wenn Sie Systemprogrammierer sind, können Sie einige dieser Schnittstellen zusammen mit den WS-Addressing-Systemprogrammierschnittstellen (Web Services Addressing) verwenden.

JAX-WS-2.1-APIs

Die standardmäßig verwendeten JAX-WS-2.1-APIs in diesem Produkt sind im Paket "javax.xml.ws.wsaddressing" enthalten. Weitere Informationen zu diesen APIs finden Sie in der Dokumentation zu den JAX-WS-2.1-APIs.

Die Implementierung der standardmäßig verwendeten JAX-WS-2.1-APIs in diesem Produkt enthält auch Anwendungsprogrammierschnittstellen im Paket "com.ibm.websphere.wsaddressing.jaxws21". Diese APIs sind in der generierten API-Dokumentation in diesem Information Center ausführlicher beschrieben. Die unten genannten APIs ermöglichen Ihnen, die folgenden Ziele durch Verwendung bestimmter Klassen zu erreichen:
  • Eine Klasse, "com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference", zum Darstellen von Endpunkten, die mit der Spezifikation "2004/08 WS-Addressing" übereinstimmen.
  • Eine Klasse, "com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReferenceBuilder", für die Erstellung einer SubmissionEndpointReference-Instanz zur Darstellung von 2004/08-Endpunkten in den Web-Services, die die Endpunktreferenz nicht generieren.
  • Eine Klasse, "com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceCoverter", für die Konvertierung von EndpointReference-Instanzen mit der IBM proprietären WS-Addressing-API in eine W3CEndpointReference- bzw. SubmissionEndpointReference-Instanz. Diese Klasse kann auch verwendet werden, um die Konvertierung von EndpointReference-Instanzen umzukehren.
  • Zum Aktivieren von WS-Addressing in Clients verwenden Sie die Klasse "com.ibm.websphere.wsaddressing.jaxws21.SubmissionAddressingFeature" und eine Annotation "@SubmissionAddressing" zum Aktivieren von WS-Addressing in Servern.

IBM proprietäre WS-Addressing-APIs

Diese Anwendungsprogrammierschnittstellen sind im Paket com.ibm.websphere.wsaddressing enthalten und in der folgenden Abbildung zusammengefasst. Die Abbildung zeigt auch die folgenden Klassen aus der JAX-WS-2.1-API: com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceConverter, javax.xml.ws.wsaddressing.W3CEndpointReference und com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference.
Die Java-Klasse EndpointReferenceManager enthält zwei Methoden: createEndpointReference und getReferenceParameterFromMessageContext. Diese Klasse verwendet drei weitere Klassen: EndpointReference (mit der Methode setReferenceParameter), WSAConstants (mit der Konstante WSADDRESSING_DESTINATION_EPR) und ReferenceParameterCreationException. WSAConstants und ReferenceParameterCreationException verwenden jeweils eine weitere Klasse, die Klasse EndpointReferenceCreationException.
Diese Schnittstellen stellen die folgenden Funktionen bereit:
  • Mechanismus für das Erstellen einer Instanz von com.ibm.websphere.wsaddressing.EndpointReference für die Darstellung einer WS-Addressing-Endpunktreferenz mit der Schnittstelle com.ibm.websphere.wsaddressing.EndpointReferenceManager.createEndpointReference.
  • Veraltetes Feature Veraltetes Feature: Eine veraltete Klasse, com.ibm.websphere.wsaddressing.EndpointReferenceCoverter, für die Konvertierung von EndpointReference-Instanzen in die veralteten Klassen com.ibm.websphere.wsaddressing.W3CEndpointReference oder com.ibm.websphere.wsaddressing.SubmissionEndpointReferences, zur Verwendung in JAX-WS-Anwendungen.

    Diese Klassen sind veraltet. Jetzt werden die JAX-WS-2.1-Klassen selben Namens (EndpointReferenceConverter, SubmissionEndpointReference und W3CEndpointReference), die in den Paketen com.ibm.websphere.wsaddressing.jaxws21 und javax.xml.ws.wsaddressing.jaxws21 enthalten sind, verwendet, wie in der Abbildung gezeigt.

    depfeat
  • Eine Methode, com.ibm.websphere.wsaddressing.EndpointReference.setReferenceParameter, mit der Sie Referenzparameter einer EndpointReference-Instanz zuordnen können.
  • Eine Schnittstelle, die es einem Client ermöglicht, seinen BindingProvider-Anforderungskontext oder sein Stub- oder Call-Objekt basierend auf einer EndpointReference-Instanz zu konfigurieren. Alle Aufrufe des BindingProvider-, Stub- oder Call-Objekts werden anschließend an den Endpunkt weitergeleitet, den die EndpointReference-Instanz darstellt. Um dieses Verhalten zu erreichen, setzen Sie die Eigenschaft "com.ibm.websphere.wsaddressing.WSAConstants.WSADDRESSING_DESTINATION_EPR" im BindingProvider-Anforderungskontext oder im Stub- oder Call-Objekt auf die fragliche EndpointReference-Instanz.
  • Ein Mechanismus für die Anforderung individueller Referenzparameter, die dem Kontext der eingehenden Nachricht zugeordnet ist, um die Nachricht über die Schnittstelle com.ibm.websphere.EndpointReferenceManager.getReferenceParameterFromMessageContext zu einer bestimmten Ressourceninstanz in Beziehung zu setzen.

Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_wsa_api
Dateiname:cwbs_wsa_api.html