org.springframework.binding.convert.converters

Class ArrayToArray

java.lang.Object

org.springframework.binding.convert.converters.ArrayToArray

All Implemented Interfaces:

Converter

public class ArrayToArray
extends java.lang.Object
implements Converter

Special one-way converter that converts from a source array to a target array. Supports type conversion of the individual array elements; for example, the ability to convert a String[] to an Integer[]. Mainly used internally by ConversionService implementations.

Author:

Keith Donald

Constructor Summary

Constructors

Constructor and Description
ArrayToArray(ConversionExecutor elementConverter) Creates a new array-to-array converter.
ArrayToArray(ConversionService conversionService) Creates a new array-to-array converter.

Method Summary

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

ArrayToArray

public ArrayToArray(ConversionService conversionService)

Creates a new array-to-array converter.

Parameters:

conversionService - the service to use to lookup conversion executors for individual array elements dynamically

ArrayToArray

public ArrayToArray(ConversionExecutor elementConverter)

Creates a new array-to-array converter.

Parameters:

elementConverter - a specific conversion executor to use to convert elements in the source array to elements in the target array.

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