gf框架之gvalid - 强大灵活的数据校验/表单校验模块

gf提供了非常强大易用的数据校验功能,通过gvalid包提供,封装了40种常用的校验规则,支持单数据多规则校验、多数据多规则批量校验、自定义错误信息、自定义正则校验等特性。由于gf是模块化、低耦合设计,gvalid包也可以在项目中单独引入使用。

使用方式:

校验规则

40种常用的校验规则:

校验方法

校验方法列表:

Check*方法只有在返回nil的情况下,表示数据校验成功,否则返回校验出错的数据项(CheckMap)以及对应的规则和错误信息的map。SetDefaultErrorMsgs方法用于批量设置默认的错误提示。默认错误提示如下:

使用示例

下面我们来举几个例子,看看如何使用gvalid来实现数据校验。

单数据校验

1、校验数据长度,使用默认的错误提示

2、校验数据类型及大小,并且使用自定义的错误提示

可以看到,多个规则以及多个自定义错误提示之间使用英文“|”号进行分割,注意自定义错误提示的顺序和多规则的顺序一一对应。msgs参数除了支持string类型以外,还支持map[string]string类型,请看以下例子:

3、使用自定义正则校验数据格式,使用默认错误提示

多数据校验

1、多数据多规则校验,使用默认错误提示

2、多数据多规则校验,使用自定义错误提示

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

 

 

Leave a Reply

Your email address will not be published.