一句話來概括:
把校驗函數(shù)(校驗器)官脓,在Schema中完成注冊,并在鉤子中進行調(diào)用孕暇,使用復雜的Error包裝校驗結(jié)果,在CRUD的回調(diào)中由用戶決定如何處理的校驗框架芭商。
一搀缠、校驗器
是一個返回boolean的函數(shù)近迁,形式如下:
function validateName(v) {
return /\d{3}-\d{3}-\d{4}/.test(v);
}
function validateCreated(v) {
return [true|false]
}
兩種校驗器:
- built-in validator
- custom validator(以上的校驗器,為custom validator)
二鉴竭、校驗器的注冊:
- built-in validator
var breakfastSchema = new Schema({
eggs: {
type: Number,
min: [6, 'Too few eggs'],
max: 12
},
bacon: {
type: Number,
required: [true, 'Why no bacon?']
},
drink: {
type: String,
enum: ['Coffee', 'Tea'],
required: function() {
return this.bacon > 3;
}
}
});
- custom validator
var userSchema = new Schema({
phone: {
type: String,
validate: {
validator: function(v) {
return /\d{3}-\d{3}-\d{4}/.test(v);
},
message: props => `${props.value} is not a valid phone number!`
},
required: [true, 'User phone number required']
}
});
三搏存、校驗的時機
在schema的pre hook的回調(diào)函數(shù),使用校驗器,以下是我完成的示意代碼(實際使用時璧眠,需要進行遞歸式校驗)
var toySchema = new Schema({ name: String, created: Date });
toySchema.pre('save', function(next) {
var err=new MogooseError();
if(!validateName(this.name)) err.errors.name=new MongooseError({msg:'xxx'});
if(!validateCreated(this.created)) err.errors.created=new MongooseError({msg:'xxx'});
if(err.errors===null) next(); //通過
throw err;//未通過
});
四袁滥、校驗未通過的處理
- 如果校驗通過時,則執(zhí)行save操作(添加或更新)题翻。
- 如果校驗沒有通過時腰鬼,則上面的“MongooseError”對象,將會出現(xiàn)在回調(diào)函數(shù)的第一個參數(shù)或promise的reject的參數(shù)上熄赡。
五、Error的結(jié)構(gòu)分析
構(gòu)造器: mongoose.Error指向的函數(shù)初家,其名稱為:MongooseError。
error對象的name:
(1)name: ValidationError溜在,此時表明校驗的對象是由Schema定義的Model產(chǎn)生的對象(簡單說:是document對象)。
(2)name: CastError掖肋,此時表明檢驗的對象是簡單JS對象或原生數(shù)據(jù)類型(簡單說:是非document對象)ValidationError對象:
即name是ValidationError的MongooseError對象。
它會有一個errors引用沿盅,其指向到一個Object纫溃,未通過校驗的field會以fieldName掛載到errors上,
(1)并指向到一個CastError對象(name是castError的ValidationError)紊浩。
(2)如果field的類型是document時,會指向到一個ValidationError對象(其包含一個errors费彼,如此遞歸口芍,最終指向到一個CastError)箍铲。CastError對象:
即name是CastError的MongooseError對象鬓椭,其屬性如下:
(1)message: String類型的信息。
(2)value: 當前值
(3)kind: 在schema中定義的類型