DISH サービスの作成

SQL Anywhere では、SOAP サービスのグループに対して SOAP 終了ポイントとして動作する DISH サービスを作成できます。また、DISH サービスでは、WSDL (Web Services Description Language) ドキュメントも自動的に構築され、WSDL で記述される SOAP サービスとのデータ交換に必要なインターフェイスを SOAP クライアントツールキットで生成できるようになります。HTTP を介した SOAP サービスの現在のワーキングセットは常に公開されるため、SOAP サービスの追加と削除には、DISH サービスの管理は必要ありません。

例

Interactive SQL で次の SQL 文を実行して、HTTP Web サーバーでサンプルの SOAP サービスと DISH サービスを作成します。

CREATE SERVICE "Samples/TestSoapOp"
    TYPE 'SOAP'
    DATATYPE ON
    USER DBA
    AUTHORIZATION OFF
    AS CALL sp_echo(:i, :f, :s);

CREATE PROCEDURE sp_echo(i INTEGER, f REAL, s LONG VARCHAR)
RESULT( ret_i INTEGER, ret_f REAL, ret_s LONG VARCHAR )
BEGIN
	SELECT i, f, s;
END;

CREATE SERVICE "dnet_endpoint"
    TYPE 'DISH'
    GROUP "Samples"
    FORMAT 'DNET';

最初の CREATE SERVICE 文は、Samples/TestSoapOp という新しい SOAP サービスを作成します。

2 番目の CREATE SERVICE 文は、dnet_endpoint という新しい DISH サービスを作成します。GROUP 句の Samples 部分は、公開する SOAP サービスのグループを識別します。DISH サービスによって生成される WSDL ドキュメントを表示できます。SQL Anywhere Web サーバーがコンピューターで実行中の場合、http://localhost:port-number/dnet_endpoint URL を使用してサービスにアクセスできます。port-number は、サーバーが実行されているポート番号です。

この例では、SOAP 応答フォーマットを示す FORMAT 句は、SOAP サービスに含まれていません。したがって、SOAP 応答フォーマットは DISH サービスで指定され、SOAP サービスの FORMAT 句は上書きされません。この機能により、各 DISH 終了ポイントが異なる機能のサービスを SOAP クライアントに提供する、同種の DISH サービスを作成できます。

同種の DISH サービスの作成

SOAP サービス定義が DISH サービスに対する FORMAT 句の指定と異なる場合、フォーマットを定義する DISH サービス内で SOAP サービスのセットをグループ化することができます。このようにすると、異なる FORMAT 指定を使用して、複数の DISH サービスで同じグループの SOAP サービスを公開できます。TestSoapOp の例を展開すると、次の SQL 文を使用して java_endpoint という別の DISH サービスを作成できます。

CREATE SERVICE "java_endpoint"
    TYPE 'DISH'
    GROUP "Samples"
    FORMAT 'CONCRETE';

この例では、SOAP クライアントが java_endpoint DISH サービスを介して TestSoapOp 操作用の Web サービス要求を行うと、SOAP クライアントは TestSoapOp_Dataset という応答オブジェクトを受信します。WSDL を調べて、dnet_endpoint と java_endpoint の違いを比較できます。この手法を使用して、特定の SOAP クライアントツールキットの条件を満たす SOAP 終了ポイントをすばやく構築できます。

参照

DocCommentXchange で意見交換できます