饮半盏湖水,当知江河滋味;拾一片落叶,尽享人间秋凉。
Mongoose是基于Node和MongoDB的高级ORM类库,典型的ORM是现代软件工程至关重要的一部分。Mongoose能从数据库提取任何信息,应用代码只通过对象及其方法进行交互。ORM允许指定不同类型对象之间的关系,也可将业务逻辑放入类在红。
Mongoose拥有内置验证和类型转换的功能,可根据需求进行扩展和定制。当Mongoose与Express相遇,Mongoose使栈真正附着在MVC的概念中。
我们可以把mongoose当做独立的MongoDB库来使用
var mongoose = require('mongoose')
mongoose的请求是异步的,连接数据库服务器时无需等待连接建立完成,而原生驱动则需回调来实现。
mongoose.connect(uri[s], [options], [callback])
连接URL遵循标准格式
mognodb://username:password@host:port/database
相比Mongoskin以及其他轻量级MongoDB类库,Mongoose有一个明显的区别,就是用model()并传入一个首字母大写的模型变量名和一个原型来创建模型。
var User = mongoose.model('User', {name:String});
配置完成后即可实例化文档对象
var user = new User({name:'junchow'});
Mongoose的文档对象拥有非常方便的内置方法,但这些方法仅适用这个文档对象本身,并不适用于整个集合或模型。文档对象与模型的区别是,文档对象是模型的一个实例,模型是抽象的,类似MongoDB集合,它由原型、方法、属性组成,并呈现为一个Node的类。Mongoose中的集合很像Mongoskin或原生驱动中的集合。严格来说,模型、集合、文档是不同的Mongoose类。通常我们不会直接使用Mongoose的集合,只会使用模型对数据进行操作。
user.save(function(err,doc){
if(err==null){
console.error(err);
process.exit(1);
}else{
console.log(doc);
process.exit(0);
}
});
Mongoose的原型
原型是一个JSON格式的类,它包含关于文档的类型、属性等信息。如果需要也可存储一些验证信息和默认值。它还可包含一些业务逻辑以及其他重要信息,简单来讲,原型可作为文档的蓝图。
模型创建时需要原型,即原型被发布为模型。在使用模型的属性前,需要先定义它们的原型。Mongoose会忽略那些没有在模型中定义的属性。
var userSchema = mongoose.Schma({
name:String
})
Mongoose原型支撑的数据类型包括
- String 标准JS/Node字符串类型,一个字符的序列。
- Number 标准JS/Node数字类型
- Boolean 标准JS/Node布尔类型,真假值。
- Buffer Node的二进制类型,如图像、档案、PDF等。
- Date ISO标准格式化日期,UTC标准格林威治时间。
- Array 标准JS/Node数组类型
- Schema.Types.ObjectId MongoDB典型24字符12字节的16进制的数字字符串
_id主键可用来对文档按时间排序,它可使用 Schema.Types 或 mogoose.Schema.Types 来调取。 - Schema.Types.Minxed 任何类型的数据,混合类型,灵活的类型
对于混合类型的对象,Mongoose并不理会它的更改,所以在保存对象前要调用 markModified() 来确保混入部分的更改是连续的。
var ObjectId = mogoose.Schema.Types.ObjectId;
var Mixed = mongoose.Schema.Type.Mixed;
var bookSchema = mongoose.Schema({
name:String,
created_at:Date,
updated_at:{type:Date, default:Date.now},
published:Boolean,
authorId:{type:ObjectId, required:true},
description:{type:String, default:null},
description:{body:String, image:Buffer},
keywords:{type:[String], default:[]},
active:{type:Boolean, default:false},
version:{type:Number, default:function(){return 1;}},
notes:Mixed,
contributes:[ObjectId]
})
Mongoose 可创建自定义类型,Mongoose 的原型是可以自定义插件的,则意味着通过创建插件可将某些功能扩展到当前应用的所有原型中。为了更好地组织和复用代码,在原型中可创建静态方法和实例方法,开发插件,定义钩子等。
使用钩子保持清晰的代码逻辑
在复杂的、拥有很多相关联对象的应用中,在保存一个对象之前我们会想执行某些特定的逻辑。钩子(Hooks)是存储这些逻辑的好地方。钩子和方法必须在原型编译成模型之前加入,即调用mongoose.model()之前。
想在保存book文档前上传一个PDF
bookSchema.pre('save', function(next){
//todo: 准备保存
//todo: 上传PDF
return next();
});
想在删除book文档前确定对于该文档没有其他待处理的请求
bookSchema.pre('remove', function(next){
//todo 准备删除
return next();
});
自定义静态方法和实例方法
除了内建的Mongoose模型方法外,可增加一些自定义的方法。
bookSchema.method({
buy:function(quantity, customer,callback){
var purchase = this;
//todo 创建购买订单和顾客发货单
return callback(result);
},
refund:function(customer,callback){
//todo 退款处理
return callback(result);
}
})
当没有或无需一个特定的文档对象时,静态方法就非常有用。
bookSchema.static({
getZeroInventoryReport:function(callback){
//todo 查找所有零件库的书籍
return callback(books);
},
getCountOfBooksById:function(bookId,callback){
//todo 通过书籍ID查找读书的剩余数量
return callback(count);
}
})
Mongoose模型
Mongoose中模型是最基础的对象,将原型编译为一个模型。
var model = mongoose.model(name, schema)
Mongoose模型的静态方法
- Model.create(data, [callback(error, doc)])
创建一个新的Mongoose文档并保存到数据库 - Model.remove(query, [callback(error)])
删除集合中与查询条件匹配的文档,当完成时调用带error参数的回调函数。 - Model.find(query, [fields], [options], [callback(error,docs)])
查找与查询条件匹配(JSON对象)的文档