org.springframework.binding.convert.ConversionService Maven / Gradle / Ivy
/*
* Copyright 2004-2012 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.binding.convert;
/**
* A service interface for retrieving type conversion executors. The returned command objects are thread-safe and may be
* safely cached for use by client code.
*
* Type converters convert from one type to another.
*
* @author Keith Donald
*/
public interface ConversionService {
/**
* Execute a conversion of the source object provided to the specified targetClass
* @param source the source to convert from (may be null)
* @param targetClass the target class to convert to
* @return the converted object, an instance of the targetClass
* @throws ConversionException if an exception occurred during the conversion process
*/
Object executeConversion(Object source, Class targetClass) throws ConversionException;
/**
* Execute a conversion using the custom converter with the provided id.
* @param converterId the id of the custom converter, which must be registered with this conversion service and
* capable of converting to the target class
* @param source the source to convert from (may be null)
* @param targetClass the target class to convert to
* @return the converted object, an instance of the targetClass
* @throws ConversionException if an exception occurred during the conversion process
*/
Object executeConversion(String converterId, Object source, Class targetClass);
/**
* Return the default conversion executor capable of converting source objects of the specified
* sourceClass to instances of the targetClass.
*
* The returned ConversionExecutor is thread-safe and may safely be cached for use in client code.
* @param sourceClass the source class to convert from (required)
* @param targetClass the target class to convert to (required)
* @return the executor that can execute instance type conversion, never null
* @throws ConversionExecutorNotFoundException when no suitable conversion executor could be found
*/
ConversionExecutor getConversionExecutor(Class sourceClass, Class targetClass)
throws ConversionExecutorNotFoundException;
/**
* Return the custom conversion executor capable of converting source objects of the specified
* sourceClass to instances of the targetClass.
*
* The returned ConversionExecutor is thread-safe and may safely be cached for use in client code.
* @param id the id of the custom conversion executor (required)
* @param sourceClass the source class to convert from (required)
* @param targetClass the target class to convert to (required)
* @return the executor that can execute instance type conversion, never null
* @throws ConversionExecutorNotFoundException when no suitable conversion executor could be found
*/
ConversionExecutor getConversionExecutor(String id, Class sourceClass, Class targetClass)
throws ConversionExecutorNotFoundException;
/**
* Lookup a class by its well-known alias. For example, long for java.lang.Long
* @param alias the class alias
* @return the class, or null if no alias exists
*/
Class getClassForAlias(String alias);
/**
* Return the underlying Spring ConversionService.
*
* @return the conversion service
*/
org.springframework.core.convert.ConversionService getDelegateConversionService();
}