跳到主要内容
约 11 分钟3 张卡

Java 反射

反射让 Java 程序在运行时检查类型、访问成员,并创建对象或调用方法。依赖注入、序列化和插件框架在编写时,并不知道用户会提供哪些类,可以等运行时取得类型信息后再操作它们。

这种灵活性也把一部分检查推迟到了运行时:找到一个方法,不代表有权限调用;传入的对象正确,也不代表调用时的类型一定匹配。理解反射,需要把成员查找、访问检查和实际调用分开,方法句柄的类型规则也要在这个基础上看。

1. 面试核心​

先记住这几条,再读正文
  • 反射通过 Class 在运行时读取类型信息并操作对象,适合处理运行时才确定的类型。卡 · Class 对象来源
  • getDeclaredMethods() 返回本类声明的方法,包括非公开方法;getMethods() 返回公开方法,也包含继承的公开方法。
  • 找到成员不等于有权限访问,调用时仍需满足访问控制和模块开放要求。
  • 被调用方法抛出的异常,会被 Method.invoke 包装在 InvocationTargetException 中,原始异常通过 getCause() 取得。
  • invokeExact 要求调用点的参数和返回类型都与句柄完全一致。卡 · 方法句柄的返回类型
  • 缓存成员可以省去重复查找,调用成本仍需实测。Java 17 与 21 的核心反射实现不同,不能套用固定的性能倍数。卡 · MethodHandle

2. Class 对象来源​

Class 对象表示一个运行时类型,是读取类型信息的入口。类型在编译期已知、手里已有对象,或者只知道类名时,分别可以用下面三种方式取得它:

Class<String> literal = String.class;

String value = "Java";
Class<?> fromObject = value.getClass();

Class<?> loaded = Class.forName("com.example.UserService");
  • String.class 是类字面量,编译期就已经知道要访问 String。
  • value.getClass() 取得 value 指向的对象的实际运行时类。
  • Class.forName(String) 根据类名加载类型,还会触发类初始化。

只需要加载但暂不初始化时,可以显式指定初始化参数和类加载器:

Class<?> type = Class.forName(
"com.example.UserService",
false,
applicationClassLoader
);

第二个参数 false 表示这次加载不触发初始化,第三个参数指定用哪个类加载器查找类型。插件根据配置中的类名查找实现时,需要使用能找到这个实现类的加载器。

3. 成员元数据​

元数据是描述类型的信息,包括成员声明、父类型、接口和注解。拿到 Class 后,就能查询这些信息。下面分别读取 User 自己声明的字段和方法:

Class<User> type = User.class;

for (Field field : type.getDeclaredFields()) {
System.out.println(field.getName() + ": " + field.getType());
}

for (Method method : type.getDeclaredMethods()) {
System.out.println(method.getName());
}

getDeclaredFields() 和 getDeclaredMethods() 只看当前类自己声明的成员,包括非公开成员,不包含继承来的成员。若要查询公开方法,并把继承的公开方法也包含进来,就用 getMethods()。

查到成员不等于能使用它。例如,getDeclaredMethods() 可以列出私有方法,但调用时仍要满足访问检查,具体见非公开成员与模块边界。

3.1 泛型声明信息​

反射可以读取声明中保留的泛型信息,即使运行时调用已经使用擦除后的类型。Class 文件用 Signature 属性保存这些声明,getGenericReturnType() 等 API 会读取它们:

Method method = UserRepository.class.getMethod("findAll");

System.out.println(method.getReturnType()); // interface java.util.List
System.out.println(method.getGenericReturnType()); // java.util.List<com.example.User>

示例中,getReturnType() 只得到 List,而 getGenericReturnType() 能读到声明中的 User。同样,getGenericParameterTypes() 可以读取参数的泛型声明。

普通 List<String> 实例的运行时类型并不单独保存 String 这个类型实参,详见 Java 泛型。

4. 对象创建与方法调用​

反射调用需要先找到匹配的构造器或方法。假设 GreetingService 有公开的无参构造器,以及接收 String 参数的公开实例方法 greet,就可以这样创建对象并调用:

Class<?> type = Class.forName("com.example.GreetingService");

Constructor<?> constructor = type.getConstructor();
Object service = constructor.newInstance();

Method greet = type.getMethod("greet", String.class);
Object result = greet.invoke(service, "Lin");

System.out.println(result);

getConstructor() 找到公开的无参构造器,constructor.newInstance() 创建对象。getMethod("greet", String.class) 再按方法名和参数类型找到方法,greet.invoke(service, "Lin") 对这个对象执行调用。这里的 接收者就是执行实例方法的对象,也就是 service。

反射调用会在运行时检查接收者、参数数量和参数类型。结果以 Object 返回,基本类型参数和返回值还会涉及装箱或拆箱。

被调用方法抛出的异常会包装在 InvocationTargetException 中:

try {
greet.invoke(service, "Lin");
} catch (InvocationTargetException exception) {
Throwable cause = exception.getCause();
// 根据框架边界处理 cause
}

getCause() 可以取出被调用方法抛出的实际异常。框架应保留这个原因及其堆栈,才能帮助开发者定位业务失败的位置。

4.1 非公开成员与模块边界​

getDeclaredMethod 能发现非公开方法,但调用仍受访问检查限制。trySetAccessible() 会尝试关闭该成员的访问检查,并通过返回值说明是否成功:

Method method = type.getDeclaredMethod("internalOperation");

if (!method.trySetAccessible()) {
throw new IllegalStateException("member is not accessible");
}

trySetAccessible() 返回 false,就说明不能通过这种方式放开访问,示例会直接报告失败。跨模块访问私有成员,需要目标包向调用模块开放;启动参数 --add-opens 可以显式开放对应的包。访问 JDK 内部实现同样受到这些限制,因此库和应用应优先使用公开 API。

私有成员属于实现细节,名称或签名在升级时可以改变。所以,依赖私有成员的框架需要验证 JDK 和依赖库升级后的兼容性。

5. MethodHandle​

方法句柄是一个带有类型信息、可以直接调用的对象,用 MethodHandle 表示。它可以指向方法、构造器或字段操作,自身的 MethodType 记录参数类型和返回类型。下面取得 GreetingService.greet 的句柄,再调用它:

MethodHandles.Lookup lookup = MethodHandles.lookup();

MethodHandle greet = lookup.findVirtual(
GreetingService.class,
"greet",
MethodType.methodType(String.class, String.class)
);

GreetingService service = new GreetingService();
String result = (String) greet.invokeExact(service, "Lin");

这里假设 greet(String) 返回 String。findVirtual 查找这个实例方法,并在创建句柄时检查权限。得到的句柄类型为 (GreetingService, String)String:调用时除了传入字符串,还要把接收者 service 放在第一个参数位置。包含这段调用的方法需要声明 throws Throwable,或者捕获调用抛出的异常。

取得句柄后可以反复调用,还可以生成适配后的新句柄。比如,bindTo 固定接收者,asType 调整参数或返回类型。参数插入和组合操作还能把多个调用步骤连在一起。

5.1 invokeExact 与 invoke​

调用点类型是编译器为这一次调用记录的参数类型和返回类型。invokeExact 要求它与句柄类型完全匹配,invoke 则允许按 asType 的规则适配参数和返回类型。

invokeExact 比较的是这些类型,不只看传入对象是什么。例如,把接收者声明成 Object,即使它实际指向 GreetingService,也和句柄要求的 GreetingService 不匹配。

5.2 方法句柄的返回类型​

invokeExact 连返回类型也要求匹配,因为调用点类型同时包含参数和返回值。下面用 String.length() 的句柄,比较返回 int 与返回 Object 的差异:

MethodHandle length = MethodHandles.lookup().findVirtual(
String.class, "length", MethodType.methodType(int.class)
);
int size = (int) length.invokeExact("Java"); // 4
// Object wrong = length.invokeExact("Java"); // WrongMethodTypeException
Object boxed = length.invoke("Java"); // Integer,值为 4

上述调用需放在声明 throws Throwable 的方法中。句柄类型为 (String)int,显式转换 (int) 让精确调用的返回类型与它一致。注释中的调用点返回 Object,因此会抛出 WrongMethodTypeException。最后一行改用 invoke,允许把 int 装箱成 Integer 后作为 Object 返回。

方法句柄直接传播目标方法抛出的异常,省去了 InvocationTargetException 包装。访问权限在创建句柄时检查,所以把私有方法句柄交给其他代码,也交出了该方法的调用能力。

5.3 MethodHandle 的适用场景​

需要动态确定目标、又希望保留明确类型时,可以考虑方法句柄。例如:

  • 动态语言运行时可以用句柄连接 invokedynamic 调用点,也就是运行时确定目标的调用入口。
  • 框架需要组织多个调用步骤时,可以用句柄绑定接收者、适配参数或组合操作。
  • 成员发现完成后,可以缓存带类型的句柄,供高频调用复用。
  • 通过 LambdaMetafactory 等底层 API 创建函数式接口实例时,可以用句柄指定实际调用的方法。

如果类型在编译期已知,普通方法调用最清楚。

6. 反射的调用成本​

反射的成本包括查找成员和实际调用,两者要分开测量。相对于直接调用,反射还可能需要做这些工作:

  • 查找阶段要按名称搜索成员,并匹配参数类型。
  • 调用阶段需要检查访问权限和实参类型。
  • 通用调用接口使用 Object[] 传递参数,还涉及装箱、拆箱和结果转换。
  • 间接调用让编译器更难确定目标,因此增加内联等优化的难度。
  • 目标方法抛出异常时需要包装,框架层还会增加调用调度。

框架可以在启动时解析并缓存 Method 或 MethodHandle,避免每次请求重新扫描。下面的 RequestHandler 就把已经找到的 Method 保存为字段:

private final Method handlerMethod;

RequestHandler(Method handlerMethod) {
this.handlerMethod = handlerMethod;
}

后续请求直接使用 handlerMethod,省去的是查找这一步;调用时的检查和参数适配仍需单独评估。

6.1 JDK 版本与调用性能​

Java 17 的核心反射使用本地调用和生成的访问器。Java 21 的核心反射则使用方法句柄实现。即时编译器(JIT)对常量 Method、Constructor 和 MethodHandle 的优化能力,也会随版本和调用形态变化。

JIT 会在运行时优化代码。调用目标越稳定,它越容易识别和优化实际执行的方法。因此,反射和句柄之间没有跨 JDK、跨调用方式的固定性能倍数。

低频扫描只占启动成本的一部分,应先测量它在启动耗时中的比例。高频序列化、路由和表达式执行则要单独测量。可以在目标 JDK 上使用 Java 微基准工具 JMH,模拟实际调用方式验证收益。

7. 使用边界​

反射适合框架发现和通用工具,不适合把普通业务代码改成字符串驱动:

// 类型在编译期已经确定时,没有必要反射
orderService.create(order);

直接调用保留编译检查、清晰的调用关系和 IDE 重构支持。反射按名称查找成员,方法名、参数或权限错误会推迟到运行时。因此,框架应在启动时校验签名、缓存解析结果,并给出明确的错误消息。

此外,反射对象与它描述的类型、类加载器和构建方式有关,框架还需要处理这些问题:

  • 类型身份与类加载器有关,因此插件之间需要明确隔离关系和类卸载方式。
  • 跨模块调用要检查目标包的开放关系和成员访问权限。
  • 泛型擦除后,框架需要根据声明信息校验并转换参数。
  • 缓存反射对象会持有对应类型,需要避免意外保留本应卸载的类加载器。
  • Native Image 等构建方式需要提前知道可达代码,因此要为动态反射目标提供配置。

8. 常见问题​

8.1 反射能访问 private 成员吗?​

可以发现本类私有方法,能否调用则取决于访问权限。getDeclaredMethod 完成发现后,还要根据调用者和模块开放关系检查 trySetAccessible() 的结果。私有方法属于实现细节,升级后仍需验证兼容性。

8.2 Class.forName 与 ClassLoader.loadClass 有什么区别?​

8.3 反射调用还会检查类型吗?​

8.4 Method 与 MethodHandle 的主要区别是什么?​

9. 面试题卡片​

10. 参考资料​

来源:Coding 101 原文 · 免费阅读,引用请保留出处。内容使用说明