Java常用反射类库与Class

Class对象由JVM类加载时自动创建,不可new;获取方式有String.class、obj.getClass()、Class.forName();反射调用需区分getMethod与getDeclaredMethod;Field操作性能差且易空指针;转型须校验类型防ClassCastException。

Class 对象不是 new 出来的,是 JVM 在类加载时自动创建的

Java 中每个类(包括数组、基本类型、甚至 void)在运行期都有且仅有一个 Class 实例,它由类加载器(ClassLoader)在首次主动使用该类时生成。你不能用 new Class() 创建它,也不能手动实例化——这是 JVM 的内部契约。

获取 Class 对象有三种常见方式,但行为和适用场景不同:

  • String.class:编译期已知类型,最安全、最快,推荐用于常量类型判断或泛型擦除后保留类型信息(如 Map.class
  • obj.getClass():运行时动态获取实际类型,注意会返回子类的 Class(比如 new ArrayList().getClass

    ()
    返回的是 ArrayList.class,不是 List.class
  • Class.forName("java.util.Date"):触发类加载,可能抛 ClassNotFoundException;若类中含静态初始化块,会执行它——这点常被忽略,导致意外副作用

反射调用方法时,getMethod 和 getDeclaredMethod 的区别很关键

getMethod 只查 public 方法(包括父类继承的),而 getDeclaredMethod 查当前类声明的所有方法(含 private、protected、package-private),但不跨类继承。多数“调用私有方法”失败,就是因为误用了 getMethod

实操建议:

  • 调用公有方法(如接口实现、标准 API)用 getMethod,更安全
  • 测试或框架内需访问私有逻辑(如单元测试 mock、ORM 字段注入)必须用 getDeclaredMethod,且要先调 setAccessible(true)
  • 注意:setAccessible(true) 在 JDK 12+ 受强封装限制(如模块系统下对 java.base 类无效),生产环境慎用

Field.get/set 性能差,且 null 安全容易出错

直接通过 Field.get(obj) 读字段比普通 getter 慢 2–5 倍(JIT 很难优化反射路径),而且如果字段是基本类型(如 int),get() 返回的是包装类(Integer),对 null 敏感——field.get(null)NullPointerException,但 field.get(someObj)someObjnull 也会抛同样的异常,错误定位困难。

更稳的做法:

  • 优先用 Method 替代 Field(比如走 getXXX() / setXXX()),语义清晰,null 检查由业务方法自己控制
  • 若必须用字段反射(如序列化框架),缓存 Field 实例 + 提前调用 setAccessible(true),避免每次重复查找和权限检查
  • JDK 9+ 可考虑 VarHandleMethodHandles.privateLookupIn 配合),性能接近直接访问,但 API 更重

ClassCastException 常在反射转型时静默发生

反射拿到对象后,常写成:

Object obj = constructor.newInstance();
String s = (String) obj;
表面看没问题,但如果构造器实际返回的是 StringBuilder,强制转型会在运行时报 ClassCastException,且 IDE 和编译器完全无法预警。

规避方式:

  • instanceofClass.isInstance() 做运行时校验,尤其在处理用户传入的 class name 字符串时(如插件机制)
  • 避免裸转型,封装成泛型工具方法: T cast(Object obj, Class targetType),内部用 targetType.isInstance(obj) + 强转
  • 注意数组类型:String[].class.isInstance(new Object[0]) 返回 false,因为 Object[] 不是 String[] 的实例——数组类型检查比普通类更严格
反射不是黑魔法,它是 JVM 开放内部结构的通道,但每开一扇门,就多一分失控风险。真正难的不是调通 invoke(),而是想清楚:这个类是否真该被外部绕过访问控制?这个字段是否本就不该暴露?很多 “反射问题”,其实源于设计边界没划清。