Soap.SOAPConn.TSoapConnection

Delphi

TSoapConnection = class(TCustomRemoteServer)

C++

class PASCALIMPLEMENTATION TSoapConnection : public Datasnap::Dbclient::TCustomRemoteServer

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
class	public	Soap.SOAPConn.pas Soap.SOAPConn.hpp	Soap.SOAPConn	Soap.SOAPConn

Beschreibung

TSoapConnection stellt eine Verbindung zu einem Anwendungsserver her, der als Webdienst implementiert ist.

TSoapConnection wird im Client-Teil einer mehrschichtigen Datenbankanwendung verwendet, um die Verbindung zwischen dem Client und einem als Webdienst implementierten Remote-Anwendungsserver einzurichten und zu verwalten.

Das TSoapConnection-Objekt führt folgende Aktionen aus :

Einrichten der Verbindung zu einem Remote-Anwendungsserver.
Abrufen eines Interface für den Anwendungsserver.
Abrufen einer Liste der auf dem Anwendungsserver verfügbaren Provider.
Beenden der Verbindung zum Remote-Anwendungsserver.

TSoapConnection verwendet SOAP, um die Verbindung zwischen der Client-Anwendung und einem Remote-Anwendungsserver herzustellen.

Hinweis: Wenn Sie TSoapConnection in Windows verwenden möchten, muss die Bibliothek wininet.dll auf dem Client-System installiert sein. Wenn IE3 oder höher installiert ist, befindet sich wininet.dll im Windows-Systemverzeichnis.

TSoapConnection verwendet ein internes THTTPRio-Objekt, um von der Webdienst-Anwendung ein Interface abzurufen. Dabei handelt es sich je nach Wert der Eigenschaft UseSOAPAdapter um das Interface IAppServer oder IAppServerSOAP (oder um ein davon abgeleitetes Interface). Es ist ratsam, IAppServerSOAP als Transportprotokoll zu verwenden, da dieses Interface besser an SOAP angepasst ist. Manche Anwendungsserver (die mit Delphi 6 oder Kylix 2 erstellt wurden) unterstützen jedoch nur das Interface IAppServer. Wenn Sie einen Anwendungsserver verwenden, der IAppServerSOAP nicht unterstützt, legen Sie UseSOAPAdapter auf "false" fest.

Unabhängig von dem Interface für die Kommunikation mit dem Anwendungsserver stellt TSoapConnection über das Interface IAppServer den Client-Datenmengen in der Client-Anwendung Informationen zur Verfügung. Client-Datenmengen kommunizieren über das IAppServer-Interface der SOAP-Verbindungskomponente mit den Providern auf dem Anwendungsserver, oder sie verwenden dieses Interface für den Aufruf des Datenmodul-Interface des Anwendungsservers.

Hinweis: Im Gegensatz zu anderen DataSnap-Verbindungskomponenten ist es bei TSoapConnection nicht möglich, über die Eigenschaft "AppServer" Methoden des Interface des Anwendungsservers aufzurufen, die keine IAppServer-Methoden sind. Verwenden Sie stattdessen zur Kommunikation mit einem SOAP-Datenmodul auf dem Anwendungs-Interface ein separates THTTPRIO-Objekt, oder geben Sie das Interface mit der Eigenschaft SOAPServerIID an und rufen Sie dann die Methode GetSOAPServer auf.

Verwenden Sie die Komponente TDCOMConnection, wenn die Verbindung zu Remote-Anwendungsservern über DCOM aufgebaut werden soll. Um eine Verbindung zu Remote-Anwendungsservern über TCP/IP herzustellen, verwenden Sie stattdessen die Komponente TSocketConnection. Wenn die Verbindung mit dem Remote-Anwendungsserver mit HTTP (aber nicht SOAP) hergestellt werden soll, verwenden Sie die Komponente TWebConnection.

Hinweis: Ab RAD Studio 11.1 kann das TLS 1.3-Sicherheitsprotokoll für Windows 10 aktiviert werden. Dieses Protokoll ist standardmäßig deaktiviert. Wenn Sie also Netzwerk-Apps verwenden , die TLS 1.3 erfordern oder unterstützen, sollten Sie dieses Protokoll aktivieren, indem Sie diese Registrierungsdatei (EN) auf Ihrem Windows 10-System ausführen. Um das Protokoll zu deaktivieren, führen Sie stattdessen diese Deaktivierungsdatei (EN) aus.