org.dromara.hutool.core.convert

Class CompositeConverter

java.lang.Object

org.dromara.hutool.core.convert.RegisterConverter

org.dromara.hutool.core.convert.CompositeConverter

All Implemented Interfaces:

Serializable, Converter

public class CompositeConverter
extends RegisterConverter

复合转换器，融合了所有支持类型和自定义类型的转换规则
在此类中，存放着默认转换器和自定义转换器，默认转换器是Hutool中预定义的一些转换器，自定义转换器存放用户自定的转换器。
转换过程类似于转换链，过程如下：

     处理null、Opt、Optional --> 自定义匹配转换器 --> 自定义类型转换器 --> 预注册的标准转换器 --> Map、集合、Enum等特殊转换器 --> Bean转换器
 

Author:

Looly

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CompositeConverter() 构造

Method Summary

Modifier and Type	Method and Description
Object	convert(Type type, Object value) 转换值为指定类型
<T> T	convert(Type type, Object value, T defaultValue) 转换值为指定类型 自定义转换器优先
<T> T	convert(Type type, Object value, T defaultValue, boolean isCustomFirst) 转换值为指定类型
static CompositeConverter	getInstance() 获得单例的 ConverterRegistry

Methods inherited from class org.dromara.hutool.core.convert.RegisterConverter

getConverter, getCustomConverter, getCustomConverter, getDefaultConverter, register, register

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.dromara.hutool.core.convert.Converter

identity

Constructor Detail

CompositeConverter

public CompositeConverter()

构造

Method Detail

getInstance

public static CompositeConverter getInstance()

获得单例的 ConverterRegistry

Returns:

ConverterRegistry

convert

public Object convert(Type type,
                      Object value)
               throws ConvertException

转换值为指定类型

Specified by:

convert in interface Converter

Overrides:

convert in class RegisterConverter

Parameters:

type - 类型

value - 值

Returns:

转换后的值，默认为null

Throws:

ConvertException - 转换器不存在

convert

public <T> T convert(Type type,
                     Object value,
                     T defaultValue)
              throws ConvertException

转换值为指定类型
自定义转换器优先

Type Parameters:

T - 转换的目标类型（转换器转换到的类型）

Parameters:

type - 类型

value - 值

defaultValue - 默认值

Returns:

转换后的值

Throws:

ConvertException - 转换器不存在

convert

public <T> T convert(Type type,
                     Object value,
                     T defaultValue,
                     boolean isCustomFirst)
              throws ConvertException

转换值为指定类型

Type Parameters:

T - 转换的目标类型（转换器转换到的类型）

Parameters:

type - 类型目标

value - 被转换值

defaultValue - 默认值

isCustomFirst - 是否自定义转换器优先

Returns:

转换后的值

Throws:

ConvertException - 转换器不存在