public interface ConversionService
Modifier and Type | Method and Description |
---|---|
Object |
executeConversion(Object source,
Class targetClass)
Execute a conversion of the source object provided to the specified
targetClass |
Object |
executeConversion(String converterId,
Object source,
Class targetClass)
Execute a conversion using the custom converter with the provided id.
|
Class |
getClassForAlias(String alias)
Lookup a class by its well-known alias.
|
ConversionExecutor |
getConversionExecutor(Class sourceClass,
Class targetClass)
Return the default conversion executor capable of converting source objects of the specified
sourceClass to instances of the targetClass . |
ConversionExecutor |
getConversionExecutor(String id,
Class sourceClass,
Class targetClass)
Return the custom conversion executor capable of converting source objects of the specified
sourceClass to instances of the targetClass . |
Set |
getConversionExecutors(Class sourceClass)
Return all conversion executors capable of converting from the provided
sourceClass . |
Object executeConversion(Object source, Class targetClass) throws ConversionException
targetClass
source
- the source to convert from (may be null)targetClass
- the target class to convert totargetClass
ConversionException
- if an exception occurred during the conversion processObject executeConversion(String converterId, Object source, Class targetClass)
converterId
- the id of the custom converter, which must be registered with this conversion service and
capable of converting to the target classsource
- the source to convert from (may be null)targetClass
- the target class to convert totargetClass
ConversionException
- if an exception occurred during the conversion processConversionExecutor getConversionExecutor(Class sourceClass, Class targetClass) throws ConversionExecutorNotFoundException
sourceClass
to instances of the targetClass
.
The returned ConversionExecutor is thread-safe and may safely be cached for use in client code.
sourceClass
- the source class to convert from (required)targetClass
- the target class to convert to (required)ConversionExecutorNotFoundException
- when no suitable conversion executor could be foundConversionExecutor getConversionExecutor(String id, Class sourceClass, Class targetClass) throws ConversionExecutorNotFoundException
sourceClass
to instances of the targetClass
.
The returned ConversionExecutor is thread-safe and may safely be cached for use in client code.
id
- the id of the custom conversion executor (required)sourceClass
- the source class to convert from (required)targetClass
- the target class to convert to (required)ConversionExecutorNotFoundException
- when no suitable conversion executor could be foundSet getConversionExecutors(Class sourceClass)
sourceClass
. For
example, getConversionExecutor(String.class)
would return all converters that convert from String to
some other Object. Mainly useful for adapting a set of converters to some other environment.sourceClass
- the source class converting from