资讯专栏INFORMATION COLUMN

Node.js使用Koa搭建 基础项目

lewif / 3103人阅读

摘要:目录一创建项目二配置路由三静态资源四模板引擎五结语是由原班人马打造的超轻量服务端框架与相比,除了自由度更高,可以自行引入中间件之外,更重要的是使用了,从而避免了回调地狱不过也是因为代码升级,所以需要以上的环境一创建项目手动创建一个项目目录,

目录

一、创建项目
二、配置路由
三、静态资源
四、模板引擎
五、结语

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 工具的原因吧了解更多

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/27535.html

相关文章

  • Node.js使用Koa搭建 基础项目

    摘要:目录一创建项目二配置路由三静态资源四模板引擎五结语是由原班人马打造的超轻量服务端框架与相比,除了自由度更高,可以自行引入中间件之外,更重要的是使用了,从而避免了回调地狱不过也是因为代码升级,所以需要以上的环境一创建项目手动创建一个项目目录, 目录 一、创建项目二、配置路由三、静态资源四、模板引擎五、结语 Koa 是由 Express 原班人马打造的超轻量服务端框架与 Express 相...

    BingqiChen 评论0 收藏0
  • 【完结汇总】iKcamp出品基于Koa2搭建Node.js实战共十一堂课(含视频)

    摘要:云集一线大厂有真正实力的程序员团队云集一线大厂经验丰厚的码农,开源奉献各教程。融合多种常见的需求场景网络请求解析模板引擎静态资源日志记录错误请求处理。结合语句中转中间件控制权,解决回调地狱问题。注意分支中的目录为当节课程后的完整代码。 ??  与众不同的学习方式,为你打开新的编程视角 独特的『同步学习』方式 文案讲解+视频演示,文字可激发深层的思考、视频可还原实战操作过程。 云...

    sPeng 评论0 收藏0
  • 开始连载啦~每周2更共11堂iKcamp课|基于Koa2搭建Node.js实战项目教学(含视频)|

    摘要:玩转同时全面掌握潮流技术采用新一代的开发框架更小更富有表现力更健壮。融合多种常见的需求场景网络请求解析模板引擎静态资源日志记录错误请求处理。结合语句中转中间件控制权,解决回调地狱问题。注意分支中的目录为当节课程后的完整代码。 ??  与众不同的学习方式,为你打开新的编程视角 独特的『同步学习』方式 文案讲解+视频演示,文字可激发深层的思考、视频可还原实战操作过程。 云集一线大厂...

    B0B0 评论0 收藏0
  • iKcamp团队制作|基于Koa2搭建Node.js实战项目教学(含视频)☞ 环境准备

    安装搭建项目的开发环境 视频地址:https://www.cctalk.com/v/15114357764004 showImg(https://segmentfault.com/img/remote/1460000012470016?w=1214&h=718); 文章 Koa 起手 - 环境准备 由于 koa2 已经开始使用 async/await 等新语法,所以请保证 node 环境在 7.6...

    bang590 评论0 收藏0

发表评论

0条评论

lewif

|高级讲师

TA的文章

阅读更多
最新活动
阅读需要支付1元查看
<