Spring Framework中SqlQuery类的rowsExpected属性废弃分析

背景介绍

在Spring Framework的JDBC模块中，SqlQuery是一个重要的抽象类，用于执行SQL查询并映射结果。在最新版本的Spring Framework中，开发团队决定废弃该类的rowsExpected属性及相关方法。这一变更看似简单，但背后反映了框架设计中对API清晰性和实用性的持续优化。

rowsExpected属性的原始设计意图

rowsExpected属性最初的设计目的是为了性能优化考虑。当开发者能够预先知道查询结果的行数时，可以通过设置这个属性来优化结果集的存储分配。具体来说：

1. 该属性会影响底层ArrayList的初始容量设置
2. 理论上可以减少集合扩容带来的性能开销
3. 主要用于大数据量查询场景下的微优化

废弃的原因分析

Spring开发团队经过深入讨论后决定废弃该属性，主要基于以下几点考虑：

1. 实际使用场景有限：框架内部从未真正使用过这个属性，getRowsExpected()方法在代码库中没有任何调用点
2. 误用风险：有第三方库错误地将此属性作为业务逻辑的一部分使用，这与设计初衷不符
3. 维护成本：保留一个几乎不被使用且可能被误用的属性会增加框架的维护负担
4. 清晰的API设计：Spring团队倾向于提供明确、有实际用途的API，避免保留"僵尸"属性

对现有应用的影响

对于大多数应用来说，这一变更不会产生任何影响，因为：

1. 该属性原本就是可选的，默认值为0
2. 即使设置了该值，也不会改变查询结果或行为
3. 仅有的影响可能是在极端大数据量场景下的微小性能差异

替代方案建议

如果开发者确实需要优化结果集存储性能，可以考虑以下替代方案：

1. 直接使用RowMapperResultSetExtractor并设置其rowsExpected属性
2. 在业务层手动控制结果集合的初始容量
3. 对于分页查询，使用Spring Data等更高级的抽象

总结

Spring Framework对SqlQuery类中rowsExpected属性的废弃，体现了框架团队对API质量的持续追求。这一变更虽然微小，但反映了Spring在保持向后兼容性的同时，不断清理和优化代码库的决心。开发者无需特别担心这一变更，但应该注意检查自己的代码是否错误地依赖了这一属性。