検証モジュールドキュメントリファレンス

サポートカテゴリ: 選択

検証モジュール v1.4

検証モジュールは、Mule フローのメッセージの内容が特定の条件と一致するかどうかを検証します。このモジュールは、フロー内での例外の原因に関する明示的なメッセージを提供します。検証する特定のデータに基づいて、ログに表示される例外メッセージをカスタマイズできます。

データ検証を実行するモジュール。検証に失敗すると、エラーがスローされます。エラー種別はさまざまですが、常に VALIDATION:VALIDATION の子になります。

メッセージが定義されている検証条件を満たさないと、検証が失敗し、VALIDATION​ エラー (例: ​VALIDATION:INVALID_URL​) が返され、ValidationException​ となります。. デフォルトでは、このメッセージは意味のある内容となっており、カスタマイズ可能です。

リリースノート: ​検証モジュールリリースノート

設定


デフォルト設定

デフォルト設定

パラメータ

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

Name (名前)

String (文字列)

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

x

I18n

I18n を標準エラーメッセージに合わせて設定します。

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

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

操作

Is Blank String

<validation:is-blank-string>

値が空白の文字列であることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

String (文字列)

チェックする値。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​NOT_BLANK_STRING

Is Elapsed

<validation:is-elapsed>

since パラメータで指定された時点から、指定された時間以上が経過していることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Time (時刻)

Number (数値)

経過時間。

x

Time Unit (時間単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

時間の単位 (TimeUnit)。

x

Since (以降)

DateTime

検証する時刻。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​NOT_ELAPSED_TIME

Is Email

<validation:is-email>

メールアドレスが有効であることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

メール

String (文字列)

メールアドレス。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_EMAIL

Is Empty Collection

<validation:is-empty-collection>

値が空白のコレクションであることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Values (値)

Any の配列

チェックする値。

#[payload]

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​NOT_EMPTY_COLLECTION

Is False

<validation:is-false>

指定された値が false であることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Boolean (ブール)

テストするブール式。

false

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_BOOLEAN

Is IP

<validation:is-ip>

文字列として表現されている IP アドレスが有効であることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Ip

String (文字列)

検証する IP アドレス。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_IP

Is Not Blacklisted Ip

<validation:is-not-blacklisted-ip>

ipAddress が ipList に含まれていないことを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Ip Address (IP アドレス)

String (文字列)

検証するアドレス。

x

Black List (ブラックリスト)

許可されていないアドレスのリスト。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_IP​

  • VALIDATION:​REJECTED_IP

Is Not Blank String

<validation:is-not-blank-string>

値が空白の文字列ではないことを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

String (文字列)

チェックする文字列。

#[payload]

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​BLANK_STRING

Is Not Elapsed

<validation:is-not-elapsed>

since パラメータで指定された時点から、指定された時間以上が経過していることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Time (時刻)

Number (数値)

経過時間。

x

Time Unit (時間単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

時間の単位 (TimeUnit)。

x

Since (以降)

DateTime

検証する時刻。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​ELAPSED_TIME

Is Not Empty Collection

<validation:is-not-empty-collection>

値が空白のコレクションではないことを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Values (値)

Any の配列

チェックする値。

#[payload]

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​EMPTY_COLLECTION

Is Not Null

<validation:is-not-null>

指定された値が null ではないことを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Any (いずれか)

テストする値。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:NULL

Is Null

<validation:is-null>

指定された値が null であることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Any (いずれか)

テストする値。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​NOT_NULL

Is Number

<validation:is-number>

数値を文字列として受け取り、numberType のルールで解析できることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

String (文字列)

テストする値。

x

Locale (ロケール)

String (文字列)

形式で使用するロケール。指定しなかった場合のデフォルトはシステムロケール。

パターン

String (文字列)

値の書式設定に使用するパターン。

Min Value (最小値)

String (文字列)

指定した場合は、解析された値がこの値以上であることを検証します。

Max Value (最大値)

String (文字列)

指定した場合は、解析された値がこの値以下であることを検証します。

Number Type (数値種別)

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

  • INTEGER

  • LONG

  • SHORT

  • DOUBLE

  • FLOAT

値をテストする数値型。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_NUMBER

Is Time

<validation:is-time>

文字列形式の時刻が指定されたパターンとロケールに対して有効であることを検証します。パターンが指定されていない場合は、ロケールのデフォルトが使用されます。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Time (時刻)

String (文字列)

文字列形式の日付。

x

Locale (ロケール)

String (文字列)

文字列のロケール。

パターン

String (文字列)

日付のパターン。

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_TIME

Is True

<validation:is-true>

指定された値が true であることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Boolean (ブール)

テストするブール式。

false

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_BOOLEAN

Is URL

<validation:is-url>

URL が有効であることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

URL

String (文字列)

文字列として検証する URL。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_URL

Is Whitelisted Ip

<validation:is-whitelisted-ip>

ipAddress が ipList に含まれていることを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Ip Address (IP アドレス)

String (文字列)

検証するアドレス。

x

White List (ホワイトリスト)

許可されているアドレスのリスト。

x

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_IP​

  • VALIDATION:​REJECTED_IP

Matches Regex

<validation:matches-regex>

値が正規表現式と一致することを検証します。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

String (文字列)

チェックする値。

x

Regex (正規表現)

String (文字列)

チェックする正規表現。

x

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

Boolean (ブール)

true である場合は、同じ文字の大文字と小文字が異なる文字として一致が検証され、そうでなければ同じ文字として扱われます。

true

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:MISMATCH

Validate Size

<validation:validate-size>

値が指定された上限と下限 (両端を含む) の間にあることを検証します。バリデータは、文字列、コレクション、マップ、および配列のインスタンスを処理できます。

パラメータ

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

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Any (いずれか)

検証する値。

x

Min (最小)

Number (数値)

予想される最小長 (この値を含み、デフォルトはゼロ)。

0

Max (最大)

Number (数値)

予想される最大長 (この値を含む)。最大値を制限しない場合は、このパラメータを指定しないか、または null を指定します。

Message (メッセージ)

String (文字列)

検証に失敗した場合にユーザに通知するメッセージを指定します。検証に成功し、メッセージが不要な場合に式の評価に集中できるように、動的ではないとしてマークされています。この値を使用するコンポーネントでは、これが式かどうかを手動でチェックし、検証に失敗した場合に式を評価します。

スロー

  • VALIDATION:​INVALID_SIZE

All

<validation:all>

ネストされた検証操作のリストを実行し、エラーがあった場合はすべてのエラーを要約した VALIDATION:MULTIPLE エラーを 1 つだけ返します。

スロー

  • VALIDATION:MULTIPLE

Any (いずれか)

バージョン 1.3 以降で使用可能

<validation:any>

ネストされた検証操作のリストを実行し、内部の検証がすべて失敗した場合に、すべてのエラーを要約した VALIDATION:MULTIPLE エラーを 1 つ返します。

スロー

  • VALIDATION:MULTIPLE

I18n

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

Bundle Path (バンドルパス)

String (文字列)

メッセージを含むバンドルファイルへのパス。null の場合はプラットフォームによってデフォルトのパスが選択されます。

x

Locale (ロケール)

String (文字列)

プラットフォームのロケール。null の場合はプラットフォームによってシステムのデフォルトが選択されます。

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

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

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

Number (数値)

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

Time Unit (時間単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位

IP 検索条件リスト

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

Ips

Array of String (文字列の配列)

x

Was this article helpful?

💙 Thanks for your feedback!