Class MetaTagHandler
- All Implemented Interfaces:
FaceletHandler
- Direct Known Subclasses:
DelegatingMetaTagHandler
Every kind of markup element in Facelets VDL that has attributes that need to take action on a JSF Java API artifact is associated with an instance of this class. This class is an abstraction to enable a rule based method for directing how different kinds of elements take different kinds of actions in the JSF Java API. For example, consider this markup:
<h:inputText value="#{user.userid}"
valueChangeListener="#{user.newUserId}" />
This markup element corresponds to an instance of HtmlInputText
in the view.
HtmlImputText
has a number of attributes that are to be exposed
to the page author. HtmlInputText
also implements
EditableValueHolder
, which extends
ValueHolder
. Each of these interfaces also
expose a number of attributes to the page author.
Facelets employes the strategy pattern to allow the manner in which all possible attributes are handled based on the nature of the JSF Java API artifact associated with the markup element.
Subclasses override the createMetaRuleset(java.lang.Class)
method to return a
MetaRuleset
instance encapsulating all the strategies for all the
attributes that make sense for this particular markup element. The runtime
calls the setAttributes(FaceletContext, Object)
method to cause
those rules to be executed and applied.
- Since:
- 2.0
-
Field Summary
Fields inherited from class javax.faces.view.facelets.TagHandler
nextHandler, tag, tagId
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected abstract MetaRuleset
createMetaRuleset
(Class type) Extend this method in order to add your own rules.protected 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 javax.faces.view.facelets.TagHandler
getAttribute, getRequiredAttribute, toString
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface javax.faces.view.facelets.FaceletHandler
apply
-
Constructor Details
-
MetaTagHandler
Constructor.- Parameters:
config
- the tag configuration.
-
-
Method Details
-
createMetaRuleset
Extend this method in order to add your own rules.- Parameters:
type
- the type.- Returns:
- the
MetaRuleset
.
-
setAttributes
Invoking/extending this method will cause the results of the created MetaRuleset to auto-wire state to the passed instance.- Parameters:
ctx
- the Facelet context.instance
- the instance.
-