摘要:目錄一創建項目二配置路由三靜態資源四模板引擎五結語是由原班人馬打造的超輕量服務端框架與相比,除了自由度更高,可以自行引入中間件之外,更重要的是使用了,從而避免了回調地獄不過也是因為代碼升級,所以需要以上的環境一創建項目手動創建一個項目目錄,
目錄
一、創建項目
二、配置路由
三、靜態資源
四、模板引擎
五、結語
Koa 是由 Express 原班人馬打造的超輕量服務端框架
與 Express 相比,除了自由度更高,可以自行引入中間件之外,更重要的是使用了 ES6 + async,從而避免了回調地獄
不過也是因為代碼升級,所以 Koa2 需要 v7.60 以上的 node.js 環境
一、創建項目
手動創建一個項目目錄,然后快速生成一個 package.json 文件
npm init -y
安裝 koa //當前版本 2.4.1
npm install koa -S
然后創建一個 app.js
`// app.js` `const Koa = require(``"koa"``);` `const app =` `new` `Koa();` `app.use(async ctx => {` `ctx.body =` `"Wise Wrong"``;` `});` `app.listen(3000);`
最后在 package.json 中添加啟動指令
image
一個最基礎的 koa 應用就這樣完成了
可以執行 npm start 并在瀏覽器訪問http://localhost:3000/ 查看效果
如果覺得手動創建項目太過繁瑣,可以使用腳手架 koa-generato 來生成項目
npm install koa-generator -g
koa2 project_name
然后在項目下 npm install 安裝依賴,npm start 啟動項目
如果是剛接觸 koa,建議先看完這篇博客,再使用腳手架工具,這樣能更好的理解各個依賴包的作用
二、配置路由
上面 app.js 中有一個 ctx,這是一個 Koa 提供的 Context 對象,封裝了 request 和 response
每一次 HTTP Request 都會創建一個 Context 對象
我們可以通過 Context.request.path 來獲取用戶請求的路徑,然后通過 Context.response.body 給用戶發送內容
Koa 默認的返回類型是 text/plain,如果要返回一個 html 文件(或者一個模塊文件),就需要修改 Context.response.type
另外,Context.response 可以簡寫,比如 Context.response.type 簡寫為 Context.type,Context.response.body 簡寫為 Context.type
在項目下創建一個存放 html 文件的目錄 views,并在該目錄下創建一個 index.html,然后修改 app.js
`// app.js// 原生路由` `const Koa = require(``"koa"``);` `const fs = require(``"fs"``);` `const app =` `new` `Koa();` `app.use(async (ctx, next) => {` `if` `(ctx.request.path ===` `"/index"``) {` `ctx.type =` `"text/html"``;` `ctx.body = fs.createReadStream(``"./views/index.html"``);` `}` `else` `{` `await next();` `}` `});` `app.listen(3000);`
然后在瀏覽器中訪問 就能看到 index.html 頁面,而訪問別的地址則是 not found
這樣處理 url 顯得特別笨拙,所以我們需要引入路由中間件 koa-router
npm install koa-router -S
需要注意的是,在導入 koa-router 的時候,需要在末尾加一個括號:
const router = require("koa-router")();
相當于:
const koaRouter = require(``"koa-router"``); const router = koaRouter();
創建一個 routes 目錄,用來存放路由文件,并在目錄下創建 index.js
image `// routes/index.js` `const fs = require(``"fs"``);` `const router = require(``"koa-router"``)()` `router.get(``"/index"``, async (ctx, next) => {` `ctx.type =` `"text/html"``;` `ctx.body = fs.createReadStream(``"./views/index.html"``);` `});` `module.exports = router`
這里還可以使用 prefix 方法,為文件中的所有接口添加一個 baseUrl
// router.prefix("/about") 修改 app.js `// app.js` `const Koa = require(``"koa"``);` `const app =` `new` `Koa();` `const index = require(``"./routes/index"``)` `app.use(index.routes(), index.allowedMethods())` `app.listen(3000);`
上面的 allowedMethods 用于校驗請求的方法,如果用 post 請求訪問 get 接口,就會直接返回失敗
另外,還可以在 url 中添加變量,然后通過 Context.params.name 訪問
`router.get(``"/about/:name"``, async (ctx, next) => {` `ctx.body = `I am ${ctx.params.name}!`;` `});`
三、靜態資源
在上面的 index.html 中,如果需要引入 css 等靜態資源,就需要用到 [koa-static]
npm install koa-static -S
創建一個目錄 public 用來存放靜態資源
image 然后在 app.js 中添加以下代碼 `const static = require(``"koa-static"``);` `// 將 public 目錄設置為靜態資源目錄` `const main = static(__dirname +` `"/public"``);` `app.use(main);`
事實上,這三行代碼還可以優化
pp.use(require("koa-static")(__dirname + "/public"``));
然后就能在 index.html 中引入對應的文件了
image
四、模板引擎
上面的路由是使用 fs 模塊直接讀取 html 文件
開發的時候更推薦使用 koa-views 中間件來渲染頁面
npm install koa-views -S
在 app.js 中將 views 目錄設定為模版目錄
`const views = require(``"koa-views"``)` `app.use(views(__dirname +` `"/views"``));` 然后在路由文件中,就能使用 render 方法了 `// routes/index.js` `const router = require(``"koa-router"``)()` `router.get(``"/index"``, async (ctx, next) => {` `await ctx.render(``"index"``);` `});` `module.exports = router`
以上是直接渲染 html 文件的方法,如果要引入模板引擎,可以添加 extension 字段來設定模版類型
`app.use(views(__dirname +` `"/views"``, {` `extension:` `"pug"` `// 以 pug 模版為例` `}))`
五、結語
如果將 Express 看作 webstorm,那么 Koa 就是 sublime
當 Express 流行的時候,其冗雜的依賴項被很多開發者所詬病
所以 Express 團隊將 Express 拆卸得只剩下最基本的骨架,讓開發者自行組裝,這就是 Koa
正如文中所說,從零開始太過繁瑣,可以使用腳手架 koa-generato 來快速開發
不過我更推薦,在熟悉了 Koa 之后,搭一個適合自己項目的腳手架
不然為何不直接用 Express 呢
我想這也是 Koa 的官方文檔中沒有提到 generato 工具的原因吧了解更多
文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規行為,您可以聯系管理員刪除。
轉載請注明本文地址:http://specialneedsforspecialkids.com/yun/27535.html
摘要:目錄一創建項目二配置路由三靜態資源四模板引擎五結語是由原班人馬打造的超輕量服務端框架與相比,除了自由度更高,可以自行引入中間件之外,更重要的是使用了,從而避免了回調地獄不過也是因為代碼升級,所以需要以上的環境一創建項目手動創建一個項目目錄, 目錄 一、創建項目二、配置路由三、靜態資源四、模板引擎五、結語 Koa 是由 Express 原班人馬打造的超輕量服務端框架與 Express 相...
摘要:云集一線大廠有真正實力的程序員團隊云集一線大廠經驗豐厚的碼農,開源奉獻各教程。融合多種常見的需求場景網絡請求解析模板引擎靜態資源日志記錄錯誤請求處理。結合語句中轉中間件控制權,解決回調地獄問題。注意分支中的目錄為當節課程后的完整代碼。 ?? ?與眾不同的學習方式,為你打開新的編程視角 獨特的『同步學習』方式 文案講解+視頻演示,文字可激發深層的思考、視頻可還原實戰操作過程。 云...
摘要:玩轉同時全面掌握潮流技術采用新一代的開發框架更小更富有表現力更健壯。融合多種常見的需求場景網絡請求解析模板引擎靜態資源日志記錄錯誤請求處理。結合語句中轉中間件控制權,解決回調地獄問題。注意分支中的目錄為當節課程后的完整代碼。 ?? ?與眾不同的學習方式,為你打開新的編程視角 獨特的『同步學習』方式 文案講解+視頻演示,文字可激發深層的思考、視頻可還原實戰操作過程。 云集一線大廠...
安裝搭建項目的開發環境 視頻地址:https://www.cctalk.com/v/15114357764004 showImg(https://segmentfault.com/img/remote/1460000012470016?w=1214&h=718); 文章 Koa 起手 - 環境準備 由于 koa2 已經開始使用 async/await 等新語法,所以請保證 node 環境在 7.6...
閱讀 1393·2021-11-22 15:11
閱讀 2838·2019-08-30 14:16
閱讀 2755·2019-08-29 15:21
閱讀 2914·2019-08-29 15:11
閱讀 2451·2019-08-29 13:19
閱讀 2985·2019-08-29 12:25
閱讀 417·2019-08-29 12:21
閱讀 2829·2019-08-29 11:03