com.forte.qqrobot.utils

Class FieldUtils

java.lang.Object

com.forte.qqrobot.utils.FieldUtils

public class FieldUtils
extends Object

字段操作工具，提供丰富的方法，以反射的方式从对象中获取值或赋值。
说是字段操作工具，但是不止操作字段 其中:
- objectGetter方法可以允许使用多级字段，例如"user.child.name"
- getExcelNum方法可以获取Excel中列的数字坐标，例如:"AA" => 27

实现了缓存优化，使得效率大幅上升 由于希望将其作为一个简单的工具类使用，因此全部使用内部类实现

2018-12-15 多层级缓存优化-getter测试结果：

2018-12-15至2018-12-16 多层级缓存优化-getter测试结果：

Author:

ForteScarlet

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FieldUtils.FieldUtilsException 类异常
static class	FieldUtils.InvokeResult 内部类 方法执行的返回值封装类,此类除了重写方法以外的唯一公共接口

Method Summary

Modifier and Type	Method and Description
static void	allNonNull(Object... all) 只要传入的参数中任意一个出现了null则会抛出空指针异常
static Class	basicToBox(Class type) 将基础数据类型封装为其对应的封装类
static Class	fieldClassGetter(Class c, String fieldName) 获取字段的class类型，支持多层级获取
static Field	fieldGetter(Class c, String fieldName) 获取类指定的字段对象，支持多层级获取
static Method	fieldGetterGetter(Class objClass, String fieldName) 获取字段的getter方法，支持多层级获取
static <T> Class	getArrayGeneric(Class<T> tClass) 获取数组的组件类型
static <T> Class	getArrayGeneric(T[] trr) 获取数组的组件类型
static String	getClassName(Class<?> c) Deprecated. 有方法直接获取的: Class.getSimpleName()
static String	getClassName(Object o) 通过对象获取类名
static long	getExcelNum(String colStr) 获取Excel中列的数字坐标 例如:"AA" => 27
static Field	getField(Class objectClass, String fieldName) 获取类指定字段对象
static Field	getField(Object object, String fieldName) 获取对象指定字段对象
static Class	getFieldClass(Class objectClass, String fieldName) 获取指定类字段的类型class对象
static Class	getFieldClass(Object object, String fieldName) 获取类指定字段的class对象
static Method	getFieldGetter(Class<?> whereIn, Field field) 获取字段的getter方法
static Method	getFieldGetter(Class<?> whereIn, String fieldName) 获取字段的getter方法,单层级
static Method	getFieldGetter(Object obj, Field field) 获取字段的getter方法
static Method	getFieldGetter(Object obj, String fieldName) 获取字段的getter方法
static Field[]	getFields(Class type, boolean withSuper) 获取类中全部的字段
static <A,R> R	getFields(Class type, boolean withSuper, Collector<? super Field,A,R> collector) 自定义流转化
static <A,R> R	getFields(Class type, boolean withSuper, Supplier<R> supplier, BiConsumer<R,? super Field> accumulator, BiConsumer<R,R> combiner) 自定义流转化
static Method	getFieldSetter(Class<?> whereIn, Field field) 获取字段的setter方法
static Method	getFieldSetter(Class<?> whereIn, String fieldName) 获取字段的setter方法
static Method	getFieldSetter(Object obj, Field field) 获取字段的setter方法
static Method	getFieldSetter(Object obj, String fieldName) 获取字段的setter方法
static Map<String,List<Field>>	getFieldsGroupByName(Class type, boolean withSuper) 获取类中的全部字段，并根据字段名分组
static List<Field>	getFieldsList(Class type, boolean withSuper) 获取类中全部的字段，转化为list
static <T> List<String>	getFieldsNameWithGetter(T t) 获取对象的所有字段名
static <T> List<String>	getFieldsNameWithoutGetter(T t) 获取对象的所有字段名(包括没有get方法的字段)
static Set<Field>	getFieldsSet(Class type, boolean withSuper) 获取类中全部的字段，转化为set
static Stream<Field>	getFieldsStream(Class type, boolean withSuper) 获取类中全部的字段
static List<Field>	getFieldsWithGetter(Class<?> tClass) 获取对象的所有字段
static <T> List<Field>	getFieldsWithGetter(T t) 获取对象的所有字段
static List<Field>	getFieldsWithoutGetter(Class<?> tClass) 获取对象的所有字段(包括没有get方法的字段)
static <T> List<Field>	getFieldsWithoutGetter(T t) 获取对象的所有字段(包括没有get方法的字段)
static Class	getListFieldGeneric(Class c, String fieldName) 获取一个list字段的泛型类型 这个字段必须是一个list类型的字段！
static Class	getListFieldGeneric(Field listField) 获取一个list字段的泛型类型 这个字段必须是一个list类型的字段！
static Class	getListFieldGeneric(Object obj, String fieldName) 获取一个list字段的泛型类型 这个字段必须是一个list类型的字段！
static String	getMethodNameWithoutGetter(Method method) 获取方法名，如果是个getter规则方法名则移除get并开头小写, 与getMethodNameWithoutSetter(Method)类似
static String	getMethodNameWithoutGetterAndSetter(Method method) 获取方法名，如果是个getter或setter规则方法名则移除get或set并开头小写
static String	getMethodNameWithoutSetter(Method method) 获取方法名，如果是个getter规则方法名则移除get并开头小写, 与getMethodNameWithoutGetter(Method)类似
static String	headLower(String str) 单词开头小写
static String	headUpper(String str) 单词开头大写
static boolean	isBasic(Class type) 判断类型是否为基础数据类型或封装类
static boolean	isChild(Class child, Class findFather) 判断一个Class对象是否为另一个对象的实现类
static boolean	isChild(Object child, Class findFather) 判断一个Class对象是否为另一个对象的实现类
static boolean	isFieldExist(Class<?> tClass, String field) 通过Class对象判断是否存在此字段
static boolean	isFieldExist(Object obj, String field) 通过对象实例判断字段是否存在
static boolean	notInterfaceAndAbstract(Class<?> clazz) 判断一个类是不是不是抽象类也不是接口
static Object	objectGetter(Object t, String fieldName) 通过对象的getter获取字段数值 支持类似“user.child”这种多层级的获取方式 获取的字段必须有其对应的公共get方法
static void	objectSetter(Object t, String fieldName, Object value) 通过对象的setter为字段赋值 支持类似“user.child”这种多层级的赋值方式 赋值的字段必须有其对应的公共set方法 如果多层级对象中有非底层级字段为null，将会尝试为其创建一个新的实例
static void	objectSetter2(Object t, String fieldName, Object param) Deprecated.

Methods inherited from class java.lang.Object

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

Method Detail

getExcelNum

public static long getExcelNum(String colStr)

获取Excel中列的数字坐标
例如:"AA" => 27

Parameters:

colStr - Excel中的列坐标

Returns:

此列坐标对应的数字

getFieldsWithoutGetter

public static List<Field> getFieldsWithoutGetter(Class<?> tClass)

获取对象的所有字段(包括没有get方法的字段)

Parameters:

tClass - 对象

Returns:

getFieldsWithoutGetter

public static <T> List<Field> getFieldsWithoutGetter(T t)

获取对象的所有字段(包括没有get方法的字段)

Type Parameters:

T -

Parameters:

t -

Returns:

getFieldsNameWithoutGetter

public static <T> List<String> getFieldsNameWithoutGetter(T t)

获取对象的所有字段名(包括没有get方法的字段)

Parameters:

t - 对象

Returns:

getFieldsWithGetter

public static List<Field> getFieldsWithGetter(Class<?> tClass)

获取对象的所有字段

Parameters:

tClass - 对象

Returns:

getFieldsWithGetter

public static <T> List<Field> getFieldsWithGetter(T t)

获取对象的所有字段

Type Parameters:

T -

Parameters:

t -

Returns:

getFieldsNameWithGetter

public static <T> List<String> getFieldsNameWithGetter(T t)

获取对象的所有字段名

Parameters:

t - 对象

Returns:

fieldGetter

public static Field fieldGetter(Class c,
                                String fieldName)

获取类指定的字段对象，支持多层级获取

Parameters:

c -

fieldName -

Returns:

fieldClassGetter

public static Class fieldClassGetter(Class c,
                                     String fieldName)

获取字段的class类型，支持多层级获取

Parameters:

c -

fieldName -

Returns:

getFieldGetter

public static Method getFieldGetter(Class<?> whereIn,
                                    String fieldName)

获取字段的getter方法,单层级

Parameters:

whereIn -

fieldName -

Returns:

getFieldGetter

public static Method getFieldGetter(Class<?> whereIn,
                                    Field field)

获取字段的getter方法

Parameters:

whereIn - 字段所在类

field - 字段

Returns:

getFieldGetter

public static Method getFieldGetter(Object obj,
                                    Field field)

获取字段的getter方法

Parameters:

obj -

field -

Returns:

getFieldGetter

public static Method getFieldGetter(Object obj,
                                    String fieldName)

获取字段的getter方法

Parameters:

obj -

fieldName -

Returns:

getFieldSetter

public static Method getFieldSetter(Class<?> whereIn,
                                    String fieldName)

获取字段的setter方法

Parameters:

whereIn -

fieldName -

Returns:

getFieldSetter

public static Method getFieldSetter(Class<?> whereIn,
                                    Field field)

获取字段的setter方法

Parameters:

whereIn -

field -

Returns:

getFieldSetter

public static Method getFieldSetter(Object obj,
                                    String fieldName)

获取字段的setter方法

Parameters:

obj -

fieldName -

Returns:

getFieldSetter

public static Method getFieldSetter(Object obj,
                                    Field field)

获取字段的setter方法

Parameters:

obj -

field -

Returns:

fieldGetterGetter

public static Method fieldGetterGetter(Class objClass,
                                       String fieldName)
                                throws NoSuchMethodException

获取字段的getter方法，支持多层级获取

Parameters:

objClass -

fieldName -

Returns:

Throws:

NoSuchMethodException

objectGetter

public static Object objectGetter(Object t,
                                  String fieldName)
                           throws IllegalAccessException,
                                  NoSuchMethodException,
                                  InvocationTargetException

通过对象的getter获取字段数值 支持类似“user.child”这种多层级的获取方式 获取的字段必须有其对应的公共get方法

Parameters:

t -

fieldName -

Returns:

Throws:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

objectSetter

public static void objectSetter(Object t,
                                String fieldName,
                                Object value)
                         throws InvocationTargetException,
                                IllegalAccessException,
                                InstantiationException,
                                NoSuchMethodException

通过对象的setter为字段赋值 支持类似“user.child”这种多层级的赋值方式 赋值的字段必须有其对应的公共set方法 如果多层级对象中有非底层级字段为null，将会尝试为其创建一个新的实例

TODO 旧

Parameters:

t - 对象

fieldName - 需要赋值的字段

value - 需要赋的值

Throws:

InvocationTargetException

IllegalAccessException

InstantiationException

NoSuchMethodException

objectSetter2

@Deprecated
public static void objectSetter2(Object t,
                                             String fieldName,
                                             Object param)
                                      throws NoSuchMethodException,
                                             InstantiationException,
                                             IllegalAccessException,
                                             InvocationTargetException

Deprecated.

通过对象的setter为字段赋值 支持类似“user.child”这种多层级的赋值方式 赋值的字段必须有其对应的公共set方法 如果多层级对象中有非底层级字段为null，将会尝试为其创建一个新的实例

Parameters:

t -

fieldName -

param -

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

getField

public static Field getField(Object object,
                             String fieldName)

获取对象指定字段对象

Parameters:

object - 对象的class对象

fieldName - 字段名称

getField

public static Field getField(Class objectClass,
                             String fieldName)

获取类指定字段对象

Parameters:

objectClass - 类的class对象

fieldName - 字段名称

getFieldClass

public static Class getFieldClass(Class objectClass,
                                  String fieldName)

获取指定类字段的类型class对象

Parameters:

objectClass - 类class对象

fieldName - 字段名称

getFieldClass

public static Class getFieldClass(Object object,
                                  String fieldName)

获取类指定字段的class对象

Parameters:

object - 类实例

fieldName - 字段名称

Returns:

getFields

public static Field[] getFields(Class type,
                                boolean withSuper)

获取类中全部的字段

Parameters:

type - Class对象

withSuper - 是否获取父类中的全部

Returns:

getFieldsList

public static List<Field> getFieldsList(Class type,
                                        boolean withSuper)

获取类中全部的字段，转化为list

Parameters:

type - Class对象

withSuper - 是否获取父类中的全部

getFieldsSet

public static Set<Field> getFieldsSet(Class type,
                                      boolean withSuper)

获取类中全部的字段，转化为set

Parameters:

type - Class对象

withSuper - 是否获取父类中的全部

getFieldsGroupByName

public static Map<String,List<Field>> getFieldsGroupByName(Class type,
                                                           boolean withSuper)

获取类中的全部字段，并根据字段名分组

getFields

public static <A,R> R getFields(Class type,
                                boolean withSuper,
                                Collector<? super Field,A,R> collector)

自定义流转化

Parameters:

type - Class对象

withSuper - 是否获取父类中的全部

collector - Stream流转化函数

getFields

public static <A,R> R getFields(Class type,
                                boolean withSuper,
                                Supplier<R> supplier,
                                BiConsumer<R,? super Field> accumulator,
                                BiConsumer<R,R> combiner)

自定义流转化

Parameters:

type - Class对象

withSuper - 是否获取父类中的全部

supplier - Stream流转化函数

accumulator - Stream流转化函数

combiner - Stream流转化函数

getFieldsStream

public static Stream<Field> getFieldsStream(Class type,
                                            boolean withSuper)

获取类中全部的字段

Parameters:

type - Class对象

withSuper - 是否获取父类中的全部

Returns:

获取到的全部字段

isFieldExist

public static boolean isFieldExist(Class<?> tClass,
                                   String field)

通过Class对象判断是否存在此字段

Parameters:

tClass -

field -

Returns:

isFieldExist

public static boolean isFieldExist(Object obj,
                                   String field)

通过对象实例判断字段是否存在

Parameters:

obj - 实例对象

field - 查询字段

Returns:

Throws:

NoSuchFieldException

getListFieldGeneric

public static Class getListFieldGeneric(Field listField)
                                 throws ClassNotFoundException

获取一个list字段的泛型类型
这个字段必须是一个list类型的字段！

Parameters:

listField - 字段

Throws:

ClassNotFoundException - 如果泛型类型未找到或多于1个

getArrayGeneric

public static <T> Class getArrayGeneric(T[] trr)

获取数组的组件类型

Type Parameters:

T -

Parameters:

trr -

Returns:

getArrayGeneric

public static <T> Class getArrayGeneric(Class<T> tClass)

获取数组的组件类型

Type Parameters:

T -

Returns:

getListFieldGeneric

public static Class getListFieldGeneric(Class c,
                                        String fieldName)
                                 throws ClassNotFoundException

获取一个list字段的泛型类型
这个字段必须是一个list类型的字段！

Parameters:

c -

fieldName -

Returns:

Throws:

ClassNotFoundException

getListFieldGeneric

public static Class getListFieldGeneric(Object obj,
                                        String fieldName)
                                 throws ClassNotFoundException

获取一个list字段的泛型类型
这个字段必须是一个list类型的字段！

Parameters:

obj -

fieldName -

Returns:

Throws:

ClassNotFoundException

isChild

public static boolean isChild(Class child,
                              Class findFather)

判断一个Class对象是否为另一个对象的实现类

Parameters:

child - 进行寻找的子类

findFather - 被寻找的父类

Returns:

isChild

public static boolean isChild(Object child,
                              Class findFather)

判断一个Class对象是否为另一个对象的实现类

Parameters:

child - 进行寻找的子类的实现类

findFather - 被寻找的父类

Returns:

isBasic

public static boolean isBasic(Class type)

判断类型是否为基础数据类型或封装类

Parameters:

type -

Returns:

basicToBox

public static Class basicToBox(Class type)

将基础数据类型封装为其对应的封装类

headUpper

public static String headUpper(String str)

单词开头大写

headLower

public static String headLower(String str)

单词开头小写

getClassName

@Deprecated
public static String getClassName(Class<?> c)

Deprecated. 有方法直接获取的: Class.getSimpleName()

获取类名

Parameters:

c - 类

Returns:

类名

getClassName

public static String getClassName(Object o)

通过对象获取类名

Parameters:

o -

Returns:

allNonNull

public static void allNonNull(Object... all)

只要传入的参数中任意一个出现了null则会抛出空指针异常

Parameters:

all -

notInterfaceAndAbstract

public static boolean notInterfaceAndAbstract(Class<?> clazz)

判断一个类是不是不是抽象类也不是接口

getMethodNameWithoutGetter

public static String getMethodNameWithoutGetter(Method method)

获取方法名，如果是个getter规则方法名则移除get并开头小写, 与getMethodNameWithoutSetter(Method)类似

Parameters:

method - 方法

Returns:

方法名

getMethodNameWithoutSetter

public static String getMethodNameWithoutSetter(Method method)

获取方法名，如果是个getter规则方法名则移除get并开头小写, 与getMethodNameWithoutGetter(Method)类似

Parameters:

method - 方法

Returns:

方法名

getMethodNameWithoutGetterAndSetter

public static String getMethodNameWithoutGetterAndSetter(Method method)

获取方法名，如果是个getter或setter规则方法名则移除get或set并开头小写

Parameters:

method - 方法

Returns:

方法名

See Also:

getMethodNameWithoutGetter(Method), getMethodNameWithoutSetter(Method)