首页
/ Protovalidate v0.10.0 发布:移除废弃特性与Bazel支持增强

Protovalidate v0.10.0 发布:移除废弃特性与Bazel支持增强

2025-07-05 12:44:21作者:史锋燃Gardner

Protovalidate是一个基于Protocol Buffers的验证框架,它允许开发者通过.proto文件定义数据验证规则,并在运行时自动执行这些验证。该项目由Buf团队维护,旨在为gRPC和Protobuf生态系统提供强大的数据验证能力。

重大变更:废弃特性移除

在Protovalidate v0.10.0版本中,开发团队移除了多个已废弃的字段和枚举值,这是该版本最重要的变更。这些被移除的特性包括:

  1. FieldConstraints中的skipped字段:现在应该使用ignore = IGNORE_ALWAYS替代
  2. FieldConstraints中的ignore_empty字段:改用ignore = IGNORE_IF_UNPOPULATED
  3. Violation中的field_path字段:推荐使用结构化的field
  4. Ignore枚举中的IGNORE_EMPTY值:使用IGNORE_IF_UNPOPULATED替代
  5. Ignore枚举中的IGNORE_DEFAULT值:使用IGNORE_IF_DEFAULT_VALUE替代

这些变更虽然会带来一定的迁移成本,但有助于简化API并提高一致性。开发团队已经将这些特性标记为废弃状态一段时间,因此建议用户尽早迁移到新的替代方案。

Bazel构建系统支持增强

v0.10.0版本显著改进了对Bazel构建系统的支持:

  1. 新增了对Bzlmod的支持,这是Bazel的新模块系统
  2. 添加了Bazel中央注册表(BCR)清单
  3. 包含了Bzlmod端到端测试
  4. 将Bazel固定到8.x之前的最后一个稳定版本

这些改进使得在Bazel生态系统中使用Protovalidate更加方便和可靠,特别是对于使用较新版本Bazel的项目。

其他改进

除了上述主要变更外,该版本还包含了一些文档和工具链的改进:

  1. 修复了文档中的拼写错误和死链接
  2. 将所有conformance runner标志添加到文档中
  3. 更新了多个Go依赖项的版本
  4. 将迁移指南移至Buf文档中心

升级建议

对于现有用户,升级到v0.10.0版本前应该:

  1. 检查项目中是否使用了任何被移除的废弃特性
  2. 按照文档指引迁移到新的替代方案
  3. 如果使用Bazel构建系统,更新相关配置以利用新的Bzlmod支持

Protovalidate v0.10.0通过移除废弃特性和增强构建系统支持,为项目未来的发展奠定了更坚实的基础。这些变更虽然可能带来短期的迁移工作,但从长远来看将提高项目的可维护性和用户体验。

登录后查看全文
热门项目推荐