mongoose:nodejs上简洁的mongodb对象模型。为什么要做mongoose,当我们使用mongodb的时候,需要面对确认、投递和商务逻辑等阻力,mongoose为此做了非常大的简化,非常简洁和优美。如下所示:
var mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/test');
var Cat = mongoose.model('Cat', { name: String });
var kitty = new Cat({ name: 'Zildjian' });
kitty.save(function (err) {
if (err) {
console.log(err);
} else {
console.log('meow');
}
});
使用mongoose
首先确认已经安装了MongoDB和Node.js,下一步通过npm安装Mongoose:
$ npm install mongoose
接下来我们要做的就是MongoDB数据库的连接和连接信息的监听:
// getting-started.js
var mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/test');
var db = mongoose.connection;
db.on('error', console.error.bind(console, 'connection error:'));
db.once('open', function() {
// we're connected!
});
一旦连接被打开,回调将会被调用。我们的代码需要关注的就是在回调中进行处理。对于Mongoose,所有的数据来源于 Schema。我们需要定义自己的Schema。
var kittySchema = mongoose.Schema({
name: String
});
var Kitten = mongoose.model('Kitten', kittySchema);
对于已经定义的数据模型操作是非常简单的:
var silence = new Kitten({ name: 'Silence' });
console.log(silence.name); // 'Silence'
也可以为Schema模型定义函数:
kittySchema.methods.speak = function () {
var greeting = this.name
? "Meow name is " + this.name
: "I don't have a name";
console.log(greeting);
}
var Kitten = mongoose.model('Kitten', kittySchema);
var fluffy = new Kitten({ name: 'fluffy' });
fluffy.speak(); // "Meow name is fluffy"
如果我们期望文档存储至数据库:
fluffy.save(function (err, fluffy) {
if (err) return console.error(err);
fluffy.speak();
});
查询文档:
Kitten.find(function (err, kittens) {
if (err) return console.error(err);
console.log(kittens);
})
// 或者使用正则匹配,搜索所有文档中名称属性中包含fluff字段的,在callback返回数组结果
Kitten.find({ name: /^fluff/ }, callback);
mongoose的操作
Schema
一种以文件形式存储的数据库模型骨架,无法直接通往数据库端,也就是说它不具备对数据库的操作能力.可以说是数据属性模型(传统意义的表结构),又或着是“集合”的模型骨架.
/* 定义一个 Schema */
var mongoose = require("mongoose");
var TestSchema = new mongoose.Schema({
name : { type:String },//属性name,类型为String
age : { type:Number, default:0 },//属性age,类型为Number,默认为0
time : { type:Date, default:Date.now },
email: { type:String,default:''}
});
上面这个 TestSchema包含4个属性 [name, age, time, email]
Model
由Schema构造生成的模型,除了Schema定义的数据库骨架以外,还具有数据库操作的行为,类似于管理数据库属性、行为的类:
var db = mongoose.connect("mongodb://127.0.0.1:27017/test");
// 创建Model
var TestModel = db.model("test1", TestSchema);
test1 数据库中的集合名称, 不存在会创建.
Entity
由Model创建的实体,使用save方法保存数据,Model和Entity都有能影响数据库的操作,但Model比Entity更具操作性
var TestEntity = new TestModel({
name : "Lenka",
age : 36,
email: "lenka@qq.com"
});
console.log(TestEntity.name); // Lenka
console.log(TestEntity.age); // 36
ObjectId
存储在mongodb集合中的每个文档(document)都有一个默认的主键_id,这个主键名称是固定的,它可以是mongodb支持的任何数据类型,默认是ObjectId。
ObjectId是一个12字节的 BSON 类型字符串。按照字节顺序,依次代表:
4字节:UNIX时间戳
3字节:表示运行MongoDB的机器
2字节:表示生成此_id的进程
3字节:由一个随机数开始的计数器生成的值
Schema - 表结构
1.构造函数
new mongoose.Schema( { name:{type:String}, age:{type:Number, default:10} } )
2.添加属性
Schema.add( { name: ‘String’, email: ‘String’, age: ‘Number’ } )
3.有时候Schema不仅要为后面的Model和Entity提供公共的属性,还要提供公共的方法
Schema.method( ‘say’, function(){console.log(‘hello’);} )
//这样Model和Entity的实例就能使用这个方法了
4.添加静态方法
Schema.static( ‘say’, function(){console.log(‘hello’);} )
//静态方法,只限于在Model层就能使用
5.追加方法
Schema.methods.say = function(){console.log(‘hello’);};
//静态方法,只限于在Model层就能使用
model - 文档操作
1.构造函数, 参数1:集合名称, 参数2:Schema实例
db.model(“test1”, TestSchema );
2.查询, 参数1忽略,或为空对象则返回所有集合文档
model.find({}, callback);
model.find({},field,callback);
过滤查询,参数2: {‘name’:1, ‘age’:0} 查询文档的返回结果包含name , 不包含age.(_id默认是1)
model.find({},null,{limit:20});
过滤查询,参数3: 游标操作 limit限制返回结果数量为20个,如不足20个则返回所有.
model.findOne({}, callback);
查询找到的第一个文档
model.findById(‘obj._id’, callback);
查询找到的第一个文档,同上. 但是只接受 __id 的值查询
3.创建, 在集合中创建一个文档
Model.create(文档数据, callback))
4.更新,参数1:查询条件, 参数2:更新对象,可以使用MondoDB的更新修改器
Model.update(conditions, update, function(error)
5.删除, 参数1:查询条件
Model.remove(conditions,callback);
Entity - 文档操作
1.构造函数, 其实就是model的实例
new TestModel( { name:‘xueyou’, age:21 } );
2.创建, 在集合中创建一个文档.
Entity.save(callback);
修改器和更新器
更新修改器:
‘$inc’ 增减修改器,只对数字有效.下面的实例: 找到 age=22的文档,修改文档的age值自增1
Model.update({‘age’:22}, {’$inc’:{‘age’:1} } );
执行后: age=23
‘$set’ 指定一个键的值,这个键不存在就创建它.可以是任何MondoDB支持的类型.
Model.update({‘age’:22}, {’$set’:{‘age’:‘haha’} } );
执行后: age=‘haha’
‘$unset’ 同上取反,删除一个键
Model.update({‘age’:22}, {’$unset’:{‘age’:‘haha’} } );
执行后: age键不存在
数组修改器:
‘$push’ 给一个键push一个数组成员,键不存在会创建
Model.update({‘age’:22}, {’$push’:{‘array’:10} } );
执行后: 增加一个 array 键,类型为数组, 有一个成员 10
‘$addToSet’ 向数组中添加一个元素,如果存在就不添加
Model.update({‘age’:22}, {’$addToSet’:{‘array’:10} } );
执行后: array中有10所以不会添加
‘$each’ 遍历数组, 和 $push 修改器配合可以插入多个值
Model.update({‘age’:22}, {’$push’:{‘array’:{’$each’: [1,2,3,4,5]}} } );
执行后: array : [10,1,2,3,4,5]
‘$pop’ 向数组中尾部删除一个元素
Model.update({‘age’:22}, {’$pop’:{‘array’:1} } );
执行后: array : [10,1,2,3,4] tips: 将1改成-1可以删除数组首部元素
‘$pull’ 向数组中删除指定元素
Model.update({‘age’:22}, {’$pull’:{‘array’:10} } );
执行后: array : [1,2,3,4] 匹配到array中的10后将其删除
条件查询:
“$lt” 小于
“$lte” 小于等于
“$gt” 大于
“$gte” 大于等于
“$ne” 不等于
Model.find({“age”:{ “$get”:18 , “$lte”:30 } } );
查询 age 大于等于18并小于等于30的文档
或查询 OR:
‘$in’ 一个键对应多个值
‘$nin’ 同上取反, 一个键不对应指定值
“$or” 多个条件匹配, 可以嵌套 $in 使用
“$not” 同上取反, 查询与特定模式不匹配的文档
Model.find({“age”:{ “$in”:[20,21,22.‘haha’]} } );
查询 age等于20或21或21或’haha’的文档
Model.find({"$or" : [ {‘age’:18} , {‘name’:‘xueyou’} ] });
查询 age等于18 或 name等于’xueyou’ 的文档
类型查询:
null 能匹配自身和不存在的值, 想要匹配键的值 为null, 就要通过 “$exists” 条件判定键值已经存在
"$exists" (表示是否存在的意思)
Model.find(“age” : { “$in” : [null] , “exists” : true } );
查询 age值为null的文档
Model.find({name: {$exists: true}},function(error,docs){
//查询所有存在name属性的文档
});
Model.find({telephone: {$exists: false}},function(error,docs){
//查询所有不存在telephone属性的文档
});
正则表达式:
MongoDb 使用 Prel兼容的正则表达式库来匹配正则表达式
find( {“name” : /joe/i } )
查询name为 joe 的文档, 并忽略大小写
find( {“name” : /joe?/i } )
查询匹配各种大小写组合
查询数组:
Model.find({“array”:10} );
查询 array(数组类型)键中有10的文档, array : [1,2,3,4,5,10] 会匹配到
Model.find({“array[5]”:10} );
查询 array(数组类型)键中下标5对应的值是10, array : [1,2,3,4,5,10] 会匹配到
‘$all’ 匹配数组中多个元素
Model.find({“array”:[5,10]} );
查询 匹配array数组中 既有5又有10的文档
‘$size’ 匹配数组长度
Model.find({“array”:{"$size" : 3} } );
查询 匹配array数组长度为3 的文档
‘$slice’ 查询子集合返回
Model.find({“array”:{"$skice" : 10} } );
查询 匹配array数组的前10个元素
Model.find({“array”:{"$skice" : [5,10] } } );
查询 匹配array数组的第5个到第10个元素
where
用它可以执行任意javacript语句作为查询的一部分,如果回调函数返回 true 文档就作为结果的一部分返回
find( {"$where" : function(){
for( var x in this ){
//这个函数中的 this 就是文档
}
if(this.x !== null && this.y !== null){
return this.x + this.y === 10 ? true : false;
}else{
return true;
}
} } )
简化版本
find( {"$where" : "this.x + this.y === 10" } )
find( {"$where" : " function(){ return this.x + this.y ===10; } " } )
游标:
limit(3) 限制返回结果的数量,
skip(3) 跳过前3个文档,返回其余的
sort( {“username”:1 , “age”:-1 } ) 排序 键对应文档的键名, 值代表排序方向, 1 升序, -1降序
补充:
使用rename
db.students.update( { _id: 1 }, { $rename: { 'nickname': 'alias', 'cell': 'mobile' } } )
批量appkey改成appid
db.app.update({},{$rename:{"appkey":"appid"}},{multi:true})
参考:
http://mongoosejs.com/docs/guide.html
https://cnodejs.org/topic/548e54d157fd3ae46b233502