Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/* Copyright (c) The m-m-m Team, Licensed under the Apache License, Version 2.0
* http://www.apache.org/licenses/LICENSE-2.0 */
package net.sf.mmm.util.value.api;
import net.sf.mmm.util.exception.api.ValueException;
/**
* This is the interface for a converter that {@link #convert(Object, Object, Class) converts} a value of the
* type <SOURCE> to the type {@literal }.
* ATTENTION:
* An implementation of this interface should be stateless and thread-safe.
*
* @param is the generic type of the object to be converted.
* @param is the generic type of the result of the conversion.
*
* @author Joerg Hohwiller (hohwille at users.sourceforge.net)
* @since 1.0.0
*/
public interface SimpleValueConverter {
/**
* This method converts the given {@code pojo} to the <TARGET>-type.
*
* @param is the generic type of {@code targetClass}.
* @param value is the value to convert.
* @param valueSource describes the source of the value. This may be the filename where the value was read
* from, an XPath where the value was located in an XML document, etc. It is used in exceptions
* thrown if something goes wrong. This will help to find the problem easier.
* @param targetClass is the type to convert the {@code value} to.
* @return the converted {@code value} or {@code null} if the conversion is NOT possible. The returned value
* has to be an {@link Class#isInstance(Object) instance} of the given {@code targetType}.
* @throws ValueException if the conversion failed (e.g. the given {@code value} is illegal for the given
* {@code targetClass}).
*/
T convert(SOURCE value, Object valueSource, Class targetClass) throws ValueException;
}
