目的

• 继续收口 FastBeanCopier 默认 backend、缓存策略与跨 classloader 兼容行为。
• 在保证兼容性的前提下优先提升热路径命中稳定性，并为 native / 受限运行时保留可靠 fallback。

核心变动

默认 backend 与运行时选择

• 默认 backend 调整为 asm-accessor。
• 新增 FastBeanCopierBackendSelector：
  • 支持 hsweb.fast-bean-copier.backend 显式指定 backend
  • 支持 hsweb.fast-bean-copier.disable-codegen 禁用 runtime codegen
  • 探测 org.graalvm.nativeimage.imagecode / hsweb.fast-bean-copier.native-image
• native / disable-codegen 环境下，默认回退到 reflection-accessor。

缓存与 classloader 策略

• FastBeanCopierSupport 增加 backend cache 与动态 loader 的 volatile copier cache。
• 动态 classloader 场景统一回退 reflection-accessor，避免 runtime codegen 在跨 loader/受限环境下失效。
• 热路径缓存改为强命中优先：
  • volatile copier cache 使用强缓存
  • ClassDescriptions 改为按 classloader 分段的强缓存
  • converter 子缓存改为按 classloader 分段的强缓存
  • accessor 泛型解析缓存 GENERIC_CACHE 改为强缓存
• 对外新增：
  • FastBeanCopier.clearCache()
  • FastBeanCopier.clearCache(ClassLoader)
• 保留 FastBeanCopier.DEFAULT_CONVERT 兼容入口，并标记弃用。

转换与兼容性补强

• FastBeanCopierConverterSupport 引入 conversion plan cache。
• 补齐 collection / map 泛型转换、enum lookup、bean-like target 等子路径缓存。
• 支持动态 loader 相关 converter / class description / accessor 缓存显式释放。

测试与基准

• 补充 FastBeanCopierSupportTest，覆盖：
  • 默认 backend 选择
  • native hint fallback
  • backend 显式 override
  • DEFAULT_CONVERT 泛型集合/Map 转换兼容
  • 跨 classloader 复制
  • 动态 loader reflection fallback
  • clearCache(ClassLoader) 回收与重建
• 更新 FastBeanCopierBenchmarkSummary.md
• 更新 FastBeanCopierJmhRunner，支持 include/forks 参数化

测试结果

单元测试

mvn -pl hsweb-core -am -Dtest=FastBeanCopierSupportTest,FastBeanCopierTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：

• Tests run: 33
• Failures: 0
• Errors: 0
• Skipped: 0

覆盖率（本模块本次测试产物）

JaCoCo：hsweb-core/target/site/jacoco/jacoco.xml

• hsweb-core overall line coverage: 43.74%
• hsweb-core overall branch coverage: 40.25%

本次关键类：

• AccessorFastBeanCopierBackend line 88.24%, branch 87.88%
• FastBeanCopierSupport line 78.91%, branch 68.42%
• FastBeanCopierConverterSupport line 70.33%, branch 59.26%
• ClassLoaderScopedClassCache line 88.89%, branch 75.00%
• FastBeanCopierBackendSelector line 77.27%, branch 52.38%

代表性性能结果

JMH 结果文件：hsweb-core/target/jmh-results/fast-bean-copier.json

单位 us/op，越小越好：

• simple bean -> bean
  • asm-accessor: 0.100
  • javassist: 0.102
  • reflection-accessor: 0.331
• complex bean -> bean
  • javassist: 5.547
  • asm-accessor: 6.495
  • reflection-accessor: 8.125
• bean -> map
  • asm-accessor: 0.908
• heterogeneous map -> bean
  • asm-accessor: 7.429
• conversion-heavy map -> bean
  • asm-accessor: 9.530
• collection-heavy map -> bean
  • asm-accessor: 0.857
• nested-heavy map -> bean
  • asm-accessor: 1.177

结论：asm-accessor 已具备默认 backend 的综合优势；仅 complex bean -> bean 单项上 javassist 仍领先。

文档同步

• 已更新：hsweb-core/src/test/java/org/hswebframework/web/bean/FastBeanCopierBenchmarkSummary.md
• README 未修改；本次测试/性能证据放在 PR 与 benchmark summary 中。

兼容性与运维说明

• FastBeanCopier 对外 facade 保持兼容，新增 cache clear API 为增量能力。
• DEFAULT_CONVERT 兼容入口保留，但建议后续迁移至 FastBeanCopierSupport.DEFAULT_CONVERT。
• 本次未引入 TTL/定时回收，避免缓存重建抖动；动态 classloader 释放依赖宿主显式 clearCache(loader)。
• 未补充 TraceHolder：本次为通用 bean copy 基础设施优化，不涉及业务链路追踪上下文。
• 未补充 MBean：当前缓存为进程内基础设施缓存，尚无独立后台任务/队列/执行器，本次仅提供显式 clear API。

已知限制 / 风险

• 目前不能宣称完整 native image 适配完成；只是具备 native/受限环境下的 fallback 基础。
• 仍存在受限反射路径，例如 setAccessible(true) 相关集合构造与 accessor 实现。
• 通过 exec-maven-plugin 运行 forked JMH 时仍会遇到 org.openjdk.jmh.runner.ForkedMain classpath 问题，当前基准结果以 non-forked 相对对比为主。