Specification项目v9.0.0版本发布：重大重构与性能优化

项目简介

Specification是一个用于.NET平台的高级规范模式实现库，它提供了一种优雅的方式来封装业务规则和查询逻辑。该库特别适合在领域驱动设计(DDD)项目中构建复杂的查询条件，同时保持代码的整洁性和可维护性。通过Specification模式，开发者可以将查询条件与业务逻辑解耦，实现更灵活的查询组合和重用。

核心变更概述

v9.0.0版本是一次重大更新，主要围绕性能优化和API简化展开。虽然标准用法基本保持不变，但内部实现经历了显著重构。以下是本次更新的关键改进：

1. 性能优化：通过减少内存分配和优化表达式处理，显著提升了查询效率
2. API简化：移除了冗余接口和方法，使API更加简洁直观
3. 功能增强：新增了缓存键、查询标记等实用功能
4. 架构调整：重构了构建器基础设施，为投影查询提供了更好的支持

主要改进详解

1. 性能优化措施

本次版本在性能方面做了多项重要改进：

• 表达式容器简化：表达式集合不再默认初始化为新列表，空集合将返回Enumerable.Empty<T>，减少了不必要的内存分配
• 查询参数类型调整：Take和Skip属性从可空int改为非可空int，默认值设为-1，消除了空值检查开销
• 包含评估器优化：使用单例IncludeEvaluator.Instance替代了原先的Default和Cached实例，减少了对象创建
• 搜索功能改进：重写了内存和EF Core的搜索评估器，提高了搜索效率
• 构建器重构：简化了构建器基础设施，减少了中间对象的创建

2. API简化与破坏性变更

为了提供更简洁的API，v9.0.0引入了一些破坏性变更：

• 移除过时方法：删除了GetBySpec等标记为过时的仓库方法
• 取消IEntity接口：不再强制要求实体实现IEntity接口，减少了框架侵入性
• Select方法调整：Select和SelectMany扩展方法现在返回void，必须在查询链末端或单独查询子句中使用
• 构造函数简化：规范构造函数不再接受评估器和验证器参数，改为通过可重写的属性提供

3. 新功能引入

v9.0.0版本增加了多项实用功能：

• 查询标记：新增TagWith扩展方法，允许为查询添加注释标签，便于调试和日志记录
• 自动包含控制：添加IgnoreAutoIncludes功能，可以显式控制是否自动加载导航属性
• 缓存键支持：引入WithCacheKey扩展，为查询结果缓存提供更灵活的键生成机制
• 更新/删除返回值：仓库的Update和Delete方法现在返回Task<int>，表示受影响的行数

4. 架构与内部重构

本次更新对项目内部结构进行了深度重构：

• 构建器基础设施：完全重写了构建器系统，更好地支持投影查询，要求扩展同时支持ISpecificationBuilder<T>和ISpecificationBuilder<T, TResult>
• 评估器简化：移除了OrderedSpecificationBuilder和CacheSpecificationBuilder等专用构建器
• 包含表达式信息：从IncludeExpressionInfo中移除了EntityType、PropertyType等冗余属性
• 评估器缓存：SpecificationEvaluator不再接受cacheEnabled参数，改为默认在必要时应用缓存

迁移指南

对于大多数标准用法，升级到v9.0.0应该相对简单。但对于以下情况需要注意：

1. 自定义扩展：如果项目中有自定义的规范扩展，需要根据新的构建器基础设施进行调整，确保同时支持普通和投影规范
2. 高级用法：依赖内部实现（如表达式容器、评估器等）的代码需要相应更新
3. 仓库方法：需要替换过时的GetBySpec方法，并处理Update/Delete方法的新返回值类型
4. Select用法：调整Select/SelectMany的使用位置，确保它们在查询链末端

总结

Specification v9.0.0是一次重要的里程碑式更新，通过内部重构和性能优化，为项目奠定了更坚实的基础。虽然引入了一些破坏性变更，但这些改变都是为了提供更高效、更简洁的API。新加入的功能如查询标记和缓存键支持，进一步扩展了库的实用性。对于追求高效数据访问和清晰架构的.NET项目，升级到v9.0.0将带来显著的性能提升和开发体验改善。