TypeKit (bus-core 6.3.5 API)

java.lang.Object
- org.aoju.bus.core.toolkit.TypeKit

public class TypeKit
extends Object

针对 Type 的工具类封装最主要功能包括：

 1. 获取方法的参数和返回值类型(包括Type和Class)
 2. 获取泛型参数类型(包括对象的泛型参数或集合元素的泛型类型)

Since:: JDK 1.8+
Version:: 6.3.5
Author:: Kimi Liu

Constructor Summary

Constructors
Constructor and Description

TypeKit()

Constructors
Constructor and Description
`TypeKit()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Type`	`getActualType(Type actualType, Class<?> typeDefineClass, Type typeVariable)` 获取指定泛型变量对应的真实类型由于子类中泛型参数实现和父类(接口)中泛型定义位置是一一对应的,因此可以通过对应关系找到泛型实现类型使用此方法注意：
`static Type`	`getActualType(Type type, Field field)` 获得泛型字段对应的泛型实际类型，如果此变量没有对应的实际类型，返回null
`static Type`	`getActualType(Type type, ParameterizedType parameterizedType)` 获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null 此方法可以处理复杂的泛型化对象，类似于Map<User, Key<Long>>
`static Type`	`getActualType(Type type, Type typeVariable)` 获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null 此方法可以处理：
`static Type[]`	`getActualTypes(Type actualType, Class<?> typeDefineClass, Type... typeVariables)` 获取指定泛型变量对应的真实类型由于子类中泛型参数实现和父类(接口)中泛型定义位置是一一对应的,因此可以通过对应关系找到泛型实现类型使用此方法注意：
`static Type[]`	`getActualTypes(Type type, Type... typeVariables)` 获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null
`static Class<?>`	`getClass(Field field)` 获得Field对应的原始类
`static Class<?>`	`getClass(Type type)` 获得Type对应的原始类
`static Type`	`getClosestParentType(Class<?> cls, Class<?> superClass)` 获取与`superClass` 指定的超类最接近的父类
`static Type`	`getFieldType(Class<?> clazz, String fieldName)` 获得字段的泛型类型
`static Class<?>`	`getFirstParamClass(Method method)` 获取方法的第一个参数类
`static Type`	`getFirstParamType(Method method)` 获取方法的第一个参数类型优先获取方法的GenericParameterTypes,如果获取不到,则获取ParameterTypes
`static Type[]`	`getImplicitBounds(TypeVariable<?> typeVariable)` 如果`TypeVariable.getBounds()`返回一个空数组, 则返回一个包含`Object` 唯一类型的数组.
`static Type[]`	`getImplicitLowerBounds(WildcardType wildcardType)` 如果`WildcardType.getLowerBounds()`返回一个空数组，则返回一个包含单个值`null`的数组否则，它将返回`WildcardType.getLowerBounds()`的结果.
`static Type[]`	`getImplicitUpperBounds(WildcardType wildcardType)` 如果`WildcardType.getUpperBounds()`返回一个空数组，则返回一个包含`Object`唯一值的数组否则，它将返回传递给`normalizeUpperBounds(java.lang.reflect.Type[])`的 `WildcardType.getUpperBounds()`的结果
`static Class<?>`	`getParamClass(Method method, int index)` 获取方法的参数类
`static Class<?>[]`	`getParamClasses(Method method)` 解析方法的参数类型列表依赖jre\lib\rt.jar
`static Type`	`getParamType(Method method, int index)` 获取方法的参数类型优先获取方法的GenericParameterTypes,如果获取不到,则获取ParameterTypes
`static Type[]`	`getParamTypes(Method method)` 获取方法的参数类型列表优先获取方法的GenericParameterTypes，如果获取不到，则获取ParameterTypes
`static Class<?>`	`getRawType(Type type, Type assigningType)` 根据上下文获取Java类型的原始类型主要用于`TypeVariable`s和`GenericArrayType`
`static Class<?>`	`getReturnClass(Method method)` 解析方法的返回类型类列表
`static Type`	`getReturnType(Method method)` 获取方法的返回值类型获取方法的GenericReturnType
`static Type`	`getType(Field field)` 获取字段对应的Type类型方法优先获取GenericType，获取不到则获取Type
`static Type`	`getTypeArgument(Type type)` 获得给定类的第一个泛型参数
`static Type`	`getTypeArgument(Type type, int index)` 获得给定类的泛型参数
`static Map<TypeVariable<?>,Type>`	`getTypeArguments(Class<?> cls, Class<?> toClass, Map<TypeVariable<?>,Type> subtypeVarAssigns)` 在`toClass`的上下文中返回类的类型参数的映射
`static Map<TypeVariable<?>,Type>`	`getTypeArguments(ParameterizedType type)` 检索此参数化类型的所有类型参数，包括所有者层次结构参数
`static Map<TypeVariable<?>,Type>`	`getTypeArguments(ParameterizedType parameterizedType, Class<?> toClass, Map<TypeVariable<?>,Type> subtypeVarAssigns)` 在`toClass`的上下文中返回参数化类型的类型参数的映射
`static Type[]`	`getTypeArguments(Type type)` 获得指定类型中所有泛型参数类型，例如：
`static Map<TypeVariable<?>,Type>`	`getTypeArguments(Type type, Class<?> toClass)` 获取基于子类型的类/接口的类型参数
`static Map<TypeVariable<?>,Type>`	`getTypeArguments(Type type, Class<?> toClass, Map<TypeVariable<?>,Type> subtypeVarAssigns)` 在`toClass`的上下文中返回`type`的类型参数的映射
`static Map<Type,Type>`	`getTypeMap(Class<?> clazz)` 获取泛型变量和泛型实际类型的对应关系Map
`static boolean`	`hasTypeVariable(Type... types)` 指定泛型数组中是否含有泛型变量
`static boolean`	`isAbstract(Class<?> clazz)` 是否为抽象类
`static boolean`	`isAbstractOrInterface(Class<?> clazz)` 是抽象类或者接口
`static boolean`	`isArray(Class<?> clazz)` 是否为数组 class 类型
`static boolean`	`isArrayType(Type type)` 了解指定的类型是否表示数组类型
`static boolean`	`isAssignable(Type type, Type toType)` 检查subject类型是否可以按照Java泛型规则隐式转换为目标类型.
`static boolean`	`isBase(Class<?> clazz)` 是否为基本类型 1.
`static boolean`	`isCollection(Class<?> clazz)` 是否为 Collection class 类型
`static boolean`	`isIterable(Class<?> clazz)` 是否为 Iterable class 类型
`static boolean`	`isJavaBean(Class<?> clazz)` 是否为标准的类这个类必须：
`static boolean`	`isJdk(Class<?> clazz)` 判断一个类是JDK 自带的类型 jdk 自带的类,classLoader 是为空的
`static boolean`	`isMap(Class<?> clazz)` 是否为 map class 类型
`static boolean`	`isUnknown(Type type)` 是否未知类型 type为null或者`TypeVariable` 都视为未知类型
`static Type[]`	`normalizeUpperBounds(Type[] bounds)` 该方法在类型变量类型和通配符类型中去除冗余的上界类型
`static ParameterizedType`	`toParameterizedType(Type type)` 将`Type` 转换为`ParameterizedType` `ParameterizedType`用于获取当前类或父类中泛型参数化后的类型一般用于获取泛型参数具体的参数类型,例如：

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - TypeKit
```
public TypeKit()
```
- Method Detail
  - isMap
```
public static boolean isMap(Class<?> clazz)
```
    是否为 map class 类型
    
    Parameters:
    
    clazz - 对象类型
    
    Returns:
    
    是否为 map class
  - isArray
```
public static boolean isArray(Class<?> clazz)
```
    是否为数组 class 类型
    
    Parameters:
    
    clazz - 对象类型
    
    Returns:
    
    是否为数组 class
  - isCollection
```
public static boolean isCollection(Class<?> clazz)
```
    是否为 Collection class 类型
    
    Parameters:
    
    clazz - 对象类型
    
    Returns:
    
    是否为 Collection class
  - isIterable
```
public static boolean isIterable(Class<?> clazz)
```
    是否为 Iterable class 类型
    
    Parameters:
    
    clazz - 对象类型
    
    Returns:
    
    是否为数组 class
  - isBase
```
public static boolean isBase(Class<?> clazz)
```
    是否为基本类型 1. 8大基本类型 2. 常见的值类型
    
    Parameters:
    
    clazz - 对象类型
    
    Returns:
    
    是否为基本类型
  - isAbstract
```
public static boolean isAbstract(Class<?> clazz)
```
    是否为抽象类
    
    Parameters:
    
    clazz - 类
    
    Returns:
    
    是否为抽象类
  - isAbstractOrInterface
```
public static boolean isAbstractOrInterface(Class<?> clazz)
```
    是抽象类或者接口
    
    Parameters:
    
    clazz - 类信息
    
    Returns:
    
    是否
  - isJavaBean
```
public static boolean isJavaBean(Class<?> clazz)
```
    是否为标准的类这个类必须：
```
 0、不为 null
 1、非接口
 2、非抽象类
 3、非Enum枚举
 4、非数组
 5、非注解
 6、非原始类型(int, long等)
 7、非集合 Iterable
 8、非 Map.clas
 9、非 JVM 生成类
 
```
    Parameters:
    
    clazz - 类
    
    Returns:
    
    是否为标准类
  - isJdk
```
public static boolean isJdk(Class<?> clazz)
```
    判断一个类是JDK 自带的类型 jdk 自带的类,classLoader 是为空的
    
    Parameters:
    
    clazz - 类
    
    Returns:
    
    是否为 java 类
  - isAssignable
```
public static boolean isAssignable(Type type,
                                   Type toType)
```
    检查subject类型是否可以按照Java泛型规则隐式转换为目标类型. 如果这两种类型都是Class对象，则该方法返回ClassKit.isAssignable(Class, Class)的结果
    
    Parameters:
    
    type - 要分配给目标类型的主题类型
    
    toType - 目标类型
    
    Returns:
    
    如果type可赋值给toType，则true.
  - isArrayType
```
public static boolean isArrayType(Type type)
```
    了解指定的类型是否表示数组类型
    
    Parameters:
    
    type - 要检查的类型
    
    Returns:
    
    如果type是数组类或GenericArrayType，则为true
  - isUnknown
```
public static boolean isUnknown(Type type)
```
    是否未知类型 type为null或者TypeVariable 都视为未知类型
    
    Parameters:
    
    type - Type类型
    
    Returns:
    
    是否未知类型
  - getClass
```
public static Class<?> getClass(Type type)
```
    获得Type对应的原始类
    
    Parameters:
    
    type - Type
    
    Returns:
    
    原始类, 如果无法获取原始类, 返回null
  - getClass
```
public static Class<?> getClass(Field field)
```
    获得Field对应的原始类
    
    Parameters:
    
    field - Field
    
    Returns:
    
    原始类，如果无法获取原始类，返回null
  - getType
```
public static Type getType(Field field)
```
    获取字段对应的Type类型方法优先获取GenericType，获取不到则获取Type
    
    Parameters:
    
    field - 字段
    
    Returns:
    
    Type，可能为null
  - getFieldType
```
public static Type getFieldType(Class<?> clazz,
                                String fieldName)
```
    获得字段的泛型类型
    
    Parameters:
    
    clazz - Bean类
    
    fieldName - 字段名
    
    Returns:
    
    字段的泛型类型
  - getFirstParamType
```
public static Type getFirstParamType(Method method)
```
    获取方法的第一个参数类型优先获取方法的GenericParameterTypes,如果获取不到,则获取ParameterTypes
    
    Parameters:
    
    method - 方法
    
    Returns:
    
    Type,可能为null
  - getFirstParamClass
```
public static Class<?> getFirstParamClass(Method method)
```
    获取方法的第一个参数类
    
    Parameters:
    
    method - 方法
    
    Returns:
    
    第一个参数类型, 可能为null
  - getParamType
```
public static Type getParamType(Method method,
                                int index)
```
    获取方法的参数类型优先获取方法的GenericParameterTypes,如果获取不到,则获取ParameterTypes
    
    Parameters:
    
    method - 方法
    
    index - 第几个参数的索引,从0开始计数
    
    Returns:
    
    Type,可能为null
  - getParamClass
```
public static Class<?> getParamClass(Method method,
                                     int index)
```
    获取方法的参数类
    
    Parameters:
    
    method - 方法
    
    index - 第几个参数的索引,从0开始计数
    
    Returns:
    
    参数类, 可能为null
  - getParamTypes
```
public static Type[] getParamTypes(Method method)
```
    获取方法的参数类型列表优先获取方法的GenericParameterTypes，如果获取不到，则获取ParameterTypes
    
    Parameters:
    
    method - 方法
    
    Returns:
    
    Type列表，可能为null
    
    See Also:
    
    Method.getGenericParameterTypes(), Method.getParameterTypes()
  - getParamClasses
```
public static Class<?>[] getParamClasses(Method method)
```
    解析方法的参数类型列表依赖jre\lib\rt.jar
    
    Parameters:
    
    method - t方法
    
    Returns:
    
    参数类型类列表
    
    See Also:
    
    Method.getGenericParameterTypes(), Method.getParameterTypes()
  - getReturnType
```
public static Type getReturnType(Method method)
```
    获取方法的返回值类型获取方法的GenericReturnType
    
    Parameters:
    
    method - 方法
    
    Returns:
    
    Type，可能为null
    
    See Also:
    
    Method.getGenericReturnType(), Method.getReturnType()
  - getReturnClass
```
public static Class<?> getReturnClass(Method method)
```
    解析方法的返回类型类列表
    
    Parameters:
    
    method - 方法
    
    Returns:
    
    返回值类型的类
    
    See Also:
    
    Method.getGenericReturnType(), Method.getReturnType()
  - getTypeArgument
```
public static Type getTypeArgument(Type type)
```
    获得给定类的第一个泛型参数
    
    Parameters:
    
    type - 被检查的类型,必须是已经确定泛型类型的类型
    
    Returns:
    
    Type,可能为null
  - getTypeArgument
```
public static Type getTypeArgument(Type type,
                                   int index)
```
    获得给定类的泛型参数
    
    Parameters:
    
    type - 被检查的类型,必须是已经确定泛型类型的类
    
    index - 泛型类型的索引号,既第几个泛型类型
    
    Returns:
    
    Type
  - getTypeArguments
```
public static Type[] getTypeArguments(Type type)
```
    获得指定类型中所有泛型参数类型，例如：
```
 class A<T>
 class B extends A<String>
 
```
    通过此方法，传入B.class即可得到String
    Parameters:
    
    type - 指定类型
    
    Returns:
    
    所有泛型参数类型
  - getTypeArguments
```
public static Map<TypeVariable<?>,Type> getTypeArguments(ParameterizedType type)
```
    检索此参数化类型的所有类型参数，包括所有者层次结构参数
    
    Parameters:
    
    type - 指定要从中获取参数的主题参数化类型
    
    Returns:
    
    带有类型参数的Map.
  - getTypeArguments
```
public static Map<TypeVariable<?>,Type> getTypeArguments(Type type,
                                                         Class<?> toClass)
```
    获取基于子类型的类/接口的类型参数
    
    Parameters:
    
    type - 用于确定toClass的类型参数的类型
    
    toClass - 类型参数将根据子类型type确定的类
    
    Returns:
    
    带有类型参数的Map
  - getTypeArguments
```
public static Map<TypeVariable<?>,Type> getTypeArguments(Type type,
                                                         Class<?> toClass,
                                                         Map<TypeVariable<?>,Type> subtypeVarAssigns)
```
    在toClass的上下文中返回type的类型参数的映射
    
    Parameters:
    
    type - 问题类型
    
    toClass - 类
    
    subtypeVarAssigns - 带有类型变量的映射
    
    Returns:
    
    带有类型参数的Map
  - getTypeArguments
```
public static Map<TypeVariable<?>,Type> getTypeArguments(Class<?> cls,
                                                         Class<?> toClass,
                                                         Map<TypeVariable<?>,Type> subtypeVarAssigns)
```
    在toClass的上下文中返回类的类型参数的映射
    
    Parameters:
    
    cls - 要确定类型参数的类
    
    toClass - 上下文类
    
    subtypeVarAssigns - 带有类型变量的映射
    
    Returns:
    
    带有类型参数的Map
  - getTypeArguments
```
public static Map<TypeVariable<?>,Type> getTypeArguments(ParameterizedType parameterizedType,
                                                         Class<?> toClass,
                                                         Map<TypeVariable<?>,Type> subtypeVarAssigns)
```
    在toClass的上下文中返回参数化类型的类型参数的映射
    
    Parameters:
    
    parameterizedType - 参数化类型
    
    toClass - 类
    
    subtypeVarAssigns - 带有类型变量的映射
    
    Returns:
    
    带有类型参数的Map
  - getClosestParentType
```
public static Type getClosestParentType(Class<?> cls,
                                        Class<?> superClass)
```
    获取与superClass 指定的超类最接近的父类
    
    Parameters:
    
    cls - 类
    
    superClass - 超类
    
    Returns:
    
    父类型
  - getActualTypes
```
public static Type[] getActualTypes(Type actualType,
                                    Class<?> typeDefineClass,
                                    Type... typeVariables)
```
    获取指定泛型变量对应的真实类型由于子类中泛型参数实现和父类(接口)中泛型定义位置是一一对应的,因此可以通过对应关系找到泛型实现类型使用此方法注意：
```
 1. superClass必须是clazz的父类或者clazz实现的接口
 2. typeVariable必须在superClass中声明
 
```
    Parameters:
    
    actualType - 真实类型所在类,此类中记录了泛型参数对应的实际类型
    
    typeDefineClass - 泛型变量声明所在类或接口,此类中定义了泛型类型
    
    typeVariables - 泛型变量,需要的实际类型对应的泛型参数
    
    Returns:
    
    给定泛型参数对应的实际类型, 如果无对应类型, 返回null
  - getActualType
```
public static Type getActualType(Type actualType,
                                 Class<?> typeDefineClass,
                                 Type typeVariable)
```
    获取指定泛型变量对应的真实类型由于子类中泛型参数实现和父类(接口)中泛型定义位置是一一对应的,因此可以通过对应关系找到泛型实现类型使用此方法注意：
```
 1. superClass必须是clazz的父类或者clazz实现的接口
 2. typeVariable必须在superClass中声明
 
```
    Parameters:
    
    actualType - 真实类型所在类,此类中记录了泛型参数对应的实际类型
    
    typeDefineClass - 泛型变量声明所在类或接口,此类中定义了泛型类型
    
    typeVariable - 泛型变量,需要的实际类型对应的泛型参数
    
    Returns:
    
    给定泛型参数对应的实际类型
  - toParameterizedType
```
public static ParameterizedType toParameterizedType(Type type)
```
    将Type 转换为ParameterizedType ParameterizedType用于获取当前类或父类中泛型参数化后的类型一般用于获取泛型参数具体的参数类型,例如：
```
 class A<T>
 class B extends A<String>
 
```
    通过此方法,传入B.class即可得到BParameterizedType,从而获取到String
    Parameters:
    
    type - Type
    
    Returns:
    
    ParameterizedType
  - getTypeMap
```
public static Map<Type,Type> getTypeMap(Class<?> clazz)
```
    获取泛型变量和泛型实际类型的对应关系Map
```
     T    org.aoju.core.Version
     E    java.lang.Integer
 
```
    Parameters:
    
    clazz - 被解析的包含泛型参数的类
    
    Returns:
    
    泛型对应关系Map
  - getActualType
```
public static Type getActualType(Type type,
                                 Field field)
```
    获得泛型字段对应的泛型实际类型，如果此变量没有对应的实际类型，返回null
    
    Parameters:
    
    type - 实际类型明确的类
    
    field - 字段
    
    Returns:
    
    实际类型，可能为Class等
  - getActualType
```
public static Type getActualType(Type type,
                                 Type typeVariable)
```
    获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null 此方法可以处理：
```
     1. 泛型化对象，类似于Map<User, Key<Long>>
     2. 泛型变量，类似于T
 
```
    Parameters:
    
    type - 类
    
    typeVariable - 泛型变量，例如T等
    
    Returns:
    
    实际类型，可能为Class等
  - getActualType
```
public static Type getActualType(Type type,
                                 ParameterizedType parameterizedType)
```
    获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null 此方法可以处理复杂的泛型化对象，类似于Map<User, Key<Long>>
    
    Parameters:
    
    type - 类
    
    parameterizedType - 泛型变量，例如List<T>等
    
    Returns:
    
    实际类型，可能为Class等
  - getActualTypes
```
public static Type[] getActualTypes(Type type,
                                    Type... typeVariables)
```
    获得泛型变量对应的泛型实际类型，如果此变量没有对应的实际类型，返回null
    
    Parameters:
    
    type - 类
    
    typeVariables - 泛型变量数组，例如T等
    
    Returns:
    
    实际类型数组，可能为Class等
  - getRawType
```
public static Class<?> getRawType(Type type,
                                  Type assigningType)
```
    根据上下文获取Java类型的原始类型主要用于TypeVariables和GenericArrayType
    
    Parameters:
    
    type - 类型
    
    assigningType - 要解析的类型
    
    Returns:
    
    如果不能解析类型，则解析Class对象或null
  - getImplicitBounds
```
public static Type[] getImplicitBounds(TypeVariable<?> typeVariable)
```
    如果TypeVariable.getBounds()返回一个空数组, 则返回一个包含Object 唯一类型的数组. 否则返回TypeVariable.getBounds() 传递给normalizeUpperBounds(java.lang.reflect.Type[])的结果
    
    Parameters:
    
    typeVariable - 类型变量
    
    Returns:
    
    包含类型变量边界的非空数组.
  - getImplicitUpperBounds
```
public static Type[] getImplicitUpperBounds(WildcardType wildcardType)
```
    如果WildcardType.getUpperBounds()返回一个空数组，则返回一个包含Object唯一值的数组否则，它将返回传递给normalizeUpperBounds(java.lang.reflect.Type[])的 WildcardType.getUpperBounds()的结果
    
    Parameters:
    
    wildcardType - 通配符类型
    
    Returns:
    
    包含通配符类型下界的非空数组.
  - getImplicitLowerBounds
```
public static Type[] getImplicitLowerBounds(WildcardType wildcardType)
```
    如果WildcardType.getLowerBounds()返回一个空数组，则返回一个包含单个值null的数组否则，它将返回WildcardType.getLowerBounds()的结果.
    
    Parameters:
    
    wildcardType - 通配符类型
    
    Returns:
    
    包含通配符类型下界的非空数组.
  - normalizeUpperBounds
```
public static Type[] normalizeUpperBounds(Type[] bounds)
```
    该方法在类型变量类型和通配符类型中去除冗余的上界类型
    
    Parameters:
    
    bounds - 表示WildcardType或 TypeVariable的上界的类型数组.
    
    Returns:
    
    包含来自bounds的值减去冗余类型的数组.
  - hasTypeVariable
```
public static boolean hasTypeVariable(Type... types)
```
    指定泛型数组中是否含有泛型变量
    
    Parameters:
    
    types - 泛型数组
    
    Returns:
    
    是否含有泛型变量

Class TypeKit

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

TypeKit

Method Detail

isMap

isArray

isCollection

isIterable

isBase

isAbstract

isAbstractOrInterface

isJavaBean

isJdk

isAssignable

isArrayType

isUnknown

getClass

getClass

getType

getFieldType

getFirstParamType

getFirstParamClass

getParamType

getParamClass

getParamTypes

getParamClasses

getReturnType

getReturnClass

getTypeArgument

getTypeArgument

getTypeArguments

getTypeArguments

getTypeArguments

getTypeArguments

getTypeArguments

getTypeArguments

getClosestParentType

getActualTypes

getActualType

toParameterizedType

getTypeMap

getActualType

getActualType

getActualType

getActualTypes

getRawType

getImplicitBounds

getImplicitUpperBounds

getImplicitLowerBounds

normalizeUpperBounds

hasTypeVariable