javax.faces.convert
Interface Converter

All Superinterfaces:

java.io.Serializable

public interface Converter

extends java.io.Serializable

Converter is an interface describing a Java class that can perform Object-to-String and String-to-Object conversions between model data objects and a String representation of those objects that is suitable for rendering. Converter instances are shared, so they must be programmed in a thread-safe manner. In addition, because Converters are part of the saved and restored state of a component tree, classes that implement this interface must also be serializable.

Method Summary

java.lang.Object	getAsObject(FacesContext context, UIComponent component, java.lang.String value) Convert the specified string value, which is associated with the specified UIComponent, into a model data object that is appropriate for being stored during the Apply Request Values phase of the request processing lifecycle.
java.lang.String	getAsString(FacesContext context, UIComponent component, java.lang.Object value) Convert the specified model object value, which is associated with the specified UIComponent, into a String that is suitable for being included in the response generated during the Render Response phase of the request processing lifeycle.

Method Detail

getAsObject

public java.lang.Object getAsObject(FacesContext context,
                                    UIComponent component,
                                    java.lang.String value)
                             throws ConverterException

Convert the specified string value, which is associated with the specified UIComponent, into a model data object that is appropriate for being stored during the Apply Request Values phase of the request processing lifecycle.

Parameters:

context - FacesContext for the request being processed

component - UIComponent with which this model object value is associated

value - String value to be converted (may be null)

Throws:

ConverterException - if conversion cannot be successfully performed

java.lang.NullPointerException - if context or component is null

getAsString

public java.lang.String getAsString(FacesContext context,
                                    UIComponent component,
                                    java.lang.Object value)
                             throws ConverterException

Convert the specified model object value, which is associated with the specified UIComponent, into a String that is suitable for being included in the response generated during the Render Response phase of the request processing lifeycle.

Parameters:

context - FacesContext for the request being processed

component - UIComponent with which this model object value is associated

value - Model object value to be converted (may be null)

Throws:

ConverterException - if conversion cannot be successfully performed

java.lang.NullPointerException - if context or component is null