Package jakarta.faces.view.facelets

Class DelegatingMetaTagHandler

java.lang.Object

jakarta.faces.view.facelets.TagHandler

jakarta.faces.view.facelets.MetaTagHandler

jakarta.faces.view.facelets.DelegatingMetaTagHandler

All Implemented Interfaces:

FaceletHandler

Direct Known Subclasses:

ComponentHandler, FaceletsAttachedObjectHandler

public abstract class DelegatingMetaTagHandler
extends MetaTagHandler

Enable the Jakarta Server Faces implementation to provide the appropriate behavior for the kind of MetaTagHandler subclass for each kind of element in the view, while providing a base-class from which those wanting to make a Java language custom tag handler can inherit. The Jakarta Server Faces runtime provides the implementation of getTagHandlerDelegate() for the appropriate subclass.

Field Summary

Fields

Modifier and Type	Field	Description
protected TagHandlerDelegateFactory	delegateFactory

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

nextHandler, tag, tagId

Constructor Summary

Constructors

Constructor	Description
DelegatingMetaTagHandler(TagConfig config)

Method Summary

Modifier and Type	Method	Description
void	apply(FaceletContext ctx, UIComponent parent)	The default implementation simply calls through to TagHandlerDelegate.apply(jakarta.faces.view.facelets.FaceletContext, jakarta.faces.component.UIComponent).
void	applyNextHandler(FaceletContext ctx, UIComponent c)	Invoke the apply() method on this instance's TagHandler.nextHandler.
protected MetaRuleset	createMetaRuleset(Class type)	The default implementation simply calls through to TagHandlerDelegate.createMetaRuleset(java.lang.Class) and returns the result.
TagAttribute	getBinding()
Tag	getTag()
TagAttribute	getTagAttribute(String localName)
protected abstract TagHandlerDelegate	getTagHandlerDelegate()	Get the tag handler delegate.
String	getTagId()
boolean	isDisabled(FaceletContext ctx)
void	setAttributes(FaceletContext ctx, Object instance)	Invoking/extending this method will cause the results of the created MetaRuleset to auto-wire state to the passed instance.

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

Field Details

delegateFactory

protected TagHandlerDelegateFactory delegateFactory

Constructor Details

DelegatingMetaTagHandler

public DelegatingMetaTagHandler(TagConfig config)

Method Details

getTagHandlerDelegate

protected abstract TagHandlerDelegate getTagHandlerDelegate()

Get the tag handler delegate.

Code that extends from DelegatingMetaTagHandler (directly or indirectly, as through extending ComponentHandler) must take care to decorate, not replace, the TagHandlerDelegate instance returned by this method. Failure to do so may produce unexpected results.

Returns:

the tag handler delegate.

isDisabled

public boolean isDisabled(FaceletContext ctx)

getBinding

public TagAttribute getBinding()

getTag

public Tag getTag()

getTagId

public String getTagId()

getTagAttribute

public TagAttribute getTagAttribute(String localName)

setAttributes

public void setAttributes(FaceletContext ctx, Object instance)

Description copied from class: MetaTagHandler

Invoking/extending this method will cause the results of the created MetaRuleset to auto-wire state to the passed instance.

Overrides:

setAttributes in class MetaTagHandler

Parameters:

ctx - the Facelet context.

instance - the instance.

apply

public void apply(FaceletContext ctx, UIComponent parent) throws IOException

The default implementation simply calls through to TagHandlerDelegate.apply(jakarta.faces.view.facelets.FaceletContext, jakarta.faces.component.UIComponent).

Parameters:

ctx - the FaceletContext for this view execution

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

Throws:

IOException - if unable to load relativePath

Since:

2.0

applyNextHandler

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

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

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

FaceletException - if thrown by the next FaceletHandler

FacesException - if thrown by the next FaceletHandler

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

Since:

2.0

createMetaRuleset

protected MetaRuleset createMetaRuleset(Class type)

The default implementation simply calls through to TagHandlerDelegate.createMetaRuleset(java.lang.Class) and returns the result.

Specified by:

createMetaRuleset in class MetaTagHandler

Parameters:

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

Returns:

the MetaRuleset.

Since:

2.0