org.springframework.binding.convert.converters

Class ObjectToCollection

java.lang.Object

org.springframework.binding.convert.converters.ObjectToCollection

All Implemented Interfaces:

Converter

public class ObjectToCollection
extends java.lang.Object
implements Converter

Special two-way converter that converts an object to an single-element collection. Supports type conversion of the individual element with parameterized collection implementations.

Author:

Keith Donald

Constructor Summary

Constructors

Constructor and Description
ObjectToCollection(ConversionExecutor elementConverter) Creates a new object to collection converter
ObjectToCollection(ConversionService conversionService) Creates a new object to collection converter

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	convertSourceToTargetClass(java.lang.Object source, java.lang.Class<?> targetClass) Convert the provided source object argument to an instance of the specified target class.
java.lang.Class<?>	getSourceClass() The source class this converter can convert from.
java.lang.Class<?>	getTargetClass() The target class this converter can convert to.

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectToCollection

public ObjectToCollection(ConversionService conversionService)

Creates a new object to collection converter

Parameters:

conversionService - the conversion service to lookup the converter to use to convert an object when adding it to a target collection

ObjectToCollection

public ObjectToCollection(ConversionExecutor elementConverter)

Creates a new object to collection converter

Parameters:

elementConverter - a specific converter to execute on an object when adding it to a target collection

Method Detail

getSourceClass

public java.lang.Class<?> getSourceClass()

Description copied from interface: Converter

The source class this converter can convert from. May be an interface or abstract type to allow this converter to convert specific subclasses as well.

Specified by:

getSourceClass in interface Converter

Returns:

the source type

getTargetClass

public java.lang.Class<?> getTargetClass()

Description copied from interface: Converter

The target class this converter can convert to. May be an interface or abstract type to allow this converter to convert specific subclasses as well.

Specified by:

getTargetClass in interface Converter

Returns:

the target type

convertSourceToTargetClass

public java.lang.Object convertSourceToTargetClass(java.lang.Object source,
                                          java.lang.Class<?> targetClass)
                                            throws java.lang.Exception

Description copied from interface: Converter

Convert the provided source object argument to an instance of the specified target class.

Specified by:

convertSourceToTargetClass in interface Converter

Parameters:

source - the source object to convert, which must be an instance of Converter.getSourceClass()

targetClass - the target class to convert the source to, which must be equal to or a specialization of Converter.getTargetClass()

Returns:

the converted object, which must be an instance of the targetClass

Throws:

java.lang.Exception - an exception occurred performing the conversion