Modifier and Type	Class and Description
private static class	CompositeComponentTagHandler.CompositeComponentMetaRuleset Specialized MetaRulesetImpl to return CompositeMetadataTarget for component attribute handling.
private static class	CompositeComponentTagHandler.CompositeComponentRule `MetaRule` for populating the ValueExpression map of a composite component.

Modifier and Type	Field and Description
private static final String	ATTACHED_OBJECT_HANDLERS_KEY The key in the value set of the composite component `BeanDescriptor`, the value for which is a `List<AttachedObjectHandler>`.
private TagAttribute	binding Hides jakarta.faces.view.facelets.DelegatingMetaTagHandler.binding.
private static final String	ccInstanceVariableStandinKey
private Resource	ccResource
private static final Logger	LOGGER

Access	Constructor and Description
public	CompositeComponentTagHandler(Resource ccResource, ComponentConfig config)

Modifier and Type	Method and Description
private void	applyCompositeComponent(FaceletContext ctx, UIComponent c)
public void	applyNextHandler(FaceletContext the `FaceletContext` for this view execution ctx, UIComponent the `UIComponent` of the component represented by this element instance. c) Overrides jakarta.faces.view.facelets.DelegatingMetaTagHandler.applyNextHandler. Invoke the `apply()` method on this instance's `TagHandler#nextHandler`.
public UIComponent	createComponent(FaceletContext the `FaceletContext` for this view execution ctx) Overrides jakarta.faces.view.facelets.ComponentHandler.createComponent. Implements com.sun.faces.facelets.tag.faces.ComponentTagHandlerDelegateImpl.CreateComponentDelegate.createComponent. 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 MetaRuleset	createMetaRuleset(Class<T> the `Class` for which the `MetaRuleset` must be created. type) Overrides jakarta.faces.view.facelets.DelegatingMetaTagHandler.createMetaRuleset. This is basically a copy of what's define in ComponentTagHandlerDelegateImpl except for the MetaRuleset implementation that's being used.
public static List<AttachedObjectHandler>	getAttachedObjectHandlers(UIComponent component)
public static List<AttachedObjectHandler>	getAttachedObjectHandlers(UIComponent component, boolean create)
public UIComponent	getCompositeComponent(FacesContext context) Implements com.sun.faces.facelets.tag.faces.ComponentTagHandlerDelegateImpl.CreateComponentDelegate.getCompositeComponent.
public void	setAttributes(FaceletContext the Facelet context. ctx, Object the instance. instance) Overrides jakarta.faces.view.facelets.DelegatingMetaTagHandler.setAttributes. Specialized implementation to prevent caching of the MetaRuleset when ProjectStage is Development.
public void	setCompositeComponent(FacesContext context, UIComponent cc) Implements com.sun.faces.facelets.tag.faces.ComponentTagHandlerDelegateImpl.CreateComponentDelegate.setCompositeComponent.

ATTACHED_OBJECT_HANDLERS_KEY	back to summary
private static final String ATTACHED_OBJECT_HANDLERS_KEY The key in the value set of the composite component `BeanDescriptor`, the value for which is a `List<AttachedObjectHandler>`.

binding	back to summary
private TagAttribute binding Hides jakarta.faces.view.facelets.DelegatingMetaTagHandler.binding.

ccInstanceVariableStandinKey	back to summary
private static final String ccInstanceVariableStandinKey

ccResource	back to summary
private Resource ccResource

LOGGER	back to summary
private static final Logger LOGGER

CompositeComponentTagHandler	back to summary
public CompositeComponentTagHandler(Resource ccResource, ComponentConfig config)

Method Detail

applyCompositeComponent	back to summary
private void applyCompositeComponent(FaceletContext ctx, UIComponent c) throws IOException

applyNextHandler back to summary

applyNextHandler	back to summary
public void applyNextHandler(FaceletContext ctx, UIComponent c) throws IOException, FacesException, ELException Overrides jakarta.faces.view.facelets.DelegatingMetaTagHandler.applyNextHandler. Doc from jakarta.faces.view.facelets.DelegatingMetaTagHandler.applyNextHandler. Invoke the `apply()` method on this instance's `TagHandler#nextHandler`. Parameters ctx:FaceletContext the `FaceletContext` for this view execution c:UIComponent the `UIComponent` of the component represented by this element instance. Annotations @Override Exceptions IOException: if thrown by the next `FaceletHandler` FacesException: if thrown by the next `FaceletHandler` ELException: if thrown by the next `FaceletHandler`

public void applyNextHandler(FaceletContext ctx, UIComponent c) throws IOException, FacesException, ELException

Overrides jakarta.faces.view.facelets.DelegatingMetaTagHandler.applyNextHandler.

Doc from jakarta.faces.view.facelets.DelegatingMetaTagHandler.applyNextHandler.

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

Parameters

ctx:FaceletContext: the FaceletContext for this view execution
c:UIComponent: the UIComponent of the component represented by this element instance.

Annotations

@Override

Exceptions

IOException:: if thrown by the next FaceletHandler
FacesException:: if thrown by the next FaceletHandler
ELException:: if thrown by the next FaceletHandler

createComponent back to summary

createComponent	back to summary
public UIComponent createComponent(FaceletContext ctx) Overrides jakarta.faces.view.facelets.ComponentHandler.createComponent. Implements com.sun.faces.facelets.tag.faces.ComponentTagHandlerDelegateImpl.CreateComponentDelegate.createComponent. Doc from jakarta.faces.view.facelets.ComponentHandler.createComponent. 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. Parameters ctx:FaceletContext the `FaceletContext` for this view execution Returns:UIComponent the newly created `UIComponent` Annotations @Override

public UIComponent createComponent(FaceletContext ctx)

Overrides jakarta.faces.view.facelets.ComponentHandler.createComponent.

Implements com.sun.faces.facelets.tag.faces.ComponentTagHandlerDelegateImpl.CreateComponentDelegate.createComponent.

Doc from jakarta.faces.view.facelets.ComponentHandler.createComponent.

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.

Parameters

ctx:FaceletContext: the FaceletContext for this view execution

Returns:UIComponent

the newly created UIComponent

Annotations

@Override

createMetaRuleset back to summary

createMetaRuleset	back to summary
protected MetaRuleset createMetaRuleset(Class<T> type) Overrides jakarta.faces.view.facelets.DelegatingMetaTagHandler.createMetaRuleset. 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. Parameters type:Class<T> the `Class` for which the `MetaRuleset` must be created. Annotations @Override

protected MetaRuleset createMetaRuleset(Class<T> type)

Overrides jakarta.faces.view.facelets.DelegatingMetaTagHandler.createMetaRuleset.

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.

Parameters

type:Class<T>: the Class for which the MetaRuleset must be created.

Annotations

@Override

getAttachedObjectHandlers	back to summary
public static List<AttachedObjectHandler> getAttachedObjectHandlers(UIComponent component)

getAttachedObjectHandlers	back to summary
public static List<AttachedObjectHandler> getAttachedObjectHandlers(UIComponent component, boolean create) Annotations @SuppressWarnings:unchecked

getCompositeComponent	back to summary
public UIComponent getCompositeComponent(FacesContext context) Implements com.sun.faces.facelets.tag.faces.ComponentTagHandlerDelegateImpl.CreateComponentDelegate.getCompositeComponent. Annotations @Override

getCompositeComponent

back to summary

public UIComponent getCompositeComponent(FacesContext context)

Implements com.sun.faces.facelets.tag.faces.ComponentTagHandlerDelegateImpl.CreateComponentDelegate.getCompositeComponent.

Annotations

@Override

setAttributes	back to summary
public void setAttributes(FaceletContext ctx, Object instance) Overrides jakarta.faces.view.facelets.DelegatingMetaTagHandler.setAttributes. Specialized implementation to prevent caching of the MetaRuleset when ProjectStage is Development. Parameters ctx:FaceletContext Doc from jakarta.faces.view.facelets.MetaTagHandler.setAttributes. the Facelet context. instance:Object Doc from jakarta.faces.view.facelets.MetaTagHandler.setAttributes. the instance. Annotations @Override

setAttributes

back to summary

public void setAttributes(FaceletContext ctx, Object instance)

Overrides jakarta.faces.view.facelets.DelegatingMetaTagHandler.setAttributes.

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

Parameters

ctx:FaceletContext

Doc from jakarta.faces.view.facelets.MetaTagHandler.setAttributes.

the Facelet context.

instance:Object

Doc from jakarta.faces.view.facelets.MetaTagHandler.setAttributes.

the instance.

Annotations

@Override

setCompositeComponent	back to summary
public void setCompositeComponent(FacesContext context, UIComponent cc) Implements com.sun.faces.facelets.tag.faces.ComponentTagHandlerDelegateImpl.CreateComponentDelegate.setCompositeComponent. Annotations @Override

setCompositeComponent

back to summary

public void setCompositeComponent(FacesContext context, UIComponent cc)

Implements com.sun.faces.facelets.tag.faces.ComponentTagHandlerDelegateImpl.CreateComponentDelegate.setCompositeComponent.

Annotations

@Override

com.sun.faces.facelets.tag.faces back to summary

private final Class CompositeComponentTagHandler.CompositeComponentMetaRuleset

Class Inheritance

extends MetaRulesetImpl

java.lang.Object
jakarta.faces.view.facelets.MetaRuleset
com.sun.faces.facelets.tag.MetaRulesetImpl
com.sun.faces.facelets.tag.faces.CompositeComponentTagHandler.CompositeComponentMetaRuleset

Specialized MetaRulesetImpl to return CompositeMetadataTarget for component attribute handling.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	CompositeComponentTagHandler.CompositeComponentMetaRuleset.CompositeMetadataTarget This class is responsible for creating ValueExpression instances with the expected type based off the following: - if the composite:attribute metadata is present, then use the type if specified by the author, or default to Object.class - if no composite:attribute is specified, then attempt to return the type based off the bean info for this component

Modifier and Type

Class and Description

private static class

CompositeComponentTagHandler.CompositeComponentMetaRuleset.CompositeMetadataTarget

This class is responsible for creating ValueExpression instances with the expected type based off the following: - if the composite:attribute metadata is present, then use the type if specified by the author, or default to Object.class - if no composite:attribute is specified, then attempt to return the type based off the bean info for this component

Field Summary

Modifier and Type	Field and Description
private BeanInfo	compBeanInfo
private Class<?>	type Hides com.sun.faces.facelets.tag.MetaRulesetImpl.type.

Constructor Summary

Access	Constructor and Description
public	CompositeComponentMetaRuleset(Tag tag, Class<?> type, BeanInfo compBeanInfo)

Method Summary

Modifier and Type	Method and Description
protected MetadataTarget	getMetadataTarget() Overrides com.sun.faces.facelets.tag.MetaRulesetImpl.getMetadataTarget.

Inherited from com.sun.faces.facelets.tag.MetaRulesetImpl:: add addRule alias finish ignore ignoreAll

Field Detail

compBeanInfo	back to summary
private BeanInfo compBeanInfo

type	back to summary
private Class<?> type Hides com.sun.faces.facelets.tag.MetaRulesetImpl.type.

Constructor Detail

CompositeComponentMetaRuleset	back to summary
public CompositeComponentMetaRuleset(Tag tag, Class<?> type, BeanInfo compBeanInfo)

Method Detail

getMetadataTarget

back to summary

protected MetadataTarget getMetadataTarget()

Overrides com.sun.faces.facelets.tag.MetaRulesetImpl.getMetadataTarget.

Annotations

@Override

com.sun.faces.facelets.tag.faces back to summary

private final Class CompositeComponentTagHandler.CompositeComponentMetaRuleset.CompositeMetadataTarget

Class Inheritance

extends MetadataTargetImpl

java.lang.Object
jakarta.faces.view.facelets.MetadataTarget
com.sun.faces.facelets.tag.MetadataTargetImpl
com.sun.faces.facelets.tag.faces.CompositeComponentTagHandler.CompositeComponentMetaRuleset.CompositeMetadataTarget

Field Summary

Modifier and Type	Field and Description
private BeanInfo	compBeanInfo

Constructor Summary

Access	Constructor and Description
public	CompositeMetadataTarget(Class<?> type, BeanInfo compBeanInfo)

Method Summary

Modifier and Type	Method and Description
private PropertyDescriptor	findDescriptor(String name)
public Class<T>	getPropertyType(String the name of the property for which the `Class` must be returned. name) Overrides com.sun.faces.facelets.tag.MetadataTargetImpl.getPropertyType. Return a `Class` for the property with name given by argument `name`.
private String	prefix(String className)

Inherited from com.sun.faces.facelets.tag.MetadataTargetImpl:: getProperty getReadMethod getTargetClass getWriteMethod isTargetInstanceOf

Field Detail

compBeanInfo	back to summary
private BeanInfo compBeanInfo

Constructor Detail

CompositeMetadataTarget	back to summary
public CompositeMetadataTarget(Class<?> type, BeanInfo compBeanInfo) throws IntrospectionException

Method Detail

findDescriptor	back to summary
private PropertyDescriptor findDescriptor(String name)

getPropertyType back to summary

public Class<T> getPropertyType(String name)

Overrides com.sun.faces.facelets.tag.MetadataTargetImpl.getPropertyType.

Doc from jakarta.faces.view.facelets.MetadataTarget.getPropertyType.

Return a Class for the property with name given by argument name.

Parameters

name:String: the name of the property for which the Class must be returned.

Returns:Class<T>

the Class of the property.

Annotations

@Override

prefix	back to summary
private String prefix(String className)

com.sun.faces.facelets.tag.faces back to summary

private Class CompositeComponentTagHandler.CompositeComponentRule

Class Inheritance

extends MetaRule

java.lang.Object
jakarta.faces.view.facelets.MetaRule
com.sun.faces.facelets.tag.faces.CompositeComponentTagHandler.CompositeComponentRule

MetaRule for populating the ValueExpression map of a composite component.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	CompositeComponentTagHandler.CompositeComponentRule.CompositeExpressionMetadata CompositeExpressionMetadata sets up specialized wrapper ValueExpression instances around the source ValueExpression that, when evaluated, will cause the parent composite component of the currently available composite component to be pushed onto a stack that the ImplicitObjectELResolver will check for.
private static class	CompositeComponentTagHandler.CompositeComponentRule.LiteralAttributeMetadata For literal expressions, coerce the literal value to the type as provided to the constructor prior to setting the value into the component's attribute map.

Field Summary

Modifier and Type	Field and Description
private static final CompositeComponentTagHandler.CompositeComponentRule	Instance

Constructor Summary

Access	Constructor and Description
private	CompositeComponentRule()

Method Summary

Modifier and Type Method and Description

Modifier and Type	Method and Description
public Metadata	applyRule(String the name for this rule. This will generally be the name of a tag attribute in the VDL. name, TagAttribute the name/value pair for this attribute on this particular instance of an element in the page. attribute, MetadataTarget the `MetadataTarged` that can be used to discern what kind of action to encapsulate within the abstraction to be returned. meta) Implements abstract jakarta.faces.view.facelets.MetaRule.applyRule. Return an abstraction that takes appropriate action given the kind of rule represented by the argument `name`, in the context of this particular concrete subclass of `MetaRule`.

public Metadata

applyRule(String

the name for this rule. This will generally be the name of a tag attribute in the VDL.

name, TagAttribute

the name/value pair for this attribute on this particular instance of an element in the page.

attribute, MetadataTarget

the MetadataTarged that can be used to discern what kind of action to encapsulate within the abstraction to be returned.

meta)

Implements abstract jakarta.faces.view.facelets.MetaRule.applyRule.

Return an abstraction that takes appropriate action given the kind of rule represented by the argument name, in the context of this particular concrete subclass of MetaRule.

Field Detail

Instance	back to summary
private static final CompositeComponentTagHandler.CompositeComponentRule Instance

Constructor Detail

CompositeComponentRule	back to summary
private CompositeComponentRule()

Method Detail

applyRule back to summary

public Metadata applyRule(String name, TagAttribute attribute, MetadataTarget meta)

Implements abstract jakarta.faces.view.facelets.MetaRule.applyRule.

Doc from jakarta.faces.view.facelets.MetaRule.applyRule.

Return an abstraction that takes appropriate action given the kind of rule represented by the argument name, in the context of this particular concrete subclass of MetaRule. The abstraction must encapsulate the value from the argument attribute.

Parameters

name:String: the name for this rule. This will generally be the name of a tag attribute in the VDL.
attribute:TagAttribute: the name/value pair for this attribute on this particular instance of an element in the page.
meta:MetadataTarget: the MetadataTarged that can be used to discern what kind of action to encapsulate within the abstraction to be returned.

Returns:Metadata

the Metadata.

Annotations

@Override

com.sun.faces.facelets.tag.faces back to summary

private final Class CompositeComponentTagHandler.CompositeComponentRule.CompositeExpressionMetadata

Class Inheritance

extends Metadata

java.lang.Object
jakarta.faces.view.facelets.Metadata
com.sun.faces.facelets.tag.faces.CompositeComponentTagHandler.CompositeComponentRule.CompositeExpressionMetadata

CompositeExpressionMetadata sets up specialized wrapper ValueExpression instances around the source ValueExpression that, when evaluated, will cause the parent composite component of the currently available composite component to be pushed onto a stack that the ImplicitObjectELResolver will check for.

Field Summary

Modifier and Type	Field and Description
private TagAttribute	attr
private String	name
private Class<?>	type

Constructor Summary

Access	Constructor and Description
public	CompositeExpressionMetadata(String name, Class<?> type, TagAttribute attr)

Method Summary

Modifier and Type Method and Description

Modifier and Type	Method and Description
public void	applyMetadata(FaceletContext The FaceletContext for this request. ctx, Object The instance from the Jakarta Faces Java API on which the action should be taken. For example, an instance of `jakarta.faces.component.EditableValueHolder`. instance) Implements abstract jakarta.faces.view.facelets.Metadata.applyMetadata. Take the action prescribed in the Jakarta Faces Specification for this particular VDL element attribute.

public void

applyMetadata(FaceletContext

The FaceletContext for this request.

ctx, Object

The instance from the Jakarta Faces Java API on which the action should be taken. For example, an instance of jakarta.faces.component.EditableValueHolder.

instance)

Implements abstract jakarta.faces.view.facelets.Metadata.applyMetadata.

Take the action prescribed in the Jakarta Faces Specification for this particular VDL element attribute.

Field Detail

attr	back to summary
private TagAttribute attr

name	back to summary
private String name

type	back to summary
private Class<?> type

Constructor Detail

CompositeExpressionMetadata	back to summary
public CompositeExpressionMetadata(String name, Class<?> type, TagAttribute attr)

Method Detail

applyMetadata back to summary

public void applyMetadata(FaceletContext ctx, Object instance)

Implements abstract jakarta.faces.view.facelets.Metadata.applyMetadata.

Doc from jakarta.faces.view.facelets.Metadata.applyMetadata.

Take the action prescribed in the Jakarta Faces Specification for this particular VDL element attribute.

Parameters

ctx:FaceletContext: The FaceletContext for this request.
instance:Object: The instance from the Jakarta Faces Java API on which the action should be taken. For example, an instance of jakarta.faces.component.EditableValueHolder.

Annotations

@Override

com.sun.faces.facelets.tag.faces back to summary

private final Class CompositeComponentTagHandler.CompositeComponentRule.LiteralAttributeMetadata

Class Inheritance

extends Metadata

java.lang.Object
jakarta.faces.view.facelets.Metadata
com.sun.faces.facelets.tag.faces.CompositeComponentTagHandler.CompositeComponentRule.LiteralAttributeMetadata

For literal expressions, coerce the literal value to the type as provided to the constructor prior to setting the value into the component's attribute map.

Field Summary

Modifier and Type	Field and Description
private TagAttribute	attribute
private String	name
private Class<?>	type

Constructor Summary

Access	Constructor and Description
public	LiteralAttributeMetadata(String name, Class<?> type, TagAttribute attribute)

Method Summary

Modifier and Type Method and Description

public void

applyMetadata(FaceletContext

The FaceletContext for this request.

ctx, Object

The instance from the Jakarta Faces Java API on which the action should be taken. For example, an instance of jakarta.faces.component.EditableValueHolder.

instance)

Implements abstract jakarta.faces.view.facelets.Metadata.applyMetadata.

Take the action prescribed in the Jakarta Faces Specification for this particular VDL element attribute.

Field Detail

attribute	back to summary
private TagAttribute attribute

name	back to summary
private String name

type	back to summary
private Class<?> type

Constructor Detail

LiteralAttributeMetadata	back to summary
public LiteralAttributeMetadata(String name, Class<?> type, TagAttribute attribute)

Method Detail

applyMetadata back to summary

public void applyMetadata(FaceletContext ctx, Object instance)

Implements abstract jakarta.faces.view.facelets.Metadata.applyMetadata.

Doc from jakarta.faces.view.facelets.Metadata.applyMetadata.

Take the action prescribed in the Jakarta Faces Specification for this particular VDL element attribute.

Parameters

ctx:FaceletContext: The FaceletContext for this request.
instance:Object: The instance from the Jakarta Faces Java API on which the action should be taken. For example, an instance of jakarta.faces.component.EditableValueHolder.

Annotations

@Override

public Class CompositeComponentTagHandler

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class CompositeComponentTagHandler.CompositeComponentMetaRuleset

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class CompositeComponentTagHandler.CompositeComponentMetaRuleset.CompositeMetadataTarget

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class CompositeComponentTagHandler.CompositeComponentRule

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class CompositeComponentTagHandler.CompositeComponentRule.CompositeExpressionMetadata

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class CompositeComponentTagHandler.CompositeComponentRule.LiteralAttributeMetadata

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail