javax.faces.render

Class Renderer

java.lang.Object

javax.faces.render.Renderer

Direct Known Subclasses:

RendererWrapper

public abstract class Renderer
extends Object

see Javadoc of JSF Specification

Field Summary

Fields

Modifier and Type	Field and Description
static String	PASSTHROUGH_RENDERER_LOCALNAME_KEY

Constructor Summary

Constructors

Constructor and Description
Renderer()

Method Summary

Modifier and Type	Method and Description
String	convertClientId(FacesContext context, String clientId)
void	decode(FacesContext context, UIComponent component)
void	encodeBegin(FacesContext context, UIComponent component)
void	encodeChildren(FacesContext context, UIComponent component) Render all children if there are any.
void	encodeEnd(FacesContext context, UIComponent component)
Object	getConvertedValue(FacesContext context, UIComponent component, Object submittedValue)
boolean	getRendersChildren() Switch for deciding who renders the children.

Methods inherited from class java.lang.Object

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

Field Detail

PASSTHROUGH_RENDERER_LOCALNAME_KEY

public static final String PASSTHROUGH_RENDERER_LOCALNAME_KEY

Since:

2.2

See Also:

Constant Field Values

Constructor Detail

Renderer

public Renderer()

Method Detail

decode

public void decode(FacesContext context,
                   UIComponent component)

encodeBegin

public void encodeBegin(FacesContext context,
                        UIComponent component)
                 throws IOException

Throws:

IOException - if an input/output error occurs while rendering

encodeChildren

public void encodeChildren(FacesContext context,
                           UIComponent component)
                    throws IOException

Render all children if there are any. Note: this will only be called if getRendersChildren() returns true. A component which has a renderer with getRendersChildren() set to true will typically contain the rendering logic for its children in this method.

Parameters:

context -

component -

Throws:

IOException

encodeEnd

public void encodeEnd(FacesContext context,
                      UIComponent component)
               throws IOException

Throws:

IOException - if an input/output error occurs while rendering

convertClientId

public String convertClientId(FacesContext context,
                              String clientId)

getRendersChildren

public boolean getRendersChildren()

Switch for deciding who renders the children.

Returns:

true - if the component takes care of rendering its children. In this case, encodeChildren() ought to be called by the rendering controller (e.g., the rendering controller could be the method encodeAll() in UIComponent). In the method encodeChildren(), the component should therefore provide all children encode logic.

false - if the component does not take care of rendering its children. In this case, encodeChildren() should not be called by the rendering controller. Instead, the children-list should be retrieved and the children should directly be rendered by the rendering controller one by one.

getConvertedValue

public Object getConvertedValue(FacesContext context,
                                UIComponent component,
                                Object submittedValue)
                         throws ConverterException

Throws:

ConverterException