Go语言ProtoBuf验证器编译器 - 简洁高效的协议缓冲区验证解决方案

最新推荐文章于 2024-09-22 07:07:37 发布

谢忻含Norma

最新推荐文章于 2024-09-22 07:07:37 发布

阅读量425

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00065/article/details/138894101

Go语言ProtoBuf验证器编译器 - 简洁高效的协议缓冲区验证解决方案

项目地址:https://gitcode.com/gh_mirrors/go/go-proto-validators

在软件开发中，数据验证是不可或缺的一环，尤其在处理RPC通信和序列化时更是如此。为此，我们向您推荐一个强大的开源项目——Golang ProtoBuf Validator Compiler。这是一个为你的Go语言protobuf结构体自动生成Validate() error函数的protoc插件，基于字段选项在.proto文件中定义验证规则，无需依赖反射进行深度消息检查，从而提供更好的性能。

项目介绍

Golang ProtoBuf Validator Compiler允许您在.proto文件中直接定义数据验证规则，并生成相应的Go代码，这些代码将帮助您执行高效且易于理解的验证操作。它支持Go 1.11至1.13版本，以及Protobuf、Go Protobuf和Gogo Protobuf的特定版本。此外，该项目还带回了proto3中缺失的required关键字，以确保必需字段的存在性。

技术分析

项目的核心在于使用protobuf的字段选项来指定验证规则，如范围限制、正则表达式等。通过protoc-gen-govalidators插件，这些规则被编译成易于阅读和使用的Go代码。当进行验证时，如果数据不符合规则，将会返回具体的错误信息。

例如，以下是一个.proto文件片段：

message InnerMessage {
  int32 some_integer = 1 [(validator.field) = {int_gt: 0, int_lt: 100}];
  double some_float = 2 [(validator.field) = {float_gte: 0, float_lte: 1}];
}

这将生成如下的Go代码：

func (this *InnerMessage) Validate() error {
  ...
  if !(this.SomeInteger > 0) {
    return fmt.Errorf("validation error: InnerMessage.SomeInteger must be greater than '0'")
  }
  if !(this.SomeInteger < 100) {
    return fmt.Errorf("validation error: InnerMessage.SomeInteger must be less than '100'")
  }
  ...
}

这种设计使得验证逻辑清晰易读，错误信息也具有可读性。