Class UIViewParameter
- All Implemented Interfaces:
EventListener
,EditableValueHolder
,PartialStateHolder
,StateHolder
,TransientStateHolder
,ValueHolder
,ComponentSystemEventListener
,FacesListener
,SystemEventListenerHolder
UIViewParameter represents a
binding between a request parameter and a model property or UIViewRoot
property. This is a bi-directional binding.
The ViewDeclarationLanguage
implementation must cause an instance of this component to appear in
the view for each occurrence of an <f:viewParam />
element placed inside of an <f:metadata />
element. The user must place this facet within the
UIViewRoot
.
Because this class extends UIInput
any actions that
one would normally take on a UIInput
instance are valid
for instances of this class. Instances of this class participate in
the regular JSF lifecycle, including on Ajax requests.
- Since:
- 2.0
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
Inner class to encapsulate aUIViewParameter
instance so that it may be safely referenced regardless of whether or not the current view is the same as the view in which thisUIViewParameter
resides. -
Field Summary
Modifier and TypeFieldDescriptionstatic final String
The standard component family for this component.static final String
The standard component type for this component.Fields inherited from class javax.faces.component.UIInput
CONVERSION_MESSAGE_ID, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAME
Fields inherited from class javax.faces.component.UIComponent
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
decode
(FacesContext context) Override behavior from superclass to pull a value from the incoming request parameter map under the name given bygetName()
and store it with a call toUIInput.setSubmittedValue(java.lang.Object)
.void
encodeAll
(FacesContext context) Called specially byUIViewRoot.encodeEnd(javax.faces.context.FacesContext)
, this method simply sets the submitted value to be the return fromgetStringValue(javax.faces.context.FacesContext)
.protected Object
getConvertedValue
(FacesContext context, Object submittedValue) Because this class has noRenderer
, leverage the one from the standard HTML_BASICRenderKit
withcomponent-family: javax.faces.Input
andrenderer-type: javax.faces.Text
and call itsRenderer.getConvertedValue(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.Object)
method.Return the identifier of the component family to which this component belongs.getName()
Return the request parameter name from which the value is retrieved.getStringValue
(FacesContext context) If the value of this parameter comes from aValueExpression
return the value of the expression, otherwise, return the local value.getStringValueFromModel
(FacesContext context) Manually perform standard conversion steps to get a string value from the value expression.Assume that the submitted value is always a string, but the return type from this method isObject
..boolean
Returnfalse
.void
processValidators
(FacesContext context) Specialize superclass behavior to treatnull
differently.void
Set the request parameter name from which the value is retrieved.void
setSubmittedValue
(Object submittedValue) PENDING (docs) Interesting that submitted value isn't saved by the parentvoid
updateModel
(FacesContext context) Call through to superclassUIInput.updateModel(javax.faces.context.FacesContext)
then take the additional action of pushing the value into request scope if and only if the value is not a value expression, is valid, and the local value was set on this lifecycle execution.Methods inherited from class javax.faces.component.UIInput
addValidator, addValueChangeListener, clearInitialState, compareValues, getConverterMessage, getRequiredMessage, getValidator, getValidatorMessage, getValidators, getValue, getValueChangeListener, getValueChangeListeners, isEmpty, isLocalValueSet, isRequired, isValid, markInitialState, processDecodes, processUpdates, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setValid, setValidator, setValidatorMessage, setValue, setValueChangeListener, validate, validateValue
Methods inherited from class javax.faces.component.UIOutput
getConverter, getLocalValue, setConverter
Methods inherited from class javax.faces.component.UIComponentBase
addClientBehavior, addFacesListener, broadcast, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent
Methods inherited from class javax.faces.component.UIComponent
getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, visitTree
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface javax.faces.component.ValueHolder
getConverter, getLocalValue, setConverter
-
Field Details
-
COMPONENT_TYPE
The standard component type for this component.
- See Also:
-
COMPONENT_FAMILY
The standard component family for this component.
- See Also:
-
-
Constructor Details
-
UIViewParameter
public UIViewParameter()Create a new
UIViewParameter
instance with default property values.
-
-
Method Details
-
getFamily
Description copied from class:UIComponent
Return the identifier of the component family to which this component belongs. This identifier, in conjunction with the value of the
rendererType
property, may be used to select the appropriateRenderer
for this component instance. -
getName
Return the request parameter name from which the value is retrieved.
- Since:
- 2.0
-
setName
Set the request parameter name from which the value is retrieved.
- Parameters:
name
- The new request parameter name.- Since:
- 2.0
-
isImmediate
public boolean isImmediate()Return
false
. The immediate setting is not relevant for view parameters and must be assumed to befalse
.- Specified by:
isImmediate
in interfaceEditableValueHolder
- Overrides:
isImmediate
in classUIInput
- Since:
- 2.0
-
getSubmittedValue
Assume that the submitted value is always a string, but the return type from this method is
Object
..- Specified by:
getSubmittedValue
in interfaceEditableValueHolder
- Overrides:
getSubmittedValue
in classUIInput
- Since:
- 2.0
-
setSubmittedValue
PENDING (docs) Interesting that submitted value isn't saved by the parent- Specified by:
setSubmittedValue
in interfaceEditableValueHolder
- Overrides:
setSubmittedValue
in classUIInput
- Parameters:
submittedValue
- The new submitted value
-
decode
Override behavior from superclass to pull a value from the incoming request parameter map under the name given by
getName()
and store it with a call toUIInput.setSubmittedValue(java.lang.Object)
.- Overrides:
decode
in classUIInput
- Parameters:
context
-FacesContext
for the request we are processing- Since:
- 2.0
-
processValidators
Specialize superclass behavior to treat
null
differently. In this class, anull
value along with the "required" flag being set totrue
will cause a validation failure.- Overrides:
processValidators
in classUIInput
- Parameters:
context
-- Since:
- 2.0
-
updateModel
Call through to superclass
UIInput.updateModel(javax.faces.context.FacesContext)
then take the additional action of pushing the value into request scope if and only if the value is not a value expression, is valid, and the local value was set on this lifecycle execution.- Overrides:
updateModel
in classUIInput
- Parameters:
context
-FacesContext
for the request we are processing- Since:
- 2.0
-
encodeAll
Called specially by
UIViewRoot.encodeEnd(javax.faces.context.FacesContext)
, this method simply sets the submitted value to be the return fromgetStringValue(javax.faces.context.FacesContext)
.- Overrides:
encodeAll
in classUIComponent
- Throws:
IOException
- if an input/output error occurs while rendering- Since:
- 2.0
-
getStringValue
If the value of this parameter comes from a
ValueExpression
return the value of the expression, otherwise, return the local value.- Since:
- 2.0
-
getStringValueFromModel
Manually perform standard conversion steps to get a string value from the value expression.
- Throws:
ConverterException
- Since:
- 2.0
-
getConvertedValue
protected Object getConvertedValue(FacesContext context, Object submittedValue) throws ConverterException Because this class has no
Renderer
, leverage the one from the standard HTML_BASICRenderKit
withcomponent-family: javax.faces.Input
andrenderer-type: javax.faces.Text
and call itsRenderer.getConvertedValue(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.Object)
method.- Overrides:
getConvertedValue
in classUIInput
- Throws:
ConverterException
- Since:
- 2.0
-