本插件基于 node-mongodb-native，提供了 MongoDB 官方 driver 及 API。
插件对一些常用 API 进行了简单封装以简化使用，同时保留了所有原版属性。例如，使用原版 API 进行一次查找需要写
db.collection('name')
.find(query)
.skip(skip)
.limit(limit)
.project(project)
.sort(sort)
.toArray();封装后
app.mongo.find('name', { query, skip, limit, project, sort });此插件完全支持 Promise，并强烈推荐使用 async/await。
安装
$ npm i egg-mongo-native --save开启插件
// config/plugin.js
exports.mongo = {
enable: true,
package: 'egg-mongo',
};配置
// {app_root}/config/config.default.js
exports.mongo = {
client: {
host: 'localhost',
port: 27017,
name: 'test',
},
};请到 config/config.default.js 查看详细配置项说明。
使用示例
本插件提供的 API 只是对原版 API 进行了必要的简化，所有属性名称与原版 API 一致。所有针对文档操作的 API，通常接受 2 个参数，第一个参数是 collection 名称，第二个参数是一个对象，属性名即为原版 API 的所有参数。例如，使用原版 API 进行一次插入
db.collection('name').insertOne(doc, options);使用插件 API
const args = { doc, options };
app.mongo.insertOne('name', args);可以看到 args 就是包含原版 API 参数的一个对象。
目前插件提供的 API 包括：
connect() // 不需要用户调用
insertOne()
findOneAndUpdate()
findOneAndReplace()
findOneAndDelete()
insertMany()
updateMany()
deleteMany()
find()
count()
distinct()
createIndex()
listCollection()
createCollection()当然，在任何时候你也都可以使用 app.mongo.db 调用所有 API。你可以在这里查看所有 API：Node.js MongoDB Driver API。
同步与异步
node-mongodb-native 所有 API 都支持 Promise，因此你可以自由地以异步或同步方式使用本插件。
异步
// Promise
function create(doc) {
app.mongo.insertOne('name', { doc })
.then(result => console.log(result))
.catch(error => console.error(error));
}同步
// 使用 async/await
async function create(doc) {
try {
const result = await app.mongo.insertOne('name', { doc });
console.log(result);
} catch (error) {
console.error(error);
}
}
// 使用 Generator
function* create(doc) {
try {
const result = yield app.mongo.insertOne('name', { doc });
console.log(result);
} catch (errpr) {
console.error(error);
}
}如果你使用 app.mongo.db 调用原版 API，则也可以使用回调函数。插件封装的 API 不支持回调函数，因为 Promise 和 async/await 更加优雅。
Node.js 7.6 开始已经原生支持 async/await，不再需要 Babel。
