Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

相关文档

Children Display
alltrue
excerptTypesimple

多数据校验 - CheckMap

多数据校验即支持同时对多条数据进行校验,需要给定校验规则,并且可以自定义出错时的错误信息。 其中比较重要且复杂的是校验规则参数的定义。

校验方法: https://pkg.go.dev/github.com/gogf/gf/v2/util/gvalid

Code Block
languagego
func CheckMap(ctx context.Context, params interface{}, rules interface{}, messages ...CustomMsg) Error
  1. 其中params参数支持任意 map 数据类型。
  2. rules参数支持 []string / map[string]string 数据类型,前面一种类型支持返回校验结果顺序,后一种不支持(因为map是无序的)。
  3. rules参数中的 map[string]string 是一个二维的关联数组/哈希表,第一维键名为参数键名,第二维为带有错误的校验规则名称,键值为错误信息。
  4. messages参数为自定义的错误信息,为非必需参数,类型为CustomMsgmap[string]interface{})具体使用请参考后续示例。

默认错误提示

Code Block
languagego
package main

import (
	"context"

	"github.com/gogf/gf/frame/g"
	"github.com/gogf/gf/util/gvalid"
)

func main() {
	params := map[string]interface{}{
		"passport":  "",
		"password":  "123456",
		"password2": "1234567",
	}
	rules := map[string]string{
		"passport":  "required|length:6,16",
		"password":  "required|length:6,16|same:password2",
		"password2": "required|length:6,16",
	}
	err := gvalid.CheckMap(context.TODO(), params, rules)
	// 也可以使用链式操作
	// err := g.Validator().Rules(rules).CheckMap(params)
	if err != nil {
		g.Dump(err.Maps())
	}
}

执行后,终端输出:

Code Block
languagejs
{
    "passport": {
            "length": "The passport value length must be between 6 and 16",
            "required": "The passport field is required"
    },
    "password": {
            "same": "The password value must be the same as field password2"
    }
}

自定义错误提示

Code Block
languagego
package main

import (
	"context"

	"github.com/gogf/gf/frame/g"
	"github.com/gogf/gf/util/gvalid"
)

func main() {
	params := map[string]interface{}{
		"passport":  "",
		"password":  "123456",
		"password2": "1234567",
	}
	rules := map[string]string{
		"passport":  "required|length:6,16",
		"password":  "required|length:6,16|same:password2",
		"password2": "required|length:6,16",
	}
	messages := map[string]interface{}{
		"passport": "账号不能为空|账号长度应当在:min到:max之间",
		"password": map[string]string{
			"required": "密码不能为空",
			"same":     "两次密码输入不相等",
		},
	}
	err := gvalid.CheckMap(context.TODO(), params, rules, messages)
	// 也可以使用链式操作
	// err := g.Validator().Messages(messages).Rules(rules).CheckMap(params)
	if err != nil {
		g.Dump(err.Maps())
	}
}

该示例同时也展示了messsages自定义错误信息传递的两种数据类型,string或者map[string]string。其中map[string]string类型参数需要指定对应字段、对应规则的错误提示信息,是一个二维的“关联数组”。该示例执行后,终端输出:

Code Block
languagejs
{
    "passport": {
            "length": "账号长度应当在6到16之间",
            "required": "账号不能为空"
    },
    "password": {
            "same": "两次密码输入不相等"
    }
}
Panel
titleContent Menu
toc