一步一步教你完成Koa2接口开发

一、系统环境

操作系统：windows10 64bit

node：v10.15.3

npm：6.4.1

koa：2.7.0

mariadb：10.2.14

二、项目初始化

进入要初始化的项目目录，执行命令

npm init

安装koa核心依赖库

npm install koa

开启服务，在项目根目录下创建app.js文件，代码如下

/*项目依赖*/
const Koa = require('koa');
const http = require('http');
/*应用实例*/
const app = new Koa();
/*web服务*/
http.createServer(app.callback())
    .listen(3000)
    .on('listening', function () {
        console.log(`服务已开启，端口：3000`)
    });

进入项目目录，执行命令，查看结果，如图：

三、数据库(mysql)准备

解压数据库文件到安装目录，此处目录为D:\db\mariadb\10.2.14（已安装好mysql的可以根据情况忽略下面几步）

添加环境变量，如图(我的电脑->右键->属性->高级系统设置->系统变量->选择Path->新建）其他环境请自行百度

创建install.bat文件（用来安装Mariadb服务），文件内容如下：

::指定创建服务的程序

@set mysql_service="D:\db\mariadb\10.2.14\bin\mysqld.exe"

::设置服务名

@set service_name="MariaDB.10"


::开始安装Mariadb服务

%mysql_service% --install %service_name% --defaults-file="D:\db\mariadb\10.2.14\my-medium.ini"


pause

创建uninstall.bat文件（用来卸载Mariadb服务，如果服务处在开启状态，需要先停止服务），文件内容如下：

@set mysql_service="D:\db\mariadb\10.2.14\bin\mysqld"
@set service_name="MariaDB.10"

:: 卸载服务
%mysql_service% --remove %service_name%

pause

创建start.bat文件（用来开启服务），服务名称需要与安装的名称一样

net start MariaDB.10

创建stop.bat文件（用来关闭服务），服务名称需要与安装的名称一样

net stop MariaDB.10

创建完成之后，先执行install.bat文件（只需要执行一次，之后不管重启与否只要没卸载改服务也不需要再次执行），再执行start.bat文件

打开mysql连接工具（此处使用SQLyog，其他工具类似），输入配置信息，输入完成之后点击测试连接（默认root密码为空，连接之后可通过管理工具添加账户或者修改root密码）：

创建数据库及表（任意表都行），如图：（account表示账户表，chia表示中国省市区的表）

四、接口开发

项目结构

添加dao文件夹 -- 数据访问层，用来连接数据库，通过sql语句返回数据供service层使用

添加service文件夹 -- 业务服务层，执行业务逻辑并且通过dao层获取数据供controller层使用

添加controller文件夹 -- 控制器层，编写接口，通过service层获取数据供接口返回

添加public/upload文件夹 -- 用来保存上传的文件内容

安装依赖

// koa-json -- get提交数据的中间件
// koa-bodyparser -- post提交数据的中间件
// koa-body -- 文件上传的中间件
// koa-router -- 路由中间件（接口地址）
// mysql -- mysql数据库连接中间件
npm install koa-json koa-bodyparser koa-body koa-router mysql

添加config.js文件，具体代码如下：

mo