public interface EditableValueHolder extends ValueHolder
EditableValueHolder is an extension of
ValueHolder that describes additional features supported by editable components, including ValueChangeEvent
s
and Validator
s.
Modifier and Type | Method and Description |
---|---|
void |
addValidator(Validator validator)
Add a
Validator instance to the set associated with this component. |
void |
addValueChangeListener(ValueChangeListener listener)
Add a new
ValueChangeListener to the set of listeners interested in being notified when
ValueChangeEvent s occur. |
java.lang.Object |
getSubmittedValue()
Return the submittedValue value of this component.
|
Validator[] |
getValidators()
Return the set of registered
Validator s for this component instance. |
ValueChangeListener[] |
getValueChangeListeners()
Return the set of registered
ValueChangeListener s for this component instance. |
boolean |
isImmediate()
Return the "immediate" state for this component.
|
boolean |
isLocalValueSet()
Return the "local value set" state for this component.
|
boolean |
isRequired()
Return the "required field" state for this component.
|
boolean |
isValid()
Return a flag indicating whether the local value of this component is valid (no conversion error has occurred).
|
void |
removeValidator(Validator validator)
Remove a
Validator instance from the set associated with this component, if it was previously associated. |
void |
removeValueChangeListener(ValueChangeListener listener)
Remove an existing
ValueChangeListener (if any) from the set of listeners interested in being notified when
ValueChangeEvent s occur. |
void |
resetValue()
Convenience method to reset this component's value to the un-initialized state. |
void |
setImmediate(boolean immediate)
Set the "immediate" state for this component.
|
void |
setLocalValueSet(boolean localValueSet)
Sets the "local value set" state for this component.
|
void |
setRequired(boolean required)
Set the "required field" state for this component.
|
void |
setSubmittedValue(java.lang.Object submittedValue)
Set the submittedValue value of this component.
|
void |
setValid(boolean valid)
Set a flag indicating whether the local value of this component is valid (no conversion error has occurred).
|
getConverter, getLocalValue, getValue, setConverter, setValue
java.lang.Object getSubmittedValue()
Return the submittedValue value of this component. This method should only be used by the encodeBegin()
and/or encodeEnd()
methods of this component, or its corresponding Renderer
.
The action taken based on whether the value is null
, empty, or
non-null
is determined based on the value of the
jakarta.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL
context-param.
void resetValue()
Convenience method to reset this component's value to the un-initialized state.
void setSubmittedValue(java.lang.Object submittedValue)
Set the submittedValue value of this component. This method should only be used by the decode()
and
validate()
method of this component, or its corresponding Renderer
.
The action taken based on whether the value is null
, empty, or
non-null
is determined based on the value of the
jakarta.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL
context-param.
submittedValue
- The new submitted valueboolean isLocalValueSet()
setValue()
automatically reset this
property to true
.true
if the local value is set, false
otherwise.void setLocalValueSet(boolean localValueSet)
localValueSet
- the "local value set" boolean.boolean isValid()
Return a flag indicating whether the local value of this component is valid (no conversion error has occurred).
true
if valid, false
otherwise.void setValid(boolean valid)
Set a flag indicating whether the local value of this component is valid (no conversion error has occurred).
valid
- The new valid flagboolean isRequired()
Return the "required field" state for this component.
true
if required, false
otherwise.void setRequired(boolean required)
Set the "required field" state for this component.
required
- The new "required field" stateboolean isImmediate()
Return the "immediate" state for this component.
true
if is immediate, false
otherwise.void setImmediate(boolean immediate)
Set the "immediate" state for this component. When set to true, the component's value will be converted and validated
immediately in the Apply Request Values phase, and ValueChangeEvent
s will be delivered in that phase
as well. The default value for this property must be false
.
immediate
- The new "immediate" statevoid addValidator(Validator validator)
Add a Validator
instance to the set associated with this component.
validator
- The Validator
to addjava.lang.NullPointerException
- if validator
is nullValidator[] getValidators()
Return the set of registered Validator
s for this component instance. If there are no registered validators, a
zero-length array is returned.
void removeValidator(Validator validator)
Remove a Validator
instance from the set associated with this component, if it was previously associated.
Otherwise, do nothing.
validator
- The Validator
to removevoid addValueChangeListener(ValueChangeListener listener)
Add a new ValueChangeListener
to the set of listeners interested in being notified when
ValueChangeEvent
s occur.
listener
- The ValueChangeListener
to be addedjava.lang.NullPointerException
- if listener
is null
ValueChangeListener[] getValueChangeListeners()
Return the set of registered ValueChangeListener
s for this component instance. If there are no registered
listeners, a zero-length array is returned.
void removeValueChangeListener(ValueChangeListener listener)
Remove an existing ValueChangeListener
(if any) from the set of listeners interested in being notified when
ValueChangeEvent
s occur.
listener
- The ValueChangeListener
to be removedjava.lang.NullPointerException
- if listener
is null