|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.faces.render.Renderer
com.sun.rave.faces.renderer.AbstractRenderer
public abstract class AbstractRenderer
Abstract base class for concrete implementations of
javax.faces.render.Renderer
for the
Widgets Library.
Field Summary | |
---|---|
static java.lang.String[] |
EVENTS_ATTRIBUTES
The list of attribute names in the HTML 4.01 Specification that correspond to the entity type %events;. |
static java.lang.String[] |
I18N_ATTRIBUTES
The list of attribute names in the HTML 4.01 Specification that correspond to the entity type %i18n;. |
Constructor Summary | |
---|---|
AbstractRenderer()
|
Method Summary | |
---|---|
void |
decode(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component)
Decode any new state of the specified UIComponent
from the request contained in the specified FacesContext ,
and store that state on the UIComponent . |
void |
encodeBegin(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component)
Render the beginning of the specified UIComponent
to the output stream or writer associated with the response we are
creating. |
void |
encodeChildren(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component)
Render the children of the specified UIComponent
to the output stream or writer associated with the response we are
creating. |
void |
encodeEnd(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component)
Render the ending of the specified UIComponent
to the output stream or writer associated with the response we are
creating. |
protected void |
encodeRecursive(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component)
Render nested child components by invoking the encode methods on those components, but only when the rendered
property is true . |
protected javax.faces.application.Application |
getApplication()
Return the Application instance for this
web application. |
protected java.lang.Object |
getAsObject(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component,
java.lang.String value)
Return the value to be stored, as an Object that has been converted from the String representation (if necessary), or null if the String representation is null. |
protected java.lang.String |
getAsString(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component)
Return the value to be rendered, as a String (converted if necessary), or null if the value is null. |
protected javax.faces.context.ExternalContext |
getExternalContext()
Return the ExternalContext instance for the current
request. |
protected javax.faces.context.FacesContext |
getFacesContext()
Return the FacesContext instance for the current
request. |
protected boolean |
isDisabled(javax.faces.component.UIComponent component)
Return true if the specified component is disabled. |
protected boolean |
isReadOnly(javax.faces.component.UIComponent component)
Return true if the specified component is read only. |
protected void |
renderAttributes(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component,
javax.faces.context.ResponseWriter writer)
Render the element attributes for the generated markup related to this component. |
protected void |
renderBoolean(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component,
javax.faces.context.ResponseWriter writer,
java.lang.String[] names)
Render any boolean attributes on the specified list that have true values on the corresponding attribute of the
specified UIComponent . |
protected void |
renderCoreAttributes(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component,
javax.faces.context.ResponseWriter writer,
java.lang.String styles)
Render the "core" set of attributes for this UIComponent . |
protected void |
renderEnd(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component,
javax.faces.context.ResponseWriter writer)
Render the element end for the generated markup related to this component. |
protected void |
renderPassThrough(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component,
javax.faces.context.ResponseWriter writer,
java.lang.String[] names)
Render any attributes on the specified list directly to the specified ResponseWriter for which the specified
UIComponent has a non-null attribute value. |
protected void |
renderStart(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component,
javax.faces.context.ResponseWriter writer)
Render the element start for the generated markup related to this component. |
protected void |
setSubmittedValue(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component)
If a submitted value was included on this request, store it in the component as appropriate. |
Methods inherited from class javax.faces.render.Renderer |
---|
convertClientId, getConvertedValue, getRendersChildren |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String[] EVENTS_ATTRIBUTES
The list of attribute names in the HTML 4.01 Specification that correspond to the entity type %events;.
public static final java.lang.String[] I18N_ATTRIBUTES
The list of attribute names in the HTML 4.01 Specification that correspond to the entity type %i18n;.
Constructor Detail |
---|
public AbstractRenderer()
Method Detail |
---|
public void decode(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component)
Decode any new state of the specified UIComponent
from the request contained in the specified FacesContext
,
and store that state on the UIComponent
.
The default implementation calls setSubmittedValue()
unless this component has a boolean disabled
or
readonly
attribute that is set to true
.
decode
in class javax.faces.render.Renderer
context
- FacesContext
for the current requestcomponent
- UIComponent
to be decoded
java.lang.NullPointerException
- if context
or
component
is null
public void encodeBegin(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component) throws java.io.IOException
Render the beginning of the specified UIComponent
to the output stream or writer associated with the response we are
creating.
The default implementation calls renderStart()
and
renderAttributes()
.
encodeBegin
in class javax.faces.render.Renderer
context
- FacesContext
for the current requestcomponent
- UIComponent
to be decoded
java.lang.NullPointerException
- if context
or
component
is null
java.io.IOException
- if an input/output error occurspublic void encodeChildren(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component) throws java.io.IOException
Render the children of the specified UIComponent
to the output stream or writer associated with the response we are
creating.
The default implementation iterates through the children of this component and renders them.
encodeChildren
in class javax.faces.render.Renderer
context
- FacesContext
for the current requestcomponent
- UIComponent
to be decoded
java.lang.NullPointerException
- if context
or
component
is null
java.io.IOException
- if an input/output error occurspublic void encodeEnd(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component) throws java.io.IOException
Render the ending of the specified UIComponent
to the output stream or writer associated with the response we are
creating.
The default implementation calls renderEnd()
.
encodeEnd
in class javax.faces.render.Renderer
context
- FacesContext
for the current requestcomponent
- UIComponent
to be decoded
java.lang.NullPointerException
- if context
or
component
is null
java.io.IOException
- if an input/output error occursprotected void encodeRecursive(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component) throws java.io.IOException
Render nested child components by invoking the encode methods
on those components, but only when the rendered
property is true
.
java.io.IOException
protected javax.faces.application.Application getApplication()
Return the Application
instance for this
web application.
protected java.lang.Object getAsObject(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, java.lang.String value)
Return the value to be stored, as an Object that has been
converted from the String representation (if necessary), or
null
if the String representation is null.
context
- FacesContext for the current requestcomponent
- Component whose value is being processed
(must be a component that implements ValueHoldervalue
- String representation of the valueprotected java.lang.String getAsString(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component)
Return the value to be rendered, as a String (converted
if necessary), or null
if the value is null.
context
- FacesContext for the current requestcomponent
- Component whose value is to be retrieved (must be
a component that implements ValueHolder)protected javax.faces.context.ExternalContext getExternalContext()
Return the ExternalContext
instance for the current
request.
protected javax.faces.context.FacesContext getFacesContext()
Return the FacesContext
instance for the current
request.
protected boolean isDisabled(javax.faces.component.UIComponent component)
Return true
if the specified component is disabled.
component
- UIComponent
to be checkedprotected boolean isReadOnly(javax.faces.component.UIComponent component)
Return true
if the specified component is read only.
component
- UIComponent
to be checkedprotected void renderAttributes(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, javax.faces.context.ResponseWriter writer) throws java.io.IOException
Render the element attributes for the generated markup related to this
component. Simple renderers that create a single markup element
for this component should override this method and include calls to
to writeAttribute()
and writeURIAttribute
on the specified ResponseWriter
.
The default implementation does nothing.
context
- FacesContext
for the current requestcomponent
- EditableValueHolder
component whose
submitted value is to be storedwriter
- ResponseWriter
to which the element
start should be rendered
java.io.IOException
- if an input/output error occursprotected void renderCoreAttributes(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, javax.faces.context.ResponseWriter writer, java.lang.String styles) throws java.io.IOException
Render the "core" set of attributes for this UIComponent
.
The default implementation conditionally generates the following
attributes with values as specified.
null
id
property, and the identifier does not start with
UIViewRoot.UNIQUE_ID_PREFIX
, render the
clientId
.null
styleClass
attribute, render its
value, combined with the syles parameter (if any).null
style
attribute, render its
value.null
title
attribute, render its
value.
context
- FacesContext
for the current requestcomponent
- EditableValueHolder
component whose
submitted value is to be storedwriter
- ResponseWriter
to which the element
start should be renderedstyles
- Space-separated list of CSS style classes to add
to the class
attribute, or null
for none
java.io.IOException
- if an input/output error occursprotected void renderEnd(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, javax.faces.context.ResponseWriter writer) throws java.io.IOException
Render the element end for the generated markup related to this
component. Simple renderers that create a single markup element
for this component should override this method and include a call
to endElement()
on the specified
ResponseWriter
.
The default implementation does nothing.
context
- FacesContext
for the current requestcomponent
- EditableValueHolder
component whose
submitted value is to be storedwriter
- ResponseWriter
to which the element
start should be rendered
java.io.IOException
- if an input/output error occursprotected void renderBoolean(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, javax.faces.context.ResponseWriter writer, java.lang.String[] names) throws java.io.IOException
Render any boolean attributes on the specified list that have
true
values on the corresponding attribute of the
specified UIComponent
.
context
- FacesContext
for the current requestcomponent
- EditableValueHolder
component whose
submitted value is to be storedwriter
- ResponseWriter
to which the element
start should be renderednames
- List of attribute names to be passed through
java.io.IOException
- if an input/output error occursprotected void renderPassThrough(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, javax.faces.context.ResponseWriter writer, java.lang.String[] names) throws java.io.IOException
Render any attributes on the specified list directly to the
specified ResponseWriter
for which the specified
UIComponent
has a non-null
attribute value.
This method may be used to "pass through" commonly used attribute
name/value pairs with a minimum of code.
context
- FacesContext
for the current requestcomponent
- EditableValueHolder
component whose
submitted value is to be storedwriter
- ResponseWriter
to which the element
start should be renderednames
- List of attribute names to be passed through
java.io.IOException
- if an input/output error occursprotected void renderStart(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, javax.faces.context.ResponseWriter writer) throws java.io.IOException
Render the element start for the generated markup related to this
component. Simple renderers that create a single markup element
for this component should override this method and include a call
to startElement()
on the specified
ResponseWriter
.
The default implementation does nothing.
context
- FacesContext
for the current requestcomponent
- EditableValueHolder
component whose
submitted value is to be storedwriter
- ResponseWriter
to which the element
start should be rendered
java.io.IOException
- if an input/output error occursprotected void setSubmittedValue(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component)
If a submitted value was included on this request, store it in the component as appropriate.
The default implementation determines whether this component
implements EditableValueHolder
. If so, it checks for a
request parameter with the same name as the clientId
of this UIComponent
. If there is such a parameter, its
value is passed (as a String) to the setSubmittedValue()
method on the EditableValueHolder
component.
context
- FacesContext
for the current requestcomponent
- EditableValueHolder
component whose
submitted value is to be stored
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |