摘要：是阿里推出的基于的開(kāi)發(fā)框架，今天抽空體驗(yàn)了下，按官方教程做一個(gè)。用于解析用戶的輸入，處理后返回相應(yīng)的結(jié)果，具體參見(jiàn)。用于編寫業(yè)務(wù)邏輯層，可選，建議使用，具體參見(jiàn)。和用于自定義啟動(dòng)時(shí)的初始化工作，可選，具體參見(jiàn)啟動(dòng)自定義。

egg.js是阿里推出的基于koa的node開(kāi)發(fā)框架，今天抽空體驗(yàn)了下，按官方教程做一個(gè)Hacker News。其實(shí)官方有腳手架提供，但是這次我們不用。

開(kāi)始之前，我們先看下KOA對(duì)于中間件的洋蔥模型，了解這個(gè)，對(duì)于我們之后理解一個(gè)請(qǐng)求的執(zhí)行路徑會(huì)很有幫助。

好了，讓我們開(kāi)始我們的egg之旅吧！

1, 先初始化項(xiàng)目結(jié)構(gòu)：

$ mkdir egg-example
$ cd egg-example
$ npm init
$ npm i egg --save
$ npm i egg-bin --save-dev

2, 在package.json里，添加如下命令：

"scripts": {
    "dev": "egg-bin dev"
  }

3， 開(kāi)始編寫代碼，這之前，我們應(yīng)該對(duì)項(xiàng)目的目錄結(jié)構(gòu)有個(gè)約定，官方的說(shuō)明在這里 https://eggjs.org/zh-cn/basic... 我們到時(shí)候在回來(lái)說(shuō)下這個(gè)目錄。

4 我們需要一個(gè)controller，一個(gè)router，一個(gè)config，內(nèi)如如下

// app/controller/home.js
const Controller = require("egg").Controller;

class HomeController extends Controller {
  async index() {
    this.ctx.body = "Hello world";
  }
}

module.exports = HomeController;

// app/router.js
module.exports = app => {
  const { router, controller } = app;
  router.get("/", controller.home.index);
};


// config/config.default.js
exports.keys = <此處改為你自己的 Cookie 安全字符串>;

此時(shí)，目錄結(jié)構(gòu)如下：

egg-example
├── app
│   ├── controller
│   │   └── home.js
│   └── router.js
├── config
│   └── config.default.js
└── package.json

好了，現(xiàn)在檢查下，運(yùn)行 npm run dev，
在 http://127.0.0.1:7001/ 檢查下，一切ok

這里有幾個(gè)地方要注意下

Controller 有class和exports兩個(gè)寫法，那么這兩個(gè)寫法有什么區(qū)別呢？

按照類的方式編寫Controller，不僅可以讓我們更好的對(duì) Controller層代碼進(jìn)行抽象（例如將一些統(tǒng)一的處理抽象成一些私有方法），還可以通過(guò)自定義Controller 基類的方式封裝應(yīng)用中常用的方法。至于方法的方式，官方不推薦使用，只是為了做兼容，其中，每一個(gè) Controller 都是一個(gè) async function，它的入?yún)檎?qǐng)求的上下文 Context 對(duì)象的實(shí)例，通過(guò)它我們可以拿到框架封裝好的各種便捷屬性和方法 

config也有module.exports 和 exports兩種寫法，那么這兩種寫法有什么區(qū)別呢？

module.exports是Module系統(tǒng)創(chuàng)建對(duì)象的語(yǔ)法，但是如果你希望你的
module是一個(gè)類的實(shí)例，你可以將實(shí)例賦予moduel.exports，如這時(shí)候
module.exprots指向的就是一個(gè)A的實(shí)例了，可以用以下方式調(diào)用A的方
法 module.exports.xxx(),等價(jià)于 a.xxx()。但是如果只是exports=
new ClassA();這個(gè)只是簡(jiǎn)單的將本模塊變量exports重新綁定了而已。注
意，對(duì)module.exports的綁定不能是異步綁定或者回調(diào)中！

可以這樣理解，其他模塊使用本模塊時(shí)，用的是module.exports指向的東
西，而exports是模塊內(nèi)部變量，外部模塊是無(wú)法訪問(wèn)的。
module.exports和exports是兩個(gè)變量，只是一開(kāi)始這兩個(gè)是指向同一個(gè)對(duì)
象而已?？梢栽谀K內(nèi)部用exports作為module.exports的快捷方式

現(xiàn)在，我們看下官方的目錄結(jié)構(gòu)規(guī)范：

egg-project
├── package.json
├── app.js (可選)
├── agent.js (可選)
├── app
|   ├── router.js
│   ├── controller
│   |   └── home.js
│   ├── service (可選)
│   |   └── user.js
│   ├── middleware (可選)
│   |   └── response_time.js
│   ├── schedule (可選)
│   |   └── my_task.js
│   ├── public (可選)
│   |   └── reset.css
│   ├── view (可選)
│   |   └── home.tpl
│   └── extend (可選)
│       ├── helper.js (可選)
│       ├── request.js (可選)
│       ├── response.js (可選)
│       ├── context.js (可選)
│       ├── application.js (可選)
│       └── agent.js (可選)
├── config
|   ├── plugin.js
|   ├── config.default.js
│   ├── config.prod.js
|   ├── config.test.js (可選)
|   ├── config.local.js (可選)
|   └── config.unittest.js (可選)
└── test
    ├── middleware
    |   └── response_time.test.js
    └── controller
        └── home.test.js

如上，由框架約定的目錄：
app/router.js 用于配置 URL 路由規(guī)則，具體參見(jiàn) Router。
app/controller/** 用于解析用戶的輸入，處理后返回相應(yīng)的結(jié)果，具體參見(jiàn) Controller。
app/service/** 用于編寫業(yè)務(wù)邏輯層，可選，建議使用，具體參見(jiàn) Service。
app/middleware/** 用于編寫中間件，可選，具體參見(jiàn) Middleware。
app/public/** 用于放置靜態(tài)資源，可選，具體參見(jiàn)內(nèi)置插件 egg-static。
app/extend/** 用于框架的擴(kuò)展，可選，具體參見(jiàn)框架擴(kuò)展。
config/config.{env}.js 用于編寫配置文件，具體參見(jiàn)配置。
config/plugin.js 用于配置需要加載的插件，具體參見(jiàn)插件。
test/** 用于單元測(cè)試，具體參見(jiàn)單元測(cè)試。
app.js 和 agent.js 用于自定義啟動(dòng)時(shí)的初始化工作，可選，具體參見(jiàn)啟動(dòng)自定義。關(guān)于agent.js的作用參見(jiàn)Agent機(jī)制。

由內(nèi)置插件約定的目錄：
app/public/** 用于放置靜態(tài)資源，可選，具體參見(jiàn)內(nèi)置插件 egg-static。
app/schedule/** 用于定時(shí)任務(wù)，可選，具體參見(jiàn)定時(shí)任務(wù)。

若需自定義自己的目錄規(guī)范，參見(jiàn) Loader API
app/view/** 用于放置模板文件，可選，由模板插件約定，具體參見(jiàn)模板渲染。
app/model/** 用于放置領(lǐng)域模型，可選，由領(lǐng)域類相關(guān)插件約定，如 egg-sequelize。

（未完待續(xù)）