mongoose是专门为node.js设计的mongoDb对象模型。
如果我们想在应用中使用mongoose,首先需要安装mongoose,然后将其包含到我们的项目中,并使用mongoose连接到我们的数据库。
$ npm install mongoose
var mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/test');
mongoose是基于schema的,每一个schema对应mongoDb数据库中的一个集合,并且定义了集合中文档的结构。
var Schema = mongoose.Schema;
var blogSchema = new Schema({
title: String,
author: String,
body: String,
comments: [{ body: String, date: Date }],
date: { type: Date, default: Date.now },
hidden: Boolean,
meta: {
votes: Number,
favs: Number
}
});
我们需要将我们定义的schema编译为模型,模型的每一个实体代表集合中的一条文档,我们可以使用模型来新增和查询集合中文档。
var Blog = mongoose.model('Blog', blogSchema);
model方法的第一个参数是单数形式的集合名称,也就是说mongoose会自动将模型Blog映射到mongoDb的blogs集合。文档是模型的实体,下面我们使用Blog模型来创建文档,并保存到mongoDb的blog集合中。
var bloga = new Blog({
title: 'mongoose introduction',
author: 'xiaocun',
body: 'mongoose is elegant mongodb object modeling for nede.js'
});
bloga.save(function(err) {
if (err) return handleError(err);
// saved!
})
我们可以使用模型来查找集合中的文档,mongoose提供了find()、findById()、findOne()等方法来方便我们查询。查询可以有两种形式,当我们传递回调函数到查询方法中时,查询结束之后会立即执行回调函数,并将查询结果传入回调函数中。
Blog.find({ title: 'mongoose', author: 'xiaocun' }, function (err, blogs) {
if (err) return handleError(err);
//operation
})
如果没有传递回调函数,会返回一个Query对象。
var query = Blog.find({ title: 'mongoose'});
同样,我们可以通过链接语法构建我们的查询,以下两个查询等价。
// With a JSON doc
Blog.
find({
title: /mongoose/,
author: 'xiaocun'
}).
limit(10).
sort({ date: -1 }).
select({ title: 1, comments: 1 }).
exec(callback);
// Using query builder
Blog.
find({ title: /mongoose/ }).
where('author').equals('xiaocun').
limit(10).
sort('-date').
select('title comments').
exec(callback);
模型有一个静态方法remove()来删除所有符合查询条件的文档。
Blog.remove({ title: 'mongoose introduction' }, function (err) {
if (err) return handleError(err);
// removed!
});
模
型有一个update()方法来帮助我们修改集合中的数据,但是update()方法并不返回修改后的结果,如果我们需要程序返回修改后的结果,可以使用findOneAndUpdate()。
Blog.update({ name: 'mongoose introduction' }, { $set: { name: 'mongoose start' } }, { multi: true }, function (err, raw) {
if (err) return handleError(err);
console.log('The raw response from Mongo was ', raw);
});
Blog.findOneAndUpdate({ name: 'mongoose introduction' }, { $set: { name: 'mongoose start' } }, { new: true }, function (err, doc, raw) {
if (err) return handleError(err);
console.log('The document after modified is ', doc);
console.log('The raw response from Mongo was ', raw);});