HTTP トランスポート・ポリシーの設定

HTTP トランスポートのポリシー構成を定義するには、このページを使用します。 HTTP 機能ポリシーおよび HTTP 接続ポリシーは、アウトバウンド・メッセージに適用されます。 このコンソール・ページで行う HTTP トランスポート・ポリシーの変更は、このカスタム HTTP トランスポート・ポリシーが添付されるすべての Java™ API for XML-Based Web Services (JAX-WS) アプリケーションに影響します。

この管理コンソール・ページを表示するには、「サービス」>「ポリシー・セット」>「アプリケーション・ポリシー・セット」 >「policy_set_name」>「HTTP トランスポート」とクリックします。policy_set_name は、 HTTP トランスポート・ポリシーが含まれるすべてのポリシー・セットに適用されます。

この管理コンソール・パネルは、Java API for XML Web Services (JAX-WS) アプリケーションにのみ適用されます。

ポリシーは、ポリシー・セットを通じてのみ構成可能です。 そのため、HTTP トランスポート・ポリシーを構成する前に、その HTTP トランスポート・ポリシーを含むポリシー・セットが存在している必要があります。

WSHTTPS デフォルト・ポリシー・セットはアプリケーション・サーバーとともに提供されるもので、これには HTTP トランスポート・ポリシー、SSL トランスポート・ポリシー、および WS-Addressing ポリシーが含まれています。 提供されるデフォルトの WSHTTPS ポリシー・セットは読み取り専用で、編集することはできません。 HTTP トランスポート・ポリシーを含むポリシー・セットをカスタマイズするには、まず最初に WSHTTPS デフォルト・ポリシー・セットのコピーを作成するか、新規のポリシー・セットを作成して、その新規ポリシー・セットに HTTP トランスポート・ポリシーを追加する必要があります。

HTTP トランスポート・ポリシーの値をカスタマイズすると、そのカスタム HTTP トランスポート・ポリシーを含むポリシー・セットにこれらの値が適用されるようになります。 カスタマイズ済みの HTTP トランスポート・ポリシーを含むこのポリシー・セットは、アプリケーション、そのサービス、エンドポイント、または操作に添付することができます。この変更は、そのポリシー・セットが添付されているすべての JAX-WS アプリケーションに影響します。 アプリケーションへのポリシー・セットの関連付けについて詳しくは、 アプリケーション・レベルでのサービス・プロバイダーおよびサービス・クライアントのポリシー・セットの 管理に関する文書を参照してください。

プロトコル・バージョン

使用する HTTP プロトコルのバージョンを指定します。 このリストを使用して、HTTP プロトコルのバージョンを指定します。 デフォルト値は、HTTP 1.1 です。 値 HTTP 1.0 も、有効なオプションです。

HTTP トランスポート・パネルの残りのオプションの一部は、HTTP バージョン 1.1 でのみ使用できます。 以下の概要説明で、これらのオプションを比較します。

HTTP 1.0
メッセージを、MIME に似た形式にすることができます。この形式には、転送されたデータに関するメタ情報と、要求または応答、あるいはその両方の修飾子が含まれます。 ただし HTTP 1.0 は、階層プロキシー、キャッシュ、持続接続の必要性、仮想ホストなどがもたらす影響には、十分に対応することができません。
HTTP 1.1
2 つの通信アプリケーションそれぞれで、true 機能か他の機能かを判別できるようになります。 機能を確実に実装するために、このプロトコルには、HTTP 1.0 より厳しい要件が含まれます。
セッションの有効化

メッセージの送信時に、HTTP セッションを有効にするかどうかを指定します。 このチェック・ボックスを選択すると、HTTP セッションを有効にできます。

このプロパティーをサービス・クライアントに添付されているポリシー・セット内で使用する場合は、HTTP セッション情報を同じクライアント・アプリケーションで呼び出された後続の要求に伝搬するかどうかを指定します。 プロパティーが使用可能の場合、HTTP セッション情報は応答メッセージでサービス・クライアントに返され、同じ RequestContext オブジェクトを使用して呼び出された後続の要求で送信されます。

このプロパティーをサービス・プロバイダーに添付されているポリシー・セット内で使用する場合は、要求の処理中に HTTP セッションを新規作成するかどうかを指定します。 プロパティーが使用可能の場合、HTTP セッションが新規作成されます (まだ作成されていない場合)。 その後、その HTTP セッション情報は応答メッセージでサービス・クライアントに返されます。

チャンク転送エンコードの有効化

メッセージの送信時に、チャンク転送エンコードを有効にするかどうかを指定します。 このチェック・ボックスを選択すると、チャンク転送エンコードを有効にできます。 このオプションが使用できるのは、「プロトコル・バージョン (Protocol version)」フィールドで HTTP 1.1 を選択している場合のみです。 HTTP 1.0 プロトコルを選択した場合、このオプションは選択できません。

このプロパティーのデフォルト値は、true です。

expect "100-request" ヘッダーの送信

メッセージの送信時に、expect "100-request" ヘッダーを使用可能にするかどうかを指定します。 このチェック・ボックスを選択すると、expect "100-request" ヘッダーが 使用可能になります。このオプションが使用できるのは、「プロトコル・バージョン (Protocol version)」フィールドで HTTP 1.1 を選択している場合のみです。 HTTP 1.0 プロトコルを選択した場合、このオプションは選択できません。

100 の状況にする目的は、起点サーバーが (要求ヘッダーに基づいて) 要求を受け入れるかどうかを、要求ボディで要求メッセージを送信しているクライアントが、要求ボディの送信前に判別できるようにすることです。 サーバーがボディを見ることなしにメッセージを拒否した場合に、クライアントにボディを送信させたくないことがあるかもしれません。

「要求ヘッダーの予期 (Expect request-header)」フィールドは、クライアントが特定のサーバーの動作を必要とすることを示すために使用されます。 要求の応答に該当するエラー状況が伴う場合、サーバーは、「予期 (Expect)」フィールド内にある期待値のいずれにも対応することができません。

URL の自動リダイレクトの受け入れ

メッセージの送信時に、URL の自動リダイレクトを受け入れるかどうかを指定します。 このチェック・ボックスを選択すると、自動でリダイレクトされた URL を受け入れ可能にできます。

要求コンテンツの圧縮

メッセージの送信時に、要求コンテンツを圧縮するどうかを指定します。 コンテンツのコーディングを使用すると、 文書の基礎となるメディア・タイプの ID を失うことなく、 かつ情報も失うことなしに、文書を圧縮することが可能になります。 このチェック・ボックスを選択すると、希望する要求コンテンツの圧縮が可能になります。 「要求コンテンツの圧縮 (Compress request content)」ボタンをクリックすると、 「圧縮形式 (Compression format)」オプションで圧縮方法を選択できます。 圧縮形式のデフォルト値は、gzip です。

応答コンテンツの圧縮

メッセージの送信時に、応答コンテンツを圧縮するかどうかを指定します。 コンテンツのコーディングを使用すると、 文書の基礎となるメディア・タイプの ID を失うことなく、 かつ情報も失うことなしに、文書を圧縮することが可能になります。 このチェック・ボックスを選択すると、希望する応答コンテンツの圧縮が可能になります。 「応答コンテンツの圧縮 (Compress response content)」ボタンをクリックすると、 圧縮方法を指定する「圧縮形式 (Compression format)」オプションが使用可能になります。圧縮形式のデフォルト値は、gzip です。

読み取りタイムアウト

Web サービス・クライアントが SOAP 応答を完全に読み取る時間の長さを、秒単位で指定します。読み取りプロセスが指定された時間内に完了しないと、SOAP 障害エラーがクライアント・マシンで生成されます。

書き込みタイムアウト

メッセージの送信時に書き込みアクションがタイムアウトする時間の長さを、秒単位で指定します。書き込みのタイムアウトが可能になる時間の長さを、秒単位で指定してください。

接続タイムアウト

メッセージの送信時に接続がタイムアウトする時間の長さを、秒単位で指定します。 接続のタイムアウトが可能になる時間の長さを、秒単位で指定してください。

持続接続の使用

メッセージの送信時に、持続接続を使用するかどうかを指定します。 このチェック・ボックスを選択すると、持続接続を使用可能にできます。 このオプションが使用できるのは、「プロトコル・バージョン (Protocol version)」フィールドで HTTP 1.1 を選択している場合のみです。 HTTP 1.0 プロトコルを選択した場合、このオプションは選択できません。

再送の有効化

メッセージを再送可能にするかどうかを指定します。 このチェック・ボックスを選択すると、メッセージを再送できるようになります。




マーク付きのリンク (オンライン) では、インターネットにアクセスする必要があります。

関連タスク
関連資料


ファイル名: uwbs_wsspshttp.html