Package org.miaixz.bus.core.convert

Class RegisterConverter

java.lang.Object

org.miaixz.bus.core.convert.ConverterWithRoot

org.miaixz.bus.core.convert.RegisterConverter

All Implemented Interfaces:

Serializable, Converter

public class RegisterConverter
extends ConverterWithRoot
implements Serializable

基于类型注册的转换器，提供两种注册方式，按照优先级依次为：

1. 按照匹配注册，使用register(MatcherConverter)。 注册后一旦给定的目标类型和值满足MatcherConverter.match(Type, Class, Object)，即可调用对应转换器转换。
2. 按照类型注册，使用register(Type, Converter)，目标类型一致，即可调用转换。

Since:

Java 17+

Author:

Kimi Liu

See Also:

• Serialized Form

Field Summary

Fields inherited from class org.miaixz.bus.core.convert.ConverterWithRoot

converter

Constructor Summary

Constructors

Constructor	Description
RegisterConverter(Converter rootConverter)	构造

Method Summary

Modifier and Type	Method	Description
Object	convert(Type targetType, Object value)	转换为指定类型 如果类型无法确定，将读取默认值的类型做为目标类型
Converter	getConverter(Type type, Object value, boolean isCustomFirst)	获得转换器
Converter	getCustomConverter(Type type)	获得指定类型对应的自定义转换器
Converter	getCustomConverter(Type type, Object value)	获得匹配类型的自定义转换器
Converter	getDefaultConverter(Type type)	获得默认转换器
RegisterConverter	register(Type type, Converter converter)	登记自定义转换器，登记的目标类型必须一致
RegisterConverter	register(MatcherConverter converter)	登记自定义转换器，符合MatcherConverter.match(Type, Class, Object)则使用其转换器

Methods inherited from class org.miaixz.bus.core.convert.ConverterWithRoot

getRootConverter

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.miaixz.bus.core.convert.Converter

convert, convert

Constructor Details

RegisterConverter

public RegisterConverter(Converter rootConverter)

构造

Parameters:

rootConverter - 根转换器，用于子转换器转换

Method Details

convert

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

Description copied from interface: Converter

转换为指定类型 如果类型无法确定，将读取默认值的类型做为目标类型

Specified by:

convert in interface Converter

Parameters:

targetType - 目标Type，非泛型类使用

value - 原始值，如果对象实现了此接口，则value为this

Returns:

转换后的值

Throws:

ConvertException - 转换无法正常完成或转换异常时抛出此异常

getConverter

public Converter getConverter(Type type,
 Object value,
 boolean isCustomFirst)

获得转换器

Parameters:

type - 类型

value - 转换的值

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

Returns:

转换器

getDefaultConverter

public Converter getDefaultConverter(Type type)

获得默认转换器

Parameters:

type - 类型

Returns:

转换器

getCustomConverter

public Converter getCustomConverter(Type type,
 Object value)

获得匹配类型的自定义转换器

Parameters:

type - 类型

value - 被转换的值

Returns:

转换器

getCustomConverter

public Converter getCustomConverter(Type type)

获得指定类型对应的自定义转换器

Parameters:

type - 类型

Returns:

转换器

register

public RegisterConverter register(Type type,
 Converter converter)

登记自定义转换器，登记的目标类型必须一致

Parameters:

type - 转换的目标类型

converter - 转换器

Returns:

this

register

public RegisterConverter register(MatcherConverter converter)

登记自定义转换器，符合MatcherConverter.match(Type, Class, Object)则使用其转换器

Parameters:

converter - 转换器

Returns:

this