# Package javax.faces.view.facelets

This package contains public classes for the Java code API of Facelets.

See: Description

- Interface Summary
  Interface | Description
  --- | ---
  AttributeHandler | An interface that allows other code to identify FaceletHandlers that correspond to component attributes.
  BehaviorConfig | Convey the id of a behavior declared in a view.
  ComponentConfig | Passed to the constructor of `ComponentHandler`.
  ConverterConfig | A Facelet version of the JSP `ConverterTag`.
  FaceletCache.MemberFactory<V> | Factory interface for creating Facelet or View Metadata Facelet instances.
  FaceletHandler | This is the root class for markup elements in Facelets VDL.
  FacetHandler | An interface that allows other code to identify FaceletHandlers that correspond to component facets.
  TagConfig | Passed to the constructor of `TagHandler` subclass, it defines the document definition of the handler we are instantiating.
  TagDecorator | Provides the ability to completely change the Tag before it's processed for compiling with the associated `TagHandler`.
  TextHandler | An interface that allows other code to identify FaceletHandlers that may provide text (String) content.
  ValidatorConfig | Used in creating `ValidatorHandler` and all implementations.

- Class Summary
  Class | Description
  --- | ---
  BehaviorHandler | The `FaceletHandler` that corresponds to attached objects that represent an instance of `ClientBehavior` that must be added to the parent component, which must implement `ClientBehaviorHolder`, with a call to `ClientBehaviorHolder.addClientBehavior(java.lang.String, javax.faces.component.behavior.ClientBehavior)`.
  ComponentHandler | Public base class for markup element instances that map to `UIComponent` instances in the view.
  CompositeFaceletHandler | A FaceletHandler that is derived of 1 or more, inner FaceletHandlers.
  ConverterHandler | Handles setting a `Converter` instance on a `ValueHolder` parent.
  DelegatingMetaTagHandler | Enable the JSF 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.
  Facelet | The parent or root object in a FaceletHandler composition.
  FaceletCache<V> | This API defines the facility by which the Facelets `ViewDeclarationLanguage` creates and caches instances of Facelets.
  FaceletCacheFactory | Allows customization of the implementation of `FaceletCache`.
  FaceletContext | Context representative of a single request from a Facelet.
  FaceletsAttachedObjectHandler | Root class for all tag handlers that represent attached objetcts in a Facelets page.
  Metadata | There are concrete subclasses within the implementation that map concepts in the Facelet VDL page to JSF Java API calls the appropriate instances.
  MetadataTarget | Information used with `MetaRule` for determining how and what `Metadata` should be wired.
  MetaRule | The root class of the abstraction that dictates how attributes on a markup element in a Facelets VDL page are wired to the JSF API object instance associated with that element.
  MetaRuleset | A mutable set of rules to be used in auto-wiring state to a particular object instance.
  MetaTagHandler | 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.
  ResourceResolver | Deprecated
  Tag | The runtime must create an instance of this class for each element in the Facelets XHTML view.
  TagAttribute | Representation of an XML attribute name=value pair on an XML element in a Facelet file.
  TagAttributes | A set of TagAttributes, usually representing all attributes on a Tag.
  TagHandler | Foundation class for `FaceletHandler`s associated with a markup element in a Facelet document.
  TagHandlerDelegate | Abstract class that defines methods relating to helping tag handler instances.
  TagHandlerDelegateFactory | Abstract factory for creating instances of `TagHandlerDelegate`.
  ValidatorHandler | Handles setting a `Validator` instance on an `EditableValueHolder` parent.

- Exception Summary
  Exception | Description
  --- | ---
  FaceletException | An Exception from the Facelet implementation
  TagAttributeException | An Exception caused by a `TagAttribute`
  TagException | An Exception caused by a `Tag`

- Annotation Types Summary
  Annotation Type | Description
  --- | ---
  FaceletsResourceResolver | The presence of this annotation on a class automatically registers the class with the runtime as a `ResourceResolver`.

## Package javax.faces.view.facelets Description

This package contains public classes for the Java code API of Facelets. The vast majority of Facelets users have no need to access the Java API and can get all their work done using the tag-level API. These classes are provided for users that have a need for a Java API that allows participation in the execution of a Facelets View, which happens as a result of the runtime calling `ViewDeclarationLanguage.buildView()`.

The most common usecase for participating in the execution of a Facelets View is to provide a custom tag handler in those cases when the non-Java API methods for doing so is not sufficient. In such cases, Java classes may extend from `ComponentHandler`, `BehaviorHandler`, `ConverterHandler`, or `ValidatorHandler` depending upon the kind of JSF Java API artifact they want to represent in the Facelets VDL page.

Copyright © 1996-2013, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.