Mongoose介紹和入門

簡介

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

  那麼要使用它,首先你得裝上node.js和mongodb,關於mongodb的安裝和操做介紹能夠參考:http://www.cnblogs.com/zhongweiv/p/node_mongodb.htmlhtml

 

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

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

 

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

 

  下面咱們一步步來了解mongoose的基本操做^_^!git

 

mongoose安裝

npm install mongoose

  安裝成功後以下圖:github

  安裝成功後,就能夠經過 require('mongoose') 來使用!sql

 

鏈接字符串

  建立一個db.jsmongodb

複製代碼
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 歡迎任何形式的轉載,但請務必註明原文詳細連接

相關文章
相關標籤/搜索