File Connector リファレンス - Mule 4

File Connector v1.5

ファイル用 Anypoint Connector (File Connector) は、ホストのオペレーションシステムにマウントされたファイルシステムを操作します。

このクラスは拡張機能の定義および設定として機能します。操作は標準の ​BaseFileSystemOperations​ に基づきます。

リリースノート: File Connector リリースノート

設定


デフォルト設定

パラメーター

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

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

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

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

接続種別

ローカル FileSystem 接続

File Connector のインスタンスからファイルシステムのインスタンスを提供する接続プロバイダー。

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

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

String (文字列)

このコネクタで使用するすべての相対パスのルートとみなされるディレクトリ。指定しない場合、デフォルトの ​user.home​ システムプロパティの値になります。このシステムプロパティが設定されていない場合、コネクタは初期化に失敗します。

Reconnection (再接続)

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

関連付けられたソース

Copy

<file:copy>

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

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

[Overwrite (上書き)]​ が ​true​ に設定されており対象ファイルがすでに存在する場合、対象ファイルが上書きされます。それ以外の場合は、​FILE: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 (再接続戦略)

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

次の設定の場合

スロー

  • FILE:CONNECTIVITY

  • FILE:ILLEGAL_PATH

  • FILE:FILE_ALREADY_EXISTS

  • FILE:RETRY_EXHAUSTED

Create Directory

<file:create-directory>

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

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

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

String (文字列)

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

x

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FILE:CONNECTIVITY

  • FILE:ILLEGAL_PATH

  • FILE:FILE_ALREADY_EXISTS

  • FILE:RETRY_EXHAUSTED

  • FILE:ACCESS_DENIED

削除

<file:delete>

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

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Path (パス)

String (文字列)

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

x

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FILE:CONNECTIVITY

  • FILE:ILLEGAL_PATH

  • FILE:RETRY_EXHAUSTED

  • FILE:ACCESS_DENIED

List

<file:list>

マッチャーに一致する​ディレクトリパス​にあるファイルをすべてリストします。

リスト中にディレクトリが検出された場合、​Recursive (再帰)​ パラメーターの値に応じて出力リストにそのコンテンツが含まれます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

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

String (文字列)

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

x

Recursive (再帰)

Boolean (ブール)

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

false

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

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

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

Number (数値)

ファイルの読み取り準備ができているかどうかを確認するためのサイズ確認間の待機時間。

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

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

サイズ確認間の待機時間で使用する時間単位。

Subset (サブセット)

返されるファイルの数の制限と並び替えを行います。

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

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

Target Variable (対象変数)

String (文字列)

操作の出力が配置される変数の名前。

Target Value (対象値)

String (文字列)

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

#[payload]

Reconnection Strategy (再接続戦略)

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

出力

[CursorProvider] ペイロードおよび [​ローカルファイル属性​] 属性のメッセージの配列

次の設定の場合

スロー

  • FILE:ILLEGAL_PATH

  • FILE:ACCESS_DENIED

Move

<file:move>

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

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

コピー先のファイルがすでに存在し、​[Overwrite (上書き)]​ が ​true​ に設定されている場合、コピー先のファイルは上書きされます。​[Overwrite (上書き)]​ が ​false​ に設定されている場合、​FILE: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 (再接続戦略)

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

次の設定の場合

スロー

  • FILE:CONNECTIVITY

  • FILE:ILLEGAL_PATH

  • FILE:FILE_ALREADY_EXISTS

  • FILE:RETRY_EXHAUSTED

Read

<file:read>

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

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

また、この方法では、読み取られるファイルの MIME タイプを判断するために最善を尽くします。ファイルの拡張子は、情報に基づいてファイルの MIME タイプを推測するために使用されます。また、ユーザーは省略可能な ​outputEncoding​ および ​outputMimeType​ パラメーターを使用して、出力のエンコードと ​mimeType​ を強制することもできます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

File Path (ファイルパス)

String (文字列)

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

x

Lock (ロック)

Boolean (ブール)

ファイルをロックするかどうか。デフォルトは false です。

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 タイプ。

Encoding (エンコード)

String (文字列)

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

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

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

Target Variable (対象変数)

String (文字列)

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

Target Value (対象値)

String (文字列)

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

#[payload]

Reconnection Strategy (再接続戦略)

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

出力

Binary (バイナリ)

Attributes Type (属性型)

次の設定の場合

スロー

  • FILE:CONNECTIVITY

  • FILE:FILE_LOCK

  • FILE:ILLEGAL_PATH

  • FILE:RETRY_EXHAUSTED

  • FILE:ACCESS_DENIED

Rename

<file:rename>

to​ パラメーターで指定される名前へのパスによって参照されるファイルの名前を変更します。​to​ 引数にはパスセパレーターを含めることができません。この前提条件が満たされない場合、FILE:ILLEGAL_PATH がスローされます。

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Path (パス)

String (文字列)

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

x

New Name (新しい名前)

String (文字列)

ファイルの新しい名前。

x

Overwrite (上書き)

Boolean (ブール)

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

false

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FILE:CONNECTIVITY

  • FILE:ILLEGAL_PATH

  • FILE:FILE_ALREADY_EXISTS

  • FILE:RETRY_EXHAUSTED

  • FILE:ACCESS_DENIED

Write

<file:write>

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

書き込み先のファイルのディレクトリが存在しない場合、操作は createParentDirectory の値に応じて FILE:ILLEGAL_PATH​ エラーをスローするか、該当のフォルダーを作成します。

ファイル自体がすでに存在している場合、その動作は指定されたモードに応じて異なります。

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

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Path (パス)

String (文字列)

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

x

Content (コンテンツ)

Binary (バイナリ)

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

#[payload]

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

String (文字列)

このパラメーターは廃止されており、設定しても何も実行されません。

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

Boolean (ブール)

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

true

Lock (ロック)

Boolean (ブール)

ファイルをロックするかどうか。デフォルトは false です。

false

Write Mode (書き込みモード)

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

  • OVERWRITE

  • APPEND

  • CREATE_NEW

FileWriteMode。デフォルトは OVERWRITE です。

OVERWRITE

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • FILE:ILLEGAL_CONTENT

  • FILE:CONNECTIVITY

  • FILE:ILLEGAL_PATH

  • FILE:FILE_ALREADY_EXISTS

  • FILE:RETRY_EXHAUSTED

  • FILE:ACCESS_DENIED

ソース

新しいファイルまたは更新されたファイル

<file:listener>

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

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

その戦略を次に示します。

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

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

  • watermarkMode パラメーターを使用して、前回ポーリングが実行された後で作成または更新されたファイルのみを選択します。

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

パラメーター

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Directory (ディレクトリ)

String (文字列)

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

Recursive (再帰)

Boolean (ブール)

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

true

Matcher (マッチャー)

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

Watermark Mode (ウォーターマークモード)

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

  • DISABLED

  • MODIFIED_TIMESTAMP​

  • CREATED_TIMESTAMP

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

DISABLED

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 タイプ。

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

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

Boolean (ブール)

ファイルの処理に失敗した場合に投稿アクション (​[Auto Delete (自動削除)]​ および ​[Move To Directory (ディレクトリに移動)]​) も適用するかどうか。​false​ に設定すると、失敗したファイルは移動も削除もされません。

true

Overwrite (上書き)

Boolean (ブール)

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

false

出力

Binary (バイナリ)

Attributes Type (属性型)

次の設定の場合

Reconnection (再接続)

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

Fails Deployment (デプロイに失敗)

Boolean (ブール)

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

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

Reconnect (再接続)

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

Frequency (頻度)

Number (数値)

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

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

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

true

Reconnect Forever (繰り返し再接続)

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

Frequency (頻度)

Number (数値)

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

blocking (ブロック)

Boolean (ブール)

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

true

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

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

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

Number (数値)

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

Time Unit (時間単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ 属性の時間単位。

ローカルファイル属性

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

Last Modified Time (最終更新時間)

DateTime

x

Last Access Time (最終アクセス時間)

DateTime

x

Creation Time (作成時間)

DateTime

x

Size (サイズ)

Number (数値)

x

Regular File (正規ファイル)

Boolean (ブール)

false

Directory (ディレクトリ)

Boolean (ブール)

false

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

Boolean (ブール)

false

Path (パス)

String (文字列)

x

File Name (ファイル名)

String (文字列)

x

Matcher (マッチャー)

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

Created Since (指定した日付以降に作成)

DateTime

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

Created Until (指定した日付以前に作成)

DateTime

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

Updated Since (指定した日付以降に更新)

DateTime

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

Updated Until (指定した日付以前に更新)

DateTime

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

Accessed Since (指定した日付以降にアクセス)

DateTime

最後のアクセスがこの日付より前のファイルは却下されます。この値でのタイムゾーンの指定は無視され、代わりに Mule サーバーのタイムゾーンが使用されます。

Accessed Since (指定した日付以前にアクセス)

DateTime

最後のアクセスがこの日付より後のファイルは却下されます。この値でのタイムゾーンの指定は無視され、代わりに Mule サーバーのタイムゾーンが使用されます。

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

Number (数値)

ファイルの最終更新後の経過期間がこの期間以上の場合、却下されません。この属性は、​[Time unit (時間単位)]​ と連携して機能します。

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

Number (数値)

ファイルの最終更新後の経過期間がこの期間以内の場合、却下されません。この属性は、​[Time unit (時間単位)]​ と連携して機能します。

Time Unit (時間単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Updated In The Last (指定した期間に更新あり)]​ 属性と ​[Not Updated In The Last (指定した期間に更新なし)]​ 属性の​時間単位​。

MILLISECONDS (ミリ秒)

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 (バッファサイズ増分)]​ 属性に従って、​[Max In Memory Size (最大メモリ内サイズ)]​ を上限としてバッファが拡張されます。

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

Number (数値)

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

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

Number (数値)

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

Buffer Unit (バッファ単位)

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

  • BYTE

  • KB

  • MB

  • GB

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

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

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

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

Number (数値)

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

Buffer Unit (バッファ単位)

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

  • BYTE

  • KB

  • MB

  • GB

[Max in Memory Size (最大メモリ内サイズ)]​ を表す単位

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

Number (数値)

データをメモリ内に保持するためにストリームで使用する最大メモリを定義します。指定された以上のメモリがコンシュームされると、ディスクへのコンテンツのバッファが開始されます。

500

Redelivery Policy (再配信ポリシー)

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

Max Redelivery Count (最大再配信数)

Number (数値)

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

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

Boolean (ブール)

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

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

String (文字列)

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

Id Expression (ID 式)

String (文字列)

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

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

ObjectStore

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

Local Subset List (ローカルサブセットリスト)

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

Limit (制限)

Number (数値)

0

Offset (オフセット)

Number (数値)

1

Criteria (条件)

Enumeration (列挙)。次のいずれかになります。 ALPHABETICALLY DATE_MODIFIED DATE_CREATED SIZE ** PATH

​DATE_MODIFIED​

Order (順序)

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

DESCENDING

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

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

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

Number (数値)

これは、ストリームをコンシュームし、ストリームへのランダムアクセスを提供する目的で、メモリ内に保持することが許可されるインスタンスの初期容量です。ストリームのデータ量がこのバッファサイズを超える場合は、​[Buffer Size Increment (バッファサイズ増分)]​ 属性に従って、​[Max in Memory instances (最大メモリ内インスタンス)]​ を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。

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

Number (数値)

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

Max in Memory instances (最大メモリ内インスタンス)

Number (数値)

使用するメモリインスタンスの最大数。指定された最大値を超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーがスローされます。0 以下の値は無制限を意味します。

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

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

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

Number (数値)

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

Buffer Unit (バッファ単位)

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

  • BYTE

  • KB

  • MB

  • GB

maxInMemorySize で表される単位

Time Between Size Check Unit (サイズ確認の時間間隔) パラメーターの動作

ファイルの Write 操作が完了してファイルの読み取りまたはアクセスを行う準備ができるようになるまで時間がかかる可能性があります。操作が未完了のファイルにアクセスしないようにするには、​timeBetweenSizeCheck​ パラメーターを使用します。 このパラメーターを設定すると、ファイルのコンテンツにアクセスする前にファイルのサイズが検証されます。 この検証では、​timeBetweenSizeCheck​ および ​timeBetweenSizeCheckUnit​ パラメーターで指定された時間待機した後にファイルのサイズが変わっていないことを確認します。 その後、​timeBetweenSizeCheck​ パラメーターによって、2 回実行される各検証間の待機時間が示されます。ファイルのサイズが両方の時間で変わらない場合、Write 操作が完了し、access 操作を続行できるとみなされます。同じでない場合、例外がスローされます。 実行される待機は、操作を実行しているスレッドが指定の期間スリープすることを示します。この待機は、ファイルのコンテンツを取得した時点で発生します。フローでファイルのコンテンツにアクセスしていない場合、確認は実行されません。

Mule Runtime Engine バージョン 4.1 および 4.2 では、この待機が複数のメッセージプロセッサーで発生する可能性があり、File Connector で待機を実行するスレッドを制御できません。スレッドプールのスレッドは、CPU に負荷がかかるスレッド (この種のタスクを目的とするものではない) でも、待機を実行する可能性があります。