ConverterRegistry (jarvis-tool-core 1.0.3.RELEASE API)

java.lang.Object
- com.github.jarvisframework.tool.core.convert.ConverterRegistry

所有已实现的接口:

Serializable
```
public class ConverterRegistry
extends Object
implements Serializable
```
转换器登记中心

将各种类型Convert对象放入登记中心，通过convert方法查找目标类型对应的转换器，将被转换对象转换之。

在此类中，存放着默认转换器和自定义转换器，默认转换器是jarvis-tool中预定义的一些转换器，自定义转换器存放用户自定的转换器。

从以下版本开始:

1.0, 2020-07-13 14:40:23

作者:

Doug Wang

另请参阅:

序列化表格

嵌套类概要

嵌套类
限定符和类型	类和说明
`private static class`	`ConverterRegistry.SingletonHolder` 类级的内部类，也就是静态的成员式内部类，该内部类的实例与外部类的实例没有绑定关系，而且只有被调用到才会装载，从而实现了延迟加载

字段概要

字段
限定符和类型	字段和说明
`private Map<Type,Converter<?>>`	`customConverterMap` 用户自定义类型转换器
`private Map<Type,Converter<?>>`	`defaultConverterMap` 默认类型转换器
`private static long`	`serialVersionUID`

构造器概要

构造器
构造器和说明

ConverterRegistry()

构造器
构造器和说明
`ConverterRegistry()`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`<T> T`	`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)` 转换值为指定类型
`private <T> T`	`convertSpecial(Type type, Class<T> rowType, Object value, T defaultValue)` 特殊类型转换包括： Collection Map 强转（无需转换）数组
`private ConverterRegistry`	`defaultConverter()` 注册默认转换器
`<T> Converter<T>`	`getConverter(Type type, boolean isCustomFirst)` 获得转换器
`<T> Converter<T>`	`getCustomConverter(Type type)` 获得自定义转换器
`<T> Converter<T>`	`getDefaultConverter(Type type)` 获得默认转换器
`static ConverterRegistry`	`getInstance()` 获得单例的 `ConverterRegistry`
`ConverterRegistry`	`putCustom(Type type, Class<? extends Converter<?>> converterClass)` 登记自定义转换器
`ConverterRegistry`	`putCustom(Type type, Converter<?> converter)` 登记自定义转换器

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - serialVersionUID
```
private static final long serialVersionUID
```
    另请参阅:
    
    常量字段值
  - defaultConverterMap
```
private Map<Type,Converter<?>> defaultConverterMap
```
    默认类型转换器
  - customConverterMap
```
private volatile Map<Type,Converter<?>> customConverterMap
```
    用户自定义类型转换器
- 构造器详细资料
  - ConverterRegistry
```
public ConverterRegistry()
```
- 方法详细资料
  - getInstance
```
public static ConverterRegistry getInstance()
```
    获得单例的 ConverterRegistry
    
    返回:
    
    ConverterRegistry
  - putCustom
```
public ConverterRegistry putCustom(Type type,
                                   Class<? extends Converter<?>> converterClass)
```
    登记自定义转换器
    
    参数:
    
    type - 转换的目标类型
    
    converterClass - 转换器类，必须有默认构造方法
    
    返回:
    
    ConverterRegistry
  - putCustom
```
public ConverterRegistry putCustom(Type type,
                                   Converter<?> converter)
```
    登记自定义转换器
    
    参数:
    
    type - 转换的目标类型
    
    converter - 转换器
    
    返回:
    
    ConverterRegistry
  - getConverter
```
public <T> Converter<T> getConverter(Type type,
                                     boolean isCustomFirst)
```
    获得转换器
    
    类型参数:
    
    T - 转换的目标类型
    
    参数:
    
    type - 类型
    
    isCustomFirst - 是否自定义转换器优先
    
    返回:
    
    转换器
  - getDefaultConverter
```
public <T> Converter<T> getDefaultConverter(Type type)
```
    获得默认转换器
    
    类型参数:
    
    T - 转换的目标类型（转换器转换到的类型）
    
    参数:
    
    type - 类型
    
    返回:
    
    转换器
  - getCustomConverter
```
public <T> Converter<T> getCustomConverter(Type type)
```
    获得自定义转换器
    
    类型参数:
    
    T - 转换的目标类型（转换器转换到的类型）
    
    参数:
    
    type - 类型
    
    返回:
    
    转换器
  - convert
```
public <T> T convert(Type type,
                     Object value,
                     T defaultValue,
                     boolean isCustomFirst)
              throws ConvertException
```
    转换值为指定类型
    
    类型参数:
    
    T - 转换的目标类型（转换器转换到的类型）
    
    参数:
    
    type - 类型目标
    
    value - 被转换值
    
    defaultValue - 默认值
    
    isCustomFirst - 是否自定义转换器优先
    
    返回:
    
    转换后的值
    
    抛出:
    
    ConvertException - 转换器不存在
  - convert
```
public <T> T convert(Type type,
                     Object value,
                     T defaultValue)
              throws ConvertException
```
    转换值为指定类型
    自定义转换器优先
    
    类型参数:
    
    T - 转换的目标类型（转换器转换到的类型）
    
    参数:
    
    type - 类型
    
    value - 值
    
    defaultValue - 默认值
    
    返回:
    
    转换后的值
    
    抛出:
    
    ConvertException - 转换器不存在
  - convert
```
public <T> T convert(Type type,
                     Object value)
              throws ConvertException
```
    转换值为指定类型
    
    类型参数:
    
    T - 转换的目标类型（转换器转换到的类型）
    
    参数:
    
    type - 类型
    
    value - 值
    
    返回:
    
    转换后的值，默认为null
    
    抛出:
    
    ConvertException - 转换器不存在
  - convertSpecial
```
private <T> T convertSpecial(Type type,
                             Class<T> rowType,
                             Object value,
                             T defaultValue)
```
    特殊类型转换
    包括：
```
 Collection
 Map
 强转（无需转换）
 数组
 
```
    类型参数:
    
    T - 转换的目标类型（转换器转换到的类型）
    
    参数:
    
    type - 类型
    
    value - 值
    
    defaultValue - 默认值
    
    返回:
    
    转换后的值
  - defaultConverter
```
private ConverterRegistry defaultConverter()
```
    注册默认转换器
    
    返回:
    
    转换器

类 ConverterRegistry

嵌套类概要

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

serialVersionUID

defaultConverterMap

customConverterMap

构造器详细资料

ConverterRegistry

方法详细资料

getInstance

putCustom

putCustom

getConverter

getDefaultConverter

getCustomConverter

convert

convert

convert

convertSpecial

defaultConverter