Einhaltung von WSDL-Bindungen in JAX-WS-Web-Services durchsetzen
In Java™ API for XML-Based Web Services (JAX-WS) Version 2.1 wurde das Konzept von Features als eine Methode für die Steuerung bestimmter Funktionen und Verhalten über das Programm eingeführt. RespectBindingFeature ist eines der unterstützten Standardfeatures. Mit RespectBindingFeature können Sie steuern, ob eine JAX-WS-Implementierung erforderlich ist, damit der Inhalt der WSDL-Bindung (Web Services Description Language), die einem Endpunkt zugeordnet ist, berücksichtigt wird.
Informationen zu diesem Vorgang
Obwohl im Entwicklungsprozess häufig WSDL-Dokumente verwendet werden, ist die tatsächliche Verwendung bereitgestellter WSDL-Dokumentspezifikationen zur Laufzeit in den Versionen der Spezifikation JAX-WS vor Version 2.1 nicht klar definiert. In der Spezifikation JAX-WS Version 2.1 wurde das Feature "RespectBindingFeature" hinzugefügt, um die Auswirkung des Elements "wsdl:binding" in einer JAX-WS-Laufzeitumgebung klar zu definieren.
Die Aktivierung des Features "RespectBindingFeature" bewirkt, dass die JAX-WS-Laufzeitumgebung das Element "wsdl:binding" für einen Endpunkt zur Laufzeit überprüft, um sicherzustellen, dass die Bindung der SEI-Parameter (Service Endpoint Interface, Serviceendpunktschnittstelle) und die Rückgabewerte berücksichtigt werden. Außerdem stellt dieses Feature sicher, dass alle erforderlichen Erweiterungen von wsdl:binding von der Laufzeitumgebung verstanden und verwendet werden bzw. dass die Erweiterungen von der Anwendung explizit inaktiviert wurden. Ihre JAX-WS-Anwendung kann eine bestimmte wsdl:binding-Erweiterung, die eine definierte WebServiceFeature-Schnittstelle hat, inaktivieren, indem sie die entsprechende Annotation, die diesem Feature zugeordnet ist, mithilfe einer API verwendet, die die Schnittstelle "javax.xml.ws.WebServiceFeature" akzeptiert, oder indem sie die Implementierungsdeskriptoren konfiguriert.
Wenn das Feature "RespectBindingFeature" nicht aktiviert ist, was die Standardeinstellung ist, kann die Laufzeitumgebung wählen, ob Teile des Elements "wsdl:binding" umgesetzt werden.
Vorgehensweise
Ergebnisse
Durch die Implementierung des Features "RespectBindingFeature" haben Sie festgelegt, dass der Inhalt einer WSDL-Bindung, die einem Endpunkt für Ihre JAX-WS-Anwendung zugeordnet ist, eingehalten werden muss.