HTTP アダプタについて
HTTP アダプタ (EnsLib.HTTP.InboundAdapterOpens in a new tab および EnsLib.HTTP.OutboundAdapterOpens in a new tab) を使用すると、プロダクションで HTTP 要求および応答を送受信できるようになります。この章では、これらのアダプタについて簡単に説明します。
Note:
Web サーバと InterSystems IRIS との間の通信の設定には Web ゲートウェイを使用することを強くお勧めしますが、必要に応じて、受信アダプタを使用することもできます。
Tip:
InterSystems IRIS® では、これらのアダプタを使用する特殊なビジネス・サービス・クラスとユーザのニーズに適したビジネス・サービス・クラスの 1 つも提供されます。そのため、プログラミングの必要がありません。"相互運用プロダクションの概要" の “接続オプション” を参照してください。
HTTP 送信アダプタとヘルパ・クラス
EnsLib.HTTP.OutboundAdapterOpens in a new tab は、HTTP 要求をプロダクションの外部に送信し HTTP 応答を受信するアダプタです。このアダプタは、以下のような項目を制御する設定を提供します。
-
アダプタが HTTP 要求を送信するサーバおよびポート
-
指定されたサーバおよびポートで、要求するリソースの URL パス
-
サーバへの接続に使用するオプションの TLS 構成
-
アダプタが要求をルーティングするプロキシ・サーバを指定するためのオプション情報
このアダプタは、HTTP POST、GET、および PUT アクションを送信するメソッドを提供します。
-
主要なメソッドは PostFormData() および GetFormData() です。各メソッドで、応答オブジェクトの出力引数、フォーム変数名のカンマ区切りのリスト、およびフォーム変数引数の変数数値 (1 つの変数数値がカンマ区切りリスト内の各名前に対応) を使用できます。1 つのフォーム変数に複数の値を設定する場合は、リスト内で同じ名前を複数回使用できます。もちろん、フラットなスカラ・コンテンツ (通常の Web ページなど) を要求するために、フォーム変数なしでこれらのメソッドを使用することもできます。
-
フォーム変数の複雑なセットが使用されている場合は、PostFormDataArray() および GetFormDataArray() メソッドを使用します。これらのメソッドでは、変数引数リストの代わりに、多次元配列が使用できます。多次元配列は、指定されたフォーム変数の複数の値を、名前リスト内の複数のエントリとしてではなく、配列のサブノードとして提供できるため、情報の組織化に役立ちます。また、位置ではなくフォーム変数名によって配列にインデックスを割り当てることができます。
-
その他の特別な HTTP 要求 (PUT など) を使用する必要がある場合や、フォーム変数や Cookie 以外の HTTP 要求の面でカスタマイズをする必要がある場合には、低レベルのワーカ・メソッドである SendFormDataArray() を使用できます。
このアダプタは、Cookie を管理するためのプロパティおよびメソッドも提供します。
HTTP 送信アダプタを使用する場合、以下の 2 つのヘルパ・クラスを使用します。