学习Java的同学注意了学习过程中遇到什么问题或者想获取学习资源的话欢迎加入Java学习交流群QQ群号码543120397 我们一起学Javajava.lang.*中Class 源代码详解【十五】public String getSimpleName()一、方法基础信息二、完整执行流程拆解三、返回值规则各类场景对比重点和getName()区分四、核心特性与设计价值五、与相关 API 关联对比六、典型业务使用场景七、关键注意事项八、总结public String getSimpleName()publicStringgetSimpleName(){ReflectionDataTrdreflectionData();StringsimpleNamerd.simpleName;if(simpleNamenull){rd.simpleNamesimpleNamegetSimpleName0();}returnsimpleName;}Class.getSimpleName() 用于获取类型简短名称不含包名底层采用懒加载 缓存机制首次调用通过 native 方法getSimpleName0()生成名称存入ReflectionData缓存后续调用直接读取缓存是日志打印、异常信息、序列化场景高频使用的 API。一、方法基础信息完整源码publicStringgetSimpleName(){// 获取当前Class绑定的反射缓存容器ReflectionDataReflectionDataTrdreflectionData();StringsimpleNamerd.simpleName;if(simpleNamenull){// 缓存未初始化调用native方法生成简短名称并回填缓存rd.simpleNamesimpleNamegetSimpleName0();}returnsimpleName;}依赖底层结构与方法说明ReflectionData reflectionData()Class内部私有方法返回ReflectionData对象。这是 Class 的反射信息缓存容器集中缓存simpleName、canonicalName、typeAnnotations等反射计算结果避免重复计算、重复调用 native 方法。多个反射 API 共享该缓存统一管理懒加载数据。volatile String simpleNameReflectionData内部成员变量作为简短名称缓存初始为null实现懒加载。private native String getSimpleName0();底层 native 本地方法由 HotSpot JVM 实现。读取类元数据、字节码信息按照getSimpleName命名规则生成简短名字符串。注意ReflectionData采用延迟创建、惰性填充策略只有第一次使用反射相关属性时才会初始化内部字段。二、完整执行流程拆解步骤 1获取反射缓存容器ReflectionDataTrdreflectionData();拿到当前 Class 专属的反射缓存对象所有反射懒加载属性统一存放在此。步骤 2读取缓存中的 simpleNameStringsimpleNamerd.simpleName;步骤 3缓存未初始化调用 native 生成并回填if(simpleNamenull){rd.simpleNamesimpleNamegetSimpleName0();}首次调用执行 native getSimpleName0()JVM 按照规范生成简短名称采用链式赋值将结果同时赋值给缓存变量与局部变量后续再次调用缓存不为 null直接跳过 native 调用。步骤 4返回简短名称字符串returnsimpleName;线程安全说明多线程同时首次调用时可能出现多次执行getSimpleName0()产生多个字符串实例属于 benign race良性竞争。即使重复生成字符串内容一致最终缓存只会保存其中一个不会破坏正确性JDK 不额外加锁以此换取更高并发性能。三、返回值规则各类场景对比重点和getName()区分类型场景getSimpleName()getName()普通顶层类 java.lang.StringStringjava.lang.String接口 java.util.ListListjava.util.List基本类型 int.classintint一维数组 String[]String[][Ljava.lang.String;二维数组 int[][]int[][][[I成员内部类 Outer.InnerInnerOuter$Inner匿名内部类 new Runnable(){}空字符串 “”Outer$1局部内部类方法内类LocalClassOuter$1LocalClassLambda 合成类$Lambda$1/xxxxOuter$$Lambda$1/xxxx无包名顶层类DemoDemo关键特殊规则匿名内部类getSimpleName() 返回空字符串“”极易踩坑数组自动追加 []对开发者友好区别于 JVM 内部签名不含任何包路径仅保留最内层类型标识不出现$分隔符局部类、内部类不会带上外部类前缀。测试示例publicclassSimpleNameDemo{classInner{}publicstaticvoidmain(String[]args){// 普通类System.out.println(String.class.getSimpleName());// String// 数组System.out.println(newString[0].getClass().getSimpleName());// String[]// 成员内部类System.out.println(Inner.class.getSimpleName());// Inner// 匿名内部类RunnablernewRunnable(){publicvoidrun(){}};System.out.println(r.getClass().getSimpleName());// 空字符串 // 基本类型System.out.println(int.class.getSimpleName());// int}}四、核心特性与设计价值懒加载 缓存优化兼顾内存与性能类加载阶段不预先计算简短名称仅第一次调用才执行 native 方法结果缓存在ReflectionData频繁调用时无 JNI 开销。面向人类可读友好的命名格式专门用于日志、异常信息、展示界面相比getName()消除 JVM 内部签名、包名可读性极强。统一数组展示格式数组直接输出Type[]屏蔽 JVM [Lxxx; 底层描述符避免上层解析数组签名。缓存聚合在 ReflectionData多个反射 API 复用同一个缓存容器减少独立字段带来的对象内存开销属于 Class 反射元数据统一缓存设计。无锁良性竞争设计不使用同步锁控制初始化牺牲极小概率重复计算换取高并发场景更好吞吐量符合 JDK 基础 API 设计思想。五、与相关 API 关联对比getSimpleName() vs getName()getSimpleName()展示用简短可读不能用于Class.forName()匿名类返回空串。getName()JVM 标准全限定名称遵循字节码描述规范可用于普通类Class.forName()适合底层判断、持久存储。getSimpleName() vs getCanonicalName()getCanonicalName()返回 Java 语言规范规范名称数组java.lang.String[]匿名类返回null// 匿名类区分重点r.getClass().getSimpleName();// r.getClass().getCanonicalName();// nullReflectionData 配套的其他缓存属性canonicalName、simpleName、typeAnnotations 统一托管getCanonicalName() 同样使用这套懒加载缓存模型设计思想同源。六、典型业务使用场景场景 1日志、异常信息打印最常用// 优先使用simpleName展示可读性更好log.info(当前处理类型{},obj.getClass().getSimpleName());场景 2简单类型名称展示UI / 监控输出publicstaticStringgetReadableClassName(Objectobj){if(objnull)returnnull;returnobj.getClass().getSimpleName();}场景 3 匿名类防御性工具封装避坑publicstaticStringsafeGetSimpleName(Class?clazz){Stringnameclazz.getSimpleName();// 匿名内部类为空字符串降级使用getNamereturnname.isBlank()?clazz.getName():name;}七、关键注意事项匿名内部类 getSimpleName() 返回空字符串 “”不是 null极易造成展示空白务必做好兼容不能依靠getSimpleName()进行类加载Class.forName不支持数组格式、匿名类无有效名称不要使用 simpleName 做唯一性判断不同包下同名类简短名称相同com.a.User 和 com.b.User simpleName 一致Lambda 类简短名称带有L a m b d a LambdaLambda标识但名称随运行环境变化不可用于业务逻辑判断缓存初始化存在良性竞态不影响结果正确性业务无需额外同步处理局部内部类、成员内部类只会输出自身名字不带外部类前缀。八、总结Class.getSimpleName() 获取类型可读简短名称实现采用 ReflectionData 懒加载缓存首次调用执行 native 方法getSimpleName0()生成名称并缓存后续直接读取返回格式对开发者友好数组展示[]、去除包名匿名内部类特殊返回空字符串核心设计懒加载减少类加载开销缓存降低 native 重复调用成本无锁良性竞争提升并发性能定位区分适合日志、展示层面底层反射判断、类加载场景优先使用getName()开发规范遇到匿名类场景必须增加空字符串防御逻辑切勿用 simpleName 作为类型唯一标识。
java.lang.*中Class 源代码详解【十五】
学习Java的同学注意了学习过程中遇到什么问题或者想获取学习资源的话欢迎加入Java学习交流群QQ群号码543120397 我们一起学Javajava.lang.*中Class 源代码详解【十五】public String getSimpleName()一、方法基础信息二、完整执行流程拆解三、返回值规则各类场景对比重点和getName()区分四、核心特性与设计价值五、与相关 API 关联对比六、典型业务使用场景七、关键注意事项八、总结public String getSimpleName()publicStringgetSimpleName(){ReflectionDataTrdreflectionData();StringsimpleNamerd.simpleName;if(simpleNamenull){rd.simpleNamesimpleNamegetSimpleName0();}returnsimpleName;}Class.getSimpleName() 用于获取类型简短名称不含包名底层采用懒加载 缓存机制首次调用通过 native 方法getSimpleName0()生成名称存入ReflectionData缓存后续调用直接读取缓存是日志打印、异常信息、序列化场景高频使用的 API。一、方法基础信息完整源码publicStringgetSimpleName(){// 获取当前Class绑定的反射缓存容器ReflectionDataReflectionDataTrdreflectionData();StringsimpleNamerd.simpleName;if(simpleNamenull){// 缓存未初始化调用native方法生成简短名称并回填缓存rd.simpleNamesimpleNamegetSimpleName0();}returnsimpleName;}依赖底层结构与方法说明ReflectionData reflectionData()Class内部私有方法返回ReflectionData对象。这是 Class 的反射信息缓存容器集中缓存simpleName、canonicalName、typeAnnotations等反射计算结果避免重复计算、重复调用 native 方法。多个反射 API 共享该缓存统一管理懒加载数据。volatile String simpleNameReflectionData内部成员变量作为简短名称缓存初始为null实现懒加载。private native String getSimpleName0();底层 native 本地方法由 HotSpot JVM 实现。读取类元数据、字节码信息按照getSimpleName命名规则生成简短名字符串。注意ReflectionData采用延迟创建、惰性填充策略只有第一次使用反射相关属性时才会初始化内部字段。二、完整执行流程拆解步骤 1获取反射缓存容器ReflectionDataTrdreflectionData();拿到当前 Class 专属的反射缓存对象所有反射懒加载属性统一存放在此。步骤 2读取缓存中的 simpleNameStringsimpleNamerd.simpleName;步骤 3缓存未初始化调用 native 生成并回填if(simpleNamenull){rd.simpleNamesimpleNamegetSimpleName0();}首次调用执行 native getSimpleName0()JVM 按照规范生成简短名称采用链式赋值将结果同时赋值给缓存变量与局部变量后续再次调用缓存不为 null直接跳过 native 调用。步骤 4返回简短名称字符串returnsimpleName;线程安全说明多线程同时首次调用时可能出现多次执行getSimpleName0()产生多个字符串实例属于 benign race良性竞争。即使重复生成字符串内容一致最终缓存只会保存其中一个不会破坏正确性JDK 不额外加锁以此换取更高并发性能。三、返回值规则各类场景对比重点和getName()区分类型场景getSimpleName()getName()普通顶层类 java.lang.StringStringjava.lang.String接口 java.util.ListListjava.util.List基本类型 int.classintint一维数组 String[]String[][Ljava.lang.String;二维数组 int[][]int[][][[I成员内部类 Outer.InnerInnerOuter$Inner匿名内部类 new Runnable(){}空字符串 “”Outer$1局部内部类方法内类LocalClassOuter$1LocalClassLambda 合成类$Lambda$1/xxxxOuter$$Lambda$1/xxxx无包名顶层类DemoDemo关键特殊规则匿名内部类getSimpleName() 返回空字符串“”极易踩坑数组自动追加 []对开发者友好区别于 JVM 内部签名不含任何包路径仅保留最内层类型标识不出现$分隔符局部类、内部类不会带上外部类前缀。测试示例publicclassSimpleNameDemo{classInner{}publicstaticvoidmain(String[]args){// 普通类System.out.println(String.class.getSimpleName());// String// 数组System.out.println(newString[0].getClass().getSimpleName());// String[]// 成员内部类System.out.println(Inner.class.getSimpleName());// Inner// 匿名内部类RunnablernewRunnable(){publicvoidrun(){}};System.out.println(r.getClass().getSimpleName());// 空字符串 // 基本类型System.out.println(int.class.getSimpleName());// int}}四、核心特性与设计价值懒加载 缓存优化兼顾内存与性能类加载阶段不预先计算简短名称仅第一次调用才执行 native 方法结果缓存在ReflectionData频繁调用时无 JNI 开销。面向人类可读友好的命名格式专门用于日志、异常信息、展示界面相比getName()消除 JVM 内部签名、包名可读性极强。统一数组展示格式数组直接输出Type[]屏蔽 JVM [Lxxx; 底层描述符避免上层解析数组签名。缓存聚合在 ReflectionData多个反射 API 复用同一个缓存容器减少独立字段带来的对象内存开销属于 Class 反射元数据统一缓存设计。无锁良性竞争设计不使用同步锁控制初始化牺牲极小概率重复计算换取高并发场景更好吞吐量符合 JDK 基础 API 设计思想。五、与相关 API 关联对比getSimpleName() vs getName()getSimpleName()展示用简短可读不能用于Class.forName()匿名类返回空串。getName()JVM 标准全限定名称遵循字节码描述规范可用于普通类Class.forName()适合底层判断、持久存储。getSimpleName() vs getCanonicalName()getCanonicalName()返回 Java 语言规范规范名称数组java.lang.String[]匿名类返回null// 匿名类区分重点r.getClass().getSimpleName();// r.getClass().getCanonicalName();// nullReflectionData 配套的其他缓存属性canonicalName、simpleName、typeAnnotations 统一托管getCanonicalName() 同样使用这套懒加载缓存模型设计思想同源。六、典型业务使用场景场景 1日志、异常信息打印最常用// 优先使用simpleName展示可读性更好log.info(当前处理类型{},obj.getClass().getSimpleName());场景 2简单类型名称展示UI / 监控输出publicstaticStringgetReadableClassName(Objectobj){if(objnull)returnnull;returnobj.getClass().getSimpleName();}场景 3 匿名类防御性工具封装避坑publicstaticStringsafeGetSimpleName(Class?clazz){Stringnameclazz.getSimpleName();// 匿名内部类为空字符串降级使用getNamereturnname.isBlank()?clazz.getName():name;}七、关键注意事项匿名内部类 getSimpleName() 返回空字符串 “”不是 null极易造成展示空白务必做好兼容不能依靠getSimpleName()进行类加载Class.forName不支持数组格式、匿名类无有效名称不要使用 simpleName 做唯一性判断不同包下同名类简短名称相同com.a.User 和 com.b.User simpleName 一致Lambda 类简短名称带有L a m b d a LambdaLambda标识但名称随运行环境变化不可用于业务逻辑判断缓存初始化存在良性竞态不影响结果正确性业务无需额外同步处理局部内部类、成员内部类只会输出自身名字不带外部类前缀。八、总结Class.getSimpleName() 获取类型可读简短名称实现采用 ReflectionData 懒加载缓存首次调用执行 native 方法getSimpleName0()生成名称并缓存后续直接读取返回格式对开发者友好数组展示[]、去除包名匿名内部类特殊返回空字符串核心设计懒加载减少类加载开销缓存降低 native 重复调用成本无锁良性竞争提升并发性能定位区分适合日志、展示层面底层反射判断、类加载场景优先使用getName()开发规范遇到匿名类场景必须增加空字符串防御逻辑切勿用 simpleName 作为类型唯一标识。
