メソッドの詳細

• getSubmittedValue

  ObjectSE getSubmittedValue()

  このコンポーネントの submittedValue 値を返します。このメソッドは、このコンポーネントの encodeBegin() メソッドおよび / または encodeEnd() メソッド、または対応する Renderer でのみ使用されます。値が null、空、または非 null であるかどうかに基づいて実行されるアクションは、jakarta.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL コンテキストパラメーターの値に基づいて決定されます。

  戻り値:

  送信された値。

• resetValue

  void resetValue()

  このコンポーネントの値を初期化されていない状態にリセットする簡易メソッド。

  導入:

  2.0

• setSubmittedValue

  void setSubmittedValue(ObjectSE submittedValue)

  このコンポーネントの submittedValue 値を設定します。このメソッドは、このコンポーネントの decode() および validate() メソッド、または対応する Renderer でのみ使用する必要があります。値が null、空、または非 null であるかどうかに基づいて実行されるアクションは、jakarta.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL コンテキストパラメーターの値に基づいて決定されます。

  パラメーター:

  submittedValue - 新しく送信された値

• isLocalValueSet

  boolean isLocalValueSet()

  このコンポーネントの「ローカル値セット」の状態を返します。setValue() を呼び出すと、このプロパティは true に自動的にリセットされます。

  戻り値:

  ローカル値が設定されている場合は true、それ以外の場合は false。

• setLocalValueSet

  void setLocalValueSet(boolean localValueSet)

  このコンポーネントの「ローカル値セット」の状態を設定します。

  パラメーター:

  localValueSet - 「ローカル値セット」ブール値。

• isValid

  boolean isValid()

  このコンポーネントのローカル値が有効かどうかを示すフラグを返します（変換エラーは発生していません）。

  戻り値:

  有効な場合は true、それ以外の場合は false。

• setValid

  void setValid(boolean valid)

  このコンポーネントのローカル値が有効である（変換エラーが発生していない）かどうかを示すフラグを設定します。

  パラメーター:

  valid - 新しい有効なフラグ

• isRequired

  boolean isRequired()

  このコンポーネントの「必須フィールド」の状態を返します。

  戻り値:

  必要な場合は true、それ以外の場合は false。

• setRequired

  void setRequired(boolean required)

  このコンポーネントの「必須フィールド」の状態を設定します。

  パラメーター:

  required - 新しい「必須フィールド」状態

• isImmediate

  boolean isImmediate()

  このコンポーネントの「即時」状態を返します。

  戻り値:

  が即時の場合は true、それ以外の場合は false。

• setImmediate

  void setImmediate(boolean immediate)

  このコンポーネントの「即時」状態を設定します。true に設定すると、コンポーネントの値は、リクエスト値の適用フェーズですぐに変換および検証され、ValueChangeEvent もそのフェーズで配信されます。このプロパティのデフォルト値は false である必要があります。

  パラメーター:

  immediate - 新しい「即時」状態

• addValidator

  void addValidator(Validator validator)

  このコンポーネントに関連付けられたセットに Validator インスタンスを追加します。

  パラメーター:

  validator - 追加する Validator

  例外:

  NullPointerExceptionSE - validator が null の場合

• getValidators

  Validator[] getValidators()

  このコンポーネントインスタンスに登録されている Validator のセットを返します。登録されたバリデーターがない場合、長さゼロの配列が返されます。

  戻り値:

  バリデーター、または長さゼロの配列。

• removeValidator

  void removeValidator(Validator validator)

  以前に関連付けられていた場合は、このコンポーネントに関連付けられているセットから Validator インスタンスを削除します。それ以外の場合は、何もしません。

  パラメーター:

  validator - 削除する Validator

• addValueChangeListener

  void addValueChangeListener(ValueChangeListener listener)

  新しい ValueChangeListener を、ValueChangeEvent の発生時に通知を受けることに関心のあるリスナーのセットに追加します。

  パラメーター:

  listener - 追加する ValueChangeListener

  例外:

  NullPointerExceptionSE - listener が null の場合

• getValueChangeListeners

  ValueChangeListener[] getValueChangeListeners()

  このコンポーネントインスタンスに登録されている ValueChangeListener のセットを返します。登録されているリスナーがない場合は、長さがゼロの配列が返されます。

  戻り値:

  値変更リスナー、または長さがゼロの配列。

• removeValueChangeListener

  void removeValueChangeListener(ValueChangeListener listener)

  ValueChangeEvent の発生時に通知を受けることに関心のあるリスナーのセットから既存の ValueChangeListener（存在する場合）を削除します。

  パラメーター:

  listener - 削除する ValueChangeListener

  例外:

  NullPointerExceptionSE - listener が null の場合

• getValidator

  @DeprecatedSE
  MethodBinding getValidator()

  非推奨です。代わりに getValidators() を使用してください。

  このインスタンスに対して setValidator(jakarta.faces.el.MethodBinding) が以前に呼び出されていなかった場合、このメソッドは null を返す必要があります。呼び出された場合、このメソッドは setValidator(jakarta.faces.el.MethodBinding) に渡された正確な MethodBinding インスタンスを返す必要があります。

  このメソッドは、プロセス検証フェーズまたはリクエスト値の適用フェーズで呼び出されます（immediate プロパティの値によって異なります）。

  戻り値:

  メソッドバインディングとしてのバリデーター。

• setValidator

  @DeprecatedSE
  void setValidator(MethodBinding validatorBinding)

  非推奨です。代わりに addValidator(jakarta.faces.validator.Validator) を使用し、MethodExpressionValidator のインスタンスを作成して引数 Validator を取得します。

  引数 validatorBinding を Validator の実装にラップし、getValidators() メソッドをサポートする内部データ構造に格納します。setValidator への以前の呼び出しによって格納されたインスタンスを上書きすることに注意してください。

  引数メソッドは、プロセス検証フェーズまたはリクエスト値の適用フェーズで呼び出されます（immediate プロパティの値によって異なります）。

  このような式で参照されるメソッドはすべて、戻り値の型が void のパブリックであり、型 FacesContext、UIComponent、Object のパラメーターを受け入れる必要があります。

  パラメーター:

  validatorBinding - 新しい MethodBinding インスタンス

• getValueChangeListener

  @DeprecatedSE
  MethodBinding getValueChangeListener()

  非推奨です。代わりに getValueChangeListeners() を使用してください。

  このインスタンスに対して setValueChangeListener(jakarta.faces.el.MethodBinding) が以前に呼び出されていなかった場合、このメソッドは null を返す必要があります。呼び出された場合、このメソッドは setValueChangeListener(jakarta.faces.el.MethodBinding) に渡された正確な MethodBinding インスタンスを返す必要があります。

  戻り値:

  値変更リスナー。

• setValueChangeListener

  @DeprecatedSE
  void setValueChangeListener(MethodBinding valueChangeMethod)

  非推奨です。代わりに addValueChangeListener(jakarta.faces.event.ValueChangeListener) を使用し、MethodExpressionValueChangeListener のインスタンスを作成して引数 ValueChangeListener を取得します。

  引数 valueChangeMethod を ValueChangeListener の実装にラップし、getValueChangeListeners() メソッドをサポートする内部データ構造に格納します。setValueChangeListener への以前の呼び出しによって格納されたインスタンスを上書きすることに注意してください。

  この引数メソッドは、プロセス検証フェーズまたはリクエスト値の適用フェーズで呼び出されます（immediate プロパティの値によって異なります）。

  このような式で参照されるメソッドはすべて、戻り値の型が void のパブリックであり、型 ValueChangeEvent のパラメーターを受け入れる必要があります。

  パラメーター:

  valueChangeMethod - 新しいメソッドバインディングインスタンス