Interface EditableValueHolder
- All Superinterfaces:
ValueHolder
- All Known Implementing Classes:
UIInput
,UISelectBoolean
,UISelectMany
,UISelectOne
,UIViewParameter
EditableValueHolder is an
extension of ValueHolder that describes additional features supported
by editable components, including ValueChangeEvent
s and
Validator
s.
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addValidator
(Validator validator) Add aValidator
instance to the set associated with this component.void
addValueChangeListener
(ValueChangeListener listener) Add a newValueChangeListener
to the set of listeners interested in being notified whenValueChangeEvent
s occur.Return the submittedValue value of this component.Deprecated.Return the set of registeredValidator
s for this component instance.Deprecated.UsegetValueChangeListeners()
instead.Return the set of registeredValueChangeListener
s for this component instance.boolean
Return the "immediate" state for this component.boolean
Return the "local value set" state for this component.boolean
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 aValidator
instance from the set associated with this component, if it was previously associated.void
removeValueChangeListener
(ValueChangeListener listener) Remove an existingValueChangeListener
(if any) from the set of listeners interested in being notified whenValueChangeEvent
s occur.void
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
(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).void
setValidator
(MethodBinding validatorBinding) Deprecated.UseaddValidator(javax.faces.validator.Validator)
instead, obtaining the argumentValidator
by creating an instance ofMethodExpressionValidator
.void
setValueChangeListener
(MethodBinding valueChangeMethod) Deprecated.UseaddValueChangeListener(javax.faces.event.ValueChangeListener)
instead, obtaining the argumentValueChangeListener
by creating an instance ofMethodExpressionValueChangeListener
.Methods inherited from interface javax.faces.component.ValueHolder
getConverter, getLocalValue, getValue, setConverter, setValue
-
Method Details
-
getSubmittedValue
Object getSubmittedValue()Return the submittedValue value of this component. This method should only be used by the
encodeBegin()
and/orencodeEnd()
methods of this component, or its correspondingRenderer
. The action taken based on whether the value isnull
, empty, or non-null
is determined based on the value of thejavax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL
context-param. -
resetValue
void resetValue()Convenience method to reset this component's value to the un-initialized state.
- Since:
- 2.0
-
setSubmittedValue
Set the submittedValue value of this component. This method should only be used by the
decode()
andvalidate()
method of this component, or its correspondingRenderer
. The action taken based on whether the value isnull
, empty, or non-null
is determined based on the value of thejavax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL
context-param.- Parameters:
submittedValue
- The new submitted value
-
isLocalValueSet
boolean isLocalValueSet()Return the "local value set" state for this component. Calls tosetValue()
automatically reset this property totrue
. -
setLocalValueSet
void setLocalValueSet(boolean localValueSet) Sets the "local value set" state for this component. -
isValid
boolean isValid()Return a flag indicating whether the local value of this component is valid (no conversion error has occurred).
-
setValid
void setValid(boolean valid) Set a flag indicating whether the local value of this component is valid (no conversion error has occurred).
- Parameters:
valid
- The new valid flag
-
isRequired
boolean isRequired()Return the "required field" state for this component.
-
setRequired
void setRequired(boolean required) Set the "required field" state for this component.
- Parameters:
required
- The new "required field" state
-
isImmediate
boolean isImmediate()Return the "immediate" state for this component.
-
setImmediate
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 befalse
.- Parameters:
immediate
- The new "immediate" state
-
getValidator
MethodBinding getValidator()Deprecated.getValidators()
should be used instead.If
setValidator(javax.faces.el.MethodBinding)
was not previously called for this instance, this method must returnnull
. If it was called, this method must return the exactMethodBinding
instance that was passed tosetValidator(javax.faces.el.MethodBinding)
.This method will be called during the Process Validations or Apply Request Values phases (depending on the value of the
immediate
property). -
setValidator
Deprecated.UseaddValidator(javax.faces.validator.Validator)
instead, obtaining the argumentValidator
by creating an instance ofMethodExpressionValidator
.Wrap the argument
validatorBinding
in an implementation ofValidator
and store it in the internal data structure that backs thegetValidators()
method, taking care to over-write any instance that was stored by a previous call tosetValidator
.The argument method will be called during the Process Validations or Apply Request Values phases (depending on the value of the
immediate
property).Any method referenced by such an expression must be public, with a return type of
void
, and accept parameters of typeFacesContext
,UIComponent
, andObject
.- Parameters:
validatorBinding
- The newMethodBinding
instance
-
getValueChangeListener
MethodBinding getValueChangeListener()Deprecated.UsegetValueChangeListeners()
instead.If
setValueChangeListener(javax.faces.el.MethodBinding)
was not previously called for this instance, this method must returnnull
. If it was called, this method must return the exactMethodBinding
instance that was passed tosetValueChangeListener(javax.faces.el.MethodBinding)
. -
setValueChangeListener
Deprecated.UseaddValueChangeListener(javax.faces.event.ValueChangeListener)
instead, obtaining the argumentValueChangeListener
by creating an instance ofMethodExpressionValueChangeListener
.Wrap the argument
valueChangeMethod
in an implementation ofValueChangeListener
and store it in the internal data structure that backs thegetValueChangeListeners()
method, taking care to over-write any instance that was stored by a previous call tosetValueChangeListener
.This argument method will be called during the Process Validations or Apply Request Values phases (depending on the value of the
immediate
property).Any method referenced by such an expression must be public, with a return type of
void
, and accept a parameter of typeValueChangeEvent
.- Parameters:
valueChangeMethod
- The new method binding instance
-
addValidator
Add a
Validator
instance to the set associated with this component.- Parameters:
validator
- TheValidator
to add- Throws:
NullPointerException
- ifvalidator
is null
-
getValidators
Validator[] getValidators()Return the set of registered
Validator
s for this component instance. If there are no registered validators, a zero-length array is returned. -
removeValidator
Remove a
Validator
instance from the set associated with this component, if it was previously associated. Otherwise, do nothing.- Parameters:
validator
- TheValidator
to remove
-
addValueChangeListener
Add a new
ValueChangeListener
to the set of listeners interested in being notified whenValueChangeEvent
s occur.- Parameters:
listener
- TheValueChangeListener
to be added- Throws:
NullPointerException
- iflistener
isnull
-
getValueChangeListeners
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. -
removeValueChangeListener
Remove an existing
ValueChangeListener
(if any) from the set of listeners interested in being notified whenValueChangeEvent
s occur.- Parameters:
listener
- TheValueChangeListener
to be removed- Throws:
NullPointerException
- iflistener
isnull
-
getValidators()
should be used instead.