mongoose

mongoose#Mongoose
##簡介
- Mongoose 是MongoDB的一個對象模型工具，是 nodejs 操作 MongoDB 的第三方框架，可以在異步的環境下執行。
- 同時它也是針對MongoDB操作的一個對象模型庫，封裝了MongoDB對文檔的的一些增刪改查等常用方法，讓NodeJS操作Mongodb數據庫變得更加靈活簡單。

- 參考資料
- 文檔： www.mongoosejs.com
- mongoose 的 API 是我見過的最好的文檔，沒有之一 
- 雖然只有英文版，但是，光看例子也能夠理解基本含義

##安裝引用
- 安裝mongoose：
npm install mongoose
- 引用mongoose：
var mongoose = require("mongoose");
- 使用"mongoose"連接數據庫：
var db = mongoose.connect("mongodb://user:pass@localhost:port/database");

## Mongoose 最重要（最難）的三個概念
1. Schema : 模式，規範
2. Model ： 模型，函數
3. Entity ： 實體，實例，對象

三者之間的關係


### Schema 簡述
- 含義： Schema —— 一種以文件形式存儲的數據庫模型骨架，可以說是數據屬性模型【傳統意義的表結構】，又或着是“集合”的模型骨架。 Schema 無法直接連接數據庫端，也就是說它不具備對數據庫的操作能力，僅僅只是數據模型在程序片段中的一種表現。說白了就是規定了一種數據存儲格式
- 代碼定義
var mongoose = require("mongoose");
var MonsterSchema = 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:''}
});
//基本屬性類型有：字符串、日期型、數值型、布爾型(Boolean)、null、數組、內嵌文檔等。

### Model 簡述
- 含義： Model —— 由Schema構造生成的模型，它具有了Schema定義的數據庫骨架（數據格式數據模型）。此外，更重要的是還具有數據庫操作的行爲，類似於管理數據庫屬性、行爲的類。
- 創建一個 Model 模型，我們需要指定：
1. 集合名稱
2. 集合的 Schema 結構對象
- 代碼
//通過Schema來創建Model呢，如下示例：
var db = mongoose.connect("mongodb://127.0.0.1:27017/test");
// 創建Model
var MonsterModel = db.model("Monster", MonsterSchema);
// MonsterModel：數據庫中的集合名稱,當我們對其添加數據時如果 MonsterModel 已經存在，則會保存到其目錄下，如果未存在，則會創建 MonsterModel 集合，然後在保存數據。

擁有了Model，我們也就擁有了操作數據庫的法寶，在後面的課程中，我們就會學習使用Model來進行增刪改查的具體操作
如果需要對某個集合有所作爲，那就交給 Model 模型來處理。

### Entity 簡述
- 含義 Entity —— 由 Model 創建的實體，Entity 指代某一條具體的文檔，model 指代某個表（collection）。 Model 和 Entity 都能操作數據庫，但 Model 比 Entity 具有更大的操作空間
- 代碼
// 使用Model創建Entity
var monsterEntity = new MonsterModel({
name : "niuMoWang",
age : 2000,
email: "[email protected]"
});
//說白了，就是 new 了一個對象
console.log(niuMoWang.name); 
console.log(niuMoWang.age); 
//創建成功之後，Schema 屬性就變成了 Model 和 Entity 的公共屬性了

##**增刪改查**
###增
- Model 保存方法
- 方法：Model.create(文檔數據, callback))
- 代碼：
MonsterModel.create({ name:"路人甲", age:2}, function(error, doc){
if(error) {
console.log(error);
} else {
console.log(doc);
}
});
- Entity 保存方法
- 方法：Entity.save(文檔數據, callback))
- 代碼：
var entity = new MonsterModel({ name:"路人甲", age:2});
entity.save(function(error,doc) {
if(error) {
console.log(error);
} else {
console.log(doc);
}
});

###刪
- Model 刪除方法
- 方法：model.remove(查詢條件,callback);
- 代碼：
var conditions = { name: '路人甲' };
MonsterModel.remove(conditions, function(error){
if(error) {
console.log(error);
} else {
console.log('Delete success!');
}
});
- Entity 刪除方法
- 方法：obj.remove(callback);
- 代碼：
entity.remove(function(err, doc){
if(err){
console.error(err);
} else {
console.log(doc);
}
});
###改
- Model 更新方法
- 方法：obj.update(查詢條件, 更新對象, callback);
- 代碼：
ar conditions = {name : '路人甲'};
var update = {$set : { age : 3 }};
MonsterModel.update(conditions, update, function(error){
if(error) {
console.log(error);
} else {
console.log('Update success!');
}
});
- Entity 更新方法
- 方法：obj.save(callback);
- 代碼：
entity.age = 3;
entity.save(function(err, doc){
if(err){
console.error(err);
} else {
console.log(doc);
}
});

###查
- **find查詢**【最重要】
- 方法： obj.find(查詢條件, 過濾條件, callback);
- 代碼：
MonsterModel.find({},function(error,docs){
//若沒有向find傳遞參數，默認的是顯示所有文檔
});
MonsterModel.find({ "age": 3 }, {_id:0}, function (error, docs) {
if(error){
console.log("error :" + error);
}else{
console.log(docs); //docs: age爲28的所有文檔
}
}); 
- 備註：
- 查詢條件有很多種，上面這段代碼，代換不同的查詢條件有不一樣的效果
- 過濾條件控制那些屬性最終會包含在結果集當中，如果過濾條件省略或爲Null，則返回所有屬性。
- 單條數據查詢
- 方法： findOne(Conditions,callback);
- 代碼：
MonsterModel.findOne({ age: 3}, function (err, doc){
// 查詢符合age等於27的第一條數據
// doc是查詢結果
});
// findOne方法，只返回第一個符合條件的文檔數據。
- 方法：findById(_id, callback);
- 代碼：
MonsterModel.findById('obj._id', function (err, doc){
//doc 查詢結果文檔
}); 

####查詢條件
"$lt"(小於)，"$lte"(小於等於),"$gt"(大於)，"$gte"(大於等於)，"$ne"(不等於)，"$in"(可單值和多個值的匹配)，"$or"(查詢多個鍵值的任意給定值)，"$exists"(表示是否存在的意思)。
- 大於、小於、不等於
MonsterModel.find({"age":{"$gt":18}},function(error,docs){
//查詢所有nage大於18的數據
});
MonsterModel.find({"age":{"$lt":60}},function(error,docs){
//查詢所有nage小於60的數據
});
MonsterModel.find({"age":{"$gt":18,"$lt":60}},function(error,docs){
//查詢所有nage大於18小於60的數據
});
MonsterModel.find({ age:{ $ne:24}},function(error,docs){
//查詢age不等於24的所有數據
});
MonsterModel.find({name:{$ne:"路人甲"},age:{$gte:3}},function(error,docs){
//查詢name不等於tom、age>=18的所有數據
});

- 包含
MonsterModel.find({ age:{ $in: 2}},function(error,docs){
//查詢age等於20的所有數據
});
MonsterModel.find({ age:{$in:[2,3]}},function(error,docs){
//可以把多個值組織成一個數組
}); 

- 邏輯或
MonsterModel.find({"$or":[{"name":"yellowBrow"},{"age":500}]},function(error,docs){
//查詢name爲yaya或age爲28的全部文檔
});

- 屬性是否存在
MonsterModel.find({name: {$exists: true}},function(error,docs){
//查詢所有存在name屬性的文檔
});
MonsterModel.find({telephone: {$exists: false}},function(error,docs){
//查詢所有不存在telephone屬性的文檔
});

##遊標
數據庫使用遊標返回 find 的執行結果。
客戶端對遊標的實現通常能夠對最終結果進行有效的控制。可以限制結果的數量，略過部分結果，根據任意鍵按任意順序的組合對結果進行各種排序。
最常用的查詢選項就是限制返回結果的數量(limit函數)、忽略一點數量的結果(skip函數)以及排序(sort函數)。所有這些選項一點要在查詢被髮送到服務器之前指定。
###遊標的三大函數
sort函數 -------- skip函數 -------- limit函數
1. ** sort 函數 **
- 介紹：sort函數可以將查詢結果數據進行排序操作，該函數的參數是一個或多個鍵/值對，鍵代表要排序的鍵名，值代表排序的方向，1是升序，-1是降序。
- 方法：find(Conditions,fields,options,callback);
- 代碼：
Model.find({},null,{sort:{age:-1}},function(err,docs){
//查詢所有數據，並按照age降序順序返回數據docs
});

2. ** skip 函數 **
- 介紹：跳過指定數量的匹配結果，返回餘下的查詢結果。
- 方法：find(Conditions,fields,options,callback);
- 代碼;
Model.find({},null,{skip:4},function(err,docs){
console.log(docs);
});
// 如果查詢結果數量中少於4個的話，則不會返回任何結果。

3. ** limit 函數 **
- 介紹：在查詢操作中，有時數據量會很大，這時我們就需要對返回結果的數量進行限制，那麼我們就可以使用limit函數，通過它來限制結果數量。
- 方法：find(Conditions,fields,options,callback);
- 代碼：
Model.find({},null,{limit:20},function(err,docs){
console.log(docs);
});
// 如果匹配的結果不到20個，則返回匹配數量的結果，也就是說limit函數指定的是上限而非下限。