javax.faces.render

Class RendererWrapper

java.lang.Object

javax.faces.render.Renderer

javax.faces.render.RendererWrapper

All Implemented Interfaces:

FacesWrapper<Renderer>

public abstract class RendererWrapper
extends Renderer
implements FacesWrapper<Renderer>

Since:

2.2

Field Summary

Fields inherited from class javax.faces.render.Renderer

PASSTHROUGH_RENDERER_LOCALNAME_KEY

Constructor Summary

Constructors

Constructor and Description
RendererWrapper()

Method Summary

Methods

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.
abstract Renderer	getWrapped() A class that implements this interface uses this method to return an instance of the class being wrapped.

Methods inherited from class java.lang.Object

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

Constructor Detail

RendererWrapper

public RendererWrapper()

Method Detail

decode

public void decode(FacesContext context,
          UIComponent component)

Overrides:

decode in class Renderer

encodeBegin

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

Overrides:

encodeBegin in class Renderer

Throws:

IOException - if an input/output error occurs while rendering

encodeChildren

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

Description copied from class: Renderer

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.

Overrides:

encodeChildren in class Renderer

Throws:

IOException

encodeEnd

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

Overrides:

encodeEnd in class Renderer

Throws:

IOException - if an input/output error occurs while rendering

convertClientId

public String convertClientId(FacesContext context,
                     String clientId)

Overrides:

convertClientId in class Renderer

getRendersChildren

public boolean getRendersChildren()

Description copied from class: Renderer

Switch for deciding who renders the children.

Overrides:

getRendersChildren in class Renderer

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

Overrides:

getConvertedValue in class Renderer

Throws:

ConverterException

getWrapped

public abstract Renderer getWrapped()

Description copied from interface: FacesWrapper

A class that implements this interface uses this method to return an instance of the class being wrapped.

Specified by:

getWrapped in interface FacesWrapper<Renderer>

Returns:

the instance of the class being wrapped