深入理解 Spring Boot 内置工具类：ReflectionUtils
深入理解 Spring Boot 内置工具类：ReflectionUtils
文章目录
- 1. 什么是反射？
- 2. 使用 ReflectionUtils
- 2.1 获取类的所有字段
- 2.2 调用方法
- 2.3 访问字段
- 3. 源码分析
- 3.1 `doWithFields`
- 3.2 `findMethod`
- 3.3 `invokeMethod`
- 4. 拓展与分析
- 4.1 拓展
- 4.2 性能考虑
- 4.3 Java 9+ 模块化
- 5. 总结
?欢迎来到架构设计专栏~深入理解 Spring Boot 内置工具类：ReflectionUtils
- ☆* o(≧▽≦)o *☆嗨~我是IT·陈寒?
- ?博客主页：IT·陈寒的博客
- ?该系列文章专栏：架构设计
- ?其他专栏：Java学习路线 Java面试技巧 Java实战项目 AIGC人工智能 数据结构学习
- ?文章作者技术和水平有限，如果文中出现错误，希望大家能指正?
- ? 欢迎大家关注！ ??
Spring Boot作为一个强大的Java框架，提供了许多方便开发的工具类和方法。其中，ReflectionUtils是一个反射工具类，它封装了Java反射的操作，使得我们能够更轻松地操作和访问类的方法、字段等。本文将深入探讨ReflectionUtils的用法、原理，并通过适当的代码插入进行解释和示范，帮助读者更好地理解和使用这个工具类。
1. 什么是反射？
反射是指在程序运行时，动态地获取类的信息并操作类的属性、方法和构造方法的能力。在Java中，可以通过java.lang.reflect包实现反射。反射的主要用途包括：
- 在运行时获取类的信息。
- 在运行时获取类的属性、方法、构造方法等。
- 在运行时调用对象的方法。
- 在运行时生成新的类。
ReflectionUtils就是Spring Boot对Java反射的封装，提供了更简洁的API，使得开发者能够更便捷地进行反射操作。
2. 使用 ReflectionUtils
ReflectionUtils包含了一系列静态方法，用于执行常见的反射操作。下面通过一些示例演示如何使用ReflectionUtils。
2.1 获取类的所有字段
import org.springframework.util.ReflectionUtils;
public class ReflectionExample {
public static void main(String[] args) {
Class<?> clazz = MyClass.class;
ReflectionUtils.doWithFields(clazz, field -> {
System.out.println("Field: " + field.getName());
});
}
private static class MyClass {
private String name;
private int age;
}
}在上面的例子中，我们通过ReflectionUtils.doWithFields方法遍历了MyClass类的所有字段，并打印出字段的名称。
2.2 调用方法
import org.springframework.util.ReflectionUtils;
import java.lang.reflect.Method;
public class ReflectionExample {
public static void main(String[] args) {
MyClass myClass = new MyClass();
Class<?> clazz = myClass.getClass();
Method method = ReflectionUtils.findMethod(clazz, "printInfo");
if (method != null) {
ReflectionUtils.invokeMethod(method, myClass);
}
}
private static class MyClass {
public void printInfo() {
System.out.println("Printing information...");
}
}
}在这个例子中，我们使用ReflectionUtils.findMethod找到了printInfo方法，并通过ReflectionUtils.invokeMethod调用了这个方法。
2.3 访问字段
import org.springframework.util.ReflectionUtils;
import java.lang.reflect.Field;
public class ReflectionExample {
public static void main(String[] args) {
MyClass myClass = new MyClass();
Class<?> clazz = myClass.getClass();
Field field = ReflectionUtils.findField(clazz, "name");
if (field != null) {
ReflectionUtils.makeAccessible(field);
ReflectionUtils.setField(field, myClass, "John Doe");
System.out.println("Name: " + ReflectionUtils.getField(field, myClass));
}
}
private static class MyClass {
private String name;
}
}在上述代码中，我们通过ReflectionUtils.findField找到了name字段，并使用ReflectionUtils.makeAccessible使得字段可访问。然后，通过ReflectionUtils.setField设置了字段的值，通过ReflectionUtils.getField获取了字段的值。
3. 源码分析
ReflectionUtils的实现原理主要是基于Java的反射机制。在ReflectionUtils中，有一些重要的方法，比如doWithFields、findMethod、invokeMethod等。下面简要分析一下其中的几个方法。
3.1 doWithFields
public static void doWithFields(Class<?> clazz, FieldCallback fieldCallback) {
doWithFields(clazz, fieldCallback, null);
}
public static void doWithFields(Class<?> clazz, FieldCallback fieldCallback, FieldFilter fieldFilter) {
// ...
ReflectionUtils.MethodFilter allMethods = ReflectionUtils.MethodFilter.TRUE;
doWithFields(clazz, fieldCallback, fieldFilter, allMethods);
}这个方法是用于遍历类的所有字段的，通过调用doWithFields的不同重载方法，可以传递FieldCallback、FieldFilter 和MethodFilter等参数。
3.2 findMethod
@Nullable
public static Method findMethod(Class<?> clazz, String name) {
return findMethod(clazz, name, EMPTY_CLASS_ARRAY);
}
@Nullable
public static Method findMethod(Class<?> clazz, String name, Class<?>... paramTypes) {
// ...
Method[] methods = clazz.getDeclaredMethods();
for (Method method : methods) {
if (name.equals(method.getName()) &&
(paramTypes.length == 0 || Arrays.equals(paramTypes, method.getParameterTypes()))) {
return method;
}
}
return null;
}findMethod方法用于查找指定名称和参数类型的方法。它通过调用clazz.getDeclaredMethods()获取所有声明的方法，然后遍历这些方法，比对方法的名称和参数类型。
3.3 invokeMethod
public static Object invokeMethod(Method method, @Nullable Object target, Object... args) {
try {
return method.invoke(target, args);
} catch (Exception ex) {
handleReflectionException(ex);
}
throw new IllegalStateException("Should never get here");
}invokeMethod方法用于调用指定对象的方法。它直接调用method.invoke来执行方法，如果出现异常则调用handleReflectionException进行处理。
4. 拓展与分析
4.1 拓展
除了上述介绍的几个常用方法，ReflectionUtils还提供了其他一些有用的方法，如doWithMethods、declaredFields等。可以根据具体的需求，灵活运用这些方法。
4.2 性能考虑
由于反射涉及到动态获取类信息、动态创建对象等操作，性能开销相对较大。在性能敏感的场景中，应谨慎使用反射，尽量采用更直接的方式。
4.3 Java 9+ 模块化
在Java 9及更高版本中，模块化的引入对反射产生了一些影响。如果项目采用了Java 9及以上版本，并使用了模块化，可能需要在module-info.java中添加相应的--add-opens声明，以确保反射能够正常访问某些模块的内部。
5. 总结
本文深入探讨了Spring Boot内置反射工具类ReflectionUtils的使用方法和源码原理。通过示例代码演示了如何遍历类的字段、查找方法、调用方法等操作。同时，对于一些拓展和性能方面的考虑进行了分析。反射是Java强大的特性之一，但在使用时需要注意性能和安全性等方面的问题，谨慎选择使用反射的场景。