28.4. エンドポイントオプション

httpUri (共通)

必須 呼び出す HTTP エンドポイントの URL。

URI

chunked (producer)

このオプションが false の場合、サーブレットは HTTP ストリーミングを無効にし、応答に content-length ヘッダーを設定します。

true

boolean

disableStreamCache (共通)

サーブレットからの生の入力ストリームがキャッシュされるかどうかを決定します (Camel はストリームをメモリー内/ファイルへのオーバーフロー、ストリームキャッシュに読み込みます)。デフォルトでは、Camel はサーブレット入力ストリームをキャッシュして複数回の読み取りをサポートし、Camel がストリームからすべてのデータを取得できるようにします。ただし、ファイルやその他の永続ストアに直接ストリーミングするなど、生のストリームにアクセスする必要がある場合は、このオプションを true に設定できます。ストリームの複数回の読み取りをサポートするためにこのオプションが false の場合、DefaultHttpBinding は要求入力ストリームをストリームキャッシュにコピーし、それをメッセージ本文に入れます。サーブレットを使用してエンドポイントをブリッジ/プロキシーする場合、メッセージペイロードを複数回読み取る必要がない場合は、このオプションを有効にしてパフォーマンスを向上させることを検討してください。http producer は、デフォルトで応答本文ストリームをキャッシュします。このオプションを true に設定すると、プロデューサは応答本文ストリームをキャッシュせず、応答ストリームをそのままメッセージ本文として使用します。

false

boolean

headerFilterStrategy (共通)

カスタムの HeaderFilterStrategy を使用して、Camel メッセージとの間でヘッダーをフィルタリングします。

HeaderFilterStrategy

httpBinding (common (上級))

カスタム HttpBinding を使用して、Camel メッセージと HttpClient との間のマッピングを制御します。

HttpBinding

bridgeEndpoint (producer)

オプションが true の場合、HttpProducer は Exchange.HTTP_URI ヘッダーを無視し、エンドポイントの URI を要求に使用します。オプション throwExceptionOnFailure を false に設定して、HttpProducer がすべての障害応答を送り返すようにすることもできます。

false

boolean

clearExpiredCookies (producer)

HTTP リクエストを送信する前に期限切れの Cookie をクリアするかどうか。これにより、有効期限が切れたときに削除される新しい Cookie を追加することで、Cookie ストアが成長し続けることがなくなります。コンポーネントが Cookie 管理を無効にしている場合、このオプションも無効になります。

true

boolean

connectionClose (producer)

Connection Close ヘッダーを HTTP 要求に追加する必要があるかどうかを指定します。デフォルトでは、connectionClose は false です。

false

boolean

copyHeaders (producer)

このオプションが true の場合、IN 交換ヘッダーは、コピー戦略に従って OUT 交換ヘッダーにコピーされます。これを false に設定すると、HTTP 応答からのヘッダーのみを含めることができます (IN ヘッダーは伝播されません)。

true

boolean

customHostHeader (producer)

producer のカスタムホストヘッダーを使用するには。クエリーで設定されていない場合は無視されます。設定すると、url から派生したホストヘッダーが上書きされます。

String

httpMethod (producer)

使用する HTTP メソッドを設定します。設定されている場合、HttpMethod ヘッダーはこのオプションをオーバーライドできません。

列挙値:

HttpMethods

ignoreResponseBody (producer)

このオプションが true の場合、http producer は応答本文を読み取らず、入力ストリームをキャッシュしません。

false

boolean

lazyStartProducer (producer)

最初のメッセージで producer をレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。

false

boolean

preserveHostHeader (producer)

オプションが true の場合、HttpProducer は Host ヘッダーを現在の Exchange Host ヘッダーに含まれる値に設定します。これは、ダウンストリームサーバーが受信した Host ヘッダーにアップストリームクライアントが呼び出した URL を反映させたいリバースプロキシーアプリケーションで役立ちます。Host ヘッダーを使用するアプリケーションが、プロキシーされたサービスの正確な URL を生成できるようにします。

false

boolean

throwExceptionOnFailure (producer)

リモートサーバーからの応答が失敗した場合に HttpOperationFailedException を出力することを無効にするオプション。これにより、HTTP ステータスコードに関係なくすべての応答を取得できます。

true

boolean

transferException (producer)

有効にすると、エクスチェンジが consumer 側で処理に失敗し、発生した例外が application/x-java-serialized-object コンテンツタイプとして応答でシリアライズされた場合に、例外がシリアライズされました。producer 側では、例外がデシリアライズされ、HttpOperationFailedException ではなくそのまま出力されます。原因となった例外はシリアライズする必要があります。これは、デフォルトでオフになっています。これを有効にすると、Java が受信データをリクエストから Java にデシリアライズし、セキュリティー上のリスクが生じる可能性があることに注意してください。

false

boolean

cookieHandler (producer (上級))

HTTP セッションを維持するように Cookie ハンドラーを設定します。

CookieHandler

cookieStore (producer (上級))

カスタム CookieStore を使用するには。デフォルトでは、メモリー内のみの Cookie ストアである BasicCookieStore が使用されます。bridgeEndpoint=true の場合、Cookie ストアは強制的に noop cookie ストアになることに注意してください。これは、単にブリッジしているだけであるため (たとえば、プロキシーとして動作するため)、Cookie を保存するべきではないためです。cookieHandler が設定されている場合、cookie の処理は cookieHandler によって実行されるため、cookie ストアも強制的に noop cookie ストアになります。

CookieStore

deleteWithBody (producer (上級))

HTTP DELETE にメッセージ本文を含めるかどうか。デフォルトでは、HTTP DELETE には HTTP 本文は含まれません。ただし、ごくまれに、ユーザーがメッセージ本文を含める必要がある場合があります。

false

boolean

getWithBody (producer (上級))

HTTP GET にメッセージ本文を含めるかどうか。デフォルトでは、HTTP GET には HTTP 本文は含まれません。ただし、ごくまれに、ユーザーがメッセージ本文を含める必要がある場合があります。

false

boolean

okStatusCodeRange (producer (上級))

正常な応答と見なされるステータスコード。値は含まれます。複数の範囲をコンマで区切って定義できます (例: 200-204,209,301-304)。各範囲は、ダッシュを含む 1 つの数字または from-to である必要があります。

200-299

String

skipRequestHeaders (producer (上級))

すべての Camel ヘッダーを HTTP リクエストヘッダーとしてマッピングすることをスキップするかどうか。HTTP 要求に含める必要がある Camel ヘッダーからのデータがない場合は、これにより、JVM ガベージコレクターの多くのオブジェクト割り当てによるオーバーヘッドの解析を回避できます。

false

boolean

skipResponseHeaders (producer (上級))

すべての HTTP 応答ヘッダーの Camel ヘッダーへのマッピングをスキップするかどうか。HTTP ヘッダーから必要なデータがない場合は、これにより、JVM ガベージコレクターの多くのオブジェクト割り当てによる解析のオーバーヘッドを回避できます。

false

boolean

userAgent (producer (上級))

カスタム HTTP User-Agent 要求ヘッダーを設定します。

String

clientBuilder (上級)

このエンドポイントの producer または consumer によって使用される新しい RequestConfig インスタンスで使用される http クライアント要求パラメーターへのアクセスを提供します。

HttpClientBuilder

clientConnectionManager (上級)

カスタム HttpClientConnectionManager を使用して接続を管理するには。

HttpClientConnectionManager

connectionsPerRoute (上級)

ルートごとの接続の最大数。

20

int

httpClient (上級)

producer が使用するカスタム HttpClient を設定します。

HttpClient

httpClientConfigurer (上級)

認証メカニズムなどを設定するために、producer または consumer によって作成された新しい HttpClient インスタンスのカスタム設定戦略を登録します。

HttpClientConfigurer

httpClientOptions (上級)

マップのキー/値を使用して HttpClient を設定するには。

Map

httpContext (上級)

カスタム HttpContext インスタンスを使用します。

HttpContext

maxTotalConnections (上級)

接続の最大数。

200

int

useSystemProperties (上級)

システムプロパティーを設定のフォールバックとして使用します。

false

boolean

proxyAuthDomain (プロキシー)

NTML で使用するプロキシー認証ドメイン。

String

proxyAuthHost (プロキシー)

プロキシー認証ホスト。

String

proxyAuthMethod (プロキシー)

使用するプロキシー認証方法。

列挙値:

String

proxyAuthNtHost (プロキシー)

NTML で使用するプロキシー認証ドメイン (ワークステーション名)。

String

proxyAuthPassword (プロキシー)

プロキシー認証パスワード。

String

proxyAuthPort (プロキシー)

プロキシー認証ポート。

int

proxyAuthScheme (プロキシー)

使用するプロキシー認証スキーム。

列挙値:

String

proxyAuthUsername (プロキシー)

プロキシー認証のユーザー名。

String

proxyHost (プロキシー)

使用するプロキシーホスト名。

String

proxyPort (プロキシー)

使用するプロキシーポート。

int

authDomain (セキュリティー)

NTML で使用する認証ドメイン。

String

authenticationPreemptive (セキュリティー)

このオプションが true の場合、camel-http はプリエンプティブ基本認証をサーバーに送信します。

false

boolean

authHost (セキュリティー)

NTML で使用する認証ホスト。

String

authMethod (security)

Basic、Digest、または NTLM の値のコンマ区切りリストとして使用できる認証方法。

String

authMethodPriority (security)

基本、ダイジェスト、または NTLM のいずれかとして、優先して使用する認証方法。

列挙値:

String

authPassword (セキュリティー)

認証パスワード。

String

authUsername (セキュリティー)

認証ユーザー名。

String

sslContextParameters (security)

SSLContextParameters を使用してセキュリティーを設定する場合。重要: HttpComponent ごとにサポートされる org.apache.camel.util.jsse.SSLContextParameters のインスタンスは 1 つだけです。2 つ以上の異なるインスタンスを使用する必要がある場合は、必要なインスタンスごとに新しい HttpComponent を定義する必要があります。

SSLContextParameters

x509HostnameVerifier (セキュリティー)

DefaultHostnameVerifier や NoopHostnameVerifier などのカスタム X509HostnameVerifier を使用します。

HostnameVerifier