Vogen 7.0.0 发布：强类型值对象库的重大更新

项目简介

Vogen 是一个用于创建强类型值对象的 .NET 库，它通过源代码生成器帮助开发者避免原始类型（primitive types）的滥用问题。值对象（Value Object）是领域驱动设计（DDD）中的一个重要概念，它封装了业务规则并提供了类型安全性。Vogen 让创建和使用值对象变得简单高效。

7.0.0 版本亮点

JSON 反序列化错误消息改进

在之前的版本中，当使用 System.Text.Json 反序列化一个值对象时，如果验证失败，会抛出 ValueObjectValidationException。在 7.0.0 版本中，现在会抛出 JsonException，这带来了两个显著优势：

1. 更精确的错误定位：JsonException 包含了问题发生的具体位置信息，这在调试复杂的 JSON 结构时特别有用。
2. 更符合 .NET 生态：与 System.Text.Json 的其他部分保持一致，开发者可以统一处理 JSON 相关的异常。

注意：这是一个轻微的破坏性变更。如果你在代码中显式捕获了 ValueObjectValidationException 来处理反序列化错误，需要更新为捕获 JsonException。

新增 Decimal 类型的 Dapper 支持

7.0.0 版本扩展了对 Dapper 这个流行的微型 ORM 的支持，现在可以正确处理 Decimal 类型的值对象。这意味着：

• 可以直接使用 Decimal 类型的值对象作为 Dapper 查询参数
• 从数据库读取 Decimal 值时能正确转换为对应的值对象
• 保持了类型安全和业务规则验证

其他改进

• 单元测试中使用了不变文化（invariant culture）进行字符串比较，确保测试在不同区域设置下行为一致
• 文档更新，包括 Azure Functions 的使用案例和主页示例的拼写修正
• 构建工具链的依赖项更新

技术价值

Vogen 7.0.0 的这些改进体现了几个重要的技术理念：

1. 开发者体验优先：更好的错误消息和更一致的异常类型选择，让调试更高效。
2. 生态系统整合：通过增强对流行库（如 Dapper 和 System.Text.Json）的支持，降低采用门槛。
3. 国际化考虑：使用不变文化进行测试，确保全球开发团队都能获得一致的行为。

升级建议

对于现有项目，升级到 7.0.0 版本需要注意：

1. 检查是否有捕获 ValueObjectValidationException 来处理 JSON 反序列化错误的代码，需要更新异常处理逻辑。
2. 如果项目中使用了 Decimal 类型的值对象与 Dapper 交互，现在可以简化相关代码。
3. 建议全面测试值对象的序列化/反序列化行为，特别是涉及验证逻辑的部分。

Vogen 7.0.0 的这些改进进一步巩固了它作为 .NET 强类型值对象解决方案的地位，值得需要类型安全和领域建模支持的开发者考虑采用。