[轉] Mongoose 參考手冊

Mongoose 參考手冊

標籤（空格分隔）： MongoDB

---

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