SOAP ( Simple Object Access Protocol ) は、XML と HTTP や SMTP などをベースに、サーバーにあるデータやサービスを呼び出すためのプロトコルです。

SOAP メッセージは Envelope、Header、Body の 3 つの要素から構成されます。

SFXSOAPParser クラスは SFXXMLDOMParser クラスを継承し、DOM ツリーをメモリ上に展開します。DOM ツリーを取得することなく、SOAP メッセージを解析するだけで、SOAP メッセージの任意の情報を取得できます。

主な SFXSOAPParser クラスの機能

SFXSOAPWriter クラスは SFXXMLDocument クラスを利用して、SOAP メッセージの各要素を生成するクラスです。

SFXSOAPRPC クラスは SFXSOAPParser と SFXSOAPWriter クラスを利用して、SOAP-RPC を実装するクラスです。

Web サービスの関数名、ターゲットとなる URI、パラメーター、サーバーの IP アドレス、Web サービスとその機能の soapAction 属性値は、コールバック関数を設定するだけで、Web サービスが呼び出せます。

SFXSOAPWriter クラスで作成した SOAP メッセージを SFXSOAPRPC::Invoke 関数に渡して、Web サービスを呼び出します。最短の場合、コードは数行で済みます。

WSDL ( Web Services Description Language ) は Web サービスの API を定義するための標準的な言語です。 WSDL を使えば、SOAP メッセージの交換レイヤーよりも上位レベルで、SOAP バインディングなどの Web サービス関連処理を抽象的に定義できます。

SFXSOAPServiceProxy クラスを使えば、WSDL 文書で記述された内容を理解する必要はありません。Web サービスの名前、ポート名、呼び出す機能のパラメーターを入力するだけで、Web サービスを呼び出せます。

SFXSOAPServiceProxy クラスでは、SFXXSDDOMParser クラスを使って WSDL 文書を解析し、WSDL 文書に対応した SOAP メッセージを生成して、SFXSOAPRPC オブジェクトに渡し、Web サービスが実行される仕組みになっています。

SFXXSDDOMParser クラスは XMLSchema 文法に対応したパーサー クラスです。( WSDL 文書は XMLSchema によって実現されています )

SFXSOAPRPC クラスでは、SOAP メッセージに記されたパラメーターを設定します。

SFXSOAPServiceProxy クラスでは、WSDL 文書に記されたパラメーターを設定します。

レスポンスとして返される SOAP メッセージはコールバック関数に渡されます。そのとき、Web サービスの戻り値は次のいずれかの方法で取得します。

サーバーから、レスポンスとして Fault 要素を含む SOAP メッセージが返されたとき、 コールバック関数の error パラメーターは SFERR_SOAP_FAULT_MESSAGE になります。 具体的なエラー情報は、SFXSOAPRPC::FAULT によって取得できます。