Soap.SOAPConn.TSoapConnection

Delphi

TSoapConnection = class(TCustomRemoteServer)

C++

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

Propriétés

Type	Visibilité	Source	Unité	Parent
class	public	Soap.SOAPConn.pas Soap.SOAPConn.hpp	Soap.SOAPConn	Soap.SOAPConn

Description

TSoapConnection connecte à un serveur d'applications implémenté comme service Web.

La classe TSoapConnection est utilisée dans la partie client d'une application de base de données multi-niveau pour établir et gérer la connexion entre un client un serveur d'application distant implémenté comme service Web.

L'objet connexion SOAP peut :

Etablir la connexion initiale avec un serveur d'applications distant.
Obtenir une interface pour le serveur d'applications.
Obtenir une liste des fournisseurs du serveur d'applications.
Fermer la connexion avec le serveur d'applications distant.

TSoapConnection établit la connexion initiale entre l'application cliente et un serveur d'applications distant utilisant SOAP.

Remarque: Pour utiliser TSoapConnection sur Windows, wininet.dll doit être installé sur le système client. wininet.dll se trouve dans le répertoire système de Windows si vous avez installé IE3 ou supérieur.

TSoapConnection utilise un objet THTTPRio interne pour obtenir une interface de l'application de services Web. Cette interface est IAppServer ou IAppServerSOAP (ou un de leurs descendants), selon la valeur de la propriété UseSOAPAdapter. Nous vous recommandons d'utiliser l'interface IAppServerSOAP, car elle forme un protocole de transport plus adapté à SOAP. En revanche, certains serveurs d'applications (ceux créés à l'aide de Delphi 6 ou Kylix 2) ne prennent en charge qu'une interface IAppServer. Si vous utilisez un serveur d'applications qui ne prend pas en charge l'interface IAppServerSOAP, attribuez la valeur false à UseSOAPAdapter.

Quelle que soit l'interface que TSoapConnection utilise pour communiquer avec le serveur d'applications, les informations sont fournies aux ensembles de données client de l'application client à l'aide d'une interface IAppServer. Les ensembles de données client utilisent l'interface IAppServer à partir du composant connexion SOAP pour communiquer avec les fournisseurs du serveur d'applications ou, sinon, pour appeler l'interface du module de données du serveur d'applications.

Remarque: A la différence des autres composants connexion DataSnap, vous ne pouvez pas utiliser la propriété AppServer de TSoapConnection pour appeler les méthodes de l'interface du serveur d'applications qui ne sont pas des méthodes IAppServer. A la place, pour communiquer avec un module de données SOAP de l'interface d'application, utilisez un objet THTTPRIO distinct ou spécifiez l'interface à l'aide de la propriété SOAPServerIID puis appelez la méthode GetSOAPServer.

Pour se connecter à un serveur d'applications distant en utilisant DCOM, employez le composant TDCOMConnection. Pour se connecter à un serveur d'applications distant en utilisant TCP/IP, employez le composant TSocketConnection. Pour la connexion aux serveurs d'application distants avec HTTP (mais sans SOAP), utilisez le composant TWebConnection.