Soap.OPConvert.TSOAPConvertOption
Delphi
TSOAPConvertOption = Soap.OpConvertOptions.TSOAPConvertOption;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
enum | public | Soap.OPConvert.pas | Soap.OPConvert | Soap.OPConvert |
Beschreibung
TSOAPConvertOption und TSOAPConvertOptions repräsentieren Flags, die die Konvertierung zwischen einer SOAP-Codierung und nativen Methodenaufrufen anpassen.
TSOAPConvertOptions ist eine Menge von TSOAPConvertOption-Werten. TSOAPConvertOption-Werte sind Flags, die die Konvertierungen steuern, die von TSOAPDomConv beim Übersetzen von nativem Code in die entsprechende SOAP-Repräsentation ausgeführt werden. Die folgende Tabelle enthält die möglichen Werte:
Option | Bedeutung |
---|---|
soSendUntyped |
Bei der Konvertierung eines nativen Typs nach SOAP das Typ-Attribut nicht angeben. Einige Web-Service-Anwendungen benötigen die Typinformation in der SOAP-Anforderung nicht, sondern gehen davon aus, dass die Werte mit der Funktionssignatur übereinstimmen. |
soSendMultiRefObj |
Bei der Konvertierung eines nativen Typs nach SOAP angeben, wenn mehrere Referenzen auf dasselbe Objekt verweisen. Das bedeutet, dass bei der Behandlung von Objekten deren auf der Objektreferenz beruhende Identität berücksichtigt wird, anstatt sie einfach als Strukturen zu behandeln, deren Identität nur auf den Werten ihrer Eigenschaften basiert. |
soSendMultiRefArray |
Bei der Konvertierung eines nativen Typs nach SOAP angeben, wenn mehrere Referenzen auf dasselbe Array verweisen. Das bedeutet, dass bei der Behandlung von Arrays deren auf der Array-Referenz beruhende Identität berücksichtigt wird, anstatt sie einfach als Strukturen zu behandeln, deren Identität nur auf den Werten ihrer Elemente basiert. |
soTryAllSchema |
Bei der Konvertierung aus SOAP in einen nativen Typ geht TSOAPDomConv standardmäßig davon aus, 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 Schema Standardtypen definiert, soll soTryAllSchema angegeben werden. Dadurch wird TSOAPDomConv veranlasst, in allen in der XML-Schema-Unit definierten Schemadokumenten nach den Typdefinitionen zu suchen. |
soRootRefNodesToBody |
Bei der Konvertierung eines nativen Typs nach SOAP erscheinen alle Mehrfachreferenzen als dem Tag <soap:body> untergeordnet, und nicht als der ersten Instanz gleichgeordnet. Diese Option wird empfohlen, weil bei einigen Web-Service-Providern Mehrfachreferenzen beim Body-Tag angegeben werden müssen. Diese Provider verstehen die Anforderung nicht, wenn dieses Flag nicht vorhanden ist. |
soDocument |
Bei der Konvertierung aus SOAP in einen nativen Typ davon ausgehen, dass die Anforderung als Dokument anstatt als ein Remote-Prozedurenaufruf (RPC) codiert ist. Diese Option wird bei der Kommunikation mit Dokumentservern verwendet. |
soReturnSuccessForFault |
Wenn der Server ein SOAP-Fehlerpaket erzeugt, sollte die Antwortbotschaft keinen Fehlerstatuscode enthalten, sondern eine erfolgreiche Ausführung angeben (200). Dadurch wird es Servern ermöglicht, Fehlerpakete an Clients zu senden, die Exceptions erzeugen, wenn eine HTTP-Antwort nicht erfolgreich war. |
soUTF8InHeader |
Bei der Konvertierung von nativen Typen nach SOAP einen SOAP-Header einbeziehen, der angibt, dass das SOAP-Paket die UTF8-Codierung verwendet. Weil die SOAP-Spezifikation UTF8 nicht als Standradcodierung behandelt, ist dieser Header technisch erforderlich. Einige Web-Service-Anwendungen verwenden diesen Header jedoch nicht. |
soDontSendEmptyNodes |
Bei der Konvertierung von nativen Typen nach SOAP kein Element für leere Strings, leere Arrays oder nil- (Delphi) bzw. NULL- (C++) Objektreferenzen einbeziehen. |
soCacheMimeResponse |
Bei der Konvertierung einer Antwort von SOAP in native Typen den eingehenden Antwortinhalt in einer temporären Datei und nicht im Arbeitsspeicher speichern, wenn der Bindungstyp (TWebServiceBindingType) angibt, dass die Antwort die MIME-Codierung verwendet. Der Grund hierfür ist, dass MIME-Codierungen anzeigen, dass Anlagen vorhanden sind, die sehr groß sein können. Entfernen Sie dieses Flag nur, wenn Sie wissen, dass die erwarteten Anlagen klein sind. |
soDontClearOutBoundHeaders |
Bei der Konvertierung von nativen Typen nach SOAP keine Klassen freigeben, die nach der Erzeugung ihrer SOAP-Darstellung Header repräsentieren. |
soCustomFaultAtDetailsNode |
Beim Erzeugen eines SOAP-Fehlerpakets zur Repräsentation einer Exception Informationen zum Detailknoten anstatt als dem Detailknoten untergeordnet serialisieren. |
soLiteralParams |
Beim Konvertieren aus der SOAP-Codierung in native Typen Parameter nicht abwickeln, auch wenn der WSDL-Import mit der Option zum Abwickeln von literalen Parametern aufgerufen wurde. Diese Option ist für die literale Dokumentcodierung erforderlich, wenn der Name einer Methode und der Name der Struktur, die deren Parameter repräsentiert, unterschiedlich sind. |
soUTF8EncodeXML |
Bei der Konvertierung von nativen Typen nach SOAP Zeichen auf der Transportebene in UTF-8 codieren. Diese Codierung ist weniger effizient als die Codierung auf DOM-Ebene, ist aber für einige Web-Services erforderlich, die von einer Codierung auf Transportebene und nicht auf der DOM-Ebene ausgehen. |
soXXXXHdr |
Der zu konvertierende Typ repräsentiert einen Header. |