cn.hutool.core.convert.Converter Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of hutool-all Show documentation

Hutool是一个小而全的Java工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。

There is a newer version: 5.8.34

package cn.hutool.core.convert;

/**
 * 转换器接口，实现类型转换
 *
 * @param  转换到的目标类型
 * @author Looly
 */
public interface Converter {

	/**
	 * 转换为指定类型

	 * 如果类型无法确定，将读取默认值的类型做为目标类型
	 *
	 * @param value 原始值
	 * @param defaultValue 默认值
	 * @return 转换后的值
	 * @throws IllegalArgumentException 无法确定目标类型，且默认值为{@code null}，无法确定类型
	 */
	T convert(Object value, T defaultValue) throws IllegalArgumentException;

	/**
	 * 转换值为指定类型，可选是否不抛异常转换

	 * 当转换失败时返回默认值
	 *
	 * @param value 值
	 * @param defaultValue 默认值
	 * @param quietly 是否静默转换，true不抛异常
	 * @return 转换后的值
	 * @since 5.8.0
	 * @see #convert(Object, Object)
	 */
	default T convertWithCheck(Object value, T defaultValue, boolean quietly) {
		try {
			return convert(value, defaultValue);
		} catch (Exception e) {
			if(quietly){
				return defaultValue;
			}
			throw e;
		}
	}
}