RegexValidator (Jakarta EE Platform API)

java.lang.ObjectSE
- jakarta.faces.validator.RegexValidator

実装されているすべてのインターフェース:
PartialStateHolder, StateHolder, Validator, EventListenerSE
```
public class RegexValidator
extends ObjectSE
implements Validator, PartialStateHolder
```
正規表現（パターンプロパティ）をチェックするバリデーター。パターンは、java.util.regex 標準に準拠する文字列に解決される必要があります。
導入:
2.0

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static StringSE`	`MATCH_EXCEPTION_MESSAGE_ID` `PatternSyntaxException` のために、`getPattern()` から返されたパターンと値を照合する動作が失敗した場合に作成される `FacesMessage` のメッセージ識別子。
`static StringSE`	`NOT_MATCHED_MESSAGE_ID` 値がパターンと一致しないために、`getPattern()` から返されたパターンと値を照合する動作が失敗した場合に作成される `FacesMessage` のメッセージ識別子。
`static StringSE`	`PATTERN_NOT_SET_MESSAGE_ID` `getPattern()` から返された値が `null` または空の文字列の場合に作成される `FacesMessage` のメッセージ識別子。
`static StringSE`	`VALIDATOR_ID` このコンバーターの標準コンバーター ID。

インターフェース jakarta.faces.validator.Validator から継承されたフィールド
NOT_IN_RANGE_MESSAGE_ID

コンストラクターの概要
コンストラクター
コンストラクターと説明
RegexValidator()

コンストラクター
コンストラクターと説明
`RegexValidator()`

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`clearInitialState()` PartialStateHolder を非デルタ追跡状態にリセットします。
`StringSE`	`getPattern()` 評価時に正規表現パターンを生成する `ValueExpression` を返します。
`boolean`	`initialStateMarked()` デルタ状態の変更が追跡されている場合は `true` を返し、それ以外の場合は `false` を返します。
`boolean`	`isTransient()` true の場合、このインターフェースを実装するオブジェクトは、状態の保存または復元に参加してはなりません。
`void`	`markInitialState()` ランタイムは、コンポーネントが初期状態であることを示すために、適切な時間にビュー内のこのインターフェースの各インスタンスで `PartialStateHolder.markInitialState()` メソッドが呼び出されることを確認する必要があります。
`void`	`restoreState(FacesContext context, ObjectSE state)` state オブジェクトのエントリから状態を復元するために必要な処理を実行します。
`ObjectSE`	`saveState(FacesContext context)` インスタンスの状態を `Serializable` オブジェクトとして取得します。
`void`	`setPattern(StringSE pattern)` 検証する正規表現プロパティ。
`void`	`setTransient(boolean transientValue)` このインターフェースを実装するオブジェクトが状態の保存または復元に参加する必要があるかどうかを示します。
`void`	`validate(FacesContext context, UIComponent component, ObjectSE value)` 正規表現パターンに対して文字列を検証します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - VALIDATOR_ID
```
public static final StringSE VALIDATOR_ID
```
    このコンバーターの標準コンバーター ID。
    関連事項:
    定数フィールド値
  - PATTERN_NOT_SET_MESSAGE_ID
```
public static final StringSE PATTERN_NOT_SET_MESSAGE_ID
```
    getPattern() から返された値が null または空の文字列の場合に作成される FacesMessage のメッセージ識別子。
    関連事項:
    定数フィールド値
  - NOT_MATCHED_MESSAGE_ID
```
public static final StringSE NOT_MATCHED_MESSAGE_ID
```
    値がパターンと一致しないために、getPattern() から返されたパターンと値を照合する動作が失敗した場合に作成される FacesMessage のメッセージ識別子。
    関連事項:
    定数フィールド値
  - MATCH_EXCEPTION_MESSAGE_ID
```
public static final StringSE MATCH_EXCEPTION_MESSAGE_ID
```
    PatternSyntaxException のために、getPattern() から返されたパターンと値を照合する動作が失敗した場合に作成される FacesMessage のメッセージ識別子。
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - RegexValidator
```
public RegexValidator()
```
- メソッドの詳細
  - setPattern
```
public void setPattern(StringSE pattern)
```
    検証する正規表現プロパティ。
    パラメーター:
    pattern - 正規表現パターン
  - getPattern
```
public StringSE getPattern()
```
    評価時に正規表現パターンを生成する ValueExpression を返します。
    戻り値:
    パターン
  - validate
```
public void validate(FacesContext context,
                     UIComponent component,
                     ObjectSE value)
```
    正規表現パターンに対して文字列を検証します。検証に合格するには、完全な正規表現パターンに一致する必要があります。
    次で指定:
    インターフェース Validator の validate
    パラメーター:
    context - 処理中のリクエストの FacesContext
    component - 正当性をチェックしている UIComponent
    value - 検証する値
    例外:
    NullPointerExceptionSE - context または component が null の場合
    ValidatorException - 検証が失敗した場合
  - saveState
```
public ObjectSE saveState(FacesContext context)
```
    インターフェースからコピーされた説明: StateHolder
    インスタンスの状態を Serializable オブジェクトとして取得します。
    このインターフェースを実装するクラスが、StateHolder を実装するインスタンス（イベントハンドラー、バリデーターなどを含む UIComponent など）への参照を持っている場合、このメソッドはそれらすべてのインスタンスで StateHolder.saveState(jakarta.faces.context.FacesContext) メソッドも呼び出す必要があります。このメソッドは、子とファセットの状態を保存してはなりませんそれは StateManager を介して行われます
    このメソッドは、実装オブジェクトの状態を変更してはなりません。つまり、このコードを実行した後:
```
 
 Object state = component.saveState(facesContext);
 
 
```
    component は、実行前と同じでなければなりません。
    このメソッドからの戻り値は Serializable でなければなりません
    次で指定:
    インターフェース StateHolder の saveState
    パラメーター:
    context - Faces コンテキスト。
    戻り値:
    保存された状態。
  - restoreState
```
public void restoreState(FacesContext context,
                         ObjectSE state)
```
    インターフェースからコピーされた説明: StateHolder
    state オブジェクトのエントリから状態を復元するために必要な処理を実行します。
    このインターフェースを実装するクラスが、StateHolder も実装するインスタンスへの参照を持っている場合（イベントハンドラー、バリデーターなどを備えた UIComponent など）、このメソッドはそれらすべてのインスタンスで StateHolder.restoreState(jakarta.faces.context.FacesContext, java.lang.Object) メソッドも呼び出す必要があります。
    state 引数が null の場合、アクションを実行せずに戻ります。
    次で指定:
    インターフェース StateHolder の restoreState
    パラメーター:
    context - Faces コンテキスト。
    state - 状態。
  - isTransient
```
public boolean isTransient()
```
    インターフェースからコピーされた説明: StateHolder
    true の場合、このインターフェースを実装するオブジェクトは、状態の保存または復元に参加してはなりません。
    次で指定:
    インターフェース StateHolder の isTransient
    戻り値:
    一時的な場合は true、それ以外の場合は false。
  - setTransient
```
public void setTransient(boolean transientValue)
```
    インターフェースからコピーされた説明: StateHolder
    このインターフェースを実装するオブジェクトが状態の保存または復元に参加する必要があるかどうかを示します。
    次で指定:
    インターフェース StateHolder の setTransient
    パラメーター:
    transientValue - このオブジェクトが状態の保存または復元に参加しない場合はブール値 true を渡し、それ以外の場合は false を渡します。
  - markInitialState
```
public void markInitialState()
```
    インターフェースからコピーされた説明: PartialStateHolder
    ランタイムは、コンポーネントが初期状態であることを示すために、適切な時間にビュー内のこのインターフェースの各インスタンスで PartialStateHolder.markInitialState() メソッドが呼び出されることを確認する必要があります。インターフェースの実装者は、markInitialState() が呼び出されてから PartialStateHolder.clearInitialState() が呼び出されるまで PartialStateHolder.initialStateMarked() が true を返すことを確認する必要があります。その後、initialStateMarked() は false を返す必要があります。また、インスタンスが initialStateMarked() から true を返す間、実装は StateHolder.saveState(jakarta.faces.context.FacesContext) の実装で変更された状態のみを返す必要があります。
    次で指定:
    インターフェース PartialStateHolder の markInitialState
  - initialStateMarked
```
public boolean initialStateMarked()
```
    インターフェースからコピーされた説明: PartialStateHolder
    デルタ状態の変更が追跡されている場合は true を返し、それ以外の場合は false を返します。
    次で指定:
    インターフェース PartialStateHolder の initialStateMarked
    戻り値:
    初期状態がマークされている場合は true、それ以外の場合は false。
  - clearInitialState
```
public void clearInitialState()
```
    インターフェースからコピーされた説明: PartialStateHolder
    PartialStateHolder を非デルタ追跡状態にリセットします。
    次で指定:
    インターフェース PartialStateHolder の clearInitialState

クラス RegexValidator

フィールドのサマリー

インターフェース jakarta.faces.validator.Validator から継承されたフィールド

コンストラクターの概要

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

フィールドの詳細

VALIDATOR_ID

PATTERN_NOT_SET_MESSAGE_ID

NOT_MATCHED_MESSAGE_ID

MATCH_EXCEPTION_MESSAGE_ID

コンストラクターの詳細

RegexValidator

メソッドの詳細

setPattern

getPattern

validate

saveState

restoreState

isTransient

setTransient

markInitialState

initialStateMarked

clearInitialState