Mongoose 參考手冊（轉載）

Mongoose 是什麼?

通常咱們不直接用MongoDB的函數來操做MongoDB數據庫 Mongose就是一套操做MongoDB數據庫的接口.

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

遊標

MongoDB 使用遊標返回find的執行結果.客戶端對遊標的實現一般可以對最終結果進行有效的控制。能夠限制結果的數量，略過部分結果，根據任意鍵按任意順序的組合對結果進行各類排序，或者是執行其餘一些強的操做。

ObjectId

存儲在mongodb集合中的每一個文檔（document）都有一個默認的主鍵_id，這個主鍵名稱是固定的，它能夠是mongodb支持的任何數據類型，默認是ObjectId。

ObjectId是一個12字節的 BSON 類型字符串。按照字節順序，依次表明：
4字節：UNIX時間戳
3字節：表示運行MongoDB的機器
2字節：表示生成此_id的進程
3字節：由一個隨機數開始的計數器生成的值

Node.js 中使用

package.json 中加入"mongoose": 「*」 字段
npm install 安裝依賴.

var mongoose = require("mongoose");
var db = mongoose.connect("mongodb://localhost:27017/test");
而後引用

API

var mongoose = require("mongoose");
var db = mongoose.connect("mongodb://localhost:27017/test");

db - 數據庫操做

1.掛接數據庫鏈接事件,參數1: 也能夠是error.

db.connection.on(‘open’, callback);

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降序