1. 程式人生 > >Mongoose介紹和入門

Mongoose介紹和入門

pwd http col guid idt sta 地址 示例 one

簡介

  Mongoose是在node.js異步環境下對mongodb進行便捷操作的對象模型工具

  那麽要使用它,首先你得裝上node.js和mongodb,關於mongodb的安裝和操作介紹可以參考:http://www.cnblogs.com/zhongweiv/p/node_mongodb.html

  Github地址:https://github.com/Automattic/mongoose

  API Docs:http://mongoosejs.com/docs/guide.html

  前面有介紹過用node-mongodb-native來操作mongodb,實際開發中估計更多會選用類似mongoose的模塊來操作來提升開發效率

  下面我們一步步來了解mongoose的基本操作^_^!

mongoose安裝

npm install mongoose

  安裝成功後如下圖:

技術分享圖片

  安裝成功後,就可以通過 require(‘mongoose‘) 來使用!

連接字符串

  創建一個db.js

技術分享圖片
var mongoose = require(‘mongoose‘),
    DB_URL = ‘mongodb://localhost:27017/mongoosesample‘;

/**
 * 連接
 */
mongoose.connect(DB_URL);

/**
  * 連接成功
  */
mongoose.connection.on(‘connected‘, function () {    
    console.log(‘Mongoose connection open to ‘ + DB_URL);  
});    

/**
 * 連接異常
 */
mongoose.connection.on(‘error‘,function (err) {    
    console.log(‘Mongoose connection error: ‘ + err);  
});    
 
/**
 * 連接斷開
 */
mongoose.connection.on(‘disconnected‘, function () {    
    console.log(‘Mongoose connection disconnected‘);  
});    
技術分享圖片

  調用node db.js執行就會看到輸出如下圖

技術分享圖片

  從代碼中可以看出,監聽了幾個事件,並且執行觸發了connected事件,這表示連接成功

  connection中不止有如上幾個事件,關鍵看你想要監聽哪個事件。

  其它事件可以自行查看:http://mongoosejs.com/docs/api.html#connection_Connection

  

  這是最簡單的連接字符串,當然還有其它形式,比如:連接密碼、數據庫連接設置、集群方式連式等等,這裏解釋了,用著了時候自行查詢API文檔

  http://mongoosejs.com/docs/api.html#index-js

  

Schema

  schema是mongoose裏會用到的一種數據模式,可以理解為表結構的定義;每個schema會映射到mongodb中的一個collection,它不具備操作數據庫的能力

  我們先改造一下db.js,導出mongoose對象  

技術分享圖片
var mongoose = require(‘mongoose‘),
    DB_URL = ‘mongodb://localhost:27017/mongoosesample‘;

/**
 * 連接
 */
mongoose.connect(DB_URL);

/**
  * 連接成功
  */
mongoose.connection.on(‘connected‘, function () {    
    console.log(‘Mongoose connection open to ‘ + DB_URL);  
});    

/**
 * 連接異常
 */
mongoose.connection.on(‘error‘,function (err) {    
    console.log(‘Mongoose connection error: ‘ + err);  
});    
 
/**
 * 連接斷開
 */
mongoose.connection.on(‘disconnected‘, function () {    
    console.log(‘Mongoose connection disconnected‘);  
});    

module.exports = mongoose;
技術分享圖片

  下面我們定義一個user的Schema,命名為user.js

技術分享圖片
/**
 * 用戶信息
 */
var mongoose = require(‘./db.js‘),
    Schema = mongoose.Schema;

var UserSchema = new Schema({          
    username : { type: String },                    //用戶賬號
    userpwd: {type: String},                        //密碼
    userage: {type: Number},                        //年齡
    logindate : { type: Date}                       //最近登錄時間
});
技術分享圖片

  定義一個Schema就這麽簡單,指定字段名和類型

  Schema Types內置類型如下:

  String

  Number

  Boolean | Bool

  Array

  Buffer

  Date

  ObjectId | Oid

  Mixed

  Schema中還可以做一些常用事,後面再講!

Model

  定義好了Schema,接下就是生成Model。

  model是由schema生成的模型,可以對數據庫的操作

  我們對上面的定義的user的schema生成一個User的model並導出,修改後代碼如下

技術分享圖片
/**
 * 用戶信息
 */
var mongoose = require(‘./db.js‘),
    Schema = mongoose.Schema;

var UserSchema = new Schema({          
    username : { type: String },                    //用戶賬號
    userpwd: {type: String},                        //密碼
    userage: {type: Number},                        //年齡
    logindate : { type: Date}                       //最近登錄時間
});

module.exports = mongoose.model(‘User‘,UserSchema);
技術分享圖片

常用數據庫操作

  接下來創建一個test.js文件做一些常用操作演示。

  插入

  Model#save([fn])

技術分享圖片
var User = require("./user.js");

/**
 * 插入
 */
function insert() {
 
    var user = new User({
        username : ‘Tracy McGrady‘,                 //用戶賬號
        userpwd: ‘abcd‘,                            //密碼
        userage: 37,                                //年齡
        logindate : new Date()                      //最近登錄時間
    });

    user.save(function (err, res) {

        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }

    });
}

insert();
技術分享圖片

  結果在robmongo工具中查看

技術分享圖片

  從圖中可以看到插入成功! 

  更新

  Model.update(conditions, update, [options], [callback])

技術分享圖片
var User = require("./user.js");

function update(){
    var wherestr = {‘username‘ : ‘Tracy McGrady‘};
    var updatestr = {‘userpwd‘: ‘zzzz‘};
    
    User.update(wherestr, updatestr, function(err, res){
        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }
    })
}

update();
技術分享圖片

  根據用戶名更新密碼,執行後結果如圖

技術分享圖片

  圖中可以看出,密碼更新成功!update方法基本可以滿足所有更新!

  

  常用方法還有findByIdAndUpdate,這種比較有指定性,就是根據_id

  Model.findByIdAndUpdate(id, [update], [options], [callback])

技術分享圖片
var User = require("./user.js");

function findByIdAndUpdate(){
    var id = ‘56f2558b2dd74855a345edb2‘;
    var updatestr = {‘userpwd‘: ‘abcd‘};
    
    User.findByIdAndUpdate(id, updatestr, function(err, res){
        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }
    })
}

findByIdAndUpdate();
技術分享圖片

  

  其它更新方法

  Model.findOneAndUpdate([conditions], [update], [options], [callback])      //找到一條記錄並更新

  

  刪除

  Model.remove(conditions, [callback])

技術分享圖片
var User = require("./user.js");

function del(){
    var wherestr = {‘username‘ : ‘Tracy McGrady‘};
    
    User.remove(wherestr, function(err, res){
        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }
    })
}

del();
技術分享圖片

  結果就不貼了,res中會返回是否成功以及影響的行數:{"ok":1,"n":1}

  其它常用方法還有:

  Model.findByIdAndRemove(id, [options], [callback])      

  Model.findOneAndRemove(conditions, [options], [callback])

  條件查詢

  已先插入一些測試數據 。。

  Model.find(conditions, [fields], [options], [callback])

技術分享圖片
var User = require("./user.js");

function getByConditions(){
    var wherestr = {‘username‘ : ‘Tracy McGrady‘};
    
    User.find(wherestr, function(err, res){
        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }
    })
}

getByConditions();
技術分享圖片

  結果我就不展示了

  第2個參數可以設置要查詢輸出的字段,比如改成

技術分享圖片
var User = require("./user.js");

function getByConditions(){
    var wherestr = {‘username‘ : ‘Tracy McGrady‘};
    var opt = {"username": 1 ,"_id": 0};
    
    User.find(wherestr, opt, function(err, res){
        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }
    })
}

getByConditions();
技術分享圖片

  輸出只會有username字段,設置方法如上,1表示查詢輸出該字段,0表示不輸出

  比如我要查詢年齡範圍條件應該怎麽寫呢?

  User.find({userage: {$gte: 21, $lte: 65}}, callback); //這表示查詢年齡大於等21而且小於等於65歲

  其實類似的還有: 

  $or    或關系

  $nor    或關系取反

  $gt    大於

  $gte    大於等於

  $lt     小於

  $lte    小於等於

  $ne 不等於

  $in 在多個值範圍內

  $nin 不在多個值範圍內

  $all 匹配數組中多個值

  $regex  正則,用於模糊查詢

  $size   匹配數組大小

  $maxDistance  範圍查詢,距離(基於LBS)

  $mod   取模運算

  $near   鄰域查詢,查詢附近的位置(基於LBS)

  $exists   字段是否存在

  $elemMatch  匹配內數組內的元素

  $within  範圍查詢(基於LBS)

  $box    範圍查詢,矩形範圍(基於LBS)

  $center 範圍醒詢,圓形範圍(基於LBS)

  $centerSphere  範圍查詢,球形範圍(基於LBS)

  $slice    查詢字段集合中的元素(比如從第幾個之後,第N到第M個元素)

  

  可能還有一些,沒什麽印象,大家自行看看api ^_^!  

  數量查詢

  Model.count(conditions, [callback])

技術分享圖片
var User = require("./user.js");

function getCountByConditions(){
    var wherestr = {};
    
    User.count(wherestr, function(err, res){
        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }
    })
}
getCountByConditions();
技術分享圖片

  res會輸出數量,也可以傳入條件做條件查詢!

  根據_id查詢

  Model.findById(id, [fields], [options], [callback])

技術分享圖片
var User = require("./user.js");

function getById(){
    var id = ‘56f261fb448779caa359cb73‘;
    
    User.findById(id, function(err, res){
        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }
    })
}

getById();
技術分享圖片

  這個還是比較常用,要據ID得到數據!  

  模糊查詢

技術分享圖片
var User = require("./user.js");

function getByRegex(){
    var whereStr = {‘username‘:{$regex:/m/i}};
    
    User.find(whereStr, function(err, res){
        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }
    })
}

getByRegex();
技術分享圖片

  上面示例中查詢出所有用戶名中有‘m‘的名字,且不區分大小寫,模糊查詢比較常用,正則形式匹配,正則方式就是javascript正則,用到的比較多!

  分頁查詢

技術分享圖片
var User = require("./user.js");

function getByPager(){
    
    var pageSize = 5;                   //一頁多少條
    var currentPage = 1;                //當前第幾頁
    var sort = {‘logindate‘:-1};        //排序(按登錄時間倒序)
    var condition = {};                 //條件
    var skipnum = (currentPage - 1) * pageSize;   //跳過數
    
    User.find(condition).skip(skipnum).limit(pageSize).sort(sort).exec(function (err, res) {
        if (err) {
            console.log("Error:" + err);
        }
        else {
            console.log("Res:" + res);
        }
    })
}

getByPager();
技術分享圖片

  分頁是用得比較多的查詢,分頁原理用過其它數據庫的都知道,分頁用到的函數和mysql的比較類似

  上面我用到sort(),這個是排序規則,就不單講了!

其它操作

  其它還有比較多常用的

  索引和默認值

  再看看我對user.js這個schema的修改

技術分享圖片
/**
 * 用戶信息
 */
var mongoose = require(‘./db.js‘),
    Schema = mongoose.Schema;

var UserSchema = new Schema({          
    username : { type: String , index: true},                    //用戶賬號
    userpwd: {type: String},                        //密碼
    userage: {type: Number},                        //年齡
    logindate : { type: Date, default:Date.now}                       //最近登錄時間
});

module.exports = mongoose.model(‘User‘,UserSchema);
技術分享圖片

  index :建索引

  default:默認值

  

  LBS地址位置

lbs : { type: Array, index: ‘2d‘, sparse: true }   //地理位置

  上面有介紹過很多基於LBS的條件查詢,Schema中定義時如上

  LBS查詢對於一些基於LBS應用會用得比較多。

  其它常用方法

  Model.distinct(field, [conditions], [callback])                  //去重

  Model.findOne(conditions, [fields], [options], [callback])             //查找一條記錄

  Model.findOneAndRemove(conditions, [options], [callback])           //查找一條記錄並刪除

  Model.findOneAndUpdate([conditions], [update], [options], [callback])      //查找一條記錄並更新

作 者: Porschev[鐘慰]
出 處: http://www.cnblogs.com/zhongweiv/
微 博: http://weibo.com/porschev
歡迎任何形式的轉載,但請務必註明原文詳細鏈接

Mongoose介紹和入門