Soap.OPConvert.TSOAPConvertOptions
Delphi
TSOAPConvertOptions = Soap.OpConvertOptions.TSOAPConvertOptions;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
set | public | Soap.OPConvert.pas | Soap.OPConvert | Soap.OPConvert |
Beschreibung
Die Flags TSOAPConvertOptions und TSOAPConvertOption steuern, wie die Konvertierung zwischen SOAP-codierten und nativen Methodenaufrufen durchgeführt wird.
TSOAPConvertOptions ist eine Menge von TSOAPConvertOption-Werten. TSOAPConvertOption-Werte sind Flags zur Steuerung der Konvertierungen von TSOAPDomConv beim Umwandeln von nativem Code in die SOAP-Entsprechung. Die folgende Tabelle enthält die möglichen Werte:
Option | Bedeutung |
---|---|
SoSendUntyped |
Bei der Konvertierung eines nativen Typs in seine SOAP-Entsprechung werden keine Typattribute berücksichtigt. Manche Web-Service-Anwendungen benötigen diese Informationen in SOAP-Anforderungen nicht, setzen aber voraus, dass die Werte der Funktionssignatur entsprechen. |
SoSendMultiRefObj |
Bei der Konvertierung eines nativen Typs in seine SOAP-Entsprechung gibt diese Option an, dass mehrere Referenzen auf dasselbe Objekt verweisen. Das heißt, dass Objekte basierend auf der Objektreferenz identifiziert werden anstatt sie als Struktur zu behandeln, deren Identifizierung nur auf den Werten ihrer Eigenschaften basiert. |
SoSendMultiRefArray |
Bei der Konvertierung eines nativen Typs in seine SOAP-Entsprechung gibt diese Option an, dass mehrere Referenzen auf dasselbe Array verweisen. Das heißt, dass Arrays basierend auf der Array-Referenz identifiziert werden anstatt sie als Struktur zu behandeln, deren Identifizierung nur auf den Werten ihrer Elemente basiert. |
SoTryAllSchema |
Bei der Konvertierung einer SOAP-Entsprechung in einen nativen Typ setzt TSOAPDomConv standardmäßig voraus, dass Xml-Schemadefinitionen zu dem Xml-Schema gehören, das der Anwendung zugeordnet ist. Wenn es möglich ist, dass die SOAP-Anforderung mit einem anderen Xml-Schema Standardtypen definiert, müssen Sie soTryAllSchema einbeziehen. Dadurch wird TSOAPDomConv veranlasst, alle Schemadokumente zu durchsuchen, die in der Unit xmlschema definiert sind. |
SoRootRefNodesToBody |
Bei der Konvertierung eines nativen Typs in SOAP erscheinen Mehrfachreferenzen als untergeordnete Elemente des Tags <soap:body> und nicht als gleichrangige Objekte der ersten Instanz. Diese Option empfiehlt sich, da einige Web-Service-Provider erfordern, dass Mehrfachreferenzen am Body-Tag angesetzt werden. Wenn dieses Flag nicht gesetzt ist, wird die Anforderung eventuell nicht verstanden. |
SoDocument |
Bei der Konvertierung aus SOAP in einen nativen Typ wird vorausgesetzt, dass die Anforderung als Dokument codiert ist, nicht als Remote Procedure Call (RPC). Diese Option wird bei der Kommunikation mit Dokumenten-Servern verwendet. |
soReturnSuccessForFault |
Wenn der Server ein SOAP-Fehlerpaket generiert, darf die Antwortbotschaft keinen Fehlerstatuscode enthalten, sondern sollte erfolgreiche Ausführung signalisieren (200). Dadurch wird es Servern möglich, Fehlerpakete an Clients zu senden, die Exceptions auslösen, wenn eine HTTP-Antwort keinen Erfolg signalisiert. |
soUTF8InHeader |
Fügen Sie bei der Konvertierung eines nativen Typs in SOAP einen SOAP-Header hinzu, der angibt, dass das SOAP-Paket einen UTF8-Codierungsstil verwendet. Die SOAP-Spezifikation behandelt UTF8 nicht als Standardstil, und daher wird der Header benötigt. Er wird aber von manchen Web-Service-Anwendungen nicht verwendet. |
soDontSendEmptyNodes |
Fügen Sie bei der Konvertierung eines nativen Typs in SOAP keine Elemente für leere Strings, leere Arrays oder nil- (Delphi) bzw. NULL- (C++) Objektreferenzen hinzu. |
soCacheMimeResponse |
Wenn der Bindungstyp (TWebServiceBindingType) angibt, dass die Antwort eine MIME-Codierung verwendet, speichern Sie beim Konvertieren einer Antwort von SOAP in native Typen den eingehenden Antwortinhalt in einer temporären Datei anstatt im Speicher. Und zwar, weil MIME-Codierungen signalisieren, dass Anlagen vorhanden sind, die sehr groß sein könnten. Entfernen Sie dieses Flag nur, wenn Sie wissen, dass die Anlagen klein sind. |
soDontClearOutBoundHeaders |
Geben Sie bei der Konvertierung eines nativen Typs in SOAP keine Klassen von Headern frei, nachdem deren SOAP-Entsprechung erstellt wurde. |
soCustomFaultAtDetailsNode |
Beim Generieren eines SOAP-Fehlerpakets für eine Exception werden die Informationen in den Detailknoten und nicht in einen untergeordneten Knoten des Detailknotens geschrieben. |
soLiteralParams |
Beim Konvertieren der SOAP-Entsprechung in einen nativen Typ werden die Parameter nicht berücksichtigt, auch wenn der WSDL-Importer mit dieser Option aufgerufen wurde. Dieses Flag wird bei der literalen Dokumentcodierung benötigt, wenn sich der Name einer Methode von dem der Struktur für ihre Parameter unterscheidet. |
soUTF8EncodeXML |
Beim Konvertieren eines nativen Typs in dessen SOAP-Entsprechung werden Zeichen nicht auf Transportebene mit UTF-8 codiert. Diese Codierungsart ist weniger effizient als die Codierung auf DOM-Ebene, sie wird aber von manchen Web-Services benötigt. |
soXXXXHdr |
Der konvertierte Typ entspricht einem Header. |