Spring Data JPA中DeclaredQuery重构：解耦查询定义与自省状态

在Spring Data JPA的持续演进中，开发团队对DeclaredQuery进行了重要重构，核心目标是解耦查询定义与其自省（introspection）状态。这一改进源于对查询处理流程的深度优化需求，特别是在#2989问题的后续处理中发现的架构改进机会。

重构背景

DeclaredQuery原本承担着双重职责：

1. 维护查询的基本属性（查询字符串、原生查询类型）
2. 管理自省后的状态（别名信息、构造函数表达式使用情况等）

这种设计导致查询创建过程与自省逻辑高度耦合，使得QueryEnhancerFactory难以被外部化配置。随着项目复杂度提升，这种耦合性限制了框架的扩展性和灵活性。

重构方案

新设计采用清晰的职责分离原则：

1. 查询定义层
   保留原始查询字符串和原生查询类型等静态属性，这些是查询的固有特征，与运行时无关。

2. 自省状态层
   将运行时解析得到的元数据（如别名映射、参数绑定方式等）剥离为独立结构，形成真正的"自省结果"对象。

这种分离带来了显著的架构优势：

• 查询定义可被安全地缓存和复用
• 自省过程可延迟执行或按需执行
• 增强器工厂(QueryEnhancerFactory)可灵活替换

技术实现要点

实现过程中主要涉及以下关键修改：

1. 状态对象提取
   创建新的IntrospectionResult类型承载所有动态解析属性，与静态查询定义形成组合关系。

2. 懒加载机制
   自省过程改为按需触发，避免不必要的解析开销，特别对于预定义的命名查询。

3. 工厂接口标准化
   定义清晰的QueryEnhancer创建接口，支持通过SPI或显式配置注入自定义实现。

对使用者的影响

这一重构对大多数用户透明，但为高级用户带来新能力：

• 自定义查询处理
  通过实现自己的QueryEnhancerFactory，可以介入查询解析过程，例如添加特殊的参数转换逻辑。

• 性能优化
  对于已知不会使用某些自省特性的查询场景，可以配置轻量级解析策略。

• 测试便利性
  模拟查询行为时不再需要完整自省流程，只需提供必要的查询定义属性。

最佳实践建议

基于新架构，推荐以下实践方式：

1. 对于简单查询，继续使用原有声明方式
2. 需要深度定制时，考虑实现QueryEnhancer接口
3. 在性能敏感场景，评估延迟自省的可行性
4. 共享查询定义时，确保自省结果的线程安全性

这一重构体现了Spring Data项目持续优化架构设计的理念，为后续的功能扩展奠定了更健康的基础。开发者现在可以更灵活地控制查询生命周期，同时享受更清晰的关注点分离带来的维护便利性。