Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 12.0.0 (Deutsch) » SQL Anywhere Server - Programmierung » HTTP-Webdienste » Zugriff auf Webdienste mithilfe von Webclients » Webclientanwendungen entwickeln » Anforderungen und Empfehlungen für Webclient-Funktionen und -Prozeduren

 

Header der SOAP-Anforderung verwalten

Bei dem Header einer SOAP-Anforderung handelt es sich um ein XML-Fragment innerhalb des SOAP-Envelope. Während der SOAP-Vorgang und seine Parametern auch als RPC (Remote Procedure Call) betrachtet werden können, kann der Header einer SOAP-Anforderung verwendet werden, um Metadaten in einer spezifischen Anforderung oder Antwort zu übertragen. Die Header einer SOAP-Anforderung übertragen Metadaten wie etwa Autorisierungs- oder Sitzungskriterien.

Der Wert einer SOAPHEADER-Klausel muss ein gültiges XML-Fragment sein, das einem Headereintrag der SOAP-Anforderung entspricht. Es können mehrere Headereinträge für eine SOAP-Anforderung angegeben werden. Die gespeicherte Prozedur oder Funktion injiziert automatisch die Headereinträge der SOAP-Anforderung innerhalb eines SOAP-Headerelements. SOAPHEADER-Werte geben SOAP-Header an, die als statische Konstante deklariert oder dynamisch mithilfe des Parameterersetzungsmechanismus festgelegt werden können.

SOAP-Antwort-Header (zurückgegeben vom SOAP-Aufruf) werden für Prozeduren und Funktionen unterschiedlich verarbeitet. Bei Verwendung einer Funktion, was die flexibelste und empfohlene Methode darstellt, wird der gesamte SOAP-Antwortrahmen empfangen. Der Antwortrahmen kann dann mit openxml verarbeitet werden, um SOAP-Header und SOAP-Hauptteildaten zu extrahieren. Bei Verwendung einer Prozedur können SOAP-Antwort-Header nur durch einen Ersetzungsparameter extrahiert werden, der einer IN- oder INOUT-Variable zugeordnet ist. In einer SOAP-Prozedur sind maximal ein IN- oder INOUT-Parameter zulässig.

Eine Webdienstfunktion muss den SOAP-Antwortrahmen syntaktisch analysieren, um die Header-Einträge zu erhalten.

 Beispiel
 Einschränkungen