FTP Connector 2.0 リファレンス - Mule 4

サポートカテゴリ: SelectLeaving the Site

FTP Connector は、指定された FTP サーバーに接続します。

設定


デフォルト設定

パラメーター

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

Name (名前)

String (文字列)

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

x

Connection (接続)

この設定に指定する接続型。

x

Default Write Encoding (デフォルト書き込みエンコード) (廃止)

String (文字列)

このパラメーターは廃止されており無視されます。

Time Between Size Check (サイズ確認の時間間隔)

Number (数値)

有効にした場合、Mule はコールから次のコールまでの指定された時間を待機して、2 回のサイズ確認を実行します。この両方の確認で同じ値が返された場合、ファイルの読み取り準備はできています。これにより、ファイルの書き込みが完了してからファイルを処理できます。この属性は、​*[Time Between Size Check Unit (サイズ確認の時間間隔の単位)]*​ と連携して機能します。値を指定しない場合、確認は実行されません。

Time Between Size Check Unit (サイズ確認の時間間隔の単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Time between size check (サイズ確認の時間間隔)]​ 属性の ​[Time unit (時間単位)]​。 デフォルトは ​MILLISECONDS (ミリ秒)​ です。

MILLISECONDS

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

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

接続種別

FTP Connection (FTP 接続)

FTP サーバーに接続します。

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

Working Directory (作業ディレクトリ)

String (文字列)

このコネクタで使用するすべての相対パスのルートとして指定したディレクトリ。指定しない場合、デフォルトはリモートサーバーのデフォルトになります。

Proxy (プロキシ)

+HTTP または HTTPS トンネルプロキシを設定できます。

Transfer Mode (転送モード)

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

  • BINARY

  • ASCII

使用する転送モード。現在のところ、BINARY (バイナリ) と ASCII (アスキー) がサポートされています。

BINARY

Passive (パッシブ)

Boolean (ブール)

パッシブモードを使用するかどうか。アクティブモードに切り替えるには ​false​ に設定します。

true

Enable Remote Verification (リモート検証の有効化)

Boolean (ブール)

データ接続に参加しているリモートホストが制御接続の接続先ホストと同じであることの検証を有効または無効にします。

true

Control Encoding (制御エンコード)

String (文字列)

リモートサーバーの制御チャネルで使用する制御エンコードを設定します。これにより、転送するファイルのコンテンツのエンコードは設定されません。 既知の制御エンコードには、​ISO-8859-1​ や ​UTF-8​ があります。

ISO-8859-1

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

Number (数値)

接続試行がタイムアウトになるまで待機する時間を表すスカラー値。この属性は、​[Connection Timeout Unit (接続タイムアウト単位)]​ と連携して機能します。

10

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

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Connection Timeout (接続タイムアウト)]​ 属性に使用できる​時間単位​。

SECONDS (秒)

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

Number (数値)

データの要求がタイムアウトになるまで待機する時間を表すスカラー値。この属性は、​[Response Timeout Unit (応答タイムアウト単位)]​ と連携して機能します。

10

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

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Response Timeout Unit (応答タイムアウト単位)]​ 属性の​時間単位​。

SECONDS

Host (ホスト)

String (文字列)

www.mulesoft.com​、​localhost​、​192.168.0.1​ などの FTP サーバー。

x

Port (ポート)

Number (数値)

接続する FTP サーバーのポート番号。

21

Username (ユーザー名)

String (文字列)

FTP サーバーのユーザー名。サーバーが認証される場合は必須です。

Password (パスワード)

String (文字列)

FTP サーバーのパスワード。サーバーが認証される場合は必須です。

Reconnection (再接続)

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

Pooling Profile (プーリングプロファイル)

接続プールの特性。

操作

関連付けられたソース

Copy

<ftp:copy>

ソースパス​で指定されたファイルまたはディレクトリを​対象パス​にコピーします。ソースパスには、ファイルまたはディレクトリを指定できます。ディレクトリを参照する場合、再帰的にコピーされます。

対象パスが存在せず、その親も存在しない場合には、​[Create Parent Directories (親ディレクトリの作成)]​ が ​true​ に設定されていると親フォルダーが作成されます。​[Create Parent Directories (親ディレクトリの作成)]​ が ​false​ に設定されている場合、​FTP:ILLEGAL_PATH​ エラーがスローされます。

[Overwrite (上書き)]​ が ​true​ に設定されておりコピー先ファイルがすでに存在する場合、コピー先ファイルが上書きされます。それ以外の場合は、​FTP:FILE_ALREADY_EXISTS​ エラーがスローされます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Source Path (ソースパス)

String (文字列)

コピーするファイルへのパス。

x

Target Path (対象パス)

String (文字列)

ファイルのコピー先のディレクトリ。

x

Create Parent Directories (親ディレクトリの作成)

Boolean (ブール)

親ディレクトリが存在しない場合に親ディレクトリを作成するかどうか。

true

Overwrite (上書き)

Boolean (ブール)

コピー先がすでに存在する場合にファイルを上書きするかどうか。

false

Rename To (変更後の名前)

String (文字列)

コピーしたファイルの新しい名前。指定しない場合、元のファイル名のままになります。

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FTP:FILE_ALREADY_EXISTS

  • FTP:RETRY_EXHAUSTED

  • FTP:ILLEGAL_PATH

  • FTP:CONNECTIVITY

Create Directory

<ftp:create-directory>

ディレクトリパス​で新しいディレクトリを作成します。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Directory Path (ディレクトリパス)

String (文字列)

新しいディレクトリの名前。

x

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FTP:FILE_ALREADY_EXISTS

  • FTP:RETRY_EXHAUSTED

  • FTP:ILLEGAL_PATH

  • FTP:ACCESS_DENIED

  • FTP:CONNECTIVITY

Delete

<ftp:delete>

パスで参照されているファイルがロックされていない場合、そのファイルを削除します。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Path (パス)

String (文字列)

削除するファイルへのパス。

x

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FTP:RETRY_EXHAUSTED

  • FTP:ILLEGAL_PATH

  • FTP:ACCESS_DENIED

  • FTP:CONNECTIVITY

List

<ftp:list>

指定されたマッチャーに一致する​ディレクトリパス​にあるファイルをすべてリストします。リスト中にディレクトリが検出された場合、recursive (再帰) パラメーターの値に応じて出力リストにそのコンテンツが含まれます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Directory Path (ディレクトリパス)

String (文字列)

リストするディレクトリへのパス。

x

Recursive (再帰)

Boolean (ブール)

サブディレクトリのコンテンツを含めるかどうか。

false

File Matching Rules (ファイル一致ルール)

出力リストを絞り込むために使用するマッチャー。

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

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

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

#[payload]

Reconnection Strategy (再接続戦略)

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

出力

ペイロードおよび [​Ftp File Attributes (Ftp ファイル属性)​] 属性のメッセージの配列。

次の設定の場合

スロー

  • FTP:ILLEGAL_PATH

  • FTP:ACCESS_DENIED

Move

<ftp:move>

ファイルまたはディレクトリを​ソースパス​から​対象パス​に移動します。ソースパスには、ファイルまたはディレクトリを指定できます。ディレクトリを参照している場合、再帰的に移動します。

対象パスが存在せず、その親も存在しない場合には、​[Create Parent Directories (親ディレクトリの作成)]​ が ​true​ に設定されていると親フォルダーが作成されます。​[Create Parent Directories (親ディレクトリの作成)]​ が ​false​ に設定されている場合、​FTP:ILLEGAL_PATH​ エラーがスローされます。

コピー先のファイルがすでに存在し、​[Overwrite (上書き)]​ が ​true​ に設定されている場合、コピー先のファイルは上書きされます。​[Overwrite (上書き)]​ が ​false​ に設定されている場合、​FTP:FILE_ALREADY_EXISTS​ エラーがスローされます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Source Path (ソースパス)

String (文字列)

コピーするファイルへのパス。

x

Target Path (対象パス)

String (文字列)

対象のディレクトリ。

x

Create Parent Directories (親ディレクトリの作成)

Boolean (ブール)

親ディレクトリが存在しない場合に親ディレクトリを作成するかどうか。

true

Overwrite (上書き)

Boolean (ブール)

コピー先がすでに存在する場合にファイルを上書きするかどうか。

false

Rename To (変更後の名前)

String (文字列)

移動したファイルの新しい名前。指定しない場合、元のファイル名のままになります。

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FTP:FILE_ALREADY_EXISTS

  • FTP:RETRY_EXHAUSTED

  • FTP:ILLEGAL_PATH

  • FTP:CONNECTIVITY

Read

<ftp:read>

指定されたパスにあるファイルのコンテンツとメタデータを取得します。この操作自体は、ファイルのコンテンツを含む入力ストリームであるペイロードを含むメッセージを返し、メタデータはメッセージの ​Message#getAttributes()​ 属性として配置される ​FtpFileAttributes​ オブジェクトとして表現されます。

lock (ロック) パラメーターを ​true​ に設定した場合、この操作によって返される入力ストリームが閉じられるか完全に使用されるまで、ファイルシステムレベルのロックがファイルに配置されます。ロックは実際にはホストのファイルシステムにより提供されるため、その動作は、マウントされたドライブと、Mule が実行されているオペレーティングシステムに応じて変わる可能性があります。このロックに依存する前に以上の点を考慮してください。

この方法では、情報に基づいて推測するためのファイルの拡張子を使用して、読み取られるファイルの MIME タイプを判断するためにベストエフォートも行います。出力の ​[Encoding (エンコード)]​ と ​[MIME Type (MIME タイプ)]​ の 2 つの省略可能なパラメーターを使用して、エンコードと MIME タイプを強制的に適用することもできます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

File Path (ファイルパス)

String (文字列)

読み取るファイルへのパス。

x

Lock (ロック)

Boolean (ブール)

ファイルをロックするかどうか。

false

Time Between Size Check (サイズ確認の時間間隔)

Number (数値)

Time Between Size Check Unit (サイズ確認の時間間隔の単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

Output Mime Type (出力 MIME タイプ)

String (文字列)

この操作で出力されるペイロードの MIME タイプ。

Output Encoding (出力エンコード)

String (文字列)

この操作で出力されるペイロードのエンコード。

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

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

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

#[payload]

Reconnection Strategy (再接続戦略)

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

出力

Type (型)

Binary (バイナリ)

Attributes Type (属性型)

次の設定の場合

スロー

  • FTP:FILE_LOCK

  • FTP:RETRY_EXHAUSTED

  • FTP:ILLEGAL_PATH

  • FTP:ACCESS_DENIED

  • FTP:CONNECTIVITY

Rename

<ftp:rename>

[New Name (新しい名前)] パラメーターで指定される値へのパスによって参照されるファイルの名前を変更します。この引数にはパスセパレーターを含めることができません。含めると FTP:ILLEGAL_PATH​ エラーがスローされます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Path (パス)

String (文字列)

名前を変更するファイルへのパス。

x

New Name (新しい名前)

String (文字列)

ファイルの新しい名前。

x

Overwrite (上書き)

Boolean (ブール)

コピー先がすでに存在する場合にファイルを上書きするかどうか。

false

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FTP:FILE_ALREADY_EXISTS

  • FTP:RETRY_EXHAUSTED

  • FTP:ILLEGAL_PATH

  • FTP:ACCESS_DENIED

  • FTP:CONNECTIVITY

Write

<ftp:write>

パスで参照されているファイルにコンテンツを書き込みます。

書き込もうとしているファイルのディレクトリが存在しない場合、​[Create Parent Directories (親ディレクトリの作成)]​ の値に応じて、FTP:ILLEGAL_PATH​ エラーがスローされるか、新しいフォルダーが作成されます。ファイルがすでに存在している場合、その動作は指定されたモードに応じて異なります。

この操作では、lock (ロック) 引数の値に応じたロックもサポートし、読み取り操作で説明したのと同じルールおよび考慮事項が適用されます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Path (パス)

String (文字列)

書き込まれるファイルのパス。

x

Content (コンテンツ)

Binary (バイナリ)

ファイルに書き込まれるコンテンツ。デフォルトは現在のメッセージペイロードです。

#[payload]

Encoding (エンコード) (廃止)

String (文字列)

Content (コンテンツ) が String (文字列) の場合、この属性で書き込み時に使用されるエンコードを指定します。設定しない場合、デフォルトは ​FileConnectorConfig#getDefaultWriteEncoding()​ になります。

Create Parent Directories (親ディレクトリの作成)

Boolean (ブール)

親ディレクトリが存在しない場合に親ディレクトリを作成するかどうか。

true

Lock (ロック)

Boolean (ブール)

ファイルをロックするかどうか。

false

Write Mode (書き込みモード)

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

  • OVERWRITE

  • APPEND

  • CREATE_NEW

ファイルの​書き込みモード​。

OVERWRITE

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FTP:FILE_LOCK

  • FTP:ILLEGAL_CONTENT

  • FTP:FILE_ALREADY_EXISTS

  • FTP:RETRY_EXHAUSTED

  • FTP:ILLEGAL_PATH

  • FTP:ACCESS_DENIED

  • FTP:CONNECTIVITY

ソース

On New or Updated File

<ftp:listener>

ディレクトリをポーリングしてそのディレクトリで作成されたファイルを探します。見つかった各ファイルに 1 つのメッセージが生成されます。

この機能の重要な部分は、ファイルが実際に新規かどうかを判断する方法です。3 つの方法があります。

  • Auto Delete (自動削除)​ パラメーターを ​true​ に設定する: この方法では、各ファイルを処理した後で処理済みのファイルを削除するため、次のポーリングで取得されるすべてのファイルが必ず新規になります。

  • Move To Directory (ディレクトリに移動)​ パラメーターを設定する: この方法では、各ファイルを処理した後で処理済みのファイルを異なるディレクトリに移動するため、​Auto Delete (自動削除)​ と同じ効果を得ることができますが、ファイルが失われることはありません。

  • Watermark Enabled (ウォーターマークの有効化)​ を使用する: この方法では、前回ポーリングが実行された後で作成または更新されたファイルのみを選択します。

ファイルをさらに絞り込むためにマッチャーを使用することもできます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Directory (ディレクトリ)

String (文字列)

ポーリングするファイルを含むディレクトリ。

Recursive (再帰)

Boolean (ブール)

サブディレクトリに含まれているファイルもポーリングするかどうか。

true

Matcher (マッチャー)

マッチャーの条件を満たさないファイルに対するイベントを絞り込むために使用するマッチャー。

Watermark Enabled (ウォーターマークの有効化)

Boolean (ブール)

ウォーターマークを設定するかどうかを制御します。設定する場合は、ファイルの変更タイムスタンプを考慮するか、作成タイムスタンプを考慮するかを制御します。

false

Time Between Size Check (サイズ確認の時間間隔)

Number (数値)

ファイルの読み取り準備ができているかどうかを確認するためのサイズ確認間の待機時間 (ミリ秒)。これにより、ファイルの書き込みが完了してから処理を実行することができます。値を省略してこの機能を無効にできます。有効にした場合、Mule はあるコールから次のコールまでの指定された時間を待機して、2 回のサイズ確認を実行します。この両方の確認で同じ値が返された場合、ファイルの読み取り準備はできています。

Time Between Size Check Unit (サイズ確認の時間間隔の単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Time between size check (サイズ確認の時間間隔)]​ 属性の ​[Time unit (時間単位)]​。

Output Mime Type (出力 MIME タイプ)

String (文字列)

この操作で出力されるペイロードの MIME タイプ。

Output Encoding (出力エンコード)

String (文字列)

この操作で出力されるペイロードのエンコード。

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

Boolean (ブール)

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

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

scheduling-strategy

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

x

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

反復可能なストリームを使用するように設定します。

Redelivery Policy (再配信ポリシー)

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

Reconnection Strategy (再接続戦略)

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

Auto Delete (自動削除)

Boolean (ブール)

各ファイルを処理後に削除するかどうか。

false

Move To Directory (ディレクトリに移動)

String (文字列)

指定した場合、処理された各ファイルは、このパスで参照されているディレクトリに移動します。

Rename To (変更後の名前)

String (文字列)

このパラメーターは、​[Move To Directory (ディレクトリに移動)]​ と連携して機能します。このパラメーターを使用して入力した名前でファイルが移動します。​[Move To Directory (ディレクトリに移動)]​ を設定しない場合は、このパラメーターも設定しないでください。

Apply Post Action When Failed (失敗した場合に投稿アクションを適用)

Boolean (ブール)

ファイルの処理に失敗した場合に投稿アクション (autoDelete および moveToDirectory) も適用するかどうか。​false​ に設定すると、失敗したファイルは移動も削除もされません。

true

Overwrite (上書き)

Boolean (ブール)

宛先ファイルの名前が同じ場合に対象ファイルを上書きできます。

false

出力

Type (型)

Binary (バイナリ)

Attributes Type (属性型)

次の設定の場合

Reconnection (再接続)

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

Fails Deployment (デプロイに失敗)

Boolean (ブール)

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

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

Reconnect (再接続)

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

Frequency (頻度)

Number (数値)

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

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。注意: この項目は XML でのみ設定可能です。

true

Reconnect Forever (繰り返し再接続)

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

Frequency (頻度)

Number (数値)

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

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。注意: この項目は XML でのみ設定可能です。

true

Pooling Profile (プーリングプロファイル)

接続プーリングメカニズムの自然な動作では、接続は常に作成されることはありません。このメカニズムでは、管理された接続は実際には閉じられず、代わりにプールで解放された接続が取得され、アクティブな状態で維持されます。このため、ユーザーは必要な場合に接続を再利用できます。

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

Max Active (最大アクティブ)

Number (数値)

一度にセッションから借りることができる Mule コンポーネントの数を制御します。負の値に設定した場合、同時にアクティブにできるコンポーネントの数に制限はありません。maxActive を超えた場合、プールは枯渇したと呼ばれます。

Max Idle (最大アイドル)

Number (数値)

プール内で同時にアイドル状態のままにできる Mule コンポーネントの最大数。負の値に設定した場合、同時にアイドルにできる Mule コンポーネントの数に制限はありません。

Max Wait (最大待機)

Number (数値)

プールが枯渇し、​[Exhausted action (枯渇アクション)]​ が ​WHEN_EXHAUSTED_WAIT​ に設定されている場合に、プールされたコンポーネントが使用可能になるまで待機する時間 (ミリ秒) を指定します。

Min Eviction Millis (最小除去時間)

Number (数値)

オブジェクトが除去対象となるまでにオブジェクトをプール内でアイドル状態のままにできる最小時間を決定します。正の値以外の場合、アイドル時間のみによってオブジェクトがプールから削除されることはありません。

Eviction Check Interval Millis (除去確認間隔)

Number (数値)

オブジェクトエビクターの実行間隔 (ミリ秒) を指定します。正の値以外の場合、オブジェクトエビクターは実行されません。

Exhausted Action (枯渇アクション)

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

  • WHEN_EXHAUSTED_GROW​

  • WHEN_EXHAUSTED_WAIT​

  • WHEN_EXHAUSTED_FAIL

Mule コンポーネントプールが枯渇した場合のプールの動作を指定します。可能な値:

  • WHEN_EXHAUSTED_FAIL​
    NoSuchElementException​ がスローされる。

  • WHEN_EXHAUSTED_WAIT​
    新規またはアイドルオブジェクトが利用可能なるまで、​Object.wait(long)​ を呼び出してブロックする。

  • WHEN_EXHAUSTED_GROW​
    新しい Mule インスタンスを作成して返す。​[Max Active (最大アクティブ)]​ は基本的に意味がなくなる。

正の ​[Max Wait (最大待機)]​ 値を指定した場合、最大でそのミリ秒間ブロックされた後に ​NoSuchElementException​ がスローされます。maxThreadWait が負の値の場合、無期限にブロックされます。

Initialisation Policy (初期化ポリシー)

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

  • INITIALISE_NONE​

  • INITIALISE_ONE​

  • INITIALISE_ALL

プール内のコンポーネントの初期化方法を決定します。可能な値:

  • INITIALISE_NONE​
    起動時にプールにコンポーネントを一切読み込まない。

  • INITIALISE_ONE​
    起動時に初期コンポーネントをプールに読み込む。

  • INITIALISE_ALL​
    起動時にすべてのコンポーネントをプールに読み込む。

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

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

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

Number (数値)

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

Time Unit (時間単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位。

Ftp File Attributes (Ftp ファイル属性)

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

Timestamp (タイムスタンプ)

DateTime

Name (名前)

String (文字列)

x

Size (サイズ)

Number (数値)

x

Regular File (正規ファイル)

Boolean (ブール)

false

Directory (ディレクトリ)

Boolean (ブール)

false

Symbolic Link (シンボリックリンク)

Boolean (ブール)

false

Path (パス)

String (文字列)

x

File Name (ファイル名)

String (文字列)

x

Matcher (マッチャー)

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

Timestamp Since (次の日時からのタイムスタンプ)

DateTime

この日付より前に作成されたファイルは却下されます。 作成日がない場合、ファイルは処理されます。この値でのタイムゾーンの指定は無視され、代わりに Mule サーバーのタイムゾーンが使用されます。

Timestamp Until (次の日時までのタイムスタンプ)

DateTime

この日付より後に作成されたファイルは却下されます。 作成日がない場合、ファイルは処理されます。この値でのタイムゾーンの指定は無視され、代わりに Mule サーバーのタイムゾーンが使用されます。

Not Updated In The Last (指定した期間に更新なし)

Number (数値)

ファイルの更新後の経過期間がこの期間以上の場合、却下されません。この属性は、#timeUnit と連携して機能します。

Updated In The Last (指定した期間に更新あり)

Number (数値)

ファイル更新後の経過期間がこの期間以内の場合、却下されません。この属性は、#timeUnit と連携して機能します。

Time Unit (時間単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

#notUpdatedInTheLast の属性。

デフォルトは SECONDS (秒) です。

SECONDS (秒)

Case Sensitive (大文字と小文字を区別)

Boolean (ブール)

外部ファイルシステムマッチャーで大文字と小文字を区別するかどうかを設定できるようにします。

true

Filename Pattern (ファイル名パターン)

String (文字列)

Path Pattern (パスパターン)

String (文字列)

Directories (ディレクトリ)

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

  • REQUIRE

  • INCLUDE

  • EXCLUDE

INCLUDE

Regular Files (正規ファイル)

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

  • REQUIRE

  • INCLUDE

  • EXCLUDE

INCLUDE

Sym Links (シンボリックリンク)

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

  • REQUIRE

  • INCLUDE

  • EXCLUDE

INCLUDE

Min Size (最小サイズ)

Number (数値)

Max Size (最大サイズ)

Number (数値)

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

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

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

Number (数値)

ストリームをコンシュームしてランダムにアクセスするために割り当てられるメモリ量。ストリームのデータ量がこのバッファサイズを超える場合は、​[Buffer Size Increment (バッファサイズ増分)]​ 属性に従って、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 (反復可能なファイルストアストリーム)

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

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 になります。

SHA-256

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断するために使用する 1 つ以上の式を定義します。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ が false の場合にのみ設定できます。

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

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

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

Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)

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

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

Number (数値)

ストリームを使用し、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンスの量。ストリームのデータ量がこのバッファサイズを超える場合は、​[Buffer Size Increment (バッファサイズ増分)]​ 属性に従って、maxInMemorySize を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。

100

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

Number (数値)

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

100

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

Number (数値)

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

Repeatable File Store Iterable (反復可能なファイルストアイテラブル)

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

In Memory Objects (メモリ内オブジェクト)

Number (数値)

メモリ内に保持されるインスタンスの最大量。これ以上の量が必要な場合、コンテンツはディスク上にバッファされます。

Buffer Unit (バッファ単位)

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

  • BYTE (バイト)

  • KB

  • MB

  • GB

maxInMemorySize で表される単位

HTTP Tunnel Proxy (HTTP トンネルプロキシ)

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

Host (ホスト)

String (文字列)

www.mulesoft.com、localhost、192.168.0.1 などの FTP プロキシサーバーホスト。

Port (ポート)

Number (数値)

接続する FTP プロキシサーバーのポート番号。

Username (ユーザー名)

String (文字列)

FTP プロキシサーバーのユーザー名。プロキシサーバーが認証される場合は必須です。

Password (パスワード)

String (文字列)

FTP プロキシサーバーのパスワード。プロキシサーバーが認証される場合は必須です。

HTTP Tunnel Proxy (HTTP トンネルプロキシ)

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

Tls Context Factory (TLS コンテキストファクトリー)

TLS

Host (ホスト)

String (文字列)

www.mulesoft.com、localhost、192.168.0.1 などの FTP プロキシサーバーホスト。

Port (ポート)

Number (数値)

接続する FTP プロキシサーバーのポート番号。

Username (ユーザー名)

String (文字列)

FTP プロキシサーバーのユーザー名。プロキシサーバーが認証される場合は必須です。

Password (パスワード)

String (文字列)

FTP プロキシサーバーのパスワード。プロキシサーバーが認証される場合は必須です。

TLS

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

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

String (文字列)

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

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

String (文字列)

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

Trust Store (トラストストア)

Key Store (キーストア)

Revocation Check (取り消し確認)

Truststore (トラストストア)

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

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

Path (パス)

String (文字列)

トラストストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Password (パスワード)

String (文字列)

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

Type (型)

String (文字列)

トラストストアの型。

Algorithm (アルゴリズム)

String (文字列)

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

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、Mule では証明書の検証の実行を停止します。これを ​true​ に設定すると、接続が攻撃に対して脆弱になる可能性があります。

Key Store (キーストア)

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

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

Path (パス)

String (文字列)

キーストアへのパス。Mule では、可能であれば、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Type (型)

String (文字列)

使用するキーストアの型。

Alias (別名)

String (文字列)

キーストアに複数の非公開キーが含まれている場合に使用するキーの別名。デフォルトでは、Mule はファイル内の最初のキーを使用します。

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 の確認方法 ([Prefer Crls (CRL を優先)] 項目で指定されていない方法) を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

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

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

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

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

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

OCSP 応答の署名証明書の別名。指定した場合、別名はトラストストアに存在する必要があります。

Crl File (Crl ファイル)

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

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

Path (パス)

String (文字列)

CRL ファイルへのパス。