Node.js的MongoDB驱动Mongoose基本使用教程
使用mongoose可以让我们更好使用mongodb数据库,而不需要写繁琐的业务逻辑。
安装
npminstallmongoose
初始化使用
使用mongoose前,需安装node和mongodb,这里不讲node和mongodb的安装方法。
varmongoose=require("mongoose"); varSchema=mongoose.Schema; vardb=mongoose.connection; mongoose.connect('mongodb://localhost/animal'); db.on('error',console.error); db.once('open',function(){ //这里建立模式和模型 }
快速入门
在mongoose中,所有的数据都是一种模式,每个模式都映射到mongodb的集合,并且定义该集合文件结构。
//这里建立一个动物的模式,所有动物都拥有这个模式下的所有属性 varanimalSchema=newSchema({ name:String, age:Number, });
模型是我们从Schema中定义的一种多样化的构造函数,模型的实例可以使用很多操作,所有文档的创建和检索都是由模型来处理
varanimalMode=db.model('Animal',animalSchema);
模型的实例实质是文件,而我们可以很轻松创建、修改这种文件
varcat=newanimalMode({ name:'catName', age:'7',//这里依然使用字符串,mongoose会自动转换类型 }); cat.save(function(err,thor){ if(err)returnconsole.log(err); console.log(thor); }); //或者可以使用create //cat.create(function(err,thor){ //if(err)returnconsole.log(err); //console.log(thor); //}); //执行查找 animalMode.find(function(err,people){ if(err)console.log(err); console.log(people); }); //查找符合条件数据 animalMode.findOne({title:'catName'},function(err,cat){ if(err)console.log(err); console.log(cat); });
Schema
数据类型
这是Schema中所有的数据类型,包括mongoose自定的数据类型
- String
- Number
- Date
- Buffer
- Boolean
- Mixed
- ObjectId
- Array
每种数据类型的使用
varanimalMode=mongoose.model('Animal',schema); varcat=newanimalMode; cat.name='StatueofLiberty'//String cat.age='7';//Number cat.updated=newDate;//Date cat.binary=newBuffer(0);//Buffer cat.living=false;//Boolean cat.mixed={any:{thing:'iwant'}};//Mixed cat._someId=newmongoose.Types.ObjectId;//ObjectId cat.ofString.push("strings!");//Array
其中Mixed是mongoose自定义的一种混合类型,因为Mixed没有定义具体内容,可以用{}来使用,以下2种定义形式等价。
varanimalSchema=newSchema({any:{}}); varanimalSchema=newSchema({any:{Schema.Types.Mixed}});
自定义方法
可以为Schema绑定方法
varanimalSchema=newSchema({ name:String, age:Number, }); animalSchema.methods.findSimilarTypes=function(cb){ returnthis.model('Animal').find({name:this.name},cb); } varanimalMode=db.model('Animal',animalSchema); cat.findSimilarTypes(function(err,cat){ if(err)console.log(err); console.log(cat); });
也可以为Schema添加静态方法
animalSchema.statics.findByName=function(name,cb){ returnthis.find({name:newRegExp(name,'i')},cb); } varanimalMode=db.model('Animal',animalSchema); animalMode.findByName('catName',function(err,animals){ console.log(animals); });
索引
我们可以为mongodb数据建立索引,mongodb支持二级索引,为了提高数据查找和定位,建立复合索引是必要的
varanimalSchema=newSchema({ name:String, age:Number, tags:{age:[String],index:true}//fieldlevel }); animalSchema.index({name:1,age:-1});//schemalevel
但是这种索引的建立可能导致显著的性能影响,建议在生产下停止,将设置模式下的自动索引设置为false禁止
animalSchema.set('autoIndex',false); //or newSchema({..},{autoIndex:false});
Model
C
cat.save(function(err,thor){ if(err)returnconsole.log(err); console.log(thor); }); //或者可以使用create cat.create(function(err,thor){ if(err)returnconsole.log(err); console.log(thor); });
R
//find animalMode.find(function(err,cat){ if(err)console.log(err); console.log(cat); }) //findOne animalMode.findOne({name:'catName'},function(err,cat){ if(err)console.log(err); console.log(cat); }) //findByID //与findOne相同,但它接收文档的_id作为参数,返回单个文档。_id//可以是字符串或ObjectId对象。 animalMode.findById(id,function(err,adventure){ if(err)consoel.log(err); console.log(adventure); }); //where //查询数据类型是字符串时,可支持正则 animalMode.where('age','2').exec(function(err,cat){ if(err)console.log(err); console.log(cat); }); animalMode .where('age').gte(1).lte(10) .where('name','catName') .exec(function(err,cat){ if(err)console.log(err); console.log(cat); });
U
官方文档提供的更新函数Model.update
Model.update(conditions,doc,[options],[callback])
- conditions更新条件
- doc更新内容
- option更新选项
- safe(boolean)安全模式,默认选项,值为true
- upsert(boolean)条件不匹配时是否创建新文档,默认值为false
- multi(boolean)是否更新多个文件,默认值为false
- strict(boolean)严格模式,只更新一条数据
- overwrite(boolean)覆盖数据,默认为false
- callback
- err更新数据出错时返回值
- numberAffected(笔者暂时不清楚)
- rawResponse受影响的行数
animalMode.update({name:'catName'},{age:'6'},{multi:true},function(err,numberAffected,raw){ if(err)returnconsole.log(err); console.log('Thenumberofupdateddocumentswas%d',numberAffected); console.log('TherawresponsefromMongowas',raw); });
D
animalMode.remove({age:6},function(err){ if(err)console.log(err); })
其它
//返回文档数
animalMode.count({age:2},function(err,cat){ if(err)console.log(err); console.log(cat); })