org.apache.velocity.util.introspection

Interface ConversionHandler

All Known Implementing Classes:

ConversionHandlerImpl

public interface ConversionHandler

A conversion handler adds admissible conversions between Java types whenever Velocity introspection has to map VTL methods and property accessors to Java methods. Both methods must be consistent: getNeededConverter must not return null whenever isExplicitlyConvertible returned true with the same arguments.

Since:

2.0

Version:

$Id: ConversionHandler.java $

Author:

Claude Brisson

Method Summary

Modifier and Type	Method and Description
void	addConverter(Class formal, Class actual, Converter converter) Add the given converter to the handler.
Converter	getNeededConverter(Class formal, Class actual) Returns the appropriate Converter object needed for an explicit conversion Returns null if no conversion is needed.
boolean	isExplicitlyConvertible(Class formal, Class actual, boolean possibleVarArg) Check to see if the conversion can be done using an explicit conversion

Method Detail

isExplicitlyConvertible

boolean isExplicitlyConvertible(Class formal,
                                Class actual,
                                boolean possibleVarArg)

Check to see if the conversion can be done using an explicit conversion

Parameters:

formal - expected formal type

actual - provided argument type

Returns:

null if no conversion is needed, or the appropriate Converter object

Since:

2.0

getNeededConverter

Converter getNeededConverter(Class formal,
                             Class actual)

Returns the appropriate Converter object needed for an explicit conversion Returns null if no conversion is needed.

Parameters:

formal - expected formal type

actual - provided argument type

Returns:

null if no conversion is needed, or the appropriate Converter object

Since:

2.0

addConverter

void addConverter(Class formal,
                  Class actual,
                  Converter converter)

Add the given converter to the handler. Implementation should be thread-safe.

Parameters:

formal - expected formal type

actual - provided argument type

converter - converter

Since:

2.0