Package javax.faces.component
package javax.faces.component
Fundamental APIs for user interface components.
For your convenience here is a UML class diagram of the classes in this package.
-
ClassDescriptionActionSource is an interface that may be implemented by any concrete
UIComponent
that wishes to be a source ofActionEvent
s, including the ability to invoke application actions via the defaultActionListener
mechanism.ActionSource2 extendsActionSource
and provides a JavaBeans property analogous to the "action
" property onActionSource
.A simple callback interace that enables taking action on a specific UIComponent (either facet or child) in the view while preserving any contextual state for that component instance in the view.EditableValueHolder is an extension of ValueHolder that describes additional features supported by editable components, includingValueChangeEvent
s andValidator
s.The presence of this annotation on a class that extendsUIComponent
must cause the runtime to register this class as a component suitable for inclusion in a view.NamingContainer is an interface that must be implemented by anyUIComponent
that wants to be a naming container.Components that want to leverage the partial state saving feature must implement this interface instead of implementingStateHolder
, from which this interface inherits.Define aMap
-like contract that makes it easier for components to implementPartialStateHolder
.This interface is implemented by classes that need to save their state between requests.Define aMap
-like contract that makes it easier for components to implementTransientStateHolder
.This interface is implemented by classes that need to save state that is expected to be available only within the scope of the current request.UIColumn is aUIComponent
that represents a single column of data within a parentUIData
component.UICommand is aUIComponent
that represents a user interface component which, when activated by the user, triggers an application specific "command" or "action".UIComponent is the base class for all user interface components in JavaServer Faces.UIComponentBase is a convenience base class that implements the default concrete behavior of all methods defined byUIComponent
.UIData is aUIComponent
that supports data binding to a collection of data objects represented by aDataModel
instance, which is the current value of this component itself (typically established via aValueExpression
).UIForm is aUIComponent
that represents an input form to be presented to the user, and whose child components represent (among other things) the input fields to be included when the form is submitted.UIGraphic is aUIComponent
that displays a graphical image to the user.UIInput is aUIComponent
that represents a component that both displays output to the user (likeUIOutput
components do) and processes request parameters on the subsequent request that need to be decoded.This component is responsible for displaying messages for a specificUIComponent
, identified by aclientId
or component id relative to the closest ancestorNamingContainer
.The renderer for this component is responsible for obtaining the messages from theFacesContext
and displaying them to the user.UINamingContainer is a convenience base class for components that wish to implementNamingContainer
functionality.This component is paired with thejavax.faces.Button
orjavax.faces.Link
renderers and encapsulates properties relating to the rendering of outcomes directly to the response.UIOutput is aUIComponent
that has a value, optionally retrieved from a model tier bean via a value expression, that is displayed to the user.UIPanel is aUIComponent
that manages the layout of its child components.UIParameter is aUIComponent
that represents an optionally named configuration parameter for a parent component.UISelectItem is a component that may be nested inside aUISelectMany
orUISelectOne
component, and causes the addition of aSelectItem
instance to the list of available options for the parent component.UISelectItems is a component that may be nested inside aUISelectMany
orUISelectOne
component, and causes the addition of one or moreSelectItem
instances to the list of available options in the parent component.UISelectMany is aUIComponent
that represents the user's choice of a zero or more items from among a discrete set of available options.UISelectOne is aUIComponent
that represents the user's choice of zero or one items from among a discrete set of available options.UIViewAction represents a method invocation that occurs during the request processing lifecycle, usually in response to an initial request, as opposed to a postback.UIViewParameter represents a binding between a request parameter and a model property orUIViewRoot
property.Inner class to encapsulate aUIViewParameter
instance so that it may be safely referenced regardless of whether or not the current view is the same as the view in which thisUIViewParameter
resides.UIViewRoot is the UIComponent that represents the root of the UIComponent tree.UniqueIdVendor is an interface implemented byUIComponents
that also implementNamingContainer
so that they can provide unique ids based on their own clientId.This exception indicates a failure to update the model and is created to wrap any exception that occurs duringUIInput.updateModel(javax.faces.context.FacesContext)
.ValueHolder is an interface that may be implemented by any concreteUIComponent
that wishes to support a local value, as well as access data in the model tier via a value expression, and support conversion between String and the model tier data's native data type.