protoc-go-inject-tag 使用教程

protoc-go-inject-tag 使用教程

项目地址:https://gitcode.com/gh_mirrors/pr/protoc-go-inject-tag

项目介绍

protoc-go-inject-tag 是一个用于在生成的 Go 结构体中注入自定义标签的工具。在使用 Protocol Buffers(protobuf)生成 Go 代码时,默认情况下生成的结构体标签是固定的,无法灵活设置。protoc-go-inject-tag 工具允许开发者在生成的 Go 文件中注入自定义的标签,从而提高代码的灵活性和可维护性。

项目快速启动

安装

首先,确保你已经安装了 protocprotoc-gen-go。然后安装 protoc-go-inject-tag

go install github.com/favadi/protoc-go-inject-tag@latest

使用示例

  1. 编写 .proto 文件
syntax = "proto3";
package pb;
option go_package = "/pb";

message IP {
  // @gotags: valid:"ip"
  string Address = 1;
}
  1. 生成 Go 代码
protoc --go_out=. test.proto
  1. 注入自定义标签
protoc-go-inject-tag -input=./pb/test.pb.go

生成的 test.pb.go 文件中的 IP 结构体将包含自定义标签:

type IP struct {
  Address string `protobuf:"bytes,1,opt,name=Address" json:"Address,omitempty" valid:"ip"`
}

应用案例和最佳实践

应用案例

假设你正在开发一个需要验证 IP 地址的 API,你可以使用 protoc-go-inject-tag 来添加自定义的验证标签:

syntax = "proto3";
package pb;
option go_package = "/pb";

message IP {
  // @gotags: valid:"ip"
  string Address = 1;
}

生成的 Go 代码将包含 valid:"ip" 标签,方便进行 IP 地址验证。

最佳实践

  1. 保持一致性:在项目中统一使用 @gotags 注释来添加自定义标签。
  2. 文档化:在 .proto 文件中添加注释,说明每个字段的用途和自定义标签的含义。
  3. 自动化:将 protoc-go-inject-tag 集成到构建脚本中,确保每次生成代码时都能自动注入标签。

典型生态项目

protoc-go-inject-tag 是 Protocol Buffers 生态系统中的一个实用工具。以下是一些相关的生态项目:

  1. protoc-gen-go:用于生成 Go 代码的 Protocol Buffers 插件。
  2. protoc-gen-validate:用于在生成的 Go 代码中添加字段验证的插件。
  3. grpc-go:Go 语言的 gRPC 实现,与 Protocol Buffers 紧密集成。

通过这些工具和插件,可以构建一个完整的、高效的、可维护的 Go 服务端应用。

protoc-go-inject-tag Inject custom tags to protobuf golang struct 项目地址: https://gitcode.com/gh_mirrors/pr/protoc-go-inject-tag

你可能感兴趣的:(protoc-go-inject-tag 使用教程)