Soap.SOAPConn.TSoapConnection

提供: RAD Studio API Documentation
移動先: 案内検索

Datasnap.DBClient.TCustomRemoteServerData.DB.TCustomConnectionSystem.Classes.TComponentSystem.Classes.TPersistentSystem.TObjectTSoapConnection

Delphi

TSoapConnection = class(TCustomRemoteServer)

C++

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

プロパティ

種類 可視性 ソース ユニット
class public
Soap.SOAPConn.pas
Soap.SOAPConn.hpp
Soap.SOAPConn Soap.SOAPConn

説明

TSoapConnection は、Web サービスとして実装されたアプリケーション サーバーに接続します。

TSoapConnection は、クライアントと、Web サービスとして実装されたリモート アプリケーション サーバーとの間の接続を確立したり管理するために、多層データベース アプリケーションのクライアント部分で使用されます。

SOAP 接続オブジェクトは次の操作を実行できます。

  • リモート アプリケーション サーバーとの最初の接続を確立する。
  • アプリケーション サーバーのインターフェイスを取得する。
  • アプリケーション サーバー上のプロバイダ リストを取得する。
  • リモート アプリケーション サーバーへの接続を切断する。

TSoapConnection は、クライアント アプリケーションと、SOAP を使用するリモート アプリケーション サーバーとの間の最初の接続を確立します。

メモ: Windows で TSoapConnection を使用するには、クライアント システムに wininet.dll がインストールされていなければなりません。 IE3 以降がインストールされている場合、wininet.dll は Windows のシステム ディレクトリ内にあります。

TSoapConnection は、内部の THTTPRio オブジェクトを使用して、Web サービス アプリケーションからインターフェイスを取得します。このインターフェイスは、UseSOAPAdapter プロパティの値に応じて、IAppServer または IAppServerSOAP のいずれか(または、それらの下位クラスのいずれか)になります。 お勧めのアプローチは、IAppServerSOAP インターフェイスを使用することです。このインターフェイスの方が、トランスポート プロトコルとして SOAP に適しています。ただし、IAppServer インターフェイスしかサポートしないアプリケーション サーバー(Delphi 6 または Kylix 2 を使用して作成されたサーバー)もあります。IAppServerSOAP をサポートしないアプリケーション サーバーを使用している場合は、UseSOAPAdapter を false に設定します。

TSoapConnection がどのインターフェイスを使用してアプリケーション サーバーと通信するかに関わらず、IAppServer インターフェイスが提供されることによって、クライアント アプリケーション内のクライアント データセットでの情報の利用が可能になります。クライアント データセットは、SOAP 接続コンポーネントの IAppServer インターフェイスを使用して、アプリケーション サーバー上のプロバイダと通信したり、アプリケーション サーバーのデータ モジュール インターフェイスを呼び出します。

メモ: ほかの DataSnap 接続コンポーネントを使用する場合と違って、IAppServer のメソッドではないアプリケーション サーバー インターフェイスのメソッドを呼び出すために、TSoapConnection の AppServer プロパティを使用することはできません。代わりに、アプリケーション インターフェイスの SOAP データ モジュールと通信するには、独立した THTTPRIO オブジェクトを使用するか、SOAPServerIID プロパティを使用してインターフェイスを指定してから GetSOAPServer メソッドを呼び出します。

DCOM を使用しているリモート アプリケーション サーバーに接続するには、代わりに TDCOMConnection コンポーネントを使用します。TCP/IP を使用しているリモート アプリケーション サーバーに接続するには、代わりに TSocketConnection コンポーネントを使用します。HTTP を使用しているリモート アプリケーション サーバーに接続するには、TWebConnection を使用します。

関連項目