com.sun.faces.facelets.tag.jsf

Class CompositeComponentTagHandler

java.lang.Object

jakarta.faces.view.facelets.TagHandler

jakarta.faces.view.facelets.MetaTagHandler

jakarta.faces.view.facelets.DelegatingMetaTagHandler

jakarta.faces.view.facelets.ComponentHandler

com.sun.faces.facelets.tag.jsf.CompositeComponentTagHandler

All Implemented Interfaces:

jakarta.faces.view.facelets.FaceletHandler

public class CompositeComponentTagHandler
extends jakarta.faces.view.facelets.ComponentHandler

Facelet handler responsible for, building the component tree representation of a composite component based on the metadata contained in the composite interface and implementation sections of the composite component template.

Field Summary

Fields inherited from class jakarta.faces.view.facelets.DelegatingMetaTagHandler

delegateFactory

Fields inherited from class jakarta.faces.view.facelets.TagHandler

nextHandler, tag, tagId

Constructor Summary

Constructors

Constructor and Description
CompositeComponentTagHandler(jakarta.faces.application.Resource ccResource, jakarta.faces.view.facelets.ComponentConfig config)

Method Summary

Modifier and Type	Method and Description
void	applyNextHandler(jakarta.faces.view.facelets.FaceletContext ctx, jakarta.faces.component.UIComponent c) Invoke the apply() method on this instance's TagHandler.nextHandler.
jakarta.faces.component.UIComponent	createComponent(jakarta.faces.view.facelets.FaceletContext ctx) Subclasses that wish to take over the task of instantiating the UIComponent instance corresponding to this tag handler my override this method to do so.
protected jakarta.faces.view.facelets.MetaRuleset	createMetaRuleset(Class type) This is basically a copy of what's define in ComponentTagHandlerDelegateImpl except for the MetaRuleset implementation that's being used.
static List<jakarta.faces.view.AttachedObjectHandler>	getAttachedObjectHandlers(jakarta.faces.component.UIComponent component)
static List<jakarta.faces.view.AttachedObjectHandler>	getAttachedObjectHandlers(jakarta.faces.component.UIComponent component, boolean create)
jakarta.faces.component.UIComponent	getCompositeComponent(jakarta.faces.context.FacesContext context)
void	setAttributes(jakarta.faces.view.facelets.FaceletContext ctx, Object instance) Specialized implementation to prevent caching of the MetaRuleset when ProjectStage is Development.
void	setCompositeComponent(jakarta.faces.context.FacesContext context, jakarta.faces.component.UIComponent cc)

Methods inherited from class jakarta.faces.view.facelets.ComponentHandler

getComponentConfig, getTagHandlerDelegate, isNew, onComponentCreated, onComponentPopulated

Methods inherited from class jakarta.faces.view.facelets.DelegatingMetaTagHandler

apply, getBinding, getTag, getTagAttribute, getTagId, isDisabled

Methods inherited from class jakarta.faces.view.facelets.TagHandler

getAttribute, getRequiredAttribute, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CompositeComponentTagHandler

public CompositeComponentTagHandler(jakarta.faces.application.Resource ccResource,
                                    jakarta.faces.view.facelets.ComponentConfig config)

Method Detail

createComponent

public jakarta.faces.component.UIComponent createComponent(jakarta.faces.view.facelets.FaceletContext ctx)

Description copied from class: jakarta.faces.view.facelets.ComponentHandler

Subclasses that wish to take over the task of instantiating the UIComponent instance corresponding to this tag handler my override this method to do so. A null return from this method will cause the TagHandlerDelegate for instance to create the component instead.

Overrides:

createComponent in class jakarta.faces.view.facelets.ComponentHandler

Parameters:

ctx - the FaceletContext for this view execution

Returns:

the newly created UIComponent

applyNextHandler

public void applyNextHandler(jakarta.faces.view.facelets.FaceletContext ctx,
                             jakarta.faces.component.UIComponent c)
                      throws IOException,
                             jakarta.faces.FacesException,
                             jakarta.el.ELException

Description copied from class: jakarta.faces.view.facelets.DelegatingMetaTagHandler

Invoke the apply() method on this instance's TagHandler.nextHandler.

Overrides:

applyNextHandler in class jakarta.faces.view.facelets.DelegatingMetaTagHandler

Parameters:

ctx - the FaceletContext for this view execution

c - the UIComponent of the component represented by this element instance.

Throws:

IOException - if thrown by the next FaceletHandler

jakarta.faces.view.facelets.FaceletException - if thrown by the next FaceletHandler

jakarta.faces.FacesException - if thrown by the next FaceletHandler

jakarta.el.ELException - if thrown by the next FaceletHandler

setCompositeComponent

public void setCompositeComponent(jakarta.faces.context.FacesContext context,
                                  jakarta.faces.component.UIComponent cc)

getCompositeComponent

public jakarta.faces.component.UIComponent getCompositeComponent(jakarta.faces.context.FacesContext context)

setAttributes

public void setAttributes(jakarta.faces.view.facelets.FaceletContext ctx,
                          Object instance)

Specialized implementation to prevent caching of the MetaRuleset when ProjectStage is Development.

Overrides:

setAttributes in class jakarta.faces.view.facelets.DelegatingMetaTagHandler

Parameters:

ctx - the Facelet context.

instance - the instance.

createMetaRuleset

protected jakarta.faces.view.facelets.MetaRuleset createMetaRuleset(Class type)

This is basically a copy of what's define in ComponentTagHandlerDelegateImpl except for the MetaRuleset implementation that's being used. This also allows us to treat composite component's backed by custom component implementation classes based on their type.

Overrides:

createMetaRuleset in class jakarta.faces.view.facelets.DelegatingMetaTagHandler

Parameters:

type - the Class for which the MetaRuleset must be created.

Returns:

getAttachedObjectHandlers

public static List<jakarta.faces.view.AttachedObjectHandler> getAttachedObjectHandlers(jakarta.faces.component.UIComponent component)

getAttachedObjectHandlers

public static List<jakarta.faces.view.AttachedObjectHandler> getAttachedObjectHandlers(jakarta.faces.component.UIComponent component,
                                                                                       boolean create)