使用Koa重构Express项目：基础设施搭建指南

在这篇博客中，我们将介绍如何使用Koa重构一个现有的Express项目，重点讲解基础设施的搭建过程。通过逐步引导，你将学会如何新建项目、配置入口文件、创建路由以及拆分业务逻辑到控制器。本文适用于有Express开发经验并希望迁移到Koa的开发者。

新建项目

首先，我们需要新建一个Koa项目并安装必要的依赖。创建项目目录koa-project并初始化项目：

npm init -y
npm install koa nodemon @koa/router koa-body @koa/cors

新建入口文件

在项目根目录下创建一个名为app.js的文件，这将作为我们的应用入口文件。下面是app.js的内容：

// app.js
const Koa = require('koa')
const koaBody = require('koa-body')
const router = require('./router')
const cors = require('@koa/cors')

const app = new Koa()
app.use(cors())
app.use(koaBody())
app.use(router.routes())

app.on('error', (err, ctx) => {
  console.log(err)
  ctx.body = 'Server Error: ' + err
})

app.listen(3000, () => {
  console.log('http://127.0.0.1:3000')
})

在这个文件中，我们引入了Koa、Koa Body、Koa Router和Koa CORS，并将它们配置到应用中。最后，我们设置了一个错误处理机制，并启动了服务器。

创建路由

接下来，我们需要创建路由。在项目根目录下新建一个名为router的文件夹，并在其中创建一个index.js文件：

// router/index.js
const Router = require('@koa/router')
const router = new Router({ prefix: '/api/v1' })

router.get('/user', (ctx, next) => {
  console.log('user index')
  ctx.body = 'user index'
})

module.exports = router

我们定义了一个简单的GET路由/user，它返回一个基本的响应。

配置启动脚本

为了方便开发，我们可以使用nodemon来自动重启服务器。编辑package.json并添加启动脚本：

"scripts": {
  "dev": "nodemon app.js"
}

使用以下命令启动服务器：

npm run dev

这会启动服务器并在代码更改时自动重启。

拆分业务逻辑到控制器

为了更好地管理业务逻辑，我们可以将其拆分到单独的控制器中。在项目根目录下新建一个名为controller的文件夹，并在其中创建一个userController.js文件：

// controller/userController.js
module.exports.index = async (ctx, next) => {
  ctx.body = 'user controller'
}

然后，我们优化路由代码以使用控制器：

// router/index.js
const Router = require('@koa/router')
const userController = require('../controller/userController')
const router = new Router({ prefix: '/api/v1' })

router.get('/user', userController.index)

这样，我们将业务逻辑从路由文件中抽离出来，提升了代码的可维护性和可读性。

总结

通过以上步骤，我们完成了使用Koa重构Express项目的基础设施搭建。接下来，你可以继续实现具体的业务逻辑。