Github上有一个express风格的koa脚手架,用着挺方便,一直以来使用koa开发web项目用的也都是那个脚手架,今天想自己从头搭一个web项目,就折腾了一下
脚手架地址: https://github.com/17koa/koa-generator
初始化
使用 npm init 初始化一个nodejs项目
mkdir koa-democd koa-demonpm init
一直回车即可,创建好之后目录里会有一个 package.json 文件
安装依赖
npm install --save koa koa-body koa-logger koa-json-error koa-router koa-static koa-njkkoa koa-body 解析http请求参数的,支持 multipart/form-data application/x-www-urlencoded application/json 三种参数类型 koa-logger 显示http请求的日志 koa-router 路由 koa-json-error 程序出异常输出json koa-static 映射静态资源文件 koa-njk nunjucks模板解析
配置
在根目录下创建 app.js 然后贴上下面代码,代码内有注释,很简单
// 引入依赖const koa = require('koa');const koa_body = require('koa-body');const koa_json_error = require('koa-json-error');const koa_logger = require('koa-logger');const koa_static = require('koa-static');const koa_njk = require('koa-njk');const path = require('path');// 初始化koaconst app = new koa()// 引入路由配置文件,这个在下面说明const routers = require('./routes/routers');// 配置程序异常输出的json格式app.use(koa_json_error((err) => { return { code: err.status || 500, description: err.message }}));// 添加静态资源文件映射app.use(koa_static(path.join(__dirname, 'static')))// 添加nunjucks模板app.use(koa_njk(path.join(__dirname, 'views'), '.njk', { autoescape: true,}, env => { // 添加自己的过滤器 env.addFilter('split', (str, comma) => { if (str) { return str.split(comma); } else { return ''; } });}));// 解析表单提交参数app.use(koa_body());// 显示请求和响应日志app.use(koa_logger());// 路由app.use(routers.routes())// 程序启动监听的端口const port = 3000;app.listen(port);console.log('Listening on ' + port);
路由
在根目录下创建 routes 文件夹
在 routes 文件夹内创建 index.js routers.js 文件
在 index.js 文件内添加如下代码
// 测试路由,输出请求的参数exports.index = async ctx => { const body = ctx.request.body; const query = ctx.request.query; const params = ctx.params; ctx.body = { body: body, query: query, params: params, };}// 测试nunjucks模板exports.view = async ctx => { await ctx.render('index', { title: 'Koa' })}// 测试异常exports.test_error = async ctx => { throw new Error('测试异常');}
配置路由,在 routers.js 文件内配置路由
const router = require('koa-router')();// routeconst index = require('./index');router.get('/view', index.view);router.get('/index', index.index);router.get('/index:id', index.index);router.post('/index', index.index);router.get('/test_error', index.test_error);module.exports = router
新闻热点
疑难解答
图片精选