com.sun.faces.taglib.jsf_core

Class ViewTag

java.lang.Object

javax.faces.webapp.UIComponentTagBase

javax.faces.webapp.UIComponentClassicTagBase

javax.faces.webapp.UIComponentELTag

com.sun.faces.taglib.jsf_core.ViewTag

All Implemented Interfaces:

javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspIdConsumer, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag

public class ViewTag
extends UIComponentELTag

All JSF component tags must be nested within a f:view tag. This tag corresponds to the root of the UIComponent tree. It does not have a Renderer. It exists mainly to provide a guarantee that all faces components reside inside of this tag.

Field Summary

Fields

Modifier and Type	Field and Description
protected javax.el.MethodExpression	afterPhase
protected javax.el.MethodExpression	beforePhase
protected javax.el.ValueExpression	locale
protected javax.el.ValueExpression	renderKitId

Fields inherited from class javax.faces.webapp.UIComponentClassicTagBase

bodyContent, pageContext, UNIQUE_ID_PREFIX

Fields inherited from class javax.faces.webapp.UIComponentTagBase

log

Fields inherited from interface javax.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Fields inherited from interface javax.servlet.jsp.tagext.BodyTag

EVAL_BODY_BUFFERED, EVAL_BODY_TAG

Fields inherited from interface javax.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Constructor Summary

Constructors

Constructor and Description
ViewTag()

Method Summary

Modifier and Type	Method and Description
int	doAfterBody() Examine the body content of this tag.
int	doEndTag() Exercise a contract with the ViewHandler to get the character encoding from the response and set it into the session.
int	doStartTag() Override parent doStartTag() to do the following:
String	getComponentType() Return the component type for the component that is or will be bound to this tag.
protected int	getDoEndValue() Return the flag value that should be returned from the doEnd() method when it is called.
protected int	getDoStartValue() Return the flag value that should be returned from the doStart() method when it is called.
protected Locale	getLocaleFromString(String localeExpr) Returns the locale represented by the expression.
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.
void	setAfterPhase(javax.el.MethodExpression newAfterPhase)
void	setBeforePhase(javax.el.MethodExpression newBeforePhase)
void	setLocale(javax.el.ValueExpression newLocale)
protected void	setProperties(UIComponent component) Override properties and attributes of the specified component, if the corresponding properties of this tag handler instance were explicitly set.
void	setRenderKitId(javax.el.ValueExpression renderKitId)

Methods inherited from class javax.faces.webapp.UIComponentELTag

createComponent, getELContext, hasBinding, release, setBinding, setRendered

Methods inherited from class javax.faces.webapp.UIComponentClassicTagBase

addChild, addFacet, addVerbatimAfterComponent, addVerbatimBeforeComponent, createVerbatimComponent, createVerbatimComponentFromBodyContent, doInitBody, encodeBegin, encodeChildren, encodeEnd, findComponent, getBodyContent, getComponentInstance, getCreated, getCreatedComponents, getDoAfterBodyValue, getFacesContext, getFacesJspId, getFacetName, getId, getIndexOfNextChildTag, getJspId, getParent, getParentUIComponentClassicTagBase, getPreviousOut, setBodyContent, setId, setJspId, setPageContext, setParent, setupResponseWriter

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.servlet.jsp.tagext.Tag

getParent, setPageContext, setParent

Field Detail

renderKitId

protected javax.el.ValueExpression renderKitId

locale

protected javax.el.ValueExpression locale

beforePhase

protected javax.el.MethodExpression beforePhase

afterPhase

protected javax.el.MethodExpression afterPhase

Constructor Detail

ViewTag

public ViewTag()

Method Detail

setRenderKitId

public void setRenderKitId(javax.el.ValueExpression renderKitId)

setLocale

public void setLocale(javax.el.ValueExpression newLocale)

setBeforePhase

public void setBeforePhase(javax.el.MethodExpression newBeforePhase)

setAfterPhase

public void setAfterPhase(javax.el.MethodExpression newAfterPhase)

getDoStartValue

protected int getDoStartValue()
                       throws javax.servlet.jsp.JspException

Description copied from class: UIComponentClassicTagBase

Return the flag value that should be returned from the doStart() method when it is called. Subclasses may override this method to return the appropriate value.

Overrides:

getDoStartValue in class UIComponentClassicTagBase

Returns:

the value to return from doStart()

Throws:

javax.servlet.jsp.JspException - to cause doStart() to throw an exception

doStartTag

public int doStartTag()
               throws javax.servlet.jsp.JspException

Override parent doStartTag() to do the following:

• Reflect the response object for a method called flushContentToWrappedResponse and invoke it. This causes any content that appears before the view to be written out to the response. This is necessary to allow proper ordering to happen.

Specified by:

doStartTag in interface javax.servlet.jsp.tagext.Tag

Overrides:

doStartTag in class UIComponentClassicTagBase

Throws:

javax.servlet.jsp.JspException - if an error occurs

doAfterBody

public int doAfterBody()
                throws javax.servlet.jsp.JspException

Examine the body content of this tag. If it is non-null, non-zero length, and not an HTML comment, call UIComponentClassicTagBase.createVerbatimComponent().

Set the value of the verbatim component to be content.

Add this child to the end of the child list for UIViewRoot.

Specified by:

doAfterBody in interface javax.servlet.jsp.tagext.IterationTag

Overrides:

doAfterBody in class UIComponentClassicTagBase

Throws:

javax.servlet.jsp.JspException - if an error is encountered

doEndTag

public int doEndTag()
             throws javax.servlet.jsp.JspException

Exercise a contract with the ViewHandler to get the character encoding from the response and set it into the session.

Specified by:

doEndTag in interface javax.servlet.jsp.tagext.Tag

Overrides:

doEndTag in class UIComponentClassicTagBase

Throws:

javax.servlet.jsp.JspException - if an error occurs

getComponentType

public String getComponentType()

Description copied from class: UIComponentTagBase

Return the component type for the component that is or will be bound to this tag. This value can be passed to Application.createComponent(java.lang.String) to create the UIComponent instance for this tag. Subclasses must override this method to return the appropriate value.

Specified by:

getComponentType in class UIComponentTagBase

Returns:

the component type

getRendererType

public String getRendererType()

Description copied from class: UIComponentTagBase

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.

Specified by:

getRendererType in class UIComponentTagBase

Returns:

the renderer type

getDoEndValue

protected int getDoEndValue()
                     throws javax.servlet.jsp.JspException

Description copied from class: UIComponentClassicTagBase

Return the flag value that should be returned from the doEnd() method when it is called. Subclasses may override this method to return the appropriate value.

Overrides:

getDoEndValue in class UIComponentClassicTagBase

Returns:

the value to return from doEnd()

Throws:

javax.servlet.jsp.JspException - to cause doEnd() to throw an exception

setProperties

protected void setProperties(UIComponent component)

Description copied from class: UIComponentELTag

Override properties and attributes of the specified component, if the corresponding properties of this tag handler instance were explicitly set. This method must be called ONLY if the specified UIComponent was in fact created during the execution of this tag handler instance, and this call will occur BEFORE the UIComponent is added to the view.

Tag subclasses that want to support additional set properties must ensure that the base class setProperties() method is still called. A typical implementation that supports extra properties foo and bar would look something like this:

 protected void setProperties(UIComponent component) {
   super.setProperties(component);
   if (foo != null) {
     component.setAttribute("foo", foo);
   }
   if (bar != null) {
     component.setAttribute("bar", bar);
   }
 }
 

The default implementation overrides the following properties:

• rendered - Set if a value for the rendered property is specified for this tag handler instance.
• rendererType - Set if the getRendererType() method returns a non-null value.

Overrides:

setProperties in class UIComponentELTag

Parameters:

component - UIComponent whose properties are to be overridden

getLocaleFromString

protected Locale getLocaleFromString(String localeExpr)

Returns the locale represented by the expression.

Parameters:

localeExpr - a String in the format specified by JSTL Specification as follows: "A String value is interpreted as the printable representation of a locale, which must contain a two-letter (lower-case) language code (as defined by ISO-639), and may contain a two-letter (upper-case) country code (as defined by ISO-3166). Language and country codes must be separated by hyphen (???-???) or underscore (???_???)."

Returns:

Locale instance cosntructed from the expression.