Mongoose學習全面理解(推薦)

更新時間：2017年01月21日 15:03:15 作者：jayruan

本篇文章主要介紹了Mongoose全面理解，詳細的介紹了mongoose連接數據庫，查找讀取數據和數據驗證等，有興趣的可以了解一下。

一、創(chuàng)建schemas

創(chuàng)建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
});
//混合類型，顧名思義，就是說里面可以放置任意類型的數據，有兩種方式創(chuàng)建該類型數據
//方式一：直接賦予一個空的字面量對象
vardjSchema= new mongoose.Schema({
  mixedUp: {}
});
//方式二：根據Schemas.Types中值來賦予
vardjSchema= new mongoose.Schema({
  mixedUp: Schema.Types.Mixed
});
//Array類型數據有兩種創(chuàng)建方式，一種是簡單數組創(chuàng)建：
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]
});
//注意：如果定義一個空的數據的話，則會創(chuàng)建為一個混合類型數據的數組：
var emailSchema = new mongoose.Schema({
  email: String,
  verified: Boolean
});
var userSchema = new mongoose.Schema({
  name: String,
  emailAddresses: [emailSchema]
});

我們可以給schema創(chuàng)建靜態(tài)方法，這個靜態(tài)方法將來會用在Model中，創(chuàng)建該靜態(tài)方法需要在創(chuàng)建完成schema之后，在Model編譯之前：

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

在其對應的模型創(chuàng)建完成并編譯后，我們就可以像下面這樣來調用該靜態(tài)方法了：

Model.findByUserID(userid,callback);

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

//路由規(guī)則：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"});
  }
};

二、創(chuàng)建Model

創(chuàng)建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:password@localhost/mydatabase';
//也可以像下面這樣傳一個對象類型的參數：
var dbURI = 'mongodb://localhost/mydatabase';
var dbOptions = {'user':'db_username','pass':'db_password'};
mongoose.connect(dbURI, dbOptions);

根據連接數據庫的方式，我們可以得到第二種創(chuàng)建Model的方式，就是使用數據庫連接的引用名來創(chuàng)建：

adminConnection.model( 'User', userSchema );

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

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

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

創(chuàng)建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: 'simon@theholmesoffice.com',
  lastLogin : Date.now()
}).save( function( err ){
  if(!err){
    console.log('User saved!');
  }
});

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

User.create({
  name: 'Simon Holmes',
  email: 'simon@theholmesoffice.com',
  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方法后才真正執(zhí)行數據庫的查詢。

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

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
  }
});

上面代碼中的第一行創(chuàng)建了一個queryBuilder.通過使用這個queryBuilder，我們就可以執(zhí)行一些比較復雜的查找工作，在創(chuàng)建完成這個queryBuilder之后，查詢操作并沒有馬上執(zhí)行，而是待到執(zhí)行exec方法時才會去執(zhí)行數據庫的查找。

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

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){console.log(users);}
  });

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

 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({_id:user._id},{$set: {lastLogin: Date.now()}},function(){});

3.數據刪除

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

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

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

User.remove({ name : /Simon/ } , function (err){
  if (!err){
    // 刪除名字中包含simon的所有用戶
  }
});

User.findOne({ email : 'simon@theholmesoffice.com'},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 }

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

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

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

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

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

match:可使用正則表達式來匹配字符串是否符合該正則表達式的規(guī)則
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');

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

您可能感興趣的文章:

mongoose

nodejs服務內存泄露排查過程和優(yōu)化方法
在開發(fā)和部署Node.js應用程序時,內存泄露是一個常見的挑戰(zhàn),本文將探討如何對于一個陌生項目進行內存排查和優(yōu)化的方法,文章通過圖文介紹的非常詳細,需要的朋友可以參考下
2023-11-11
node.js事件循環(huán)機制及與js區(qū)別詳解
這篇文章主要為大家介紹了node.js事件循環(huán)機制及與js區(qū)別詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪
2022-09-09
使用C++為node.js寫擴展模塊
本文給大家介紹的是在window7下使用C++來給node.js編寫擴展模塊的方法，附上一個簡單的hello實例，有需要的小伙伴可以參考下。
2015-04-04
nodeJs鏈接Mysql做增刪改查的簡單操作
本篇文章主要介紹了nodeJs鏈接Mysql做增刪改查的簡單操作，小編覺得挺不錯的，現在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2017-02-02
NodeJS服務器實現gzip壓縮的示例代碼
這篇文章主要介紹了NodeJS服務器實現gzip壓縮的示例代碼，小編覺得挺不錯的，現在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2018-10-10
NodeJS爬蟲實例之糗事百科
本篇文章主要給大家講解了一下用NodeJS學習爬蟲，并通過爬糗事百科來講解用法和效果，一起學習下吧。
2017-12-12
淺談Node.js 子進程與應用場景
這篇文章主要介紹了淺談Node.js 子進程與應用場景，小編覺得挺不錯的，現在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2018-01-01
你所未知的3種Node.js代碼優(yōu)化方式
這篇文章主要為大家介紹了3種你所未知的Node.js代碼優(yōu)化方式，幫助大家剛好的進行代碼優(yōu)化，感興趣的小伙伴們可以參考一下
2016-02-02
Node.js API詳解之 querystring用法實例分析
這篇文章主要介紹了Node.js API詳解之 querystring用法,結合實例形式分析了Node.js API中querystring的基本功能、用法及相關操作注意事項,需要的朋友可以參考下
2020-04-04
node中npm ERR! network ‘proxy‘ 配置問題解決
在進行npm依賴管理時,可能會遇到因網絡配置不當導致的錯誤,如npm ERR! network proxy config is set properly,下面就來介紹一下,感興趣的可以了解一下
2024-09-09