Mongoose全面理解

時間  2019-11-07
標籤 mongoose 全面 理解 欄目 MongoDB 简体版
原文   原文鏈接

1、建立schemas

建立schemas的方式：javascript

1 var userSchema = new mongoose.Schema({
2     name: String,
3     email: String,
4     createdOn: Date
5 });

schemas中的數據類型有如下幾種：
• String
• Number
• Date
• Boolean
• Buffer
• ObjectId
• Mixed
• Arrayjava

特別須要說明一下ObjectId類型和Mixed類型以及Array類型，在schemas中聲明這幾種類型的方式以下：正則表達式

複製代碼 
 1 //ObjectId就相似於惟一鍵值
 2 projectSchema.add({
 3     owner: mongoose.Schema.Types.ObjectId
 4 });
 5 //混合類型，顧名思義，就是說裏面能夠放置任意類型的數據，有兩種方式建立該類型數據
 6 //方式一：直接賦予一個空的字面量對象
 7 vardjSchema= new mongoose.Schema({
 8     mixedUp: {}
 9 });
10 //方式二：根據Schemas.Types中值來賦予
11 vardjSchema= new mongoose.Schema({
12     mixedUp: Schema.Types.Mixed
13 });
14 //Array類型數據有兩種建立方式，一種是簡單數組建立：
15 var userSchema = new mongoose.Schema({
16     name: String,
17     emailAddresses: [String]
18 });
19 //第二種方式就是複雜類型數據數組，例如咱們能夠再數組中添加不一樣類型的schemas:
20 var emailSchema = new mongoose.Schema({
21     email: String,
22     verified: Boolean
23 });
24 var userSchema = new mongoose.Schema({
25     name: String,
26     emailAddresses: [emailSchema]
27 });
28 //注意：若是定義一個空的數據的話，則會建立爲一個混合類型數據的數組：
29 var emailSchema = new mongoose.Schema({
30     email: String,
31     verified: Boolean
32 });
33 var userSchema = new mongoose.Schema({
34     name: String,
35     emailAddresses: [emailSchema]
36 });
複製代碼

咱們能夠給schema建立靜態方法，這個靜態方法未來會用在Model中，建立該靜態方法須要在建立完成schema以後，在Model編譯以前：mongodb

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

在其對應的模型建立完成並編譯後，咱們就能夠像下面這樣來調用該靜態方法了：
Model.findByUserID(userid,callback);
該靜態方法會返回一個JSON格式的數據，這在咱們使用AJAX技術來加載網頁數據的時候會比較方便，就像下面這樣：數據庫

複製代碼 
 1 //路由規則：app.get('/project/byuser/:userid', project.byUser);
 2 exports.byUser = function (req, res) {
 3     console.log("Getting user projects");
 4     if (req.params.userid){
 5         Project.findByUserID(req.params.userid,function (err, projects) {
 6             if(!err){
 7                 console.log(projects);
 8                 res.json(projects);
 9             }else{
10                 console.log(err);
11                 res.json({"status":"error", "error":"Error finding projects"});
12             }
13         });
14     }else{
15         console.log("No user id supplied");
16         res.json({"status":"error", "error":"No user id supplied"});
17     }
18 };
複製代碼

 

 

2、建立Model

建立Model很簡單：
Mongoose.Model('User', userSchema);
參數一爲Model的名字，參數二爲生成Model所須要的schema,Model就像是schema所編譯而成的同樣。
mongoose鏈接數據庫是有兩種方式的：json

複製代碼 
 1 //方式一：
 2 var dbURI = 'mongodb://localhost/mydatabase';
 3 mongoose.connect(dbURI);
 4 //方式二：
 5 var dbURI = 'mongodb://localhost/myadmindatabase';
 6 var adminConnection = mongoose.createConnection(dbURI);
 7 //若是須要聲明端口號：
 8 var dbURI = 'mongodb://localhost:27018/mydatabase';
 9 //若是須要定義用戶名和密碼：
10 var dbURI = 'mongodb://username:password@localhost/mydatabase';
11 //也能夠像下面這樣傳一個對象類型的參數：
12 var dbURI = 'mongodb://localhost/mydatabase';
13 var dbOptions = {'user':'db_username','pass':'db_password'};
14 mongoose.connect(dbURI, dbOptions);
複製代碼

根據鏈接數據庫的方式，咱們能夠獲得第二種建立Model的方式，就是使用數據庫鏈接的引用名來建立：
adminConnection.model( 'User', userSchema );數組

默認狀況下mongoose會根據咱們傳入的Model名字來生成collection名字，在上面的代碼中就會生成名爲users(全爲小寫字母)的collection(集合)；
有兩種方法能讓咱們自定義collection的名字。app

複製代碼 
 1 //方式一，在建立schema的時候定義collection的名字：
 2 var userSchema = new mongoose.Schema({
 3     name: String,
 4     email: {type: String, unique:true}
 5 },
 6 {
 7     collection: 'myuserlist'
 8 });
 9 //方式二，在建立Model的時候定義collection的名字：
10 mongoose.model( 'User', userSchema, 'myuserlist' );
複製代碼

建立Model實例：
var user = new User({ name: 'Simon' });
user就是模型User的一個實例，它具備mongoose中模型所具備的一些方法，例如保存實例：mongoose

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

模型也具備一些經常使用的增刪查改的方法：函數

複製代碼 
 1 User.findOne({'name' : 'Sally', function(err,user) {
 2     if(!err){
 3         console.log(user);
 4     }
 5 });
 6 User.find({}, function(err, users) {
 7     if(!err){
 8         console.log(users);
 9     }
10 });
複製代碼

可使用鏈式方式使用這些方法，例如：

複製代碼 
1 var newUser = new User({
2     name: 'Simon Holmes',
3     email: 'simon@theholmesoffice.com',
4     lastLogin : Date.now()
5 }).save( function( err ){
6     if(!err){
7         console.log('User saved!');
8     }
9 });
複製代碼

上面的代碼建立了一個模型實例，而後進行保存。咱們有一個更爲簡介的方式來完成這項工做，就是使用Model.create()方法：

複製代碼 
 1 User.create({
 2     name: 'Simon Holmes',
 3     email: 'simon@theholmesoffice.com',
 4     lastLogin : Date.now()
 5 }, function( err, user ){
 6     if(!err){
 7         console.log('User saved!');
 8         console.log('Saved user name: ' + user.name);
 9         console.log('_id of saved user: ' + user._id);
10     }
11 });
複製代碼

 

 

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

1.使用QueryBuilder接口來查找數據
先看看下面的代碼：

複製代碼 
1 var myQuery = User.find({'name' : 'Simon Holmes'});
2 myQuery.where('age').gt(18);
3 myQuery.sort('-lastLogin');
4 myQuery.select('_id name email');
5 myQuery.exec(function (err, users){
6     if (!err){
7         console.log(users); // output array of users found
8     }
9 });
複製代碼

代碼中，咱們查找名字爲"Simon Holmes"，而且年齡大於18歲，查找結果根據lastLogin降序排列，只獲取其中的_id, name, email三個字段的值，上面的代碼只有在調用exec方法後才真正執行數據庫的查詢。
固然咱們可使用鏈式的方式來改寫上面的代碼，代碼會更加簡潔：

複製代碼 
1 User.find({'name' : 'Simon Holmes'})
2 .where('age').gt(18)
3 .sort('-lastLogin')
4 .select('_id name email')
5 .exec(function (err, users){
6     if (!err){
7         console.log(users); // output array of users found
8     }
9 });
複製代碼

上面代碼中的第一行建立了一個queryBuilder.經過使用這個queryBuilder，咱們就能夠執行一些比較複雜的查找工做，
在建立完成這個queryBuilder以後，查詢操做並無立刻執行，而是待到執行exec方法時纔會去執行數據庫的查找。
固然也有另一種方式可以直接查找數據庫的，就是直接在查找方法中添加回調函數，使用方式爲：
Model.find(conditions, [fields], [options], [callback])
下面舉一個簡單例子：

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

另外一個稍微複雜的例子：

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

另外一個更加複雜的例子，包含查詢結果的排序：

複製代碼 
1 User.find({'name' : 'Simon Holmes'},
2     null, // 若是使用null，則會返回全部的字段值
3     {sort : {lastLogin : -1}}, // 降序排序
4     function (err, users){
5         if (!err){console.log(users);}
6     });
複製代碼

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

1 Model.find(query);
2 Model.findOne(query);//返回查找到的全部實例的第一個
3 Model.findById(ObjectID);//根據ObjectId查找到惟一實例

例如：

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

 

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兩個方法中的可選設置是不一樣的；

複製代碼 
 1 //在update方法中，options的可選設置爲：
 2 {
 3 safe:true|false,  //聲明是否返回錯誤信息，默認true
 4 upsert:false|true, //聲明若是查詢不到須要更新的數據項，是否須要新插入一條記錄，默認false
 5 multi:false|true,  //聲明是否能夠同時更新多條記錄，默認false
 6 strict:true|false  //聲明更新的數據中是否能夠包含在schema定義以外的字段數據，默認true
 7 }
 8 //對於findOneAndUpdate、findByIdAndUpdate這兩個方法，他們的options可選設置項爲：
 9 {
10 new:true|false, //聲明返回的數據時更新後的該是更新前的，若是爲true則返回更新後的，默認true
11 upsert:false|trure, 
12 sort:javascriptObject, //若是查詢返回多個文檔記錄，則能夠進行排序，在這裏是根據傳入的javascript object對象進行排序
13 select:String //這裏聲明要返回的字段，值是一個字符串
14 }
複製代碼

下面舉個例子：

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

 

3.數據刪除
跟更新數據同樣，也有三種方法給咱們刪除數據：
remove();
findOneAndRemove();
findByIdAndRemove();
remove方法有兩種使用方式，一種是用在模型上，另外一種是用在模型實例上，例如：

複製代碼 
 1 User.remove({ name : /Simon/ } , function (err){
 2     if (!err){
 3         // 刪除名字中包含simon的全部用戶
 4     }
 5 });
 6 
 7 User.findOne({ email : 'simon@theholmesoffice.com'},function (err,user){
 8     if (!err){
 9         user.remove( function(err){
10             // 刪除匹配到該郵箱的第一個用戶
11         });
12     }
13 });
複製代碼

接下來看一下findOneAndRemove方法：

複製代碼 
1 User.findOneAndRemove({name : /Simon/},{sort : 'lastLogin', select : 'name email'},function (err, user){
2     if (!err) {
3         console.log(user.name + " removed");
4         // Simon Holmes removed
5     };
6 });
複製代碼

另一個findByIdAndRemove方法則是一模一樣的。

複製代碼 
1 User.findByIdAndRemove(req.body._id,function (err, user) {
2     if(err){
3         console.log(err);
4         return;
5     }
6     console.log("User deleted:", user);
7 });
複製代碼

 

4、數據驗證

1.mongoose內置數據驗證
在mongoose中，數據驗證這一層是放在schema中的，mongoose已經幫咱們作了不少內置的數據驗證，有一些驗證是針對某些數據類型的，也有一些是針對全部數據類型的。
可以做用在全部數據類型上的驗證有require，意思就是該字段是不是必須的，例如：
email: { type: String, unique: true, required: true }
上面的代碼就定義了一個email是必須的schema.
下面再分別介紹一下mongoose內置的一些數據驗證類型。


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

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

 

字符串類型SchemasType,對於該類型數據，mongoose提供了兩種驗證器：
match:可以使用正則表達式來匹配字符串是否符合該正則表達式的規則
enum:枚舉出字符串可以使用的一些值
分別舉例以下：

複製代碼 
1 var weekdaySchema = new Schema({
2     day : {type: String, match: /^(mon|tues|wednes|thurs|fri)day$/i}
3 });
4 
5 var weekdays = ['monday', 'tuesday', 'wednesday', 'thursday','friday'];
6 var weekdaySchema = new Schema({
7     day : {type: String, enum: weekdays}
8 });
複製代碼

 

在咱們進行一些數據庫的時候，若是有錯誤，可能會返回一些錯誤信息，這些信息封裝在一個對象中，該對象的數據格式大體以下：

複製代碼 
 1 { 
 2     message: 'Validation failed',
 3     name: 'ValidationError',
 4     errors:{ 
 5         email:{
 6             message: 'Validator "required" failed for path email',
 7             name: 'ValidatorError',
 8             path: 'email',
 9             type: 'required' 
10         },
11         name:{ 
12             message: 'Validator "required" failed for path name',
13             name: 'ValidatorError',
14             path: 'name',
15             type: 'required' 
16         } 
17     } 
18 }
複製代碼

知道該錯誤信息的具體格式以後，咱們能夠從中得出咱們想要的信息並反饋到控制檯。

複製代碼 
1 if(err){
2     Object.keys(err.errors).forEach(function(key) {
3         var message = err.errors[key].message;
4         console.log('Validation error for "%s": %s', key, message);
5     });
6 }
複製代碼

 

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

複製代碼 
1 var lengthValidator = function(val) {
2     if (val && val.length >= 5){
3         return true;
4     }
5     return false;
6 };
7 //usage:
8 name: {type: String, required: true, validate: lengthValidator }
複製代碼

能夠看到，咱們只須要在schema中添加validate鍵值對便可，validate對應的值即是咱們自定義的驗證方法；
可是該形式的數據驗證沒法給咱們提供完整的錯誤信息，好比errors信息中返回的type值就會成爲undefined;
在此基礎上若是但願錯誤信息中能返回一個錯誤描述，那咱們能夠稍微進行一點修改：

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

將validate的值修改成一個對象，而且該對象包含驗證器和錯誤描述。
咱們也可使用另外一種方式在寫這些驗證器，就是將驗證器卸載schema外部，例如：

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

眼睛放大，一看再看，確實沒錯，在validate中咱們傳入的是一個數組了，而不是原來的對象了。
其實就validateLength這個東東來講，他就是一個簡寫來的，你也能夠改爲下面這樣：

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

恩，到這裏，應該能明白了，將對象改成數組以後，咱們即可以傳遞多個驗證器給咱們的schema了，的確如此。

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

咱們還有另一種方法給咱們的schema提供驗證器：

1 userSchema.path('name').validate(lengthValidator, 'Too short');
2 userSchema.path('name').validate(/^[a-z]+$/i, 'Letters only');
相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程