在使用node.js时,时常与之搭配的是mongoDB,一般我们不写原生mongo语法,一个经常使用的mongo库便是mongoose,由于个人记性比较差,用过就忘了,因此便记录一下常用增删改查api.
安装mongoDB
安装文档: mongoDB安装
我是mac平台 用的是brew安装
更新 brew (官网上是这么写的 其实大可不必,直接跳过到第二步,会默认帮你更新)
brew update
brew install mongodb
其实到这里 就已经安装完了 并且可以启动了
输入 表示启动服务
mongod --config /usr/local/etc/mongod.conf
新起一个窗口启动
mongo
但是每次这样启动也很麻烦 我们配置一下
创建数据目录
sudo mkdir -p /data/db
进入安装目录 运行mongodb
cd /usr/local/Cellar/mongodb/<这里是你安装时的版本号对应文件夹>/bin
mongod
添加环境变量
export PATH=<安装路径>/bin:$PATH
把 <安装路径> 替换成你的, 比如我的 /usr/local/Cellar/mongodb/<这里是你安装时的版本号对应文件夹> , 其实和上面的路径对应搞定
输入mongod
另起窗口输入mongo
可视化工具
- 官网 robomongo
我个人使用的是robomongo 当然还有特别多优秀的客户端,根据个人喜好选择
快速开始
- mongoose官网
其实大部分都在官网写的十分详细,以备不时之需可以查阅
使用
const mongoose = require('mongoose')
// 可用于监测数据库状态
const db = mongoose.connection
// 连接数据库 test 表 如果不存在也没关系
mongoose.connect('mongodb://localhost/test', { useMongoClient: true });
// 用于解决警告
mongoose.Promise = global.Promise;
解释:
- { useMongoClient: true } 用于解决如下警告
(node:2772) DeprecationWarning:
open()
is deprecated in mongoose >= 4.11.0, useopenUri()
instead, or set theuseMongoClient
option if usingconnect()
orcreateConnection()
. See http://mongoosejs.com/docs/connections.html#use-mongo-client
创建 Schema
详见 Schema
const Schema = mongoose.Schema;
// 定义表模型的数据类型
// required 必须的 接收一个 boolean 或者 function
const blogSchema = new Schema({
title: {type: String, required: true},
author: String,
age: { type: Number, min: 18, max: 65 },
comments: [{ body: String, date: Date }],
date: { type: Date, default: Date.now },// default 默认当前时间戳
hidden: Boolean,
meta: {
votes: Number,
favs: Number
}
});
- 支持的类型
- String
- Number
- Date
- Buffer
- Boolean
- Mixed
- ObjectId
- Array
创建model
var Blog = mongoose.model('Blog', blogSchema);
注: 文档中在声明方法的时候不要使用箭头函数
创建文档
通过上面的步骤其实已经创建了表模型 创建一个文档并保存到数据库非常简单
增删改查
增加
方法一:
var Tank = mongoose.model('Tank', yourSchema);
var small = new Tank({ size: 'small' });
small.save(function (err, doc) {
if (err) return handleError(err);
console.log(doc)
})
create: Model.create(doc(s), [callback])
Tank.create({ size: 'small' }, function (err, small) {
if (err) return handleError(err);
console.log(small._doc)
})
Model.insertMany(doc(s), [options], [options.ordered, [options.rawResult, [callback])
这一方法比循环create
快 因为它只向服务器发送一个操作
var arr = [{ name: 'Star Wars' }, { name: 'The Empire Strikes Back' }];
Movies.insertMany(arr, function(error, docs) {});
删除
Tank.remove({ size: 'large' }, function (err) {
if (err) return handleError(err);
});
删除 Tank 表中 size
为 large
的数据
改(更新)
update: Model.update(conditions, doc, [options], [callback])
参数
conditions
__注: 不能修改主键 _id __
- options 有如下选项:
- safe (boolean): 默认为true。安全模式。
- upsert (boolean): 默认为false。如果不存在则创建新记录。
- multi (boolean): 默认为false。是否更新多个查询记录。
- runValidators: 如果值为true,执行Validation验证。
- setDefaultsOnInsert: 如果upsert选项为true,在新建时插入文档定义的默认值。
- strict (boolean): 以strict模式进行更新。
- overwrite (boolean): 默认为false。禁用update-only模式,允许覆盖记录
示例
MyModel.update({ name: 'Tobi' }, { ferret: true }, { multi: true }, function (err, raw) {
if (err) return handleError(err);
console.log('The raw response from Mongo was ', raw);
});
更新多个 name
为 Tobi
的文档 将 ferret 设置为 true
Model.updateMany
更新多条数据 与update相同
Model.updateOne
更新一条数据 设置 multi 无效
查找
find: Model.find(conditions, [projection], [options], [callback])
conditions
:查询条件;projection
:控制返回的字段;options
:控制选项;callback
:回调函数。
示例
// 命名 john age 大于等于 18 只返回 title 与 author 字段 skip 跳过 10 条
MyModel.find({ name: 'john', age: { $gte: 18 }},{title: 1, author: 1},
{ skip: 10 },
function (err, docs) {});
// 返回一个query对象 类似于 promise exec 于 then
var query = MyModel.find({ name: /john/i }, null, { skip: 10 })
query.exec(function (err, docs) {});
findOne: Model.findOne([conditions], [projection], [options], [callback])
使用方法与 find 相同 只不过只返回第一个查询记录
findById: Model.findById(id, [projection], [options], [callback])
根据 _id 字段查询
相关查询详见 mongoDB
比较查询操作符
- $gt 大于(>)
- $lt 小于(<)
- $gte 大于等于(>=)
- $lte 小于等于(<=)
- $eq 等于(=)
- $ne 不等于(!=)
- $in 一个键对应多个值(在数组中)
Model.find( { qty: { $in: [ 5, 15 ] } } ) // 查询 qty 等于 5 或者 15 的文档
- $nin 同上取反, 一个键不对应指定值
逻辑查询操作符
- $or 多个条件匹配, 可以嵌套 $in 使用
Model.find( { $or: [ { quantity: { $lt: 20 } }, { price: 10 } ] } )
// 查询 quantity 小于 20 或者 price 等于 10 的文档
$nor 同上取反
$not 不符合条件的文档
Model.find( { price: { $not: { $gt: 1.99 } } } ) // price 不大于 1.99的
- $and 与
其他常用运算符
limit 指定返回的最大条数
Query#limit(val)
query.limit(20)
skip 指定要跳过的条数
常用于分页 公式 skip = (page<页数> - 1) * pageSize<每页条数>;
Query#skip(val)
query.skip(100).limit(20)
sort 排序 降序 -1 升序 1
Query#sort(arg)
query.sort({ test: -1 }); // 将 query 降序排列
原文链接: mongoose 操作备忘