|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||
JavaTM Platform, Enterprise Edition, v 5.0
javax.faces.render
|
Constructor Summary | |
---|---|
Renderer()
|
Method Summary | |
---|---|
String |
convertClientId(FacesContext context,
String clientId)
Convert the component generated client id to a form suitable for transmission to the client. |
void |
decode(FacesContext context,
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(FacesContext context,
UIComponent component)
Render the beginning specified UIComponent to the
output stream or writer associated with the response we are creating. |
void |
encodeChildren(FacesContext context,
UIComponent component)
Render the child components of this UIComponent , following
the rules described for encodeBegin() to acquire the
appropriate value to be rendered. |
void |
encodeEnd(FacesContext context,
UIComponent component)
Render the ending of the current state of the specified UIComponent , following the rules described for
encodeBegin() to acquire the appropriate value
to be rendered. |
Object |
getConvertedValue(FacesContext context,
UIComponent component,
Object submittedValue)
Attempt to convert previously stored state information into an object of the type required for this component (optionally using the registered Converter for this component,
if there is one). |
boolean |
getRendersChildren()
Return a flag indicating whether this Renderer is responsible
for rendering the children the component it is asked to render. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public Renderer()
Method Detail |
---|
public void decode(FacesContext context, 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
.
During decoding, events may be enqueued for later processing
(by event listeners that have registered an interest), by calling
queueEvent()
on the associated UIComponent
.
context
- FacesContext
for the request we are processingcomponent
- UIComponent
to be decoded.
NullPointerException
- if context
or component
is null
public void encodeBegin(FacesContext context, UIComponent component) throws IOException
Render the beginning specified UIComponent
to the
output stream or writer associated with the response we are creating.
If the conversion attempted in a previous call to
getConvertedValue()
for this component failed, the state
information saved during execution
of decode()
should be used to reproduce the incorrect
input.
context
- FacesContext
for the request we are processingcomponent
- UIComponent
to be rendered
IOException
- if an input/output error occurs while rendering
NullPointerException
- if context
or component
is nullpublic void encodeChildren(FacesContext context, UIComponent component) throws IOException
Render the child components of this UIComponent
, following
the rules described for encodeBegin()
to acquire the
appropriate value to be rendered. This method will only be called
if the rendersChildren
property of this component
is true
.
context
- FacesContext
for the response we are creatingcomponent
- UIComponent
whose children are to be rendered
IOException
- if an input/output error occurs while rendering
NullPointerException
- if context
or component
is null
public void encodeEnd(FacesContext context, UIComponent component) throws IOException
Render the ending of the current state of the specified
UIComponent
, following the rules described for
encodeBegin()
to acquire the appropriate value
to be rendered.
context
- FacesContext
for the response we are creatingcomponent
- UIComponent
to be rendered
IOException
- if an input/output error occurs while rendering
NullPointerException
- if context
or component
is null
public String convertClientId(FacesContext context, String clientId)
Convert the component generated client id to a form suitable for transmission to the client.
The default implementation returns the argument
clientId
unchanged.
context
- FacesContext
for the current requestclientId
- the client identifier to be converted to client a
specific format.
NullPointerException
- if context
or clientId
is null
public boolean getRendersChildren()
Return a flag indicating whether this Renderer
is responsible
for rendering the children the component it is asked to render.
The default implementation returns false
.
public Object getConvertedValue(FacesContext context, UIComponent component, Object submittedValue) throws ConverterException
Attempt to convert previously stored state information into an
object of the type required for this component (optionally using the
registered Converter
for this component,
if there is one). If conversion is successful, the new value
should be returned from this method; if not, a
ConverterException
should be thrown.
context
- FacesContext
for the request we are processingcomponent
- UIComponent
to be decoded.submittedValue
- a value stored on the component during
decode
.
ConverterException
- if the submitted value
cannot be converted successfully.
NullPointerException
- if context
or component
is null