Mongoose是MongoDB的一个对象模型工具
同时它也是针对MongoDB操作的一个对象模型库,封装了MongoDB对文档的的一些增删改查等常用方法
让NodeJS操作Mongodb数据库变得更加灵活简单
Mongoose因为封装了MongoDB对文档操作的常用方法,可以高效处理mongodb,还提供了类似Schema的功能,如hook、plugin、virtual、populate等机制。
官网 mongoosejs
$ npm install mongoose
使用mongoose
var mongoose = require('mongoose');
var connection = mongoose.createConnection("mongodb://127.0.0.1/test");
connection.on('error', function (error) {
console.log('数据库连接失败: ' + error);
});
connection.on('open', function (error) {
console.log('数据库连接成功');
});
Schema是数据库集合的模型骨架 定义了集合中的字段的名称和类型以及默认值等信息
var personSchema = new Schema({
name:String, //姓名
binary:Buffer,//二进制
living:Boolean,//是否活着
birthday:Date,//生日
age:Number,//年龄
_id:Schema.Types.ObjectId, //主键
_fk:Schema.Types.ObjectId, //外键
array:[],//数组
arrOfString:[String],//字符串数组
arrOfNumber:[Number],//数字数组
arrOfDate:[Date],//日期数组
arrOfBuffer:[Buffer],//Buffer数组
arrOfBoolean:[Boolean],//布尔值数组
arrOfObjectId:[Schema.Types.ObjectId]//对象ID数组
nested:{ //内嵌文档
name:String,
}
// 如果说对象中的字段在Schema中没有,则会被忽略
// 如说说对象中的字段少于Schema中的字段,则缺少的字段不会被保存,或者保存Schema中的默认值
// 存储的字段和Schema中定义的类型不同,回报错
let p = new Person();
p.name= 'leo';
p.age = 25;
p.birthday = new Date();
p.married = false;
p.mixed= {any:{other:'other'}};
p._otherId = new mongoose.Types.ObjectId;
p.hobby.push('smoking');
p.ofString.push('string');
p.ofNumber.pop(3);
p.ofDates.addToSet(new Date);
p.ofBuffer.pop();
p.ofMixed = ['anything',3,{name:'leo'}];
p.nested.name = 'leo';
Model是由通过Schema构造而成 除了具有Schema定义的数据库骨架以外,还可以操作数据库 如何通过Schema来创建Model呢,如下:
//连接数据库
mongoose.connect("mongodb://123.57.143.189:27017/test");
//两个参数表示定义一个模型
var PersonModel = mongoose.model("Person", PersonSchema);
// 如果该Model已经定义,则可以直接通过名字获取
var PersonModel = mongoose.model('Person');//一个参数表示获取已定义的模型
// 拥有了Model,我们也就拥有了操作数据库的能力 在数据库中的集合名称等于 模型名转小写再转复数,比如
// Person>person>people,Child>child>children
// Model 是模型,操作的是猪哥哥集合
通过Model创建的实体,它也可以操作数据库 使用Model创建Entity,如下示例:
var personEntity = new PersonModel({
name : "leo",
age : 6
});
//Schema生成Model,Model创造Entity,Model和Entity都可对数据库操作,但Model比Entity可以实现的功能更多
// Entity 操作的是自己本身,不会对整个集合处理
let mongoose = require("mongoose");
mongoose.connect("mongodb://127.0.0.1:27017/persons");
let PersonSchema = new mongoose.Schema({
name: {type: String},
age: {type: Number, default: 0}
});
let PersonModel = mongoose.model("Person", PersonSchema);
let PersonEntity = new PersonModel({
name: "leo",
age: 6
});
// 使用回调的方式接收参数
PersonEntity.save(function (error, doc) {
if (error) {
console.log("error :" + error);
} else {
//doc是返回刚存的person对象
console.log(doc);
}
});
// 使用promise
PersonEntity.save()
.then(doc => {
//doc是返回刚存的person对象
console.log(doc);
}, err => {
console.log('err', err)
})
语法: Model.find(查询条件,callback);
//
// 代码
Model.find({},function(error,docs){
//若没有向find传递参数,默认的是显示所有文档
});
Model.find({ "age": 6 }, function (error, docs) {
if(error){
console.log("error :" + error);
}else{
console.log(docs); //docs: age为6的所有文档
}
});
语法: Model.create(文档数据, callback))
PersonModel.create({ name:"leo", age:7}, function(error,doc){
if(error) {
console.log(error);
} else {
console.log(doc);
}
});
语法: Entity.save(callback))
let PersonEntity = new PersonModel({name:"leo",age: 9});
PersonEntity.save(function(error,doc) {
if(error) {
console.log(error);
} else {
console.log(doc);
}
});
语法: Model.update(查询条件,更新对象,callback);
let conditions = {name : 'leo'};
let update = {$set : { age : 100 }};
PersonModel.update(conditions, update, function(error){
if(error) {
console.log(error);
} else {
console.log('Update success!');
}
});
// 请注意如果匹配到多条记录,默认只更新一条,如果要更新匹配到的所有记录的话需要加一个参数 {multi:true}
语法: Model.remove(查询条件,callback);
var conditions = { name: 'leo' };
PersonModel.remove(conditions, function(error){
if(error) {
console.log(error);
} else {
console.log('Delete success!');
}
});
PersonModel.create([
{ name: "leo1", age: 1 },
{ name: "leo2", age: 2 },
{ name: "leo3", age: 3 },
{ name: "leo4", age: 4 },
{ name: "leo5", age: 5 },
{ name: "leo6", age: 6 },
{ name: "leo7", age: 7 },
{ name: "leo8", age: 8 },
{ name: "leo9", age: 9 },
{ name: "leo10", age: 10 }
], function (error, docs) {
if (error) {
console.log(error);
} else {
console.log('save ok');
}
});
语法: find(Conditions,field,callback)
//field省略或为Null,则返回所有属性。
//返回只包含name、age两个键的所有记录
Model.find({},{name:1, age:1, _id:0},function(err,docs){
//docs 查询结果集
})
// 我们只需要把显示的属性设置为大于零的数就可以,当然1是最好理解的,id是默认返回,如果不要显示加上("id":0)
findOne(查询单条)
与find相同,但只返回单个文档,也就说当查询到即一个符合条件的数据时,将停止继续查询,并返回查询结果
语法:findOne(Conditions,callback)
TestModel.findOne({ age: 6}, function (err, doc){
// 查询符合age等于6的第一条数据
// doc是查询结果
});
findById(按ID单条数据),
与findOne相同,但它只接收文档的_id作为参数,返回单个文档 语法
语法: findById(_id, callback)
PersonModel.findById(person._id, function (err, doc){
//doc 查询结果文档
});
查询时我们经常会碰到要根据某些字段进行条件筛选查询,比如说Number类型,怎么办呢,我们就可以使用 g t ( > ) 、 gt(>)、 gt(>)、lt(<)、 l t e ( < = ) 、 lte(<=)、 lte(<=)、gte(>=)操作符进行排除性的查询,如下示例:
Model.find({"age":{"$gt":6}},function(error,docs){
//查询所有nage大于6的数据
});
Model.find({"age":{"$lt":6}},function(error,docs){
//查询所有nage小于6的数据
});
Model.find({"age":{"$gt":6,"$lt":9}},function(error,docs){
//查询所有nage大于6小于9的数据
});
$ne(!=)操作符的含义相当于不等于、不包含,查询时我们可通过它进行条件判定,具体使用方法如下:
Model.find({ age:{ $ne:6}},function(error,docs){
//查询age不等于6的所有数据
});
和 n e 操 作 符 相 反 , ne操作符相反, ne操作符相反,in相当于包含、等于,查询时查找包含于指定字段条件的数据
Model.find({ age:{ $in: 6}},function(error,docs){
//查询age等于6的所有数据
});
Model.find({ age:{$in:[6,7]}},function(error,docs){
//可以把多个值组织成一个数组
});
可以查询多个键值的任意给定值,只要满足其中一个就可返回,用于存在多个条件判定的情况下使用,如下示例:
Model.find({"$or":[{"name":"leo"},{"age":6}]},function(error,docs){
//查询name为leo或age为6的全部文档
});
$exists操作符,可用于判断某些关键字段是否存在来进行条件查询。如下示例:
Model.find({name: {$exists: true}},function(error,docs){
//查询所有存在name属性的文档
});
Model.find({email: {$exists: false}},function(error,docs){
//查询所有不存在email属性的文档
});
可以限制结果的数量,跳过部分结果,根据任意键对结果进行各种排序
所有这些选项都要在查询被发送到服务器之前指定
在查询操作中,有时数据量会很大,这时我们就需要对返回结果的数量进行限制 那么我们就可以使用limit函数,通过它来限制结果数量。
语法: find(Conditions,fields,options,callback);
Model.find({},null,{limit:20},function(err,docs){
console.log(docs);
});
// 如果匹配的结果不到20个,则返回匹配数量的结果,也就是说limit函数指定的是上限而非下限
skip函数的功能是略过指定数量的匹配结果,返回余下的查询结果 如下示例:
语法: find(Conditions,fields,options,callback);
Model.find({},null,{skip:4},function(err,docs){
console.log(docs);
});
// 上述查询,如果查询结果数量中少于4个的话,则不会返回任何结果。
sort函数可以将查询结果数据进行排序操作 该函数的参数是一个或多个键/值对 键代表要排序的键名,值代表排序的方向,1是升序,-1是降序
语法: find(Conditions,fields,options,callback)
Model.find({},null,{sort:{age:-1}},function(err,docs){
//查询所有数据,并按照age降序顺序返回数据docs
});
sort函数可根据用户自定义条件有选择性的来进行排序显示数据结果。
Model('User').find({})
.sort({createAt:-1})
.skip((pageNum-1)*pageSize)
.limit(pageSize)
.populate('user')
.exec(function(err,docs){
console.log(docs);
});
populate
pupulate 填充的意思,把集合文档中的一个外链转换成对应的文档,将对应的外键转换为对象
下边是栗子:
var mongoose = require('mongoose');
//连接数据库
mongoose.connect('mongodb://localhost:27017/201606blog');
//定义课程Schema
var CourseSchema = new mongoose.Schema({
name:String
});
var CourseModel = mongoose.model('Course',CourseSchema);
var PersonSchema = new mongoose.Schema({
name:{
type:String,
required:true
},
// 外键 别的集合的主键
course:{
type:mongoose.Schema.Types.ObjectId,
ref:'Course' //指明此外键是哪个集合中的外键
}
});
var PersonModel = mongoose.model('Person',PersonSchema);
// 保存数据
CourseModel.create({name:'node.js'},function(err,course){
PersonModel.create({name:'leo',course:course._id},function(err,doc){
console.log(doc);
PersonModel.findById(doc._id).populate('course').exec(function(err,doc){
console.log(doc);
})
})
});
// 查询
PersonModel.findOne({name: 'leo'})
.populate({
path: 'course',
})
.exec(function (err, data) {
console.log(data);
})