Mongoose學習全面知識大全

ADVERTISEMENT

Mongoose學習全面知識大全

一、創建schemas

創建schemas的方式:


 var userSchema = new mongoose.Schema({
 name: String,
 email: String,
 createdOn: Date
 });
 

schemas中的數據類型有以下幾種:

  • String
  • Number
  • Date
  • Boolean
  • Buffer
  • ObjectId
  • Mixed
  • Array

特別需要說明一下ObjectId類型和Mixed類型以及Array類型,在schemas中聲明這幾種類型的方式如下:


 //ObjectId就類似於唯一鍵值
 projectSchema.add({
 owner: mongoose.Schema.Types.ObjectId
 });
 //混合類型,顧名思義,就是說里面可以放置任意類型的數據,有兩種方式創建該類型數據
 //方式一:直接賦予一個空的字面量對象
 vardjSchema= new mongoose.Schema({
 mixedUp: {}
 });
 //方式二:根據Schemas.Types中值來賦予
 vardjSchema= new mongoose.Schema({
 mixedUp: Schema.Types.Mixed
 });
 //Array類型數據有兩種創建方式,一種是簡單數組創建:
 var userSchema = new mongoose.Schema({
 name: String,
 emailAddresses: [String]
 });
 //第二種方式就是複雜類型數據數組,例如我們可以再數組中添加不同類型的schemas:
 var emailSchema = new mongoose.Schema({
 email: String,
 verified: Boolean
 });
 var userSchema = new mongoose.Schema({
 name: String,
 emailAddresses: [emailSchema]
 });
 //注意:如果定義一個空的數據的話,則會創建為一個混合類型數據的數組:
 var emailSchema = new mongoose.Schema({
 email: String,
 verified: Boolean
 });
 var userSchema = new mongoose.Schema({
 name: String,
 emailAddresses: [emailSchema]
 });

我們可以給schema創建靜態方法,這個靜態方法將來會用在Model中,創建該靜態方法需要在創建完成schema之後,在Model編譯之前:


 projectSchema.statics.findByUserID = function (userid, callback) {
 this.find({ createdBy: userid }, '_id projectName', {sort: 'modifiedOn'}, callback);
 };

在其對應的模型創建完成並編譯後,我們就可以像下面這樣來調用該靜態方法了:

Model.findByUserID(userid,callback);

該靜態方法會返回一個JSON格式的數據,這在我們使用AJAX技術來加載網頁數據的時候會比較方便,就像下面這樣:


 //路由規則:app.get('/project/byuser/:userid', project.byUser);
 exports.byUser = function (req, res) {
 console.log("Getting user projects");
 if (req.params.userid){
 Project.findByUserID(req.params.userid,function (err, projects) {
 if(!err){
 console.log(projects);
 res.json(projects);
 }else{
 console.log(err);
 res.json({"status":"error", "error":"Error finding projects"});
 }
 });
 }else{
 console.log("No user id supplied");
 res.json({"status":"error", "error":"No user id supplied"});
 }
 };

二、創建Model

創建Model很簡單:


 Mongoose.Model('User', userSchema);

參數一為Model的名字,參數二為生成Model所需要的schema,Model就像是schema所編譯而成的一樣。

mongoose連接數據庫是有兩種方式的:


 //方式一:
 var dbURI = 'mongodb://localhost/mydatabase';
 mongoose.connect(dbURI);
 //方式二:
 var dbURI = 'mongodb://localhost/myadmindatabase';
 var adminConnection = mongoose.createConnection(dbURI);
 //如果需要聲明端口號:
 var dbURI = 'mongodb://localhost:27018/mydatabase';
 //如果需要定義用戶名和密碼:
 var dbURI = 'mongodb://username:[email protected]/mydatabase';
 //也可以像下面這樣傳一個對象類型的參數:
 var dbURI = 'mongodb://localhost/mydatabase';
 var dbOptions = ;
 mongoose.connect(dbURI, dbOptions);

根據連接數據庫的方式,我們可以得到第二種創建Model的方式,就是使用數據庫連接的引用名來創建:


 adminConnection.model( 'User', userSchema );

默認情況下mongoose會根據我們傳入的Model名字來生成collection名字,在上面的代碼中就會生成名為users(全為小寫字母)的collection(集合);

有兩種方法能讓我們自定義collection的名字。


 //方式一,在創建schema的時候定義collection的名字:
 var userSchema = new mongoose.Schema({
 name: String,
 email: {type: String, unique:true}
 },
 {
 collection: 'myuserlist'
 });
 //方式二,在創建Model的時候定義collection的名字:
 mongoose.model( 'User', userSchema, 'myuserlist' );

創建Model實例:


 var user = new User({ name: 'Simon' });

user就是模型User的一個實例,它具有mongoose中模型所具有的一些方法,例如保存實例:


 user.save(function (err) {
 if (err) return handleError(err);
 });
 

模型也具有一些常用的增刪查改的方法:


 User.findOne({'name' : 'Sally', function(err,user) {
 if(!err){
 console.log(user);
 }
 });
 User.find({}, function(err, users) {
 if(!err){
 console.log(users);
 }
 });

可以使用鏈式方式使用這些方法,例如:


 var newUser = new User({
 name: 'Simon Holmes',
 email: '[email protected]',
 lastLogin : Date.now()
 }).save( function( err ){
 if(!err){
 console.log('User saved!');
 }
 });
ADVERTISEMENT

上面的代碼創建了一個模型實例,然後進行保存。我們有一個更為簡介的方式來完成這項工作,就是使用Model.create()方法:


 User.create({
 name: 'Simon Holmes',
 email: '[email protected]',
 lastLogin : Date.now()
 }, function( err, user ){
 if(!err){
 console.log('User saved!');
 console.log('Saved user name: ' + user.name);
 console.log('_id of saved user: ' + user._id);
 }
 });

三、查找數據和讀取數據的方法

1.使用QueryBuilder接口來查找數據

先看看下面的代碼:


 var myQuery = User.find({'name' : 'Simon Holmes'});
 myQuery.where('age').gt(18);
 myQuery.sort('-lastLogin');
 myQuery.select('_id name email');
 myQuery.exec(function (err, users){
 if (!err){
 console.log(users); // output array of users found
 }
 });

代碼中,我們查找名字為"Simon Holmes",並且年齡大於18歲,查找結果根據lastLogin降序排列,隻獲取其中的_id, name, email三個字段的值,上面的代碼只有在調用exec方法後才真正執行數據庫的查詢。

當然我們可以使用鏈式的方式來改寫上面的代碼,代碼會更加簡潔:


 User.find({'name' : 'Simon Holmes'})
 .where('age').gt(18)
 .sort('-lastLogin')
 .select('_id name email')
 .exec(function (err, users){
 if (!err){
 console.log(users); // output array of users found
 }
 });

上面代碼中的第一行創建了一個queryBuilder.通過使用這個queryBuilder,我們就可以執行一些比較複雜的查找工作,在創建完成這個queryBuilder之後,查詢操作並沒有馬上執行,而是待到執行exec方法時才會去執行數據庫的查找。

當然也有另外一種方式能夠直接查找數據庫的,就是直接在查找方法中添加回調函數,使用方式為:


 Model.find(conditions, [fields], [options], [callback])

下面舉一個簡單例子:


 User.find({'name', 'simon holmes'}, function(err, user) {});

另一個稍微複雜的例子:


 User.find({'name', 'simon holmes'}, 'name email',function(err, user) {
 //console.log('some thing');
 });

另一個更加複雜的例子,包含查詢結果的排序:


 User.find({'name' : 'Simon Holmes'},
 null, // 如果使用null,則會返回所有的字段值
 {sort : {lastLogin : -1}}, // 降序排序
 function (err, users){
 if (!err)
 });

列舉幾個比較實用的查找方法:


 Model.find(query);
 Model.findOne(query);//返回查找到的所有實例的第一個
 Model.findById(ObjectID);//根據ObjectId查找到唯一實例
 

例如:


 User.findOne({'email' : req.body.Email},
 '_id name email',
 function(err, user) {
 //todo
 });
 

2.更新數據

有三種方式來更新數據:

(1)update(conditions,update,options,callback);

該方法會匹配到所查找的內容進行更新,不會返回數據;

(2)findOneAndUpdate(conditions,update,options,callback);

該方法會根據查找去更新數據庫,另外也會返回查找到的並未改變的數據;

(3)findByIdAndUpdate(conditions,update,options,callback);

該方法跟上面的findOneAndUpdate方法功能一樣,不過他是根據ID來查找文檔並更新的。

三個方法都包含四個參數,一下稍微說明一下幾個參數的意思:

  • conditions:查詢條件
  • update:更新的數據對象,是一個包含鍵值對的對象
  • options:是一個聲明操作類型的選項,這個參數在下面再詳細介紹
  • callback:回調函數

對於options參數,在update方法中和findOneAndUpdate、findByIdAndUpdate兩個方法中的可選設置是不同的;


 //在update方法中,options的可選設置為:
 {
 safe:true|false, //聲明是否返回錯誤信息,默認true
 upsert:false|true, //聲明如果查詢不到需要更新的數據項,是否需要新插入一條記錄,默認false
 multi:false|true, //聲明是否可以同時更新多條記錄,默認false
 strict:true|false //聲明更新的數據中是否可以包含在schema定義之外的字段數據,默認true
 }
 //對於findOneAndUpdate、findByIdAndUpdate這兩個方法,他們的options可選設置項為:
 {
 new:true|false, //聲明返回的數據時更新後的該是更新前的,如果為true則返回更新後的,默認true
 upsert:false|trure, 
 sort:javascriptObject, //如果查詢返回多個文檔記錄,則可以進行排序,在這里是根據傳入的javascript object對象進行排序
 select:String //這里聲明要返回的字段,值是一個字符串
 }

下面舉個例子:


 User.update(,{$set: {lastLogin: Date.now()}},function(){});

3.數據刪除

跟更新數據一樣,也有三種方法給我們刪除數據:


 remove();
 findOneAndRemove();
 findByIdAndRemove();

remove方法有兩種使用方式,一種是用在模型上,另一種是用在模型實例上,例如:


 User.remove({ name : /Simon/ } , function (err){
 if (!err){
 // 刪除名字中包含simon的所有用戶
 }
 });
 
 User.findOne({ email : '[email protected]'},function (err,user){
 if (!err){
 user.remove( function(err){
 // 刪除匹配到該郵箱的第一個用戶
 });
 }
 });
 

接下來看一下findOneAndRemove方法:


 User.findOneAndRemove({name : /Simon/},{sort : 'lastLogin', select : 'name email'},function (err, user){
 if (!err) {
 console.log(user.name + " removed");
 // Simon Holmes removed
 };
 });

另外一個findByIdAndRemove方法則是如出一轍的。


 User.findByIdAndRemove(req.body._id,function (err, user) {
 if(err){
 console.log(err);
 return;
 }
 console.log("User deleted:", user);
 });

四、數據驗證

1.mongoose內置數據驗證

在mongoose中,數據驗證這一層是放在schema中的,mongoose已經幫我們做了很多內置的數據驗證,有一些驗證是針對某些數據類型的,也有一些是針對所有數據類型的。

能夠作用在所有數據類型上的驗證有require,意思就是該字段是否是必須的,例如:


 email: { type: String, unique: true, required: true }
ADVERTISEMENT

上面的代碼就定義了一個email是必須的schema.

下面再分別介紹一下mongoose內置的一些數據驗證類型。

數字類型schemasType,對於Number類型的數據,具有min,max提供用來界定最大最小值:


 var teenSchema = new Schema({
 age : {type: Number, min: 13, max:19}
 });

字符串類型SchemasType,對於該類型數據,mongoose提供了兩種驗證器:

  • match:可使用正則表達式來匹配字符串是否符合該正則表達式的規則
  • enum:枚舉出字符串可使用的一些值

分別舉例如下:


 var weekdaySchema = new Schema({
 day : {type: String, match: /^(mon|tues|wednes|thurs|fri)day$/i}
 });
 
 var weekdays = ['monday', 'tuesday', 'wednesday', 'thursday','friday'];
 var weekdaySchema = new Schema({
 day : {type: String, enum: weekdays}
 });
 

在我們進行一些數據庫的時候,如果有錯誤,可能會返回一些錯誤信息,這些信息封裝在一個對象中,該對象的數據格式大致如下:


 { 
 message: 'Validation failed',
 name: 'ValidationError',
 errors:{ 
 email:{
 message: 'Validator "required" failed for path email',
 name: 'ValidatorError',
 path: 'email',
 type: 'required' 
 },
 name:{ 
 message: 'Validator "required" failed for path name',
 name: 'ValidatorError',
 path: 'name',
 type: 'required' 
 } 
 } 
 }

知道該錯誤信息的具體格式之後,我們可以從中得出我們想要的信息並反饋到控製台。


 if(err){
 Object.keys(err.errors).forEach(function(key) {
 var message = err.errors[key].message;
 console.log('Validation error for "%s": %s', key, message);
 });
 }

2.自定義數據驗證

最簡單的自定義數據驗證方式就是定義一個數據驗證的函數,並將它傳遞給schema;


 var lengthValidator = function(val) {
 if (val && val.length >= 5){
 return true;
 }
 return false;
 };
 //usage:
 name: {type: String, required: true, validate: lengthValidator }

可以看到,我們隻需要在schema中添加validate鍵值對即可,validate對應的值便是我們自定義的驗證方法;

但是該形式的數據驗證無法給我們提供完整的錯誤信息,比如errors信息中返回的type值就會成為undefined;

在此基礎上如果希望錯誤信息中能返回一個錯誤描述,那我們可以稍微進行一點修改:


 //code 1
 validate: { validator: lengthValidator, msg: 'Too short' }
 
 //code 2
 var weekdaySchema = new Schema({
 day : {type: String, validate: {validator:/^(mon|tues|wednes|thurs|fri)day$/i, msg: 'Not a day' }
 });
 

將validate的值修改為一個對象,並且該對象包含驗證器和錯誤描述。

我們也可以使用另一種方式在寫這些驗證器,就是將驗證器卸載schema外部,例如:


 var validateLength = [lengthValidator, 'Too short' ];
 var validateDay = [/^(mon|tues|wednes|thurs|fri)day$/i, 'Not a day' ];
 //usage:
 name: {type: String, required: true, validate: validateLength }
 day : {type: String, validate: validateDay }
 

眼睛放大,一看再看,確實沒錯,在validate中我們傳入的是一個數組了,而不是原來的對象了。

其實就validateLength這個東東來說,他就是一個簡寫來的,你也可以改成下面這樣:


 var validateLength = [
 {validator: lengthValidator, msg: 'Too short'}
 ];
 

恩,到這里,應該能明白了,將對象改為數組之後,我們便可以傳遞多個驗證器給我們的schema了,的確如此。


 var validateUsername = [
 {validator: lengthValidator, msg: 'Too short'} ,
 {validator: /^[a-z]+$/i, msg: 'Letters only'}
 ];
 

我們還有另外一種方法給我們的schema提供驗證器:


 userSchema.path('name').validate(lengthValidator, 'Too short');
 userSchema.path('name').validate(/^[a-z]+$/i, 'Letters only');

以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持路飯。


本文地址:
ADVERTISEMENT
ADVERTISEMENT