orm2 中文文档 3.2 模型验证器

朴灿烈づ我的快乐病毒、 2022-04-25 04:08 104阅读 0赞

> 译者：[飞龙][Link 1]
> 
> 来源：[Model Validations][]

[Enforce][]模块用于验证数据。对于使用以前的验证器的用户，还可以继续使用，它们中的一部分整合到了enforce，剩余部分还没有。推荐你开始使用`orm.enforce`来取代`orm.validators`。可用的验证器的列表请见[node-enforce][]。

`unique`验证器也构建于ORM中，可以这样来访问：

name: orm.enforce.unique("name already taken!")
    name: orm.enforce.unique({ scope: ['age'] }, "Sorry, name already taken for this age group")
    name: orm.enforce.unique({ ignoreCase: true }) // 'John' is same as 'john' (mysql is case insensitive by default)

你可以为模型的每个属性定义验证器。对于每个属性，你可以定义一个或多个验证器。你也可以使用预定义的验证器，或者自己新建。

var Person = db.define("person", {
        name : String,
        age  : Number
    }, {
        validations : {
            name : orm.enforce.ranges.length(1, undefined, "missing"), // "missing" is a name given to this validation, instead of default
            age  : [ orm.enforce.ranges.number(0, 10), orm.enforce.lists.inside([ 1, 3, 5, 7, 9 ]) ]
        }
    });

上面的代码限定了`name`的长度必须在1和undefined之间（undfined表示任意值），以及`age`必须在0和10（闭区间）之间，而且是列出的值之一。这个例子或许没有意义，但是足够解释了。

保存一个对象的时候，如果由任何一个验证器验证失败，你都会得到一个带有属性名称和验证错误描述的`error`对象。这个描述可以帮助你弄清楚发生了什么。

var John = new Person({
        name : "",
        age : 20
    });
    John.save(function (err) {
        // err.field = "name" , err.value = "" , err.msg = "missing"
    });

在第一个验证器验证失败之后，验证就停止了。如果你想要验证每个属性并且返回所有验证错误，你可以在全局或局部设置中更改这一行为：

[Link 1]: https://github.com/wizardforcel
[Model Validations]: https://github.com/dresende/node-orm2/wiki/Model-Validations
[Enforce]: http://github.com/dresende/node-enforce
[node-enforce]: https://github.com/dresende/node-enforce