Top Description Fields Constructors Methods
javax.faces.webapp

public abstract Class UIComponentTagBase

extends Object
implements JspTag
Class Inheritance
All Implemented Interfaces
javax.servlet.jsp.tagext.JspTag
Known Direct Subclasses
javax.faces.webapp.UIComponentClassicTagBase
Imports
javax.el.ELContext, javax.faces.component.UIComponent, javax.faces.context.FacesContext, javax.servlet.jsp.tagext.JspTag, java.util.logging.Logger

UIComponentTagBase is the base class for all JSP tags that correspond to a javax.faces.component.UIComponent instance in the view. This base class allows a single view to be described in a JSP page consisting of both UIComponentELTag and UIComponentTag instances.

Field Summary

Modifier and TypeField and Description
protected static final Logger

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
protected abstract void
addChild(UIComponent
New child whose identifier should be added
child
)

Add the component identifier of the specified UIComponent to the list of component identifiers created or located by nested UIComponentTags processing this request.

protected abstract void
addFacet(String
Facet name to be added
name
)

Add the facet name of the specified facet to the list of facet names created or located by nested UIComponentTags processing this request.

public abstract UIComponent

Returns:

the component
getComponentInstance
()

Return the UIComponent instance that is associated with this tag instance.

public abstract String

Returns:

the component type
getComponentType
()

Return the component type for the component that is or will be bound to this tag.

public abstract boolean

Returns:

the result as specified above
getCreated
()

Return true if we dynamically created a new component instance during execution of this tag.

protected ELContext

Returns:

the {code ELContext} for this FacesContext
getELContext
()

Return the ELContext for the FacesContext for this request.

protected abstract FacesContext

Returns:

the FacesContext for the current request.
getFacesContext
()

Return the FacesContext instance for the current request.

protected abstract int

Returns:

the index
getIndexOfNextChildTag
()

Return the index of the next child to be added as a child of this tag.

public abstract String

Returns:

the renderer type
getRendererType
()

Return the rendererType property that selects the Renderer to be used for encoding this component, or null to ask the component to render itself directly.

public abstract void
setId(String
The new component identifier. This may not start with javax.faces.component.UIViewRoot#UNIQUE_ID_PREFIX.
id
)

Set the component identifier for the component corresponding to this tag instance.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

logback to summary
protected static final Logger log

Constructor Detail

UIComponentTagBaseback to summary
public UIComponentTagBase()

Method Detail

addChildback to summary
protected abstract void addChild(UIComponent child)

Add the component identifier of the specified UIComponent to the list of component identifiers created or located by nested UIComponentTags processing this request.

Parameters
child:UIComponent

New child whose identifier should be added

addFacetback to summary
protected abstract void addFacet(String name)

Add the facet name of the specified facet to the list of facet names created or located by nested UIComponentTags processing this request.

Parameters
name:String

Facet name to be added

getComponentInstanceback to summary
public abstract UIComponent getComponentInstance()

Return the UIComponent instance that is associated with this tag instance. This method is designed to be used by tags nested within this tag, and only returns useful results between the execution of doStartTag() and doEndTag() on this tag instance.

Returns:UIComponent

the component

getComponentTypeback to summary
public abstract String getComponentType()

Return the component type for the component that is or will be bound to this tag. This value can be passed to javax.faces.application.Application#createComponent to create the UIComponent instance for this tag. Subclasses must override this method to return the appropriate value.

Returns:String

the component type

getCreatedback to summary
public abstract boolean getCreated()

Return true if we dynamically created a new component instance during execution of this tag. This method is designed to be used by tags nested within this tag, and only returns useful results between the execution of doStartTag() and doEndTag() on this tag instance.

Returns:boolean

the result as specified above

getELContextback to summary
protected ELContext getELContext()

Return the ELContext for the FacesContext for this request.

This is a convenience for getFacesContext().getELContext().

Returns:ELContext

the {code ELContext} for this FacesContext

getFacesContextback to summary
protected abstract FacesContext getFacesContext()

Return the FacesContext instance for the current request. This value will be non-null only from the beginning of doStartTag() through the end of doEndTag() for each tag instance.

Returns:FacesContext

the FacesContext for the current request.

getIndexOfNextChildTagback to summary
protected abstract int getIndexOfNextChildTag()

Return the index of the next child to be added as a child of this tag. The default implementation maintains a list of created components and returns the size of the list.

Returns:int

the index

getRendererTypeback to summary
public abstract String getRendererType()

Return the rendererType property that selects the Renderer to be used for encoding this component, or null to ask the component to render itself directly. Subclasses must override this method to return the appropriate value.

Returns:String

the renderer type

setIdback to summary
public abstract void setId(String id)

Set the component identifier for the component corresponding to this tag instance. If the argument begins with javax.faces.component.UIViewRoot#UNIQUE_ID_PREFIX throw an IllegalArgumentException

Parameters
id:String

The new component identifier. This may not start with javax.faces.component.UIViewRoot#UNIQUE_ID_PREFIX.

Exceptions
IllegalArgumentException:
if the argument is non-null and starts with javax.faces.component.UIViewRoot#UNIQUE_ID_PREFIX.