golang proto api 校验国际化 protovalidate

golang proto api 校验国际化 protovalidate
Photo by Scott Webb / Unsplash

众所周知,protobuf 原型文件扩展很多功能,比如生成 http 接口层代码,顺势就有了生成接口参数校验代码的需求。

早期可以使用https://github.com/bufbuild/protoc-gen-validate 来实现,通过生成特定的 go 代码的方式来实现校验。

github 中也提到目前趋于稳定,不会有更多新特性的支持,推荐大家使用新的版本 protovalidate,https://github.com/bufbuild/protovalidate 。该版本是protoc-gen-validate 的“精神继承者”。它不需要任何代码生成并支持自定义约束。

现在我们尝试新版本,并且增加国际化支持。

go get github.com/bufbuild/protovalidate-go

import "github.com/bufbuild/protovalidate-go"

syntax = "proto3";
package demo;

import "google/api/annotations.proto";
import "validate/validate.proto";

option go_package = "demo/app";

service App {
  rpc AppDetail(AppRequest) returns (AppItem) {
    option (google.api.http) = {
      get: "/app/detail",
    };
  }
}

message AppRequest {
  // 应用id
  int64 app_id = 1 [(buf.validate.field).int64 = {gt:  999}];
}

上图中的 validate/validate.proto 可以从仓库中复制下来https://github.com/bufbuild/protovalidate/tree/main/proto/protovalidate/buf/validate。不过官方可能推荐你使用他家 buf managed mode 来生成,这里就不展开了。

package app

import (
	"github.com/bufbuild/protovalidate-go"
)

func (a AppHTTPServerController) AppDetail(context *gin.Context, request *app.AppRequest) (*app.AppItem, error) {
    validator, err := protovalidate.New()
    if err != nil {
        log.Fatalf("failed to create validator: %v", err)
    }
    // 为每个约束设置中文,这里是一个 demo,需要进一步完成。
    var ruleMessages = map[string]string{
        "int64.gt": "{{.FieldName}}: 值必须要大于 {{.FieldValue}},当前值 {{.RuleValue}}",
    }

    type ErrorInfo struct {
        FieldName  string
        RuleValue  any
        FieldValue any
    }

    if err := validator.Validate(request); err != nil {
        fmt.Printf("Validation failed: %v\n", err)
        var valErr *protovalidate.ValidationError
        if ok := errors.As(err, &valErr); ok {
            for _, violation := range valErr.Violations {
                errmsg := template.Must(template.New("").Parse(ruleMessages[violation.Proto.GetConstraintId()])).
                    Execute(os.Stdout, ErrorInfo{
                        FieldName:  protovalidate.FieldPathString(violation.Proto.GetField()),
                        RuleValue:  violation.RuleValue.Interface(),
                        FieldValue: violation.FieldValue.Interface(),
                    })
                // 这里输出每个约束的信息
                fmt.Println(errmsg)
            }
        }
        return nil, err
    } else {
        fmt.Println("Validation passed!")
    }
}

输出:

🔹
app_id: 值必须要大于 100,当前值 999

网上鲜有 demo,这里仅作示例,未对任何框架做适配。

Read more

git clone 复制一个整个仓库并推送到新地址

git clone 复制一个整个仓库并推送到新地址

要使用 git clone --bare 复制一个新的仓库并推送到远程仓库,可以按照以下步骤操作: 1. 克隆一个裸仓库 首先,使用 git clone --bare 命令克隆源仓库。假设源仓库的 URL 是 https://github.com/user/source-repo.git,你可以执行以下命令: bash复制 git clone --bare https://github.com/user/source-repo.git 这将创建一个新的裸仓库(没有工作区),通常会创建一个名为 source-repo.git 的目录。 2. 进入裸仓库目录 进入刚刚克隆的裸仓库目录: bash复制 cd source-repo.git 3. 添加新的远程仓库 接下来,

By brian
搜索引擎技巧不用多,学会 3 个加速 100% 找到目标

搜索引擎技巧不用多,学会 3 个加速 100% 找到目标

在搜索时使用英文关键词,提高结果质量。尽量使用 google.com 以下搜索引擎技巧在 google.com 进行测试,效果都很好,前三个非常常用且强烈推荐。 使用精确搜索 * 建议: 使用双引号 "" 搜索完全匹配的短语,避免无关结果。 * 示例: * "Java NullPointerException" fix * 场景: 找到错误信息的精确解决方案。 利用站内搜索 * 建议: 使用 site: 限制搜索范围到特定网站。 * 示例: * site:stackoverflow.com "TypeError: undefined is not a function" * 场景: 搜索 Stack Overflow、官方文档或技术博客的特定内容。 一些关键词 * 建议:

By brian

代码 Refactoring

重构不必谈之色变。 它也不是洪水猛兽,而是开发过程中持续进行的优化过程。让我们开始学习这个主题,重新认识它的价值。 🌟整洁代码 重构的主要目的是消除技术债务。它将混乱变成整洁的代码和简单的设计。 * 对于其他程序员来说,整洁的代码是显而易见的。 我并不是在谈论超级复杂的算法。糟糕的变量命名、臃肿的类和方法、魔法数字 - 等等,所有这些都会让代码变得混乱和难以理解。 * 整洁的代码不包含重复。 每次你需要对重复的代码进行更改时,你都必须记住对每个实例进行相同的更改。这会增加认知负担并减慢进度。 * 整洁的代码包含最少数量的类和其他活动部件。 代码越少,脑子里需要记住的东西就越少。代码越少,维护工作就越少。代码越少,错误就越少。代码就是责任,保持代码简短。 * 整洁的代码通过所有测试。 如果只有 95% 的测试通过,你就知道代码不整洁。如果测试覆盖率为 0%,你就知道你完蛋了。 * 整洁的代码维护成本低! 🗑️技术债(What) 每个人都尽最大努力从头开始编写出色的代码。可能没有程序员会故意编写不干净的代码,从而损害项目。但是干净的代码在什么时

By brian
沪ICP备2022013452号-1