Menu Close
12.2.2. 設定の使用
namespace
HTTP コンシューマーエンドポイントの設定に使用される要素は、namespace http://cxf.apache.org/transports/http/configuration で定義されます。通常、プレフィックス http-conf
を使用して参照されます。HTTP 設定要素を使用するには、例12.4「HTTP コンシューマー設定 namespace」 にある行をエンドポイント設定ファイルの beans
要素に追加する必要があります。また、設定要素の namespace を xsi:schemaLocation
属性に追加する必要があります。
例12.4 HTTP コンシューマー設定 namespace
<beans ... xmlns:http-conf="http://cxf.apache.org/transports/http/configuration" ... xsi:schemaLocation="... http://cxf.apache.org/transports/http/configuration http://cxf.apache.org/schemas/configuration/http-conf.xsd ...">
Undertow ランタイムまたは Netty ランタイム
http-conf
namespace の要素を使用して、Undertow ランタイムまたは Netty ランタイムを設定できます。
conduit 要素
http-conf:conduit
要素およびその子を使用して HTTP コンシューマーエンドポイントを設定します。http-conf:conduit
要素は、エンドポイントに対応する WSDL port
要素を指定する単一の属性 name
を取ります。name
属性の値は、portQName`.http-conduit` の形式を取ります。例12.5「http-conf:conduit
要素」 は、エンドポイントのターゲット namespace が http://widgets.widgetvendor.net の場合に WSDL フラグメント <port binding="widgetSOAPBinding" name="widgetSOAPPort>
によって指定されるエンドポイントの設定を追加するために使用される http-conf:conduit
要素を示しています。
例12.5 http-conf:conduit
要素
... <http-conf:conduit name="{http://widgets/widgetvendor.net}widgetSOAPPort.http-conduit"> ... </http-conf:conduit> ...
http-conf:conduit
要素には設定情報を指定する子要素があります。これらについては、表12.1「HTTP コンシューマーエンドポイントの設定に使用される要素」 を参照してください。
表12.1 HTTP コンシューマーエンドポイントの設定に使用される要素
要素 | 説明 |
---|---|
| タイムアウト、キープアライブリクエスト、コンテンツ型など、HTTP コネクションプロパティーを指定します。「client 要素」 を参照してください。 |
エンドポイントが先行で使用する Basic 認証方法を設定するパラメーターを指定します。優先される方法は | |
送信 HTTP プロキシーサーバーに対して Basic 認証を設定するパラメーターを指定します。 | |
SSL/TLS の設定に使用されるパラメーターを指定します。 | |
先制的または 401 HTTP チャレンジに応答して、エンドポイントによって使用される Basic 認証情報を提供するオブジェクトの Bean 参照またはクラス名を指定します。 | |
情報送信前に HTTPS サービスプロバイダーとのコネクションに対して信頼を確立するために HTTP(S) |
client 要素
http-conf:client
要素は、コンシューマーエンドポイントの HTTP コネクションのセキュリティー以外のプロパティーを設定するために使用されます。表12.2「HTTP コンシューマー設定属性」 に記載されているその属性は、コネクションのプロパティーを指定します。
表12.2 HTTP コンシューマー設定属性
属性 | 説明 |
---|---|
コンシューマーがタイムアウトするまでにコネクションを確立しようとする時間 (ミリ秒単位) を指定します。デフォルトは
| |
応答がタイムアウトするまでコンシューマーが待機する時間をミリ秒単位で指定します。デフォルトは
| |
コンシューマがサーバー発行のリダイレクトを自動的にフォローするかどうかを指定します。デフォルトは | |
コンシューマがリダイレクトを満たすためにリクエストを再送信する最大回数を指定します。デフォルトは | |
コンシューマーがチャンクを使用してリクエストを送信するかどうかを指定します。デフォルトは 次のいずれかに当てはまる場合、チャンクは使用できません。
いずれの場合も、 | |
コンシューマが処理する準備ができているメディア型を指定します。値は HTTP | |
コンシューマが応答を受信する目的で優先される言語 (アメリカ英語など) を指定します。値は HTTP 言語タグは、国際標準化機構 (ISO) によって規制されており、通常は ISO-639 規格で定められた言語コードと、ISO-3166 規格で定められた国コードをハイフンで区切って組み合わせて形成されます。たとえば、en-US はアメリカ英語を表します。 | |
コンシューマが処理する準備ができているコンテンツエンコーディングを指定します。コンテンツエンコーディングラベルは、Internet Assigned Numbers Authority (IANA) によって規制されています。値は HTTP | |
メッセージのボディーで送信されるデータのメディア型を指定します。メディア型は、MIME 型を使用して指定されます。値は HTTP
Web サービスの場合、これを | |
要求が呼び出されるリソースのインターネットホストおよびポート番号を指定します。値は HTTP 通常、この属性は必要ありません。これは、特定の DNS シナリオまたはアプリケーション設計でのみ必要です。たとえば、クライアントがクラスターでどのホストを優先するか (つまり、仮想サーバーの同じインターネットプロトコル (IP) アドレスへのマッピング) を示します。 | |
各要求/応答ダイアログの後で、特定のコネクションを開いたままにするか、閉じるかを指定します。有効な値は 2 つあります。
| |
コンシューマからサービスプロバイダーへのリクエストで構成されるチェーンに関与するキャッシュが厳守しなければならない動作に関するディレクティブを指定します。「コンシューマーキャッシュ制御ディレクティブ」 を参照してください。 | |
すべてのリクエストで送信される静的クッキーを指定します。 | |
リクエストの発信元のブラウザーに関する情報を指定します。World Wide Web Consortium (W3C) からの HTTP 仕様では、ユーザーエージェント とも呼ばれます。一部のサーバーは、リクエストを送信しているクライアントを基にして最適化されています。 | |
特定のサービスでリクエストを行うようにコンシューマに指示したリソースの URL を指定します。値は HTTP この HTTP プロパティーは、ブラウザユーザーが URL を入力した結果のリクエストではなく、ハイパーリンクをクリックした結果のリクエストである場合に使用されます。これにより、サーバーは以前のタスクフローに基づいて処理を最適化でき、ロギング、最適化されたキャッシュ、廃止されたリンクや入力ミスのリンクの追跡などのために、リソースへのバックリンクの一覧を生成できます。ただし、通常は web サービスアプリケーションでは使用されません。
| |
個別のプロバイダー→コンシューマーコネクション上で応答を受信するための分離エンドポイントの URL を指定します。分離されたエンドポイントの使用に関する詳細は、「分離モードでの HTTP トランスポートの使用」 を参照してください。 分散されたエンドポイントが機能するには、コンシューマーエンドポイントとサービスプロバイダーエンドポイントの両方を WS-Addressing を使用するように設定する必要があります。 | |
要求がルーティングされるプロキシーサーバーの URL を指定します。 | |
要求がルーティングされるプロキシーサーバーのポート番号を指定します。 | |
要求をルーティングするために使用されるプロキシーサーバーの型を指定します。有効な値は次のとおりです。
|
例
例12.6「HTTP コンシューマーエンドポイントの設定」 は、リクエスト間で、プロバイダーへのコネクションを開いたままにする HTTP コンシューマーエンドポイントの設定を示しています。これは、呼び出しごとにリクエストを 1 度だけ再送信し、チャンキングストリームを使用できません。
例12.6 HTTP コンシューマーエンドポイントの設定
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:http-conf="http://cxf.apache.org/transports/http/configuration" xsi:schemaLocation="http://cxf.apache.org/transports/http/configuration http://cxf.apache.org/schemas/configuration/http-conf.xsd http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd"> <http-conf:conduit name="{http://apache.org/hello_world_soap_http}SoapPort.http-conduit"> <http-conf:client Connection="Keep-Alive" MaxRetransmits="1" AllowChunking="false" /> </http-conf:conduit> </beans>
詳細情報
HTTP コンジットの詳細は、16章コンジット を参照してください。