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

前端之家收集整理的这篇文章主要介绍了Node.js使用Koa搭建 基础项目前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

Koa 是由 Express 原班人马打造的超轻量服务端框架

与 Express 相比,除了自由度更高,可以自行引入中间件之外,更重要的是使用了 ES6 + async,从而避免了回调地狱

不过也是因为代码升级,所以 Koa2 需要 v7.60 以上的 node.js 环境

一、创建项目

手动创建一个项目目录,然后快速生成一个package.json 文件

const Koa = require('koa');
const app = new Koa();

app.use(async ctx => {
ctx.body = 'Wise Wrong';
});

app.listen(3000);

添加启动指令

一个最基础的 koa 应用就这样完成了

可以执行 npm start 并在浏览器访问 http://localhost:3000/ 查看效果

如果觉得手动创建项目太过繁琐,可以使用脚手架 koa-generato 来生成项目

如果是刚接触 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

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);

页面,而访问别的地址则是 not found

这样处理 url 显得特别笨拙,所以我们需要引入路由中间件

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

// router.prefix('/about')

修改 app.js

const Koa = require('koa');
const app = new Koa();

const index = require('./routes/index')
app.use(index.routes(),index.allowedMethods())

app.listen(3000);

另外,还可以在 url 中添加变量,然后通过 Context.params.name 访问

{ ctx.body = `I am ${ctx.params.name}!`; });

三、静态资源

在上面的 index.html 中,如果需要引入 css 等静态资源,就需要用到

然后在 app.js 中添加以下代码

代码还可以优化
文件了

四、模板引擎

上面的路由是使用 fs 模块直接读取 html 文件

开发的时候更推荐使用 nofollow" target="_blank" href="https://www.npmjs.com/package/koa-views">koa-views 中间件来渲染页面

文件中,就能使用 render 方法
const router = require('koa-router')()

router.get('/index',next) => {
await ctx.render('index');
});

module.exports = router

文件的方法,如果要引入模板引擎,可以添加 extension 字段来设定模版类型

五、结语

如果将 Express 看作 webstorm,那么 Koa 就是 sublime

当 Express 流行的时候,其冗杂的依赖项被很多开发者所诟病

所以 Express 团队将 Express 拆卸得只剩下最基本的骨架,让开发者自行组装,这就是 Koa

正如文中所说,从零开始太过繁琐,可以使用脚手架 koa-generato 来快速开发

不过我更推荐,在熟悉了 Koa 之后,搭一个适合自己项目的脚手架

不然为何不直接用 Express 呢

我想这也是 Koa 的官方文档中没有提到 generato 工具的原因吧

猜你在找的Node.js相关文章