java.lang.Object
- jakarta.faces.component.UIComponent
- - com.sun.faces.facelets.tag.composite.BehaviorHolderWrapper

All Implemented Interfaces:

ClientBehaviorHolder, PartialStateHolder, StateHolder, TransientStateHolder, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder, EventListener
```
public class BehaviorHolderWrapper
extends UIComponent
implements ClientBehaviorHolder
```

Field Summary
- Fields inherited from class jakarta.faces.component.UIComponent
  ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, FACETS_KEY, VIEW_LOCATION_KEY

Constructor Summary

Constructors
Constructor	Description
`BehaviorHolderWrapper(UIComponent parent, String virtualEvent, String event, jakarta.el.ValueExpression targets)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`addClientBehavior(String eventName, ClientBehavior behavior)`	Attaches a `ClientBehavior` to the component implementing this interface for the specified event.
`protected void`	`addFacesListener(FacesListener listener)`	Add the specified `FacesListener` to the set of listeners registered to receive event notifications from this `UIComponent`.
`void`	`broadcast(FacesEvent event)`	Broadcast the specified `FacesEvent` to all registered event listeners who have expressed an interest in events of this type.
`void`	`decode(FacesContext context)`	Decode any new state of this `UIComponent` from the request contained in the specified `FacesContext`, and store this state as needed.
`void`	`encodeBegin(FacesContext context)`	If our `rendered` property is `true`, render the beginning of the current state of this `UIComponent` to the response contained in the specified `FacesContext`.
`void`	`encodeChildren(FacesContext context)`	If our `rendered` property is `true`, render the child `UIComponent`s of this `UIComponent`.
`void`	`encodeEnd(FacesContext context)`	If our `rendered` property is `true`, render the ending of the current state of this `UIComponent`.
`UIComponent`	`findComponent(String expr)`	Search for and return the `UIComponent` with an `id` that matches the specified search expression (if any), according to the algorithm described below.
`Map<String,Object>`	`getAttributes()`	Return a mutable `Map` representing the attributes (and properties, see below) associated wth this `UIComponent`, keyed by attribute name (which must be a String).
`int`	`getChildCount()`	Return the number of child `UIComponent`s that are associated with this `UIComponent`.
`List<UIComponent>`	`getChildren()`	Return a mutable `List` representing the child `UIComponent`s associated with this component.
`Map<String,List<ClientBehavior>>`	`getClientBehaviors()`	Returns a non-null, unmodifiable `Map` that contains the the `ClientBehavior`s that have been attached to the component implementing this interface.
`String`	`getClientId(FacesContext context)`	Return a client-side identifier for this component, generating one if necessary.
`String`	`getDefaultEventName()`	Returns the default event name for this `ClientBehaviorHolder` implementation.
`Collection<String>`	`getEventNames()`	Returns a non-null, unmodifiable `Collection` containing the names of the logical events supported by the component implementing this interface.
`protected FacesContext`	`getFacesContext()`	Convenience method to return the `FacesContext` instance for the current request.
`protected FacesListener[]`	`getFacesListeners(Class clazz)`	Return an array of registered `FacesListener`s that are instances of the specified class.
`UIComponent`	`getFacet(String name)`	Convenience method to return the named facet, if it exists, or `null` otherwise.
`Map<String,UIComponent>`	`getFacets()`	Return a mutable `Map` representing the facet `UIComponent`s associated with this `UIComponent`, keyed by facet name (which must be a String).
`Iterator<UIComponent>`	`getFacetsAndChildren()`	Return an `Iterator` over the facet followed by child `UIComponent`s of this `UIComponent`.
`String`	`getFamily()`	Return the identifier of the component family to which this component belongs.
`String`	`getId()`	Return the component identifier of this `UIComponent`.
`UIComponent`	`getParent()`	Return the parent `UIComponent` of this `UIComponent`, if any.
`Map<String,Object>`	`getPassThroughAttributes(boolean create)`	This method has the same specification as `UIComponent.getPassThroughAttributes()` except that it is allowed to return `null` if and only if the argument `create` is `false` and no pass through attribute data structure exists for this instance.
`protected Renderer`	`getRenderer(FacesContext context)`	Convenience method to return the `Renderer` instance associated with this component, if any; otherwise, return `null`.
`String`	`getRendererType()`	Return the `Renderer` type for this `UIComponent` (if any).
`boolean`	`getRendersChildren()`	Return a flag indicating whether this component is responsible for rendering its child components.
`jakarta.el.ValueExpression`	`getTargets()`
`jakarta.el.ValueExpression`	`getValueExpression(String name)`	Return the `ValueExpression` used to calculate the value for the specified attribute or property name, if any.
`boolean`	`invokeOnComponent(FacesContext context, String clientId, ContextCallback callback)`	Starting at this component in the View hierarchy, search for a component with a `clientId` equal to the argument `clientId` and, if found, call the `ContextCallback.invokeContextCallback(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent)` method on the argument `callback`, passing the current `FacesContext` and the found component as arguments.
`boolean`	`isInView()`	Return `true` if this component is within the view hierarchy otherwise `false`
`boolean`	`isRendered()`	Return `true` if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle.
`boolean`	`isTransient()`	If true, the Object implementing this interface must not participate in state saving or restoring.
`void`	`processDecodes(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`	`processEvent(ComponentSystemEvent event)`	The default implementation performs the following action.
`void`	`processRestoreState(FacesContext context, Object state)`	Perform the component tree processing required by the Restore View phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows.
`Object`	`processSaveState(FacesContext context)`	Perform the component tree processing required by the state saving portion of the Render Response 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(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(FacesContext context)`	Perform the component tree processing required by the Process Validations phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows.
`void`	`queueEvent(FacesEvent event)`	Queue an event for broadcast at the end of the current request processing lifecycle phase.
`protected void`	`removeFacesListener(FacesListener listener)`	Remove the specified `FacesListener` from the set of listeners registered to receive event notifications from this `UIComponent`.
`void`	`restoreState(FacesContext context, Object state)`	Perform any processing required to restore the state from the entries in the state Object.
`Object`	`saveState(FacesContext context)`	Gets the state of the instance as a `Serializable` Object.
`void`	`setId(String id)`	Set the component identifier of this `UIComponent` (if any).
`void`	`setParent(UIComponent parent)`	Set the parent `UIComponent` of this `UIComponent`.
`void`	`setRendered(boolean rendered)`	Set the `rendered` property of this `UIComponent`.
`void`	`setRendererType(String rendererType)`	Set the `Renderer` type for this `UIComponent`, or `null` for components that render themselves.
`void`	`setTransient(boolean newTransientValue)`	Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.
`void`	`setValueExpression(String name, jakarta.el.ValueExpression binding)`	Set the `ValueExpression` used to calculate the value for the specified attribute or property name, if any.
`void`	`subscribeToEvent(Class<? extends SystemEvent> eventClass, ComponentSystemEventListener componentListener)`	This implementation throws `UnsupportedOperationException` and is provided for the sole purpose of not breaking existing applications that extend this class.
`void`	`unsubscribeFromEvent(Class<? extends SystemEvent> eventClass, ComponentSystemEventListener componentListener)`	This implementation throws `UnsupportedOperationException` and is provided for the sole purpose of not breaking existing applications that extend this class.
`boolean`	`visitTree(VisitContext context, VisitCallback callback)`	Perform a tree visit starting at this node in the tree.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - BehaviorHolderWrapper
```
public BehaviorHolderWrapper(UIComponent parent,
                             String virtualEvent,
                             String event,
                             jakarta.el.ValueExpression targets)
```
- Method Detail
  - broadcast
```
public void broadcast(FacesEvent event)
               throws AbortProcessingException
```
    Description copied from class: UIComponent
    
    Broadcast the specified FacesEvent to all registered event listeners who have expressed an interest in events of this type. Listeners are called in the order in which they were added.
    
    If the event is an instance of BehaviorEvent and the current component is the source of the event call BehaviorEvent.getBehavior() to get the Behavior for the event. Call Behavior.broadcast(jakarta.faces.event.BehaviorEvent) on the Behavior instance.
    
    Specified by:
    
    broadcast in class UIComponent
    
    Parameters:
    
    event - The FacesEvent to be broadcast
    
    Throws:
    
    AbortProcessingException - Signal the Jakarta Faces implementation that no further processing on the current event should be performed
    
    See Also:
    
    UIComponent.broadcast(jakarta.faces.event.FacesEvent)
  - decode
```
public void decode(FacesContext context)
```
    Description copied from class: UIComponent
    
    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().
    
    Specified by:
    
    decode in class UIComponent
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    See Also:
    
    UIComponent.decode(jakarta.faces.context.FacesContext)
  - encodeBegin
```
public void encodeBegin(FacesContext context)
                 throws IOException
```
    Description copied from class: UIComponent
    
    If our rendered property is true, render the beginning of the current state of this UIComponent to the response contained in the specified FacesContext. Call UIComponent.pushComponentToEL(jakarta.faces.context.FacesContext,jakarta.faces.component.UIComponent). Call Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object), passing PreRenderComponentEvent.class as the first argument and the component instance to be rendered as the second argument.
    
    If a Renderer is associated with this UIComponent, the actual encoding will be delegated to Renderer.encodeBegin(FacesContext, UIComponent).
    
    If our rendered property is false, call UIComponent.pushComponentToEL(jakarta.faces.context.FacesContext,jakarta.faces.component.UIComponent) and return immediately.
    
    Specified by:
    
    encodeBegin in class UIComponent
    
    Parameters:
    
    context - FacesContext for the response we are creating
    
    Throws:
    
    IOException - if an input/output error occurs while rendering
    
    See Also:
    
    UIComponent.encodeBegin(jakarta.faces.context.FacesContext)
  - encodeChildren
```
public void encodeChildren(FacesContext context)
                    throws IOException
```
    Description copied from class: UIComponent
    
    If our rendered property is true, render the child UIComponents of this UIComponent. This method will only be called if the rendersChildren property is true.
    
    If a Renderer is associated with this UIComponent, the actual encoding will be delegated to Renderer.encodeChildren(FacesContext, UIComponent). If no Renderer is associated with this UIComponent, iterate over each of the children of this component and call UIComponent.encodeAll(jakarta.faces.context.FacesContext).
    
    Specified by:
    
    encodeChildren in class UIComponent
    
    Parameters:
    
    context - FacesContext for the response we are creating
    
    Throws:
    
    IOException - if an input/output error occurs while rendering
    
    See Also:
    
    UIComponent.encodeChildren(jakarta.faces.context.FacesContext)
  - encodeEnd
```
public void encodeEnd(FacesContext context)
               throws IOException
```
    Description copied from class: UIComponent
    
    If our rendered property is true, render the ending of the current state of this UIComponent.
    
    If a Renderer is associated with this UIComponent, the actual encoding will be delegated to Renderer.encodeEnd(FacesContext, UIComponent).
    
    Call UIComponent.popComponentFromEL(jakarta.faces.context.FacesContext). before returning regardless of the value of the rendered property.
    
    Specified by:
    
    encodeEnd in class UIComponent
    
    Parameters:
    
    context - FacesContext for the response we are creating
    
    Throws:
    
    IOException - if an input/output error occurs while rendering
    
    See Also:
    
    UIComponent.encodeEnd(jakarta.faces.context.FacesContext)
  - findComponent
```
public UIComponent findComponent(String expr)
```
    Description copied from class: UIComponent
    Search for and return the UIComponent with an id that matches the specified search expression (if any), according to the algorithm described below.
    
    WARNING: The found UIComponent instance, if any, is returned without regard for its tree traversal context. Retrieving an Jakarta Expression Language-bound attribute from the component is not safe. Jakarta Expression Language expressions can contain implicit objects, such as #{component}, which assume they are being evaluated within the scope of a tree traversal context. Evaluating expressions with these kinds of implicit objects outside of a tree traversal context produces undefined results. See UIComponent.invokeOnComponent(jakarta.faces.context.FacesContext, java.lang.String, jakarta.faces.component.ContextCallback) for a method that does correctly account for the tree traversal context when operating on the found UIComponent instance. UIComponent.invokeOnComponent(jakarta.faces.context.FacesContext, java.lang.String, jakarta.faces.component.ContextCallback) is also useful to find components given a simple clientId.
    Component identifiers are required to be unique within the scope of the closest ancestor NamingContainer that encloses this component (which might be this component itself). If there are no NamingContainer components in the ancestry of this component, the root component in the tree is treated as if it were a NamingContainer, whether or not its class actually implements the NamingContainer interface.
    
    A search expression consists of either an identifier (which is matched exactly against the id property of a UIComponent, or a series of such identifiers linked by the UINamingContainer.getSeparatorChar(jakarta.faces.context.FacesContext) character value. The search algorithm should operates as follows, though alternate alogrithms may be used as long as the end result is the same:
    
    Identify the UIComponent that will be the base for searching, by stopping as soon as one of the following conditions is met:
    
    If the search expression begins with the the separator character (called an "absolute" search expression), the base will be the root UIComponent of the component tree. The leading separator character will be stripped off, and the remainder of the search expression will be treated as a "relative" search expression as described below.
    
    Otherwise, if this UIComponent is a NamingContainer it will serve as the basis.
    
    Otherwise, search up the parents of this component. If a NamingContainer is encountered, it will be the base.
    
    Otherwise (if no NamingContainer is encountered) the root UIComponent will be the base.
    
    The search expression (possibly modified in the previous step) is now a "relative" search expression that will be used to locate the component (if any) that has an id that matches, within the scope of the base component. The match is performed as follows:
    
    If the search expression is a simple identifier, this value is compared to the id property, and then recursively through the facets and children of the base UIComponent (except that if a descendant NamingContainer is found, its own facets and children are not searched).
    
    If the search expression includes more than one identifier separated by the separator character, the first identifier is used to locate a NamingContainer by the rules in the previous bullet point. Then, the findComponent() method of this NamingContainer will be called, passing the remainder of the search expression.
    Specified by:
    
    findComponent in class UIComponent
    
    Parameters:
    
    expr - Search expression identifying the UIComponent to be returned
    
    Returns:
    
    the found UIComponent, or null if the component was not found.
    
    See Also:
    
    UIComponent.findComponent(java.lang.String)
  - getAttributes
```
public Map<String,Object> getAttributes()
```
    Description copied from class: UIComponent
    Return a mutable Map representing the attributes (and properties, see below) associated wth this UIComponent, keyed by attribute name (which must be a String). The returned implementation must support all of the standard and optional Map methods, plus support the following additional requirements:
    
    The Map implementation must implement the java.io.Serializable interface.
    
    Any attempt to add a null key or value must throw a NullPointerException.
    
    Any attempt to add a key that is not a String must throw a ClassCastException.
    
    If the attribute name specified as a key matches a property of this UIComponent's implementation class, the following methods will have special behavior:
    
    containsKey - Return false.
    
    get() - If the property is readable, call the getter method and return the returned value (wrapping primitive values in their corresponding wrapper classes); otherwise throw IllegalArgumentException.
    
    put() - If the property is writeable, call the setter method to set the corresponding value (unwrapping primitive values in their corresponding wrapper classes). If the property is not writeable, or an attempt is made to set a property of primitive type to null, throw IllegalArgumentException.
    
    remove - Throw IllegalArgumentException.
    Specified by:
    
    getAttributes in class UIComponent
    
    Returns:
    
    the component attribute map.
    
    See Also:
    
    UIComponent.getAttributes()
  - getPassThroughAttributes
```
public Map<String,Object> getPassThroughAttributes(boolean create)
```
    Description copied from class: UIComponent
    
    This method has the same specification as UIComponent.getPassThroughAttributes() except that it is allowed to return null if and only if the argument create is false and no pass through attribute data structure exists for this instance. The returned Map implementation must support all of the standard and optional Map methods, plus support the following additional requirements. The map must be stored in using UIComponent.getStateHelper().
    
    The Map implementation must implement java.io.Serializable.
    
    Any attempt to add a null key or value must throw a NullPointerException.
    
    Any attempt to add a key that is not a String must throw an IllegalArgumentException.
    
    For backward compatibility with components that extend directly from this class, a default implementation is provided that returns the empty map.
    
    Overrides:
    
    getPassThroughAttributes in class UIComponent
    
    Parameters:
    
    create - if true, a new Map instance will be created if it does not exist already. If false, and there is no existing Map instance, one will not be created and null will be returned.
    
    Returns:
    
    A Map instance, or null.
  - getChildCount
```
public int getChildCount()
```
    Description copied from class: UIComponent
    
    Return the number of child UIComponents that are associated with this UIComponent. If there are no children, this method must return 0. The method must not cause the creation of a child component list.
    
    Specified by:
    
    getChildCount in class UIComponent
    
    Returns:
    
    the number of child components.
    
    See Also:
    
    UIComponent.getChildCount()
  - getChildren
```
public List<UIComponent> getChildren()
```
    Description copied from class: UIComponent
    Return a mutable List representing the child UIComponents associated with this component. The returned implementation must support all of the standard and optional List methods, plus support the following additional requirements:
    
    The List implementation must implement the java.io.Serializable interface.
    
    Any attempt to add a null must throw a NullPointerException
    
    Any attempt to add an object that does not implement UIComponent must throw a ClassCastException.
    
    Whenever a new child component is added, the parent property of the child must be set to this component instance. If the parent property of the child was already non-null, the child must first be removed from its previous parent (where it may have been either a child or a facet).
    
    Whenever an existing child component is removed, the parent property of the child must be set to null.
    
    After the child component has been added to the view, Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object) must be called, passing PostAddToViewEvent.class as the first argument and the newly added component as the second argument if any the following cases are true.
    
    FacesContext.getCurrentPhaseId() returns PhaseId.RESTORE_VIEW and partial state saving is enabled.
    
    FacesContext.isPostback() returns false and FacesContext.getCurrentPhaseId() returns something other than PhaseId.RESTORE_VIEW
    Specified by:
    
    getChildren in class UIComponent
    
    Returns:
    
    the list of children.
    
    See Also:
    
    UIComponent.getChildren()
  - getClientId
```
public String getClientId(FacesContext context)
```
    Description copied from class: UIComponent
    
    Return a client-side identifier for this component, generating one if necessary. The associated Renderer, if any, will be asked to convert the clientId to a form suitable for transmission to the client.
    
    The return from this method must be the same value throughout the lifetime of the instance, unless the id property of the component is changed, or the component is placed in a NamingContainer whose client ID changes (for example, UIData). However, even in these cases, consecutive calls to this method must always return the same value. The implementation must follow these steps in determining the clientId:
    
    Find the closest ancestor to this component in the view hierarchy that implements NamingContainer. Call getContainerClientId() on it and save the result as the parentId local variable. Call UIComponent.getId() on this component and save the result as the myId local variable. If myId is null, call context.getViewRoot().createUniqueId() and assign the result to myId. If parentId is non-null, let myId equal parentId + UINamingContainer.getSeparatorChar(jakarta.faces.context.FacesContext) + myId. Call Renderer.convertClientId(jakarta.faces.context.FacesContext, java.lang.String), passing myId, and return the result.
    
    Specified by:
    
    getClientId in class UIComponent
    
    Parameters:
    
    context - The FacesContext for the current request
    
    Returns:
    
    the client id.
    
    See Also:
    
    UIComponent.getClientId(jakarta.faces.context.FacesContext)
  - getFacet
```
public UIComponent getFacet(String name)
```
    Description copied from class: UIComponent
    
    Convenience method to return the named facet, if it exists, or null otherwise. If the requested facet does not exist, the facets Map must not be created.
    
    Specified by:
    
    getFacet in class UIComponent
    
    Parameters:
    
    name - Name of the desired facet
    
    Returns:
    
    the component, or null.
    
    See Also:
    
    UIComponent.getFacet(java.lang.String)
  - getFacets
```
public Map<String,UIComponent> getFacets()
```
    Description copied from class: UIComponent
    Return a mutable Map representing the facet UIComponents associated with this UIComponent, keyed by facet name (which must be a String). The returned implementation must support all of the standard and optional Map methods, plus support the following additional requirements:
    
    The Map implementation must implement the java.io.Serializable interface.
    
    Any attempt to add a null key or value must throw a NullPointerException.
    
    Any attempt to add a key that is not a String must throw a ClassCastException.
    
    Any attempt to add a value that is not a UIComponent must throw a ClassCastException.
    
    Whenever a new facet UIComponent is added:
    
    The parent property of the component must be set to this component instance.
    
    If the parent property of the component was already non-null, the component must first be removed from its previous parent (where it may have been either a child or a facet).
    
    Whenever an existing facet UIComponent is removed:
    
    The parent property of the facet must be set to null.
    Specified by:
    
    getFacets in class UIComponent
    
    Returns:
    
    the map of facets.
    
    See Also:
    
    UIComponent.getFacets()
  - getFacetsAndChildren
```
public Iterator<UIComponent> getFacetsAndChildren()
```
    Description copied from class: UIComponent
    
    Return an Iterator over the facet followed by child UIComponents of this UIComponent. Facets are returned in an undefined order, followed by all the children in the order they are stored in the child list. If this component has no facets or children, an empty Iterator is returned.
    
    The returned Iterator must not support the remove() operation.
    
    Specified by:
    
    getFacetsAndChildren in class UIComponent
    
    Returns:
    
    the facets and children iterator.
    
    See Also:
    
    UIComponent.getFacetsAndChildren()
  - getFamily
```
public String 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 appropriate Renderer for this component instance. Note this method should NOT return null
    
    Specified by:
    
    getFamily in class UIComponent
    
    Returns:
    
    the component family (not null).
    
    See Also:
    
    UIComponent.getFamily()
  - getId
```
public String getId()
```
    Description copied from class: UIComponent
    
    Return the component identifier of this UIComponent.
    
    Specified by:
    
    getId in class UIComponent
    
    Returns:
    
    the component identifier.
    
    See Also:
    
    UIComponent.getId()
  - getParent
```
public UIComponent getParent()
```
    Description copied from class: UIComponent
    
    Return the parent UIComponent of this UIComponent, if any. A component must allow child components to be added to and removed from the list of children of this component, even though the child component returns null from getParent( ).
    
    Specified by:
    
    getParent in class UIComponent
    
    Returns:
    
    the parent component.
    
    See Also:
    
    UIComponent.getParent()
  - getRendererType
```
public String getRendererType()
```
    Description copied from class: UIComponent
    
    Return the Renderer type for this UIComponent (if any).
    
    Specified by:
    
    getRendererType in class UIComponent
    
    Returns:
    
    the renderer type.
    
    See Also:
    
    UIComponent.getRendererType()
  - getRendersChildren
```
public boolean getRendersChildren()
```
    Description copied from class: UIComponent
    
    Return a flag indicating whether this component is responsible for rendering its child components. The default implementation in UIComponentBase.getRendersChildren() tries to find the renderer for this component. If it does, it calls Renderer.getRendersChildren() and returns the result. If it doesn't, it returns false. As of version 1.2 of the Jakarta Faces Specification, component authors are encouraged to return true from this method and rely on UIComponentBase.encodeChildren(jakarta.faces.context.FacesContext).
    
    Specified by:
    
    getRendersChildren in class UIComponent
    
    Returns:
    
    true if the component renders its children, false otherwise.
    
    See Also:
    
    UIComponent.getRendersChildren()
  - getValueExpression
```
public jakarta.el.ValueExpression getValueExpression(String name)
```
    Description copied from class: UIComponent
    
    Return the ValueExpression used to calculate the value for the specified attribute or property name, if any.
    
    This method must be overridden and implemented for components that comply with Jakarta Faces 1.2 and later.
    
    Overrides:
    
    getValueExpression in class UIComponent
    
    Parameters:
    
    name - Name of the attribute or property for which to retrieve a ValueExpression
    
    Returns:
    
    the value expression, or null.
  - invokeOnComponent
```
public boolean invokeOnComponent(FacesContext context,
                                 String clientId,
                                 ContextCallback callback)
                          throws FacesException
```
    Description copied from class: UIComponent
    Starting at this component in the View hierarchy, search for a component with a clientId equal to the argument clientId and, if found, call the ContextCallback.invokeContextCallback(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent) method on the argument callback, passing the current FacesContext and the found component as arguments. This method is similar to UIComponent.findComponent(java.lang.String) but it does not support the leading UINamingContainer.getSeparatorChar(jakarta.faces.context.FacesContext) syntax for searching from the root of the View.
    
    The default implementation will first check if this.getClientId() is equal to the argument clientId. If so, first call UIComponent.pushComponentToEL(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent), then call the ContextCallback.invokeContextCallback(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent) method on the argument callback, passing through the FacesContext argument and passing this as the component argument. Then call UIComponent.popComponentFromEL(jakarta.faces.context.FacesContext). If an Exception is thrown by the callback, wrap it in a FacesException and re-throw it. Otherwise, return true.
    
    Otherwise, for each component returned by UIComponent.getFacetsAndChildren(), call invokeOnComponent() passing the arguments to this method, in order. The first time invokeOnComponent() returns true, abort traversing the rest of the Iterator and return true.
    
    When calling ContextCallback.invokeContextCallback(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent) the implementation of this method must guarantee that the state of the component passed to the callback correctly reflects the component's position in the View hierarchy with respect to any state found in the argument clientId. For example, an iterating component such as UIData will need to set its row index to correctly reflect the argument clientId before finding the appropriate child component backed by the correct row. When the callback returns, either normally or by throwing an Exception the implementation of this method must restore the state of the view to the way it was before invoking the callback.
    
    If none of the elements from UIComponent.getFacetsAndChildren() returned true from invokeOnComponent(), return false.
    
    Simple usage example to find a component by clientId.
    
    private UIComponent found = null; private void doFind(FacesContext context, String clientId) { context.getViewRoot().invokeOnComponent(context, clientId, new ContextCallback() { public void invokeContextCallback(FacesContext context, UIComponent component) { found = component; } }); }
    Overrides:
    
    invokeOnComponent in class UIComponent
    
    Parameters:
    
    context - the FacesContext for the current request
    
    clientId - the client identifier of the component to be passed to the argument callback.
    
    callback - an implementation of the Callback interface.
    
    Returns:
    
    true if the a component with the given clientId is found, the callback method was successfully invoked passing that component as an argument, and no Exception was thrown. Returns false if no component with the given clientId is found.
    
    Throws:
    
    FacesException - if the argument Callback throws an Exception, it is wrapped in a FacesException and re-thrown.
    
    See Also:
    
    UIComponent.invokeOnComponent(jakarta.faces.context.FacesContext, java.lang.String, jakarta.faces.component.ContextCallback)
  - isInView
```
public boolean isInView()
```
    Description copied from class: UIComponent
    
    Return true if this component is within the view hierarchy otherwise false
    
    Overrides:
    
    isInView in class UIComponent
    
    Returns:
    
    true if within a view hierarchy, false otherwise.
    
    See Also:
    
    UIComponent.isInView()
  - isRendered
```
public boolean isRendered()
```
    Description copied from class: UIComponent
    
    Return true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle.
    
    Specified by:
    
    isRendered in class UIComponent
    
    Returns:
    
    true if the component should be rendered, false otherwise.
    
    See Also:
    
    UIComponent.isRendered()
  - isTransient
```
public boolean isTransient()
```
    Description copied from interface: StateHolder
    
    If true, the Object implementing this interface must not participate in state saving or restoring.
    
    Specified by:
    
    isTransient in interface StateHolder
    
    Returns:
    
    true if transient, false otherwise.
    
    See Also:
    
    StateHolder.isTransient()
  - processDecodes
```
public void processDecodes(FacesContext context)
```
    Description copied from class: UIComponent
    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.
    
    If the rendered property of this UIComponent is false, skip further processing.
    
    Call UIComponent.pushComponentToEL(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent).
    
    Call the processDecodes() method of all facets and children of this UIComponent, in the order determined by a call to getFacetsAndChildren().
    
    Call the decode() method of this component.
    
    Call UIComponent.popComponentFromEL(jakarta.faces.context.FacesContext) from inside of a finally block, just before returning.
    
    If a RuntimeException is thrown during decode processing, call FacesContext.renderResponse() and re-throw the exception.
    Specified by:
    
    processDecodes in class UIComponent
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    See Also:
    
    UIComponent.processDecodes(jakarta.faces.context.FacesContext)
  - processEvent
```
public void processEvent(ComponentSystemEvent event)
                  throws AbortProcessingException
```
    Description copied from class: UIComponent
    
    The default implementation performs the following action. If the argument event is an instance of PostRestoreStateEvent, call this.UIComponent.getValueExpression(java.lang.String) passing the literal string “binding”, without the quotes, as the argument. If the result is non-null, set the value of the ValueExpression to be this.
    
    Specified by:
    
    processEvent in interface ComponentSystemEventListener
    
    Overrides:
    
    processEvent in class UIComponent
    
    Parameters:
    
    event - the ComponentSystemEvent instance that is being processed.
    
    Throws:
    
    AbortProcessingException - if lifecycle processing should cease for this request.
    
    See Also:
    
    UIComponent.processEvent(jakarta.faces.event.ComponentSystemEvent)
  - processRestoreState
```
public void processRestoreState(FacesContext context,
                                Object state)
```
    Description copied from class: UIComponent
    Perform the component tree processing required by the Restore View phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows.
    
    Call the restoreState() method of this component.
    
    Call UIComponent.pushComponentToEL(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent).
    
    Call the processRestoreState() method of all facets and children of this UIComponent in the order determined by a call to getFacetsAndChildren(). After returning from the processRestoreState() method on a child or facet, call UIComponent.popComponentFromEL(jakarta.faces.context.FacesContext)
    
    This method may not be called if the state saving method is set to server.
    Specified by:
    
    processRestoreState in class UIComponent
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    state - the state.
    
    See Also:
    
    UIComponent.processRestoreState(jakarta.faces.context.FacesContext, java.lang.Object)
  - processSaveState
```
public Object processSaveState(FacesContext context)
```
    Description copied from class: UIComponent
    Perform the component tree processing required by the state saving portion of the Render Response phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows.
    
    consult the transient property of this component. If true, just return null.
    
    Call UIComponent.pushComponentToEL(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent).
    
    Call the processSaveState() method of all facets and children of this UIComponent in the order determined by a call to getFacetsAndChildren(), skipping children and facets that are transient. Ensure that UIComponent.popComponentFromEL(jakarta.faces.context.FacesContext) is called correctly after each child or facet.
    
    Call the saveState() method of this component.
    
    Encapsulate the child state and your state into a Serializable Object and return it.
    
    This method may not be called if the state saving method is set to server.
    Specified by:
    
    processSaveState in class UIComponent
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    Returns:
    
    the saved state.
    
    See Also:
    
    UIComponent.processSaveState(jakarta.faces.context.FacesContext)
  - processUpdates
```
public void processUpdates(FacesContext context)
```
    Description copied from class: UIComponent
    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.
    
    If the rendered property of this UIComponent is false, skip further processing.
    
    Call UIComponent.pushComponentToEL(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent).
    
    Call the processUpdates() method of all facets and children of this UIComponent, in the order determined by a call to getFacetsAndChildren(). After returning from the processUpdates() method on a child or facet, call UIComponent.popComponentFromEL(jakarta.faces.context.FacesContext)
    Specified by:
    
    processUpdates in class UIComponent
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    See Also:
    
    UIComponent.processUpdates(jakarta.faces.context.FacesContext)
  - processValidators
```
public void processValidators(FacesContext context)
```
    Description copied from class: UIComponent
    Perform the component tree processing required by the Process Validations phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows.
    
    If the rendered property of this UIComponent is false, skip further processing.
    
    Call UIComponent.pushComponentToEL(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent).
    
    Call the processValidators() method of all facets and children of this UIComponent, in the order determined by a call to getFacetsAndChildren().
    
    After returning from calling getFacetsAndChildren() call UIComponent.popComponentFromEL(jakarta.faces.context.FacesContext).
    Specified by:
    
    processValidators in class UIComponent
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    See Also:
    
    UIComponent.processValidators(jakarta.faces.context.FacesContext)
  - queueEvent
```
public void queueEvent(FacesEvent event)
```
    Description copied from class: UIComponent
    
    Queue an event for broadcast at the end of the current request processing lifecycle phase. The default implementation in UIComponentBase must delegate this call to the queueEvent() method of the parent UIComponent.
    
    Specified by:
    
    queueEvent in class UIComponent
    
    Parameters:
    
    event - FacesEvent to be queued
    
    See Also:
    
    UIComponent.queueEvent(jakarta.faces.event.FacesEvent)
  - restoreState
```
public void restoreState(FacesContext context,
                         Object state)
```
    Description copied from interface: StateHolder
    
    Perform any processing required to restore the state from the entries in the state Object.
    
    If the class that implements this interface has references to instances that also implement StateHolder (such as a UIComponent with event handlers, validators, etc.) this method must call the StateHolder.restoreState(jakarta.faces.context.FacesContext, java.lang.Object) method on all those instances as well.
    
    If the state argument is null, take no action and return.
    
    Specified by:
    
    restoreState in interface StateHolder
    
    Parameters:
    
    context - the Faces context.
    
    state - the state.
    
    See Also:
    
    StateHolder.restoreState(jakarta.faces.context.FacesContext, java.lang.Object)
  - saveState
```
public Object saveState(FacesContext context)
```
    Description copied from interface: StateHolder
    Gets the state of the instance as a Serializable Object.
    
    If the class that implements this interface has references to instances that implement StateHolder (such as a UIComponent with event handlers, validators, etc.) this method must call the StateHolder.saveState(jakarta.faces.context.FacesContext) method on all those instances as well. This method must not save the state of children and facets. That is done via the StateManager
    
    This method must not alter the state of the implementing object. In other words, after executing this code:
    
    Object state = component.saveState(facesContext);
    
    component should be the same as before executing it.
    
    The return from this method must be Serializable
    Specified by:
    
    saveState in interface StateHolder
    
    Parameters:
    
    context - the Faces context.
    
    Returns:
    
    the saved state.
    
    See Also:
    
    StateHolder.saveState(jakarta.faces.context.FacesContext)
  - setId
```
public void setId(String id)
```
    Description copied from class: UIComponent
    Set the component identifier of this UIComponent (if any). Component identifiers must obey the following syntax restrictions:
    
    Must not be a zero-length String.
    
    First character must be a letter or an underscore ('_').
    
    Subsequent characters must be a letter, a digit, an underscore ('_'), or a dash ('-').
    
    Component identifiers must also obey the following semantic restrictions (note that this restriction is NOT enforced by the setId() implementation):
    
    The specified identifier must be unique among all the components (including facets) that are descendents of the nearest ancestor UIComponent that is a NamingContainer, or within the scope of the entire component tree if there is no such ancestor that is a NamingContainer.
    Specified by:
    
    setId in class UIComponent
    
    Parameters:
    
    id - The new component identifier, or null to indicate that this UIComponent does not have a component identifier
    
    See Also:
    
    UIComponent.setId(java.lang.String)
  - setParent
```
public void setParent(UIComponent parent)
```
    Description copied from class: UIComponent
    Set the parent UIComponent of this UIComponent. If parent.isInView() returns true, calling this method will first cause a PreRemoveFromViewEvent to be published, for this node, and then the children of this node. Then, once the re-parenting has occurred, a PostAddToViewEvent will be published as well, first for this node, and then for the node's children, but only if any of the following conditions are true.
    
    FacesContext.getCurrentPhaseId() returns PhaseId.RESTORE_VIEW and partial state saving is enabled.
    
    FacesContext.isPostback() returns false and FacesContext.getCurrentPhaseId() returns something other than PhaseId.RESTORE_VIEW
    
    This method must never be called by developers; a UIComponent's internal implementation will call it as components are added to or removed from a parent's child List or facet Map.
    Specified by:
    
    setParent in class UIComponent
    
    Parameters:
    
    parent - The new parent, or null for the root node of a component tree
    
    See Also:
    
    UIComponent.setParent(jakarta.faces.component.UIComponent)
  - setRendered
```
public void setRendered(boolean rendered)
```
    Description copied from class: UIComponent
    
    Set the rendered property of this UIComponent.
    
    Specified by:
    
    setRendered in class UIComponent
    
    Parameters:
    
    rendered - If true render this component; otherwise, do not render this component
    
    See Also:
    
    UIComponent.setRendered(boolean)
  - setRendererType
```
public void setRendererType(String rendererType)
```
    Description copied from class: UIComponent
    
    Set the Renderer type for this UIComponent, or null for components that render themselves.
    
    Specified by:
    
    setRendererType in class UIComponent
    
    Parameters:
    
    rendererType - Logical identifier of the type of Renderer to use, or null for components that render themselves
    
    See Also:
    
    UIComponent.setRendererType(java.lang.String)
  - setTransient
```
public void setTransient(boolean newTransientValue)
```
    Description copied from interface: StateHolder
    
    Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.
    
    Specified by:
    
    setTransient in interface StateHolder
    
    Parameters:
    
    newTransientValue - boolean pass true if this Object will not participate in state saving or restoring, otherwise pass false.
    
    See Also:
    
    StateHolder.setTransient(boolean)
  - setValueExpression
```
public void setValueExpression(String name,
                               jakarta.el.ValueExpression binding)
```
    Description copied from class: UIComponent
    
    Set the ValueExpression used to calculate the value for the specified attribute or property name, if any.
    
    The implementation must call Expression.isLiteralText() on the argument expression. If isLiteralText() returns true, invoke ValueExpression.getValue(jakarta.el.ELContext) on the argument expression and pass the result as the value parameter in a call to this.UIComponent.getAttributes().put(name, value) where name is the argument name. If an exception is thrown as a result of calling ValueExpression.getValue(jakarta.el.ELContext), wrap it in a FacesException and re-throw it. If isLiteralText() returns false, simply store the un-evaluated expression argument in the collection of ValueExpressions under the key given by the argument name.
    
    This method must be overridden and implemented for components that comply with Jakarta Faces 1.2 and later.
    
    Overrides:
    
    setValueExpression in class UIComponent
    
    Parameters:
    
    name - Name of the attribute or property for which to set a ValueExpression
    
    binding - The ValueExpression to set, or null to remove any currently set ValueExpression
    
    See Also:
    
    UIComponent.setValueExpression(java.lang.String, jakarta.el.ValueExpression)
  - subscribeToEvent
```
public void subscribeToEvent(Class<? extends SystemEvent> eventClass,
                             ComponentSystemEventListener componentListener)
```
    Description copied from class: UIComponent
    
    This implementation throws UnsupportedOperationException and is provided for the sole purpose of not breaking existing applications that extend this class. UIComponentBase provides the implementation of this method.
    
    Overrides:
    
    subscribeToEvent in class UIComponent
    
    Parameters:
    
    eventClass - the event class.
    
    componentListener - the listener.
    
    See Also:
    
    UIComponent.subscribeToEvent(java.lang.Class, jakarta.faces.event.ComponentSystemEventListener)
  - unsubscribeFromEvent
```
public void unsubscribeFromEvent(Class<? extends SystemEvent> eventClass,
                                 ComponentSystemEventListener componentListener)
```
    Description copied from class: UIComponent
    
    This implementation throws UnsupportedOperationException and is provided for the sole purpose of not breaking existing applications that extend this class. UIComponentBase provides the implementation of this method.
    
    Overrides:
    
    unsubscribeFromEvent in class UIComponent
    
    Parameters:
    
    eventClass - the event class.
    
    componentListener - the component listener.
    
    See Also:
    
    UIComponent.unsubscribeFromEvent(java.lang.Class, jakarta.faces.event.ComponentSystemEventListener)
  - visitTree
```
public boolean visitTree(VisitContext context,
                         VisitCallback callback)
```
    Description copied from class: UIComponent
    
    Perform a tree visit starting at this node in the tree.
    
    UIComponent.visitTree() implementations do not invoke the VisitCallback directly, but instead call VisitContext.invokeVisitCallback(jakarta.faces.component.UIComponent, jakarta.faces.component.visit.VisitCallback) to invoke the callback. This allows VisitContext implementations to provide optimized tree traversals, for example by only calling the VisitCallback for a subset of components.
    
    UIComponent.visitTree() implementations must call UIComponent.pushComponentToEL() before performing the visit and UIComponent.popComponentFromEL() after the visit.
    
    Overrides:
    
    visitTree in class UIComponent
    
    Parameters:
    
    context - the VisitContext for this visit
    
    callback - the VisitCallback instance whose visit method will be called for each node visited.
    
    Returns:
    
    component implementations may return true to indicate that the tree visit is complete (eg. all components that need to be visited have been visited). This results in the tree visit being short-circuited such that no more components are visited.
    
    See Also:
    
    UIComponent.visitTree(jakarta.faces.component.visit.VisitContext, jakarta.faces.component.visit.VisitCallback)
  - addFacesListener
```
protected void addFacesListener(FacesListener listener)
```
    Description copied from class: UIComponent
    Add the specified FacesListener to the set of listeners registered to receive event notifications from this UIComponent. It is expected that UIComponent classes acting as event sources will have corresponding typesafe APIs for registering listeners of the required type, and the implementation of those registration methods will delegate to this method. For example:
    
    public class FooEvent extends FacesEvent { ... } public interface FooListener extends FacesListener { public void processFoo(FooEvent event); } public class FooComponent extends UIComponentBase { ... public void addFooListener(FooListener listener) { addFacesListener(listener); } public void removeFooListener(FooListener listener) { removeFacesListener(listener); } ... }
    Specified by:
    
    addFacesListener in class UIComponent
    
    Parameters:
    
    listener - The FacesListener to be registered
  - getFacesContext
```
protected FacesContext getFacesContext()
```
    Description copied from class: UIComponent
    
    Convenience method to return the FacesContext instance for the current request.
    
    Specified by:
    
    getFacesContext in class UIComponent
    
    Returns:
    
    the Faces context.
  - getFacesListeners
```
protected FacesListener[] getFacesListeners(Class clazz)
```
    Description copied from class: UIComponent
    
    Return an array of registered FacesListeners that are instances of the specified class. If there are no such registered listeners, a zero-length array is returned. The returned array can be safely be cast to an array strongly typed to an element type of clazz.
    
    Specified by:
    
    getFacesListeners in class UIComponent
    
    Parameters:
    
    clazz - Class that must be implemented by a FacesListener for it to be returned
    
    Returns:
    
    the Faces listeners, or a zero-length array.
  - getRenderer
```
protected Renderer getRenderer(FacesContext context)
```
    Description copied from class: UIComponent
    
    Convenience method to return the Renderer instance associated with this component, if any; otherwise, return null.
    
    Specified by:
    
    getRenderer in class UIComponent
    
    Parameters:
    
    context - FacesContext for the current request
    
    Returns:
    
    the renderer, or null.
  - removeFacesListener
```
protected void removeFacesListener(FacesListener listener)
```
    Description copied from class: UIComponent
    
    Remove the specified FacesListener from the set of listeners registered to receive event notifications from this UIComponent.
    
    Specified by:
    
    removeFacesListener in class UIComponent
    
    Parameters:
    
    listener - The FacesListener to be deregistered
  - addClientBehavior
```
public void addClientBehavior(String eventName,
                              ClientBehavior behavior)
```
    Description copied from interface: ClientBehaviorHolder
    
    Attaches a ClientBehavior to the component implementing this interface for the specified event. Valid event names for a UIComponent implementation are defined by ClientBehaviorHolder.getEventNames().
    
    Specified by:
    
    addClientBehavior in interface ClientBehaviorHolder
    
    Parameters:
    
    eventName - the logical name of the client-side event to attach the behavior to.
    
    behavior - the ClientBehavior instance to attach for the specified event name.
  - getClientBehaviors
```
public Map<String,List<ClientBehavior>> getClientBehaviors()
```
    Description copied from interface: ClientBehaviorHolder
    
    Returns a non-null, unmodifiable Map that contains the the ClientBehaviors that have been attached to the component implementing this interface. The keys in this Map are event names defined by ClientBehaviorHolder.getEventNames().
    
    Specified by:
    
    getClientBehaviors in interface ClientBehaviorHolder
    
    Returns:
    
    an unmodifiable map of client behaviors.
  - getDefaultEventName
```
public String getDefaultEventName()
```
    Description copied from interface: ClientBehaviorHolder
    
    Returns the default event name for this ClientBehaviorHolder implementation. This must be one of the event names returned by ClientBehaviorHolder.getEventNames() or null if the component does not have a default event.
    
    Specified by:
    
    getDefaultEventName in interface ClientBehaviorHolder
    
    Returns:
    
    the default event name.
  - getEventNames
```
public Collection<String> getEventNames()
```
    Description copied from interface: ClientBehaviorHolder
    
    Returns a non-null, unmodifiable Collection containing the names of the logical events supported by the component implementing this interface.
    
    Specified by:
    
    getEventNames in interface ClientBehaviorHolder
    
    Returns:
    
    an unmodifiable collection of event names.
  - getTargets
```
public jakarta.el.ValueExpression getTargets()
```

Class BehaviorHolderWrapper

Field Summary

Fields inherited from class jakarta.faces.component.UIComponent

Constructor Summary

Method Summary

Methods inherited from class jakarta.faces.component.UIComponent

Methods inherited from class java.lang.Object

Constructor Detail

BehaviorHolderWrapper

Method Detail

broadcast

decode

encodeBegin

encodeChildren

encodeEnd

findComponent

getAttributes

getPassThroughAttributes

getChildCount

getChildren

getClientId

getFacet

getFacets

getFacetsAndChildren

getFamily

getId

getParent

getRendererType

getRendersChildren

getValueExpression

invokeOnComponent

isInView

isRendered

isTransient

processDecodes

processEvent

processRestoreState

processSaveState

processUpdates

processValidators

queueEvent

restoreState

saveState

setId

setParent

setRendered

setRendererType

setTransient

setValueExpression

subscribeToEvent

unsubscribeFromEvent

visitTree

addFacesListener

getFacesContext

getFacesListeners

getRenderer

removeFacesListener

addClientBehavior

getClientBehaviors

getDefaultEventName

getEventNames

getTargets