Doodoo.js – 中文最佳实践Node.js Web快速开发框架。支持Koa.js中间件，支持模块化，插件，钩子机制，可以直接在项目里使用 ES6/7（Generator Function, Class, Async & Await）等特性。同时吸收了thinkphp，laravel等国内外众多框架的设计理念和思想，让开发 Node.js 项目更加简单、高效、灵活。
使用 ES6/7 特性来开发项目可以大大提高开发效率，是趋势所在。并且新版的 Node.js 对 ES6 特性也有了较好的支持，即使有些特性还没有支持，也可以借助 Babel 编译来支持。
支持koa全部中间件
支持使用 ES6+ 全部特性来开发项目
支持断点调试 ES6+ 项目
支持多种项目结构和多种项目环境
支持 Route, Controller 中使用Koa.js的所有API
支持多级 Controller
支持模块化开发
支持钩子机制
支持插件机制
支持错误处理
支持全局doodoo变量
支持Bookshelf, knex链接数据库
支持前置，后置操作
支持 Restful 设计
支持启动自定义
支持环境加载配置
…
环境要求：node >= 7.6.0, git（doodoo.js的所有包都托管在github上）
//npm npm install doodooke/doodoo.js --save //yarn yarn add doodooke/doodoo.js
//base controller, app/demo/controller/base.js module.exports = class extends doodoo.Controller { async _initialize() { console.log('base _initialize'); } async isLogin() { console.log('base isLogin'); } } //index controller, app/demo/controller/index.js const base = require('./base'); module.exports = class extends base { async _initialize() { await super._initialize(); } async index() { this.success("Hello Doodoo.js"); } async index2() { this.fail("Hello Doodoo.js"); } }
项目中可以使用 ES6/7 里的特性，可以稳定运行在 >= 7.6.0 的 Node.js 环境中。
服务 启动日志
[doodoo] Version: 1.0.1 [doodoo] Website: 127.0.0.1 [doodoo] Nodejs Version: v10.5.0 [doodoo] Nodejs Platform: darwin x64 [doodoo] Server Enviroment: development [doodoo] Server Startup Time: 212ms [doodoo] Server Current Time: 2018-08-21 11:17:19 [doodoo] Server Running At: http://127.0.0.1:3000
HTTP 请求日志
<-- GET /home/index/index --> GET /home/index/index 200 4ms
与 express/koa 对比
express/koa 是 2 个比较简单的框架，框架本身提供的功能比较简单，项目中需要借助大量的第三方插件才能完成项目的开发，所以灵活度比较高。但使用很多第三方组件一方面提高了项目的复杂度。
koa 1.x 使用 ES6 里的 */yield 解决了异步回调的问题，但 */yield 只会是个过渡解决方案，会被 ES7 里的 async/await 所替代。
*/yield
async/await
与 sails 对比
sails 也是一个提供整套解决方案的 Node.js 框架，对数据库、REST API、安全方面也很多封装，使用起来比较方便。
但 sails 对异步回调的问题还没有优化，还是使用 callback 的方式，给开发带来很大的不便，导致项目中无法较好的使用 ES6/7 特性。
与 thinkjs 对比
thinkjs 是一个非常优秀的框架，在开发效率和体验上占有绝对优势，但是中间件非常少，框架还比较新，缺少社区等方面的支持，还没有经过超大型项目的检验。
// 下载demo git clone https://github.com/doodooke/doodoo.js.git // 安装依赖 yarn install // 进入项目 cd doodoo.js/example // 启动项目 node app.js
在项目目录下执行命令 node app.js，如果能看到类似下面的内容，表示服务启动成功。
node app.js
项目默认使用的是mysql，redis数据库。
|-- app | |-- demo | | |-- controller | | | |-- home | | | | |-- index.js | | | | `-- base.js | | | |-- admin | | |-- model | | |-- hook.js |-- logs |-- node_modules |-- www |-- app.js |-- package.json
源代码目录
模块控制器目录
模块模型目录
模块钩子文件
静态文件目录，存放图片，样式等文件的目录
项目启动入口文件
doodoo.js无伦是文件名还是控制器都默认区分大小写，很多在 Windows 下开发项目不区分大小写，所以如果服务器环境是 Linux 要特别注意。
Windows
Linux
ES6 中有大量的语法糖可以简化我们的代码，让代码更加简洁高效。 Node.js 最新版本已经较好的支持了 ES6 的语法，即使有些语法不支持，也可以通过 Babel 编译来支持。
控制器 constructor 方法请尽量不要使用，推荐使用 _initialize ，如果需要使用，必须调用 super
constructor
_initialize
super
module.exports = class doodoo.Controller { constructor(ctx, next) { super(ctx, next); } }
虽然现在的 Node.js 版本已经支持了很多 ES6 的特性，但这些特性现在还只是实现了，V8 里还没有对这些特性进行优化。如：*/yield 等功能。
所以建议使用 Babel 来编译，一方面可以使用 ES6 和 ES7 几乎所有的特性，另一方面编译后的性能也比默认支持的要高。
async/await 是nodejs异步最终解决方案
无论是在 VS Code（v1.7+） 下断点调试，还是在WebStorm 下断点调试，断点一定要设置在 runtime 目录下，不能设置在 app目录下。
ES6/7 里提供了大量的新特性，这些特性会带来巨大的开发便利和效率上的提升。如：ES6 里的 */yield 和 ES7 里的 async/await 特性解决异步回调的问题；箭头函数解决 this 作用域的问题；class 语法糖解决类继承的问题。
this
class
虽然现在 Node.js 环境还没有完全支持这些新的特性，但借助 Babel 编译，可以稳定运行在现在的 Node.js 环境中。所以我们尽可以享受这些新特性带来的便利。
默认情况下，Node.js 服务监听的端口为 3000，如果需要修改的话，可以通过修改配置文件.env 来修改，如：
3000
.env
APP_PORT=3000
使用 async/await 来处理异步时，是串行执行的。但很多场景下我们需要并行处理，这样可以大大提高执行效率，此时可以结合 Promise.all 来处理。
Promise.all
module.exports = class extends doodoo.Controller { async index() { let d1 = this.getData1(); let d2 = this.getData2(); let [d1Data, d2Data] = await Promise.all([d1, d2]); } }
项目中有时候要输出图片等类型的数据，可以通过下面的方式进行：
module.exports = class extends doodoo.Controller { async index() { //图片 buffer 数据，读取本地文件或者从远程获取 let imageBuffer = new Buffer(); this.set('Content-Type', 'image/png'); this.view(imageBuffer); } }
// app/demo/controller/home/base.js module.exports = class extends doodoo.Controller { async _initialize() { await this.isLogin(); } async isLogin() { // 判断登录业务逻辑 } } // app/demo/controller/home/index.js const base = require("./base"); module.exports = class extends base { async _initialize() { await super._initialize(); } async index() { this.success(); } }
Doodoo.js 创建项目时支持多种项目模式，默认创建的项目是按模块来划分的。使用模块的方式划分项目，可以让项目结构更加清晰。
app 下面的目录就是模块列表
app
控制器是一类操作的集合，用来响应用户同一类的请求。
创建文件 app/demo/controller/home/index.js，表示 demo 模块下有名为 home/index 控制器，文件内容类似如下：
app/demo/controller/home/index.js
demo
home/index
module.exports = class extends doodoo.Controller { async index (){ this.view('Hello World!'); } }
ctx上的函数或参数将自动加载到Controller，例如支持 this.body = 'Hello World!', ctx中具体的API请参考Koa.js, Controller中的扩展方法如下。
this.body = 'Hello World!'
this.ctx; this.next; this.isGet(); this.isPost(); this.isAjax(); this.isPjax(); this.isMethod(method); this.hook.run(name, ...args); this.download(file); this.view(data); this.success(errmsg: "ok", errcode: 0, data: data); this.error(errmsg = "error", errcode = 1);
# .env文件 # 应用配置 APP_ROOT=app APP_PORT=3000 APP_HOST=127.0.0.1 # MYSQL数据库链接 MYSQL=true MYSQL_HOST=127.0.0.1 MYSQL_USER=root MYSQL_PASSWORD=root MYSQL_DATABASE=doodoo MYSQL_PORT=3306 MYSQL_CHARSET=utf8mb4 # REDIS链接 REDIS=false REDIS_HOST=127.0.0.1 REDIS_PORT=6379 REDIS_PREFIX=doodoo: # 静态资源服务 STATIC_DIR=www STATIC_MAXAGE=30 * 24 * 60 * 60 STATIC_DYNAMIC=true
创建 .env 配置文件，例如修改默认启动端口
Doodoo.js默认使用了自动加载路由，类似于thinkphp的开发方式。例如访问的路径是 /demo/home/user/index，demo会解析成模块，home/user会解析成控制器，index会解析成方法，此时会加载 app/demo/controller/home/user.js 下的index方法。
/demo/home/user/index
app/demo/controller/home/user.js
Doodoo.js支持多级控制器，例如访问的路径是 /demo/home/shop/product/index，demo会解析成模块，home/shop/product会解析成控制器，index解析成方法，此时会加载 app/controller/home/shop/product.js 下的index方法。
/demo/home/shop/product/index
app/controller/home/shop/product.js
钩子一般用于数据统计，功能扩展等，默认是开启状态。
// 注册 this.hook.add('addOrder', async function sendEmail(orderId) { // 业务逻辑 }); this.hook.add('addOrder', async function addLog(orderId) { // 业务逻辑 }); // 运行 - 等待 await this.hook.run('addOrder', 1); // 运行 - 不等待 this.hook.run('addOrder', 1);
Doodoo.js登录授权验证如果是异步的，可以放到前后置操作里面。如果前后置操作输出数据到页面的话，响应将会中断不会再继续执行下面的流程。
// app/demo/controller/home/index.js module.exports = class extends doodoo.Controller { async _initialize() { // 控制器初始化 } async _before() { // 控制器前置 } async _before_index() { // 方法前置 } async index() { this.view('Hello World!'); } async _after_index() { // 方法后置 } async _after() { // 控制器后置 } }
Doodoo.js默认使用了bookshelf。可以通过中间件的方式，自定义支持mysql，mongodb等等各种数据库。
例如使用 koa-cors中间件，跟使用koa.js中间件一样。
koa-cors
const Doodoo = require("doodoo.js"); const cors = require("koa-cors"); const app = new Doodoo(); app.use(cors()); app.start();
中间件列表
正式环境推荐使用 pm2 启动项目，配置参考
pm2
{ "name": "doodoo.js-demo", "script": "app.js", "watch": false, "ignore_watch": [ "www/public", "logs", "node_modules" ], "exec_mode": "cluster", "max_memory_restart": "1G", "error_file": "./logs/error.log", "out_file": "./logs/out.log", "node_args": [], "args": [], "env": {} }
Doodoo实例
const Doodoo = require("doodoo.js"); const app = new Doodoo();
获取socket
const Doodoo = require("doodoo.js"); const socket = require("socket.io"); const app = new Doodoo(); (async () => { const server = app.start(); const io = socket(server); })
如发现文档中的错误，请点击这里联系作者。
