org.omnifaces.converter

Class ToCollectionConverter

java.lang.Object

org.omnifaces.converter.TrimConverter

org.omnifaces.converter.ToCollectionConverter

All Implemented Interfaces:

Converter

public class ToCollectionConverter
extends TrimConverter

The omnifaces.ToCollectionConverter is intented to convert submitted String values to a Java collection based on a delimiter. Additionally, it trims any whitespace around each delimited submitted value. This is useful for among others comma separated value inputs.

Usage

This converter is available by converter ID omnifaces.ToCollectionConverter. Just specify it in the converter attribute of the component referring the Collection property. For example:

 <h:inputText value="#{bean.commaSeparatedValues}" converter="omnifaces.ToCollectionConverter" />
 

The default delimiter is comma followed by space , and the default collection type is java.util.LinkedHashSet for a Set property and java.util.ArrayList for anything else, and the default converter for each item will in getAsString() be determined based on item type and in getAsObject() be determined based on generic return type of the getter method.

You can use <o:converter> to specify those attributes. The delimiter must be a String, the collectionType must be a FQN and the itemConverter can be anything which is acceptable by Faces.createConverter(Object).

 <h:inputText value="#{bean.uniqueOrderedSemiColonSeparatedNumbers}">
     <o:converter converterId="omnifaces.ToCollectionConverter"
                  delimiter=";"
                  collectionType="java.util.TreeSet"
                  itemConverter="javax.faces.Integer" >
 </h:inputText>
 

Since:

2.6

Author:

Bauke Scholtz

See Also:

TrimConverter

Field Summary

Fields inherited from interface javax.faces.convert.Converter

DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE_PARAM_NAME

Constructor Summary

Constructors

Constructor and Description
ToCollectionConverter()

Method Summary

Modifier and Type	Method and Description
Object	getAsObject(FacesContext context, UIComponent component, String submittedValue)
String	getAsString(FacesContext context, UIComponent component, Object modelValue)
void	setCollectionType(String collectionType)
void	setDelimiter(String delimiter)
void	setItemConverter(Object itemConverter)

Methods inherited from class java.lang.Object

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

Constructor Detail

ToCollectionConverter

public ToCollectionConverter()

Method Detail

getAsObject

public Object getAsObject(FacesContext context,
                          UIComponent component,
                          String submittedValue)

Specified by:

getAsObject in interface Converter

Overrides:

getAsObject in class TrimConverter

getAsString

public String getAsString(FacesContext context,
                          UIComponent component,
                          Object modelValue)

Specified by:

getAsString in interface Converter

Overrides:

getAsString in class TrimConverter

setDelimiter

public void setDelimiter(String delimiter)

setCollectionType

public void setCollectionType(String collectionType)

setItemConverter

public void setItemConverter(Object itemConverter)