go语言后端开发学习(三)——基于validator包实现接口校验

简介: go语言后端开发学习(三)——基于validator包实现接口校验

前言

在我们开发模块的时候,有一个问题是我们必须要去考虑的,它就是如何进行入参校验,在gin框架的博客中我就介绍过一些常见的参数校验,大家可以参考gin框架学习笔记(四) ——参数绑定与参数验证,而这个其实也不是能够完全应对我们在日常开发中的需要,而今天我们要介绍的就是如何基于validator这个第三方库来实现对接口入参的校验,话不多说,开始发车!

validator包的下载

go get github.com/go-playground/validator/v10

validator的使用

背景介绍

在讲解validator包的使用方式之前我们先来看一个应用场景:博主最近在写自己的博客网站,而博客网站中有一个问题,我们先来看一下表结构:

type User struct {
  gorm.Model
  Username string `gorm:"type:varchar(20)" json:"username"`
  Password string `gorm:"type:varchar(100)" json:"password"`
  Role     int    `gorm:"type:int;default:2" json:"role"`
}

在博客中我设置了两种角色管理员(role=1)普通用户(role=2),而这也造成了一个问题:我们在添加用户按照正常业务情况是不能直接在前台创建管理员,而这个就需要我们在后端进行参数校验了(备注:其实参数校验这件事前后端都是要做的,但是我们这里介绍主要是后端,就以后端视角来介绍了),而接下来我们以给这个用户模块做参数校验为例,来介绍一下我们如何来实现参数校验以及一些其他的相关操作。

为数据模型添加校验条件

type User struct {
  gorm.Model
  Username string `gorm:"type:varchar(20)" json:"username" validate:"required,min=4,max=12"`
  Password string `gorm:"type:varchar(100)" json:"password" validate:"required,min=6 max=20"`
  Role     int    `gorm:"type:int;default:2" json:"role" validate:"required,gte=2"`
}

如上我们利用validate字段指明了数据的验证规则

拓展bindingvalidate的区别:

"validate"通常用于描述数据的验证规则,用于确保输入的数据符合特定的格式、要求或约束。验证通常在
数据提交之前进行,以确保数据的完整性和准确性。
而"binding"通常用于描述数据的绑定规则,用于将用户界面元素与数据模型进行关联。数据绑定确保用户输
入的数据与数据模型的字段正确地同步,使用户界面的更改能够反映在数据模型中,或反之亦然。因此,
"validate"主要关注数据的验证和校验,而"binding"主要关注数据在用户界面元素和数据模型之间的绑定
和同步

编写数据校验模块

我先示范一下数据消炎模块的书写,然后我再给大家具体讲解一下代码,首先我们来看一下最终我们所定义的User数据模型:

type User struct {
  gorm.Model
  Username string `gorm:"type:varchar(20)" json:"username" validate:"required,min=4,max=12" label:"用户名"`
  Password string `gorm:"type:varchar(100)" json:"password" validate:"required,min=6,max=20" label:"密码"`
  Role     int    `gorm:"type:int;default:2" json:"role" validate:"required,gte=2" label:"角色码"`
}

这里主要添加了两个标签:

  • validate:用来记录我们做入参验证的时候所做的限制条件
  • label:作为标记来返回标签值作为字段的名称

我们再来看校验模块的源代码:

package validator
import (
  "fmt"
  "gin_vue_blog/utils/errmsg"
  "github.com/go-playground/locales/zh_Hans_CN"
  ut "github.com/go-playground/universal-translator"
  "github.com/go-playground/validator/v10"
  "github.com/go-playground/validator/v10/translations/zh"
  "reflect"
)
func Validator(data any) (string, int) {
  validate := validator.New()
  uni := ut.New(zh_Hans_CN.New())
  trans, _ := uni.GetTranslator("zh_Hans_CN")
  err := zh.RegisterDefaultTranslations(validate, trans) // 注册翻译器
  if err != nil {
    fmt.Println("err:", err)
  }
  validate.RegisterTagNameFunc(func(field reflect.StructField) string {
    label := field.Tag.Get("label") // 获取label标签
    return label
  })
  err = validate.Struct(data)
  if err != nil {
    for _, err := range err.(validator.ValidationErrors) {
      return err.Translate(trans), errmsg.ERROR
    }
  }
  return "", errmsg.SUCCESS
}

我们可以来测试一下这段代码,效果如下:

我们可以看到我们成功实现了数据的校验功能,我们来看一下这一整个过程:

  1. 初始化valitor
validate := validator.New()
  1. 编写中间件,实现国际化
    validator中其默认的错误信息是英文,一定程度上会影响我们阅读,我们可以尝试将其转换为其他语言,这里我选择转换为简体中文:
uni := ut.New(zh_Hans_CN.New())
  trans, _ := uni.GetTranslator("zh_Hans_CN")
  err := zh.RegisterDefaultTranslations(validate, trans) // 注册翻译器
  if err != nil {
    fmt.Println("err:", err)
  }
  1. 进行数据校验并返回错误消息
err = validate.Struct(data)
if err != nil {
  for _, err := range err.(validator.ValidationErrors) {
    return err.Translate(trans), errmsg.ERROR
  }
}
return "", errmsg.SUCCESS
}

就这样我们就实现了一个通用的数据校验模块了。

相关文章
|
1天前
|
Kubernetes 监控 开发者
探索后端开发中的微服务架构实践
在现代软件开发领域,微服务架构作为一种灵活、可扩展的后端解决方案,正逐渐取代传统的单体式架构。本文将深入探讨微服务的设计理念、实施策略及其在企业级应用中的具体应用案例,旨在为读者提供一套系统的微服务实践指南。通过对比分析微服务与单体架构的性能差异,结合具体数据和案例研究,本文揭示了微服务在提高系统可维护性、可扩展性和敏捷性方面的优势。最后,文章讨论了微服务实施过程中可能遇到的挑战及解决策略,为后端开发者提供了宝贵的参考和启示。
|
1天前
|
缓存 安全 编译器
Go语言的goroutine是基于什么线程模型实现的
Go语言的goroutine是基于什么线程模型实现的?
8 3
|
2天前
|
Kubernetes 搜索推荐 开发者
探索后端开发的未来之路:微服务架构与容器化技术
随着云计算技术的不断成熟和普及,后端开发领域正经历着前所未有的变革。本文将深入探讨微服务架构和容器化技术如何重塑后端开发的面貌,提升系统的可扩展性、灵活性和可靠性。通过分析现代后端系统面临的挑战,我们将展示微服务和容器化如何提供解决方案,并预测这些技术如何塑造后端开发的未来发展。
16 3
|
2天前
|
消息中间件 监控 Kubernetes
后端开发中的微服务架构实践与挑战
在数字化时代的浪潮下,后端开发不断演化,微服务架构应运而生,成为解决复杂系统设计问题的一种新范式。本文将深入探讨微服务架构的核心概念、实施策略以及面临的主要技术挑战,同时结合具体案例分析其在实际开发中的应用效果和价值体现,旨在为后端开发人员提供一套系统的微服务实践指南和思考框架。
|
1天前
|
缓存 安全 API
后端开发中的API设计原则与实践
在数字化时代的浪潮中,后端开发作为技术架构的核心,承载着数据交互与业务逻辑的重要职责。本文深入探讨了API设计的艺术与科学,从RESTful原则到安全性考量,再到性能优化的实践策略,旨在为后端开发者提供一套全面的API设计指南。通过具体案例分析,文章揭示了良好API设计对于提升系统可维护性、扩展性和用户体验的重要性,同时指出了常见设计陷阱与应对策略,为后端开发领域的专业人士提供了宝贵的参考和启示。
12 0
|
1天前
|
敏捷开发 运维 负载均衡
探索后端开发中的微服务架构:优势与挑战
本文深入探讨了微服务架构在后端开发中的应用,分析了其设计原则、技术优势及面临的主要挑战。通过对比传统单体架构,我们揭示了微服务如何促进敏捷开发和持续交付,同时指出了在采用微服务过程中可能遇到的复杂性和治理问题。文章旨在为后端开发者提供一份微服务实践的指南,帮助他们在架构选择上做出更明智的决定。 【7月更文挑战第24天】
|
2月前
|
开发框架 安全 中间件
Go语言开发小技巧&易错点100例(十二)
Go语言开发小技巧&易错点100例(十二)
47 1
|
1月前
|
存储 Go 开发工具
go语言后端开发学习(二)——基于七牛云实现的资源上传模块
go语言后端开发学习(二)——基于七牛云实现的资源上传模块
|
1月前
|
JSON 算法 Go
go语言后端开发学习(一)——JWT的介绍以及基于JWT实现登录验证
go语言后端开发学习(一)——JWT的介绍以及基于JWT实现登录验证
|
2月前
|
缓存 负载均衡 网络协议
使用Go语言开发高性能服务的深度解析
【5月更文挑战第21天】本文深入探讨了使用Go语言开发高性能服务的技巧,强调了Go的并发性能、内存管理和网络编程优势。关键点包括:1) 利用goroutine和channel进行并发处理,通过goroutine池优化资源;2) 注意内存管理,减少不必要的分配和释放,使用pprof分析;3) 使用非阻塞I/O和连接池提升网络性能,结合HTTP/2和负载均衡技术;4) 通过性能分析、代码优化、缓存和压缩等手段进一步提升服务性能。掌握这些技术能帮助开发者构建更高效稳定的服务。