HTTP Connector 1.9 リファレンス - Mule 4

HTTP 用 Anypoint Connector (HTTP Connector) を使用して、HTTP 要求を処理および実行します。このクラスは、拡張定義としてのみ機能します。このコネクタの設定は、サーバー機能 (​<http:listener-config>​) とクライアント機能 (​<http:requester-config>​) に分けられます。

リリースノート: HTTP Connector Release Notes​ (HTTP Connector リリースノート)

設定


リスナー設定

HttpListener の設定要素。

パラメーター

名前 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定できる接続種別。

x

Base Path (ベースパス)

String (文字列)

この設定を参照するすべての要求で使用されるベースパス。

Listener Interceptor (リスナーインターセプター)

要求および応答イベントに適用されるリスナーインターセプター。

Reject Invalid Transfer Encoding (無効な転送エンコードを拒否)

Boolean (ブール)

true​ の場合、Transfer-Encoding ヘッダーの値が無効の要求は拒否され、400 Bad Request (400 不正な要求) メッセージが表示されます。有効な値は ​chunked​、​deflate​、​compress​、​identity​、​gzip​ です。これらの値は、​RFC-7230​ と ​RFC-2616​ で定義されます。

false

接続種別

リスナー

HttpListener の接続プロバイダーで、HttpServer インスタンスの作成を処理します。

パラメーター
名前 説明 デフォルト値 必須

TLS Configuration (TLS 設定)

TLS

TLS 設定要素への参照。これにより、この設定で HTTPS が有効になります。

Protocol (プロトコル)

Enumeration (列挙)。次のいずれかになります。

  • HTTP

  • HTTPS

通信に使用するプロトコル。有効な値は HTTP と HTTPS です。デフォルト値は HTTP です。HTTPS を使用すると、HTTP 通信が TLS/SSL を使用して保護されます。プロトコルとして HTTPS が設定されている場合、ユーザーはこの listener-config の tls:context 子要素で少なくともキーストアを設定する必要があります。

HTTP

Host (ホスト)

String (文字列)

要求の送信先となるホスト。

x

Port (ポート)

Number (数値)

要求が受信されるポート。

x

Use Persistent Connections (永続接続を使用)

Boolean (ブール)

false の場合、各接続は最初の要求が完了すると終了します。

true

Connection Idle Timeout (接続アイドルタイムアウト)

Number (数値)

接続が終了するまでのアイドル状態を維持できるミリ秒。この属性の値は、永続接続が有効になっている場合にのみ使用されます。タイムアウトの発生直前に既存の接続で要求を送信した場合の Remotely Closed (リモート終了) 例外を回避するために、リスナーのデフォルトの接続アイドルタイムアウトはリクエスターのデフォルトの接続アイドルタイムアウトより大きくなります。

40000

Read Timeout (読み取りタイムアウト)

Number (数値)

リスナーがメッセージの受信中に待機する必要がある最大時間 (ミリ秒単位)。

30000

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

関連付けられたソース


要求設定

HTTP 要求の設定要素。

パラメーター

名前 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定できる接続種別。

x

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Runtime で期限切れに相当するとみなされます。これは、対象になった瞬間にプラットフォームでインスタンスの有効期限が切れるという意味ではありません。ランタイムによって適切と判断されたときに、インスタンスが実際にパージされます。

Base Path (ベースパス)

String (文字列)

この設定を参照するすべての要求で使用されるベースパス。

/

Follow Redirects (リダイレクトをフォロー)

Boolean (ブール)

リダイレクトをフォローするかどうかを示します。デフォルト値は true です。

true

Send Body Mode (本文送信モード)

Enumeration (列挙)。次のいずれかになります。

  • ALWAYS

  • AUTO

  • NEVER

要求に本文が含まれる必要があるかどうかを定義します。AUTO (自動) の場合、メソッドに応じて異なります (GET、HEAD、および OPTIONS では本文は送信されません)。

AUTO

Request Streaming Mode (要求ストリーミングモード)

Enumeration (列挙)。次のいずれかになります。

  • AUTO

  • ALWAYS

  • NEVER

要求をストリーミングで送信する必要があるかどうかを定義します。この属性が存在しない場合、動作はペイロードの種別に応じて異なります (ストリーミングするのは InputStream の場合のみ)。true に設定されている場合、常にストリーミングします。false に設定されている場合、一切ストリーミングしません。ストリーミングの実行時、要求はユーザーに Transfer-Encoding: chunked で送信されます。

AUTO

Enable Cookies (Cookie を有効化)

Boolean (ブール)

true の場合、HTTP 応答で受信した Cookie は保存され、後続の HTTP 要求で送信されます。

true

Default Headers (デフォルトヘッダー)

メッセージに含まれる必要があるデフォルト HTTP ヘッダー。

クエリパラメーター

応答に含まれる必要があるデフォルトクエリパラメーター。

Send Correlation Id (送信相関 ID)

Enumeration (列挙)。次のいずれかになります。

  • AUTO

  • ALWAYS

  • NEVER

メッセージをパブリッシュするときに相関 id を指定するかどうか。操作レベルで指定されるカスタム相関 id と、現在のイベントから引用されるデフォルト相関 id の両方に適用されます。

AUTO

Preserve Headers Case (ヘッダーの文字を保持)

Boolean (ブール)

デフォルトでは、ヘッダーキーは内部的に小文字で保存されます。これは、ヘッダー処理のパフォーマンス向上が目的で、RFC の仕様どおりに正しく機能します。<p> サーバーが特定の文字のヘッダーを期待している場合、このフラグを true に設定してヘッダーキーの文字を保持できます。

false

Response Timeout (応答タイムアウト)

Number (数値)

要求要素が HTTP 応答を待機中のフローの実行をブロックする最大時間 (ミリ秒)。この値が存在しない場合、コネクタは Mule 設定のデフォルトの応答タイムアウト (10000) を使用します。

10000

Response Validator (応答バリデーター)

応答のデフォルトのエラー処理を設定します。

接続種別

Request

HTTP 要求の接続プロバイダーで、HttpExtensionClient インスタンスの作成を処理します。

パラメーター
名前 説明 デフォルト値 必須

Proxy Config (プロキシ設定)

次のいずれかになります。

プロキシ経由のアウトバウンド接続の再利用可能な設定要素。プロキシ要素では、必ずホスト名およびポート属性を定義し、必要に応じてユーザー名とパスワードを定義できます。

Authentication (認証)

HTTP 要求で使用する認証方式。

TLS Configuration (TLS 設定)

TLS

TLS 設定要素への参照。これにより、この設定で HTTPS が有効になります。

Protocol (プロトコル)

Enumeration (列挙)。次のいずれかになります。

  • HTTP

  • HTTPS

通信に使用するプロトコル。有効な値は HTTP と HTTPS です。デフォルト値は HTTP です。HTTPS を使用すると、HTTP 通信が TLS/SSL を使用して保護されます。HTTPS がプロトコルとして設定された場合、この listener-config の ​tls:context​ 子要素を定義することで、ユーザーが tls/SSL 設定をカスタマイズできます。​tls:context​ が定義されていない場合、デフォルトの JVM 証明書が通信の確立に使用されます。

HTTP

Host (ホスト)

String (文字列)

要求の送信先となるホスト。

Port (ポート)

Number (数値)

要求の送信先となるポート。プロトコル属性が HTTP (デフォルト) の場合、デフォルト値は 80、プロトコル属性が HTTPS の場合、デフォルト値は 443 です。

Use Persistent Connections (永続接続を使用)

Boolean (ブール)

false の場合、各接続は最初の要求が完了すると終了します。

true

Max Connections (最大接続数)

Number (数値)

同時に開いた状態にできるアウトバウンド接続の最大数。デフォルトでは、接続数は無制限です。最大接続数の値を設定するとメモリ使用量を制限できますが、スループットが低下する可能性があります。

-1

Connection Idle Timeout (接続アイドルタイムアウト)

Number (数値)

接続が終了するまでのアイドル状態を維持できるミリ秒。この属性の値は、永続接続が有効になっている場合にのみ使用されます。

30000

Stream Response (応答のストリーミング)

Boolean (ブール)

受信応答をストリーミングする必要があるかどうか。つまり、すべてのヘッダーが解析されたらすぐに処理を続行し、本文は到着するとストリーミングされます。設定されたバッファサイズによっては、メモリに収まらず、容量が空くまで処理が停止する可能性があるため、有効になっている場合は徐々に応答を読み取る必要があります。

false

Response Buffer Size (応答バッファサイズ)

Number (数値)

HTTP 応答が保存されるバッファの領域 (バイト)。

-1

Client Socket Properties (クライアントソケットのプロパティ)

クライアントソケットのプロパティが設定されます。

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

関連操作

操作

要求

<http:request>

HTTP サービスをコンシュームします。

パラメーター

名前 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Method (メソッド)

String (文字列)

要求の HTTP メソッド。

GET

Streaming Strategy (ストリーミング戦略)

反復可能ストリームを使用すべきかどうか、およびその動作を設定します。

Path (パス)

String (文字列)

要求の送信先となるパス。

URL

String (文字列)

要求を送信する URL。

Follow Redirects (リダイレクトをフォロー)

Boolean (ブール)

リダイレクトをフォローするかどうかを示します。

Send Body Mode (本文送信モード)

Enumeration (列挙)。次のいずれかになります。

  • ALWAYS

  • AUTO

  • NEVER

要求に本文が含まれる必要があるかどうかを定義します。

Request Streaming Mode (要求ストリーミングモード)

Enumeration (列挙)。次のいずれかになります。

  • AUTO

  • ALWAYS

  • NEVER

要求をストリーミングで送信する必要があるかどうかを定義します。

Response Timeout (応答タイムアウト)

Number (数値)

要求要素が HTTP 応答を待機中のフローの実行をブロックする最大時間 (ミリ秒)。

Body (本文)

Any (いずれか)

応答メッセージの本文。

#[payload]

Headers (ヘッダー)

Object (オブジェクト)

メッセージに含まれる必要がある HTTP ヘッダー。

URI パラメーター

Object (オブジェクト)

要求の作成に使用する必要がある URI パラメーター。

クエリパラメーター

Object (オブジェクト)

要求に含まれる必要があるクエリパラメーター。

Send Correlation Id (送信相関 ID)

Enumeration (列挙)。次のいずれかになります。

  • AUTO

  • ALWAYS

  • NEVER

アウトバウンド相関 ID を含めるかどうかのオプション

Correlation Id (相関 ID)

String (文字列)

カスタム相関 ID の設定を許可します。

Response Validator (応答バリデーター)

応答のエラー処理を設定します。

Target Variable (対象変数)

String (文字列)

操作の出力が格納される変数の名前

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。その式の結果は対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。この項目はこの操作では使用しません。

出力

Any (いずれか)

Attributes Type (属性型)

設定。

スロー

  • HTTP:BAD_REQUEST

  • HTTP:CLIENT_SECURITY

  • HTTP:CONNECTIVITY

  • HTTP:FORBIDDEN

  • HTTP:INTERNAL_SERVER_ERROR

  • HTTP:METHOD_NOT_ALLOWED

  • HTTP:NOT_ACCEPTABLE

  • HTTP:NOT_FOUND

  • HTTP:PARSING

  • HTTP:RETRY_EXHAUSTED

  • HTTP:SECURITY

  • HTTP:SERVICE_UNAVAILABLE

  • HTTP:TIMEOUT

  • HTTP:TOO_MANY_REQUESTS

  • HTTP:UNAUTHORIZED

  • HTTP:UNSUPPORTED_MEDIA_TYPE

  • HTTP:BAD_GATEWAY

  • HTTP:GATEWAY_TIMEOUT

Basic Security Filter

<http:basic-security-filter>

受信した HTTP 要求を認証します。リスナーコンポーネントの後に使用する必要があります。

パラメーター

名前 説明 デフォルト値 必須

Realm (レルム)

String (文字列)

認証レルム。

x

セキュリティプロバイダー

Array of String (文字列の配列)

認証に使用する代理セキュリティプロバイダー。設定内に複数のセキュリティマネージャーが定義されている場合に使用します。

Attributes (属性)

Authorization​ ヘッダーを確認するための HTTP リスナーソースからの HttpRequestAttributes。

#[attributes]

スロー

  • HTTP:BASIC_AUTHENTICATION

  • MULE:SERVER_SECURITY

Load Static Resource

<http:load-static-resource>

この静的リソースにより、HTTP で使用する静的コンテンツが提供されます。要求パスはリソースの検索に使用されます。

パラメーター

名前 説明 デフォルト値 必須

Resource Base Path (リソースベースパス)

String (文字列)

ドキュメントの提供元であるリソースベース。例: /Users/maxthemule/resources

x

Default File (デフォルトファイル)

String (文字列)

ディレクトリが指定されたときに提供するデフォルトファイル。デフォルト値は ​index.html​ です。

index.html

Attributes (属性)

必須リソースを確認するための HTTP リスナーソースからの HttpRequestAttributes。

#[attributes]

Target Variable (対象変数)

String (文字列)

操作の出力が格納される変数の名前

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は対象変数に保存されます。

#[payload]

出力

Any (いずれか)

Attributes Type (属性型)

Any (いずれか)

スロー

  • HTTP:NOT_FOUND

ソース

リスナー

<http:listener>

HTTP 要求のリスナーを表します。

パラメーター

名前 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Path (パス)

String (文字列)

HTTP リスナー設定で指定されたパスからの相対パス。

x

Allowed Methods (許可されるメソッド)

String (文字列)

このリスナーで許可される HTTP メソッドのカンマ区切りリスト。すべてのメソッドを許可する場合は、この属性を定義しないでください。

Response Streaming Mode (応答ストリーミングモード)

Enumeration (列挙)。次のいずれかになります。

  • AUTO

  • ALWAYS

  • NEVER

応答をストリーミングで送信する必要があるかどうかを定義します。この属性が存在しない場合、動作はペイロードの種別に応じて異なります (ストリーミングするのは InputStream の場合のみ)。true に設定されている場合、常にストリーミングします。false に設定されている場合、一切ストリーミングしません。ストリーミングの実行時、応答はユーザーに Transfer-Encoding: chunked で送信されます。

AUTO

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの実行時、このソースをプライマリノード上でのみ実行する必要があるかどうか。

Streaming Strategy (ストリーミング戦略)

反復可能ストリームを使用すべきかどうか、およびその動作を設定します。

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシー。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Body (本文)

Any (いずれか)

応答メッセージの本文。

#[payload]

Headers (ヘッダー)

Object (オブジェクト)

メッセージに含まれる必要がある HTTP ヘッダー。

Status Code (状況コード)

Number (数値)

応答に含まれる必要がある HTTP 状況コード。

Reason Phrase (理由を示す語句)

String (文字列)

応答に含まれる必要がある HTTP の理由を示す語句。

出力

Any (いずれか)

Attributes Type (属性型)

設定。

ポーリング入力元

<http:polling-source>​ 指定された HTTP サーバーに対して、スケジュールされた HTTP 要求を実行するイベントソース。

パラメーター

名前 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Path (パス)

String (文字列)

HTTP Request 操作設定で指定されたパスからの相対パス。

Method (メソッド)

String (文字列)

HTTP 要求メソッド

GET

Response Validator (応答バリデーター)

接続テストの応答に適用される検証。

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

On Capacity Overload (容量過負荷時)

Enumeration (列挙)。次のいずれかになります。 DROP WAIT ** FAIL

フローで管理可能な容量を超えたメッセージを受信した場合に Mule が適用する戦略。

WAIT

Scheduling Strategy (スケジュール戦略)

scheduling-strategy

ポーリングをトリガーするスケジューラーを設定します。

x

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。反復可能ストリームは、デフォルトの動作です。

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Body (本文)

String (文字列)

応答メッセージの本文。

Headers (ヘッダー)

pollingRequestHeader の配列

メッセージに含まれる HTTP ヘッダー。

URI パラメーター

pollingRequestUriParam の配列

要求の作成に使用する URI パラメーター。

Query Parameters (クエリパラメーター)

pollingRequestQueryParam の配列

要求に含まれるクエリパラメーター。

Split Expression (分割式)

String (文字列)

応答に適用される分割式。

Watermark Expression (ウォーターマーク式)

String (文字列)

(分割) 応答からウォーターマークを取得する式。

Id Expression (ID 式)

String (文字列)

各 (分割) 項目から ID を取得する式。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

出力

Any (いずれか)

Attributes Type (属性型)

次の設定の場合

TLS

設定の HTTPS を有効にする TLS 設定要素への参照。

項目 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

TLS 用のトラストストアを設定します。

Key Store (キーストア)

TLS プロトコル用のキーストアを設定します。生成したキーストアには、非公開キーと公開証明書が格納されます。

Revocation Check (取り消し確認)

TLS の取り消し確認を設定します。

トラストストア

TLS 用のトラストストアを設定します。

項目 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

使用するストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用するアルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true の場合、証明書の検証が行われず、攻撃に対して脆弱な接続がレンダリングされます。各自の責任で使用してください。

Key Store (キーストア)

TLS プロトコル用のキーストアを設定します。生成したキーストアには、非公開キーと公開証明書が格納されます。

項目 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアの場所 (可能であれば、現在のクラスパスとファイルシステムに対して解決されます)。

Type (型)

String (文字列)

使用するストアの型。

Alias (別名)

String (文字列)

キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、ファイルにある最初のキーがデフォルトで使用されます。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用するアルゴリズム。

Standard Revocation Check (標準の取り消し確認)

TLS 証明書の標準取り消し確認を設定します。

項目 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーンの最後の要素のみを確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

最初に OCSP ではなく CRL を試みます。

No Fallback (代替なし)

Boolean (ブール)

第 2 の確認方法 (以前に選択されていない方法) を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。

Custom OCSP Responder (カスタム OCSP レスポンダー)

証明書の取り消し確認のカスタム OCSP レスポンダーを設定します。

項目 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。

CRL File (CRL ファイル)

証明書失効リスト (CRL) ファイルの場所を指定します。

項目 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。

Reconnection (再接続)

操作の再接続戦略を設定します。

項目 説明 デフォルト値 必須

Fails Deployment (デプロイに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。trure に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

Reconnect (再接続)

標準再接続戦略を設定し、再接続の頻度と、コネクタソースまたは操作で実行できる再接続の試行回数を指定します。

項目 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

Reconnect Forever (繰り返し再接続)

Mule アプリケーションが実行されている間はコネクタソースや操作によって指定された頻度で再接続が試行される Forever 再接続戦略を設定します。

項目 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

CORS Interceptor Wrapper (Cors インターセプターラッパー)

項目 説明 デフォルト値 必須

Cors Interceptor (Cors インターセプター)

要求が CORS 仕様に準拠していることを検証し、応答に対して適宜アクションを実行するインターセプター。

x

CORS Listener Interceptor (Cors リスナーインターセプター)

項目 説明 デフォルト値 必須

Allow Credentials (ログイン情報を許可)

Boolean (ブール)

false

Origins (発生源)

Array (配列)。次のいずれかになります。

x

HTTP Request Attributes (HTTP 要求属性)

メッセージ属性の使用方法についての詳細は、​メッセージ属性に関する​ドキュメントを参照してください。

項目 説明 デフォルト値 必須

Listener Path (リスナーパス)

String (文字列)

要求が受信された場所のフルパス。

x

Raw Request Path (未加工要求パス)

String (文字列)

受信時にエンコードされる、要求されたフルパス。 1.5.0 以降

x

相対パス

String (文字列)

ベースパスを考慮しない、要求が受信された場所のパス。

x

Masked Request Path (マスクされた要求パス)

String (文字列)

リスナーパスをマスクし、差異を取り込んで算出されたパス。 これは、null の場合にのみ計算されます。

1.4.0 以降

x

バージョン

String (文字列)

要求の HTTP バージョン。

x

Schema (スキーマ)

String (文字列)

要求の HTTP スキーム。

x

Method (メソッド)

String (文字列)

要求の HTTP メソッド。

x

Request Uri (要求 URI)

String (文字列)

要求の完全 URI。

x

Raw Request Uri (未加工要求 URI)

String (文字列)

受信時にエンコードされる、要求のフル URI。 1.5.0 以降

x

Query String (クエリ文字列)

String (文字列)

要求のクエリ文字列。

x

Local Address (ローカルアドレス)

String (文字列)

サーバーからのローカルホストアドレス。

x

Remote Address (リモートアドレス)

String (文字列)

送信者からのリモートホストアドレス。

x

Client Certificate (クライアント証明書)

Any (いずれか)

クライアント証明書 (双方向 TLS が有効な場合)。

Query Params (クエリパラメーター)

Object (オブジェクト)

解析した文字列からビルドしたクエリパラメーターのマッピング。

x

Uri Params (URI パラメーター)

Object (オブジェクト)

要求パスから抽出した URI パラメーター。

x

Request Path (要求パス)

String (文字列)

要求されたフルパス。

x

Headers (ヘッダー)

Object (オブジェクト)

メッセージ内の HTTP ヘッダーのマッピング。

x

Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

データが最大バッファサイズを超えた場合に要求が失敗するメモリ内ストリーミング戦略を設定します。ユースケースで最適なバッファサイズは、必ずパフォーマンステストを実施して決めてください。

項目 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

これは、ストリームをコンシュームし、ストリームへのランダムアクセスを提供する目的で割り当てられるメモリの容量です。ストリームに含まれているデータがこのバッファに適合できる量を超えている場合、bufferSizeIncrement 属性に従ってバッファが拡張され、上限は maxInMemorySize となります。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、どれだけ拡張するか。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。

Max Buffer Size (最大バッファサイズ)

Number (数値)

これは、バッファで使用できるメモリの最大量。これを超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

これらのすべての属性の単位

Repeatable File Store Stream (反復可能なファイルストアストリーム)

反復可能なファイルストアストリーミング戦略を設定します。この戦略では、ストリームコンテンツの一部がメモリ内に格納されます。ストリームのコンテンツが、設定されたバッファサイズよりも大きい場合、Mule はバッファのコンテンツをディスクにバックアップしてからメモリをクリアします。

項目 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

データをメモリ内に保持するためにストリームで使用できる最大メモリを定義します。これを超えると、コンテンツはディスクにバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

maxInMemorySize で表される単位

Redelivery Policy (再配信ポリシー)

エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。

項目 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

正常に処理されずにプロセス失敗メッセージがトリガーされるまでにメッセージを再配信できる最大回数。

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

使用するセキュアハッシュアルゴリズム。設定しない場合、デフォルトの SHA-256 になります。

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断するために使用する 1 つ以上の式を定義します。このプロパティは、useSecureHash が false の場合にのみ設定できます。

Object Store (オブジェクトストア)

ObjectStore

各メッセージの再配信カウンターが保存されるオブジェクトストア。

TCP クライアントソケットのプロパティ

クライアントソケットのプロパティが設定されます。

項目 説明 デフォルト値 必須

Connection Timeout (接続タイムアウト)

Number (数値)

タイムアウトで失敗する前に、リモートサーバーへの接続中に待機する時間。設定されたリクエスターホストが複数の IP アドレスに解決される場合、ホストはそれぞれの IP アドレスへの接続を試みます。 そのため、すべての接続がタイムアウトになる場合、解決された IP アドレスの数だけグローバル接続タイムアウトの時間が長くなります。

30000

Send Tcp No Delay (遅延なく TCP を送信)

Boolean (ブール)

効率を高めるために送信データを収集して直ちにデータを送信するかどうかを示します。

true

Linger (延長)

Number (数値)

残りのデータが正しく送信されるように、ソケットが閉じるまでにかかるミリ秒単位の時間。

Keep Alive (キープアライブ)

Boolean (ブール)

ソケット接続が長時間未使用のまま開いており接続を使用できない場合にソケット接続を閉じることができるかどうかを示します。

false

Fail On Unresolved Host (ホストを解決できない場合は失敗)

Boolean (ブール)

作成時のソケットがエンドポイントに設定されているホストを解決できない場合に失敗するかどうかを示します。

true

Send Buffer Size (送信バッファサイズ)

Number (数値)

データ送信時のバイト単位のバッファのサイズ。

Receive Buffer Size (受信バッファサイズ)

Number (数値)

データ受信時のバイト単位のバッファのサイズ。

Client Timeout (クライアントタイムアウト)

Number (数値)

ブロック操作で失敗するまでにソケットが待機するミリ秒単位の時間。

Reuse Address (アドレスの再利用)

Boolean (ブール)

ポートをバインドしようとするときに、設定済みのポートを再利用する (​true​) か失敗にする (​false​) かを示します。

true

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。インスタンスが期限切れとみなされた瞬間にインスタンスが期限切れになるという意味ではありません。必要に応じて、インスタンスがパージされます。

項目 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位

Default Header (デフォルトヘッダー)

メッセージに含まれる必要があるデフォルト HTTP ヘッダー。

項目 説明 デフォルト値 必須

Key (キー)

String (文字列)

デフォルト HTTP ヘッダーのキー。

x

Value (値)

String (文字列)

デフォルト HTTP ヘッダーの値。

x

Query Param (クエリパラメーター)

応答に含まれる必要があるデフォルトクエリパラメーター。

項目 説明 デフォルト値 必須

Key (キー)

String (文字列)

デフォルトクエリパラメーターのキー名。

x

Value (値)

String (文字列)

デフォルトクエリパラメーターの値。

x

HTTP Response Attributes (HTTP 応答属性)

メッセージ属性の使用方法についての詳細は、​メッセージ属性に関する​ドキュメントを参照してください。

項目 説明 デフォルト値 必須

Status Code (状況コード)

Number (数値)

応答の HTTP 状況コード。

x

Reason Phrase (理由を示す語句)

String (文字列)

応答の HTTP の理由を示す語句。

x

Headers (ヘッダー)

Object (オブジェクト)

メッセージ内の HTTP ヘッダーのマッピング。

x

基本認証

基本認証メソッドを使用すると、HTTP ユーザーエージェントは HTTP 要求を行うときにユーザー名とパスワードを指定できます。

項目 説明 デフォルト値 必須

Username (ユーザー名)

String (文字列)

認証するユーザー名。

x

Password (パスワード)

String (文字列)

認証するパスワード。

x

Preemptive (プリエンプティブ)

Boolean (ブール)

認証をプリエンプティブにする必要があるかどうかを設定します。プリエンプティブ認証では、認証ヘッダーを、401 応答コードを待機してから送信するのではなく、最初の要求で送信します。

true

ダイジェスト認証

ダイジェスト認証メソッドを使用すると、Web サーバーはユーザーの Web ブラウザーを介してユーザーログイン情報を検証できます。

項目 説明 デフォルト値 必須

Username (ユーザー名)

String (文字列)

認証するユーザー名。

x

Password (パスワード)

String (文字列)

認証するパスワード。

x

Preemptive (プリエンプティブ)

Boolean (ブール)

認証をプリエンプティブにする必要があるかどうかを設定します。プリエンプティブ認証では、認証ヘッダーを、401 応答コードを待機してから送信するのではなく、最初の要求で送信します。

true

NTLM 認証

NT LAN Manager (NTLM) 認証で、以前の Microsoft 製品である Microsoft LAN Manager (LANMAN) の認証プロトコルが置き換えられました。

項目 説明 デフォルト値 必須

Domain (ドメイン)

String (文字列)

認証するドメイン。

Workstation (ワークステーション)

String (文字列)

認証するワークステーション。

Username (ユーザー名)

String (文字列)

認証するユーザー名。

x

Password (パスワード)

String (文字列)

認証するパスワード。

x

Preemptive (プリエンプティブ)

Boolean (ブール)

認証をプリエンプティブにする必要があるかどうかを設定します。プリエンプティブ認証では、認証ヘッダーを、401 応答コードを待機してから送信するのではなく、最初の要求で送信します。

true

Proxy (プロキシ)

プロキシ経由のアウトバウンド接続の再利用可能な設定要素。プロキシ要素では、必ずホスト名およびポート属性を定義し、必要に応じてユーザー名とパスワードを定義できます。

項目 説明 デフォルト値 必須

Host (ホスト)

String (文字列)

プロキシ要求の送信先となるホスト。

x

Port (ポート)

Number (数値)

プロキシ要求の送信先となるポート。

x

Username (ユーザー名)

String (文字列)

プロキシに対して認証するユーザー名。

Password (パスワード)

String (文字列)

プロキシに対して認証するパスワード。

Non Proxy Hosts (非プロキシホスト)

String (文字列)

プロキシの使用対象にならないカンマ区切りホストのリスト。

NTLM Proxy (NTLM プロキシ)

項目 説明 デフォルト値 必須

Ntlm Domain (NTLM ドメイン)

String (文字列)

プロキシに対して認証するドメイン。

x

Host (ホスト)

String (文字列)

プロキシ要求の送信先となるホスト。

x

Port (ポート)

Number (数値)

プロキシ要求の送信先となるポート。

x

Username (ユーザー名)

String (文字列)

プロキシに対して認証するユーザー名。

Password (パスワード)

String (文字列)

プロキシに対して認証するパスワード。

Non Proxy Hosts (非プロキシホスト)

String (文字列)

プロキシの使用対象にならないカンマ区切りホストのリスト。

Success Status Code Validator (成功状況コードバリデーター)

項目 説明 デフォルト値 必須

Values (値)

String (文字列)

考慮される状況コード。

x

Failure Status Code Validator (失敗状況コードバリデーター)

項目 説明 デフォルト値 必須

Values (値)

String (文字列)

考慮される状況コード。

x

Origin (発生源)

項目 説明 デフォルト値 必須

Url

String (文字列)

ブラウザーがリソースを読み込める発生元の URL。

x

Access Control Max Age (アクセス制御最大保持期間)

Number (数値)

プリフライト要求の結果をキャッシュする秒単位の時間。

x

Allowed Methods (許可されるメソッド)

Method (メソッド)​ の配列

発生元からリソースにアクセスするときに許可される HTTP メソッドを示します。

Allowed Headers (許可されるヘッダー)

Header (ヘッダー)​ の配列

プリフライト要求で、実際の要求中に使用する HTTP ヘッダーを示します。

Expose Headers (ヘッダーを公開)

Header (ヘッダー)​ の配列

要求で公開されるレスポンスヘッダー。

Method (メソッド)

HTTP メソッド名。

項目 説明 デフォルト値 必須

Method Name (メソッド名)

String (文字列)

HTTP メソッド名。

x

HTTP ヘッダー名。

項目 説明 デフォルト値 必須

Header Name (ヘッダー名)

String (文字列)

HTTP ヘッダー名。

x