cn.hutool.core.convert.Converter Maven / Gradle / Ivy
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;
}
}
}