SOAP DECLARATION

SOAP DECLARATION コマンドを使用して、Webサービスとして公開された4Dメソッドで使用される引数の型を明示的に宣言できます。

メソッドがWebサービスとして公開されると、標準の引数$0, $1... $nが外部へのWebサービス引数の定義に使用されます (特にWSDLファイル内で)。SOAPプロトコルは、引数が明示的に命名されていることを要求します。4Dは“FourD_arg0, FourD_arg1 ... FourD_argN”をデフォルトで使用します。

このデフォルトの動作は、以下の理由で問題となる場合があります:

• $0 や $1, $2を配列として宣言できません。ゆえにポインタを使用する必要がありますが、この場合、値の型はWSDLファイル生成時に分かっていなければなりません。
• 入出力引数の名前を変更したい、あるいは変更しなければならない時があります。
• XML構造とDOM参照を引数として使用したい場合があります。
• 32 KBを超えるサイズの値を返したい時があります (非Unicodeモードのテキストサイズの上限)。
• 最後に、この動作だとRPC呼び出しごとに複数の値を返すことができません ($0に)。

SOAP DECLARATION コマンドを使用すればこれらの制限から解放されます。このコマンドを入出力引数毎に実行し、名前と型を割り当てます。

Note: SOAP DECLARATION コマンドが使用されていても、依然として4Dの変数と配列をCompiler_Webメソッド内で“コンパイラ”テーマのコマンドを使用して宣言する必要があります。

variableには、Webサービスを呼び出すときに参照される4D変数を渡します。

警告: プロセス変数または4D引数 ($0 から $n) のみを参照できます。ローカルおよびインタープロセス変数は使用できません。

デフォルトで、テキスト型の引数のみが使用できるため、非Unicodeモードのデータベースでは、SOAPサーバのレスポンスは32KBに制限されます。しかしBLOBを使用すれば32KBを超えるレスポンスを返信できます。この制限を超えるには、SOAP DECLARATION コマンドを呼び出す前に引数をBLOBとして宣言します (例題 4参照)。

Note: クライアント側では、このタイプのWebサービスを4Dから呼び出した場合、Webサービスウィザードはテキスト型の変数を生成します。これを使用可能にするには、プロクシメソッド内の値を受け取る変数をBLOB型に変更します。

typeには対応する4Dのデータ型を渡します。ほとんどのタイプの4D変数と配列を使用できます。 インストールとアクティベーションテーマの以下の定義済み定数と、XMLタイプの場合テーマの2つの定数を使用できます:

Is XML と Is DOM reference 定数を使用して、入出力共に変数を"XML structure" と "DOM reference" 型に宣言できます。このタイプの引数が指定されると、引数への処理やエンコードは行われず、データはそのまま送信されます (例題 5参照)。

• 出力引数:
  
  • Is XML は引数がXML構造であることを示します。
  • Is DOM reference はXML構造のDOM参照であることを示します。この場合、XML構造をSOAPメッセージに挿入することは、DOM EXPORT TO VAR コマンドを実行することと同じです。

Note: 出力引数としてを使用するDOM参照の場合、例えばOn Startupで作成し、アプリケーションの終了時に廃棄されるグローバルな参照を使用することをお勧めします。実際Webサービス内で作成されるDOM参照は、DOM CLOSE XMLで閉じることはできません。これはメソッドの実行が終了して、値が実際にWebサービスクライアントに返されるときにも、XML参照が存在していなければならないためです。Webサービスを複数回呼び出せば、閉じられないDOM参照が複数できることになり、メモリ不足を引き起こすかもしれません。

• 入力引数:
  
  • Is XML はSOAPクライアントから送信されたXML引数を受け取ることを示します
  • Is DOM reference はSOAPクライアントから送信されたXML引数に対応するXML構造のDOM参照を受け取ることを示します。

• WSDLの変更: これらのXML構造は4Dにより"anyType" 型 (不定) としてWSDL内で宣言されます。XML構造を明確に型宣言したい場合、WSDLファイルを保存して、手作業によりWSDLの<types>部に適切なデータスキーマを追加します。

4D変数を参照する入力SOAP引数 (4Dメソッド引数を除く) はまずCOMPILER_WEBプロジェクトメソッド内で宣言されなければなりません。実際Webサービスメソッド内でプロセス変数を使用するには、メソッドが呼び出される前にそれらが宣言されていることを必要とします。COMPILER_WEBプロジェクトメソッドは、存在すれば、SOAPリクエストが受け入れられるたびに呼び出されます。デフォルトでCOMPILER_WEBメソッドは存在しません。明示的に作成する必要があります。

COMPILER_WEBメソッドはWebサーバでも使用されます (参照)。

aliasには、WSDLとSOAP交換時に表示される引数の名前を渡します。

警告: この名前はRPC内でユニークでなければなりません (入力、出力引数両方で)。そうでなければ最後の宣言のみが有効になります。

Note: 引数名は数字で始まっていてはならず、スペースを含むことはできません。さらに互換性の問題を避けるため、アクセント文字などの拡張文字は使用しないことをお勧めします。
alias 引数が省略されると、4Dはデフォルトで変数名または4Dメソッド引数にはFourD_argNを使用します。

Note: SOAP DECLARATION コマンドはWebサービスとして公開されるメソッドに含まれていなければなりません。他のメソッドから呼び出すことはできません。

この例題は引数名を指定します:

この例題は郵便番号の配列を倍長整数型で受け取ります:

この例題では、引数名を指定せずに、2つの戻り値を参照しています:

この例題は、非Unicodeモードのデータベースにおいて、32KBを超える値を返すことを可能にします:

Note タイプ Is Text (Is BLOBではなく)を使用していることに留意してください。これにより引数が正しく処理されます。

以下の例題では様々なタイプの宣言を示しています: