|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.faces.component.UIComponent
javax.faces.component.UIComponentBase
com.sun.webui.jsf.component.TreeNode
com.sun.webui.jsf.component.Tree
public class Tree
The Tree component is used to display a tree structure in the rendered HTML page.
Field Summary | |
---|---|
static java.lang.String |
COOKIE_SUFFIX
This is the suffix appended to the client id to form the key to the cookie Map needed to retrieve the tree selection. |
static java.lang.String |
COOKIE_SUFFIX_EXPAND
This is the suffix appended to the client id to form the key to the cookie Map needed to retrieve the node that may need to be expanded (because it was just selected). |
static java.lang.String |
JAVA_SCRIPT_THEME_KEY
This is the Theme key used to retrieve
the JavaScript needed for this component. |
static java.lang.String |
SELECTED_SUFFIX
This is the suffix appended to the client id when forming a request attribute key. |
static java.lang.String |
TREE_CONTENT_FACET_NAME
String constant representing the content facet name. |
static java.lang.String |
TREE_IMAGE_FACET_NAME
String constant representing the image facet name. |
Fields inherited from class com.sun.webui.jsf.component.TreeNode |
---|
CONTENT_FACET_KEY, IMAGE_FACET_KEY |
Fields inherited from interface javax.faces.component.NamingContainer |
---|
SEPARATOR_CHAR |
Constructor Summary | |
---|---|
Tree()
Constructor. |
Method Summary | |
---|---|
void |
addValidator(javax.faces.validator.Validator validator)
Add a Validator instance to the set associated with
this component. |
void |
addValueChangeListener(javax.faces.event.ValueChangeListener listener)
Add a new ValueChangeListener to the set of listeners
interested in being notified when ValueChangeEvent s
occur. |
void |
broadcast(javax.faces.event.FacesEvent event)
In addition to to the default UIComponent#broadcast
processing, pass the ValueChangeEvent being broadcast
to the method referenced by valueChangeListener . |
void |
decode(javax.faces.context.FacesContext context)
Decode any new state of this UIComponent from the
request contained in the specified FacesContext , and
store this state as needed. |
javax.el.MethodExpression |
getActionExpression()
The action attribute is used to specify the action to take when this component is activated by the user. |
javax.el.MethodExpression |
getActionListenerExpression()
The actionListener attribute is used to specify a method to handle an action event that is triggered when a component is activated by the user. |
javax.faces.convert.Converter |
getConverter()
Return the Converter (if any) that is registered for
this UIComponent . |
java.lang.String |
getCookieExpandNode()
This method will return the TreeNode client ID that is
selected according the browser cookie. |
java.lang.String |
getCookieSelectedTreeNode()
This method returns the TreeNode client ID that is
selected according the browser cookie. |
java.lang.String |
getFamily()
Return the family for this component. |
java.lang.String |
getImageURL()
Absolute or relative URL to the image to be rendered for the tree node. |
java.lang.Object |
getLocalValue()
Return the local value of this UIComponent (if any),
without evaluating any associated ValueBinding . |
boolean |
getRendersChildren()
This component renders its children |
java.lang.String |
getSelected()
Returns the id of the selected tree node. |
java.lang.String |
getStyle()
CSS style(s) to be applied to the outermost HTML element when this component is rendered. |
java.lang.String |
getStyleClass()
CSS style class(es) to be applied to the outermost HTML element when this component is rendered. |
java.lang.Object |
getSubmittedValue()
Return the submittedValue value of this component. |
java.lang.String |
getTarget()
The resource at the specified URL is displayed in the frame that is specified with the target attribute. |
java.lang.String |
getUrl()
Indicates that the text that is specified with the text attribute should be rendered as a hyperlink that resolves to the specified URL. |
javax.faces.el.MethodBinding |
getValidator()
Return a MethodBinding pointing at a method that will
be used to validate the current value of this component. |
javax.faces.validator.Validator[] |
getValidators()
Return the set of registered Validator s for this
component instance. |
java.lang.Object |
getValue()
Gets the value of this UIComponent . |
javax.faces.el.MethodBinding |
getValueChangeListener()
Return a MethodBinding instance method that will be
called after any registered ValueChangeListener s have
been notified of a value change. |
javax.faces.event.ValueChangeListener[] |
getValueChangeListeners()
Return the set of registered ValueChangeListener s for
this component instance. |
javax.el.ValueExpression |
getValueExpression(java.lang.String name)
Return the ValueExpression stored for the
specified name (if any), respecting any property aliases. |
boolean |
isClientSide()
Set the clientSide attribute to true to specify that the Tree component should run on the client. |
boolean |
isExpanded()
Set the expanded attribute to true to display the tree node as expanded when the component is initially rendered. |
boolean |
isExpandOnSelect()
Flag indicating that folder / container nodes will automatically expand when they are selected. |
boolean |
isImmediate()
Flag indicating that event handling for this component should be handled immediately (in Apply Request Values phase) rather than waiting until Invoke Application phase. |
boolean |
isLocalValueSet()
Return the "local value set" state for this component. |
boolean |
isRequired()
Flag indicating that the user must select a value for this tree. |
boolean |
isValid()
Return a flag indicating whether the local value of this component is valid (no conversion error has occurred). |
boolean |
isVisible()
Use the visible attribute to indicate whether the component should be viewable by the user in the rendered HTML page. |
void |
processDecodes(javax.faces.context.FacesContext context)
Perform the component tree processing required by the Apply Request Values phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows. |
void |
processUpdates(javax.faces.context.FacesContext context)
Perform the component tree processing required by the Update Model Values phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows. |
void |
processValidators(javax.faces.context.FacesContext context)
In addition to the standard processValidators behavior
inherited from UIComponentBases , calls
validate() if the immediate property is
false (which is the default); if the component is invalid
afterwards, calls FacesContext.renderResponse . |
void |
removeValidator(javax.faces.validator.Validator validator)
Remove a Validator instance from the set associated
with this component, if it was previously associated. |
void |
removeValueChangeListener(javax.faces.event.ValueChangeListener listener)
Remove an existing ValueChangeListener (if any) from
the set of listeners interested in being notified when
ValueChangeEvent s occur. |
void |
restoreState(javax.faces.context.FacesContext _context,
java.lang.Object _state)
Restore the state of this component. |
java.lang.Object |
saveState(javax.faces.context.FacesContext context)
Save the state of this component. |
void |
selectTreeNode(java.lang.String id)
Deprecated. Use #setValue(Object) |
void |
selectTreeNode(TreeNode treeNode)
Deprecated. Use #setValue(Object) |
void |
setClientSide(boolean clientSide)
Set the clientSide attribute to true to specify that the Tree component should run on the client. |
void |
setConverter(javax.faces.convert.Converter conv)
Set the Converter (if any) that is registered for
this UIComponent . |
void |
setExpandOnSelect(boolean expandOnSelect)
Flag indicating that folder / container nodes will automatically expand when they are selected. |
void |
setId(java.lang.String id)
The component identifier for this component. |
void |
setImmediate(boolean immediate)
Flag indicating that event handling for this component should be handled immediately (in Apply Request Values phase) rather than waiting until Invoke Application phase. |
void |
setLocalValueSet(boolean value)
Sets the "local value set" state for this component. |
void |
setRendered(boolean rendered)
Use the rendered attribute to indicate whether the HTML code for the component should be included in the rendered HTML page. |
void |
setRequired(boolean required)
Flag indicating that the user must select a value for this tree. |
void |
setSelected(java.lang.String selected)
Specify the id of the selected tree node. |
void |
setStyle(java.lang.String style)
CSS style(s) to be applied to the outermost HTML element when this component is rendered. |
void |
setStyleClass(java.lang.String styleClass)
CSS style class(es) to be applied to the outermost HTML element when this component is rendered. |
void |
setSubmittedValue(java.lang.Object value)
Set the submittedValue value of this component. |
void |
setValid(boolean value)
Set a flag indicating whether the local value of this component is valid (no conversion error has occurred). |
void |
setValidator(javax.faces.el.MethodBinding valBinding)
Set a MethodBinding pointing at a method that will be
used to validate the current value of this component. |
void |
setValue(java.lang.Object val)
Set the value of this UIComponent (if any). |
void |
setValueChangeListener(javax.faces.el.MethodBinding method)
Set a MethodBinding instance method that will be
called after any registered ValueChangeListener s have
been notified of a value change. |
void |
setValueExpression(java.lang.String name,
javax.el.ValueExpression binding)
Set the ValueExpression stored for the
specified name (if any), respecting any property
aliases. |
void |
setVisible(boolean visible)
Use the visible attribute to indicate whether the component should be viewable by the user in the rendered HTML page. |
void |
updateModel(javax.faces.context.FacesContext context)
Perform the following algorithm to update the model data associated with this component, if any, as appropriate. |
void |
validate(javax.faces.context.FacesContext context)
Perform the following algorithm to validate the local value of this UIInput . |
Methods inherited from class com.sun.webui.jsf.component.TreeNode |
---|
addActionListener, getAbsoluteRoot, getActionListeners, getChildNode, getChildTreeNodes, getContentHyperlink, getHandleIcon, getImageKeys, getNodeImageHyperlink, getParentTreeNode, getText, getToolTip, getTurnerImageHyperlink, removeActionListener, setActionExpression, setActionListenerExpression, setExpanded, setImageURL, setTarget, setText, setToolTip, setUrl |
Methods inherited from class javax.faces.component.UIComponentBase |
---|
encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientId, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getRendererType, getValueBinding, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, restoreAttachedState, saveAttachedState, setParent, setRendererType, setTransient, setValueBinding |
Methods inherited from class javax.faces.component.UIComponent |
---|
encodeAll, getContainerClientId |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String JAVA_SCRIPT_THEME_KEY
This is the Theme
key used to retrieve
the JavaScript needed for this component.
Theme.getPathToJSFile(String)
,
Constant Field Valuespublic static final java.lang.String SELECTED_SUFFIX
This is the suffix appended to the client id when forming a request attribute key. The value associated with the generated key indicates which node should be selected. The renderer uses this information to generate JavaScript to select this node, overriding the previous selection.
public static final java.lang.String COOKIE_SUFFIX
This is the suffix appended to the client id to form the key to the cookie Map needed to retrieve the tree selection.
public static final java.lang.String COOKIE_SUFFIX_EXPAND
This is the suffix appended to the client id to form the key to the cookie Map needed to retrieve the node that may need to be expanded (because it was just selected).
public static final java.lang.String TREE_CONTENT_FACET_NAME
String constant representing the content facet name.
public static final java.lang.String TREE_IMAGE_FACET_NAME
String constant representing the image facet name.
Constructor Detail |
---|
public Tree()
Method Detail |
---|
public java.lang.String getFamily()
Return the family for this component.
getFamily
in class TreeNode
public void setId(java.lang.String id)
setId
in class TreeNode
public void setRendered(boolean rendered)
setRendered
in class TreeNode
public java.lang.String getTarget()
getTarget
in class TreeNode
public java.lang.String getUrl()
getUrl
in class TreeNode
public java.lang.String getImageURL()
image
facet.
When the imageURL attribute is used with the url attribute, the image is hyperlinked.
getImageURL
in class TreeNode
public javax.el.MethodExpression getActionListenerExpression()
void
. The class that defines the method must implement
the java.io.Serializable
interface or
javax.faces.component.StateHolder
interface.
In the TreeNode component, the method specified with the actionListener atttribute is invoked when the node's handle icon is clicked.
getActionListenerExpression
in class TreeNode
public javax.el.MethodExpression getActionExpression()
(faces-config.xml)
.
java.io.Serializable
interface or
javax.faces.component.StateHolder
interface.
In the Tree and TreeNode components, the action applies only when attributes are used to define the tree and tree nodes. When facets are used, the action attribute does not apply to the facets.
getActionExpression
in class TreeNode
public boolean isExpanded()
TreeNode
Set the expanded attribute to true to display the tree node as expanded when the component is initially rendered. When a node is expanded, its child tree nodes are displayed. By default, nodes are collapsed initially.
isExpanded
in class TreeNode
public boolean isClientSide()
Set the clientSide attribute to true to specify that the Tree component should run on the client. By default, this attribute is false, so the Tree component interacts with the server. In a client-side tree, expanding and collapsing of the tree nodes happens only in the browser. In a server-side tree, a request is made to the server each time the tree nodes are expanded or collapsed. If you use the actionListener attribute to fire events, you must use a server side tree so that the event can be processed.
public void setClientSide(boolean clientSide)
Set the clientSide attribute to true to specify that the Tree component should run on the client. By default, this attribute is false, so the Tree component interacts with the server. In a client-side tree, expanding and collapsing of the tree nodes happens only in the browser. In a server-side tree, a request is made to the server each time the tree nodes are expanded or collapsed. If you use the actionListener attribute to fire events, you must use a server side tree so that the event can be processed.
isClientSide()
public boolean isExpandOnSelect()
Flag indicating that folder / container nodes will automatically expand when they are selected. This attribute is true by default. If you want a tree's container nodes to expand only when the handle icons are clicked, set expandOnSelect to false.
public void setExpandOnSelect(boolean expandOnSelect)
Flag indicating that folder / container nodes will automatically expand when they are selected. This attribute is true by default. If you want a tree's container nodes to expand only when the handle icons are clicked, set expandOnSelect to false.
isExpandOnSelect()
public boolean isImmediate()
Flag indicating that event handling for this component should be handled immediately (in Apply Request Values phase) rather than waiting until Invoke Application phase. May be desired for this component when required is true (although most likely not).
isImmediate
in interface javax.faces.component.EditableValueHolder
public void setImmediate(boolean immediate)
Flag indicating that event handling for this component should be handled immediately (in Apply Request Values phase) rather than waiting until Invoke Application phase. May be desired for this component when required is true (although most likely not).
setImmediate
in interface javax.faces.component.EditableValueHolder
isImmediate()
public boolean isRequired()
Flag indicating that the user must select a value for this tree. Default value is false. This attribute should be hidden from the application developer as it does not make sense in the context of the tree. The isRequired()/setRequired() methods have to be maintained as Tree implements EditableValueHolder.
isRequired
in interface javax.faces.component.EditableValueHolder
public void setRequired(boolean required)
Flag indicating that the user must select a value for this tree. Default value is false.
setRequired
in interface javax.faces.component.EditableValueHolder
isRequired()
public java.lang.String getStyle()
CSS style(s) to be applied to the outermost HTML element when this component is rendered.
getStyle
in class TreeNode
public void setStyle(java.lang.String style)
CSS style(s) to be applied to the outermost HTML element when this component is rendered.
setStyle
in class TreeNode
getStyle()
public java.lang.String getStyleClass()
CSS style class(es) to be applied to the outermost HTML element when this component is rendered.
getStyleClass
in class TreeNode
public void setStyleClass(java.lang.String styleClass)
CSS style class(es) to be applied to the outermost HTML element when this component is rendered.
setStyleClass
in class TreeNode
getStyleClass()
public boolean isVisible()
Use the visible attribute to indicate whether the component should be viewable by the user in the rendered HTML page. If set to false, the HTML code for the component is present in the page, but the component is hidden with style attributes. By default, visible is set to true, so HTML for the component HTML is included and visible to the user. If the component is not visible, it can still be processed on subsequent form submissions because the HTML is present.
isVisible
in class TreeNode
public void setVisible(boolean visible)
Use the visible attribute to indicate whether the component should be viewable by the user in the rendered HTML page. If set to false, the HTML code for the component is present in the page, but the component is hidden with style attributes. By default, visible is set to true, so HTML for the component HTML is included and visible to the user. If the component is not visible, it can still be processed on subsequent form submissions because the HTML is present.
setVisible
in class TreeNode
isVisible()
public boolean getRendersChildren()
getRendersChildren
in class TreeNode
public java.lang.String getSelected()
Returns the id of the selected tree node. Should be cast to a String and nothing else.
public void setSelected(java.lang.String selected)
Specify the id of the selected tree node. Should specify a String object. Also note that this should NOT be the client ID of the selected node.
getSelected()
public javax.el.ValueExpression getValueExpression(java.lang.String name)
Return the ValueExpression
stored for the
specified name (if any), respecting any property aliases.
getValueExpression
in class javax.faces.component.UIComponentBase
name
- Name of value binding to retrievepublic void setValueExpression(java.lang.String name, javax.el.ValueExpression binding)
Set the ValueExpression
stored for the
specified name (if any), respecting any property
aliases.
setValueExpression
in class javax.faces.component.UIComponentBase
name
- Name of value binding to setbinding
- ValueBinding to set, or null to removepublic javax.faces.convert.Converter getConverter()
Return the Converter
(if any) that is registered for
this UIComponent
.
Not implemented for this component.
getConverter
in interface javax.faces.component.ValueHolder
public void setConverter(javax.faces.convert.Converter conv)
Set the Converter
(if any) that is registered for
this UIComponent
.
Not implemented for this component.
setConverter
in interface javax.faces.component.ValueHolder
conv
- New Converter
(or null
)public java.lang.Object getLocalValue()
Return the local value of this UIComponent
(if any),
without evaluating any associated ValueBinding
.
getLocalValue
in interface javax.faces.component.ValueHolder
public java.lang.Object getValue()
Gets the value of this UIComponent
. First, consult the
local value property of this component. If non-null
return it. If non-null, see if we have a ValueBinding
for the value
property. If so, return the result of
evaluating the property, otherwise return null.
getValue
in interface javax.faces.component.ValueHolder
public void setValue(java.lang.Object val)
Set the value of this UIComponent
(if any).
setValue
in interface javax.faces.component.ValueHolder
val
- The new local valuepublic 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
.
getSubmittedValue
in interface javax.faces.component.EditableValueHolder
public void setSubmittedValue(java.lang.Object value)
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
.
setSubmittedValue
in interface javax.faces.component.EditableValueHolder
value
- The new submitted value.public boolean isLocalValueSet()
Return the "local value set" state for this component. Calls to
setValue()
automatically reset this property to
true
.
isLocalValueSet
in interface javax.faces.component.EditableValueHolder
public void setLocalValueSet(boolean value)
Sets the "local value set" state for this component.
setLocalValueSet
in interface javax.faces.component.EditableValueHolder
public boolean isValid()
Return a flag indicating whether the local value of this component is valid (no conversion error has occurred).
isValid
in interface javax.faces.component.EditableValueHolder
public void setValid(boolean value)
Set a flag indicating whether the local value of this component is valid (no conversion error has occurred).
setValid
in interface javax.faces.component.EditableValueHolder
value
- The new valid flag.public javax.faces.el.MethodBinding getValidator()
Return a MethodBinding
pointing at a method that will
be used to validate the current value of this component. This
method will be called during the Process Validations or
Apply Request Values phases (depending on the value of
the immediate
property).
Not implemented for this component.
getValidator
in interface javax.faces.component.EditableValueHolder
public void setValidator(javax.faces.el.MethodBinding valBinding)
Set a MethodBinding
pointing at a method that will be
used to validate the current value of this component. This 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 type
FacesContext
, UIComponent
, and
Object
.
Not implemented for this component.
setValidator
in interface javax.faces.component.EditableValueHolder
valBinding
- The new MethodBinding
instance.public void addValidator(javax.faces.validator.Validator validator)
Add a Validator
instance to the set associated with
this component.
Not implemented for this component.
addValidator
in interface javax.faces.component.EditableValueHolder
validator
- The Validator
to add.public javax.faces.validator.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.
Not implemented for this component.
getValidators
in interface javax.faces.component.EditableValueHolder
public void removeValidator(javax.faces.validator.Validator validator)
Remove a Validator
instance from the set associated
with this component, if it was previously associated. Otherwise,
do nothing.
Not implemented for this component.
removeValidator
in interface javax.faces.component.EditableValueHolder
validator
- The Validator
to remove.public javax.faces.el.MethodBinding getValueChangeListener()
Return a MethodBinding
instance method that will be
called after any registered ValueChangeListener
s have
been notified of a value change. This method will be called during
the Process Validations or Apply Request Values
phases (depending on the value of the immediate
property).
getValueChangeListener
in interface javax.faces.component.EditableValueHolder
public void setValueChangeListener(javax.faces.el.MethodBinding method)
Set a MethodBinding
instance method that will be
called after any registered ValueChangeListener
s have
been notified of a value change. This method will be called
during the Process Validations or Apply Request
Values phases (depending on the value of the
immediate
property).
setValueChangeListener
in interface javax.faces.component.EditableValueHolder
method
- The new MethodBinding instance.public void addValueChangeListener(javax.faces.event.ValueChangeListener listener)
Add a new ValueChangeListener
to the set of listeners
interested in being notified when ValueChangeEvent
s
occur.
addValueChangeListener
in interface javax.faces.component.EditableValueHolder
listener
- The ValueChangeListener
to be added.public javax.faces.event.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.
getValueChangeListeners
in interface javax.faces.component.EditableValueHolder
public void removeValueChangeListener(javax.faces.event.ValueChangeListener listener)
Remove an existing ValueChangeListener
(if any) from
the set of listeners interested in being notified when
ValueChangeEvent
s occur.
removeValueChangeListener
in interface javax.faces.component.EditableValueHolder
listener
- The ValueChangeListener
to be removed.public void decode(javax.faces.context.FacesContext context)
Decode any new state of this UIComponent
from the
request contained in the specified FacesContext
, and
store this state as needed.
During decoding, events may be enqueued for later processing (by
event listeners who have registered an interest), by calling
queueEvent()
.
decode
in class javax.faces.component.UIComponentBase
context
- FacesContext
for the request we are processing.public void broadcast(javax.faces.event.FacesEvent event) throws javax.faces.event.AbortProcessingException
In addition to to the default UIComponent#broadcast
processing, pass the ValueChangeEvent
being broadcast
to the method referenced by valueChangeListener
.
broadcast
in class TreeNode
event
- FacesEvent
to be broadcast
javax.faces.event.AbortProcessingException
- Signal the JSF implementation
that no further processing on the current event should be performedpublic void processUpdates(javax.faces.context.FacesContext context)
Perform the component tree processing required by the Update Model Values phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows.
rendered
property of this
UIComponent
is false
, skip
further processing.processUpdates()
method of all
facets and children of this UIComponent
, in the
order determined by a call to
getFacetsAndChildren()
.
processUpdates
in class javax.faces.component.UIComponentBase
context
- FacesContext
for this requestpublic void updateModel(javax.faces.context.FacesContext context)
Perform the following algorithm to update the model data associated with this component, if any, as appropriate.
valid
property of this component is
false
, take no further action.localValueSet
property of this
component is false
, take no further action.ValueBinding
for value
exists, take no further action.setValue()
method of the
ValueBinding
to update the value that the
ValueBinding
points at.setValue()
method returns successfully:
localValueSet
property of
this component to false.setValue()
method call fails:
addMessage()
on the specified
FacesContext
instance.valid
property of this
component to false
.
context
- FacesContext
for the request we are
processing.public void processDecodes(javax.faces.context.FacesContext context)
Perform the component tree processing required by the Apply Request Values phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows.
rendered
property of this
UIComponent
is false
, skip
further processing.processDecodes()
method of all
facets and children of this UIComponent
, in the
order determined by a call to
getFacetsAndChildren()
.decode()
method of this
component.RuntimeException
is thrown during decode
processing, call FacesContext.renderResponse
and re-throw the exception.
processDecodes
in class javax.faces.component.UIComponentBase
context
- FacesContext
for the request.public void processValidators(javax.faces.context.FacesContext context)
In addition to the standard processValidators
behavior
inherited from UIComponentBases
, calls
validate()
if the immediate
property is
false (which is the default); if the component is invalid
afterwards, calls FacesContext.renderResponse
. If a
RuntimeException
is thrown during validation
processing, calls FacesContext.renderResponse
and
re-throws the exception.
processValidators
in class javax.faces.component.UIComponentBase
public void validate(javax.faces.context.FacesContext context)
Perform the following algorithm to validate the local value of
this UIInput
.
getSubmittedValue()
. If this returns null,
exit without further processing. (This indicates that no
value was submitted for this component.)getConvertedValue
.validateValue
.valid
property of this component is
still true
, retrieve the previous value of
the component (with getValue()
), store the new
local value using setValue()
, and reset the
submitted value to null. If the local value is different
from the previous value of this component, fire a
ValueChangeEvent
to be broadcast to all
interested listeners.
context
- FacesContext
for the current request.public void selectTreeNode(TreeNode treeNode)
This method accepts the TreeNode
which is to be selected.
The previous TreeNode
that was selected will unselected.
No state is saved with this operation, the state is maintained on
the client.
treeNode
- The TreeNode
to be selected.public void selectTreeNode(java.lang.String id)
This method accepts the clientId of a TreeNode
which is to
be selected. The previous TreeNode
that was selected will
unselected. No state is saved with this operation, the state is
maintained on the client-side.
id
- The id of the TreeNode
to be selected.public java.lang.String getCookieSelectedTreeNode()
This method returns the TreeNode
client ID that is
selected according the browser cookie. This method is generally
only useful during the decode process.
public java.lang.String getCookieExpandNode()
This method will return the TreeNode
client ID that is
selected according the browser cookie. This method is only
useful during the decode process as the cookie will typically be
reset to null immediately after the request is processed.
public java.lang.Object saveState(javax.faces.context.FacesContext context)
TreeNode
Save the state of this component.
saveState
in interface javax.faces.component.StateHolder
saveState
in class TreeNode
public void restoreState(javax.faces.context.FacesContext _context, java.lang.Object _state)
Restore the state of this component.
restoreState
in interface javax.faces.component.StateHolder
restoreState
in class TreeNode
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |