基于Koa2框架的项目搭建及实战开发

Koa是基于 Node.js 平台的下一代 web 开发框架,由express原班人马打造,致力于成为一个更小、更富有表现力、更健壮的 Web 框架。使用 koa 编写 web 应用,通过组合不同的 generator,可以免除重复繁琐的回调函数嵌套,并极大地提升错误处理的效率。koa 不在内核方法中绑定任何中间件,它仅仅提供了一个轻量优雅的函数库,使得编写 Web 应用变得得心应手。

此文是简单介绍使用kos2进行项目的基本搭建以及api的简单开发

搭建环境

1.因为此框架是基于node.js的,安装node是必须的进行的第一步,这里不再详细介绍

2.安装koa(我们使用淘宝镜像进行安装)

npm install koa --save

3.安装koa2项目生成器并创建项目

cnpm install koa-generator -g
koa2 myPro
cd myPro
cnpm install
koa2 myPro用来生成项目的基本的项目架构

基于Koa2框架的项目搭建及实战开发

4.启动项目服务

npm start 

访问 http://localhost:3000/

基于Koa2框架的项目搭建及实战开发

这是项目搭建成功的初始页面

搭建项目

接下来进行实战项目的基本搭建

1.安装sequelize(Sequelize是一个基于promise的nodejs ORM,目前支持Postgres、mysql、SQLite和Microsoft SQL Server。它具有强大的事务支持,关联关系,读取和复制等功能。)

cnpm install sequelize --save

2.安装mysql、mysql2

项目使用的是mysql的数据库

cnpm install mysql mysql2 --save

3.配置Sequelize的数据库链接

在项目的根目录下创建一个config目录,config目录中创建db.js,该文件主要用来创建mysql的数据库链接的。

基于Koa2框架的项目搭建及实战开发

/config/db.js

const Sequelize = require('sequelize');
const sequelize = new Sequelize('test','root','123456',{
host:'182.61.15.43',
dialect:'mysql',
operatorsAliases:false,
dialectOptions:{
//字符集
charset:'utf8mb4',
collate:'utf8mb4_unicode_ci',
supportBigNumbers: true,
bigNumberStrings: true
},
pool:{
max: 5,
min: 0,
acquire: 30000,
idle: 10000
},
timezone: '+08:00' //东八时区
}); module.exports = {
sequelize
};

其中test为数据库名称,root为数据库用户名,123456为数据库密码,这是我自己搭建的服务器

4.创建schema、modules、controllers

schema:数据表模型实例
modules:实体模型
controllers:控制器

3个目录下分别创建student.js(有点像thinkPhp5的框架目录)

基于Koa2框架的项目搭建及实战开发

5.schema数据表模型
在schema目录下新建一个student.js文件,该文件的主要作用就是建立与数据表的对应关系,也可以理解为代码的建表。

schema/student.js

const moment = require("moment");
module.exports = function(sequelize,DataTypes){
return sequelize.define('student',{
id:{
type: DataTypes.INTEGER,
primaryKey: true,
allowNull: true,
autoIncrement: true
},
//学生姓名
name:{
type: DataTypes.STRING,
allowNull: false,
field: 'name'
},
//年龄
age:{
type: DataTypes.INTEGER,
allowNull: false,
field: 'age'
},
//性别
gender:{
type: DataTypes.STRING,
allowNull: false,
field:'gender'
},
//分数
grade:{
type: DataTypes.STRING,
allowNull: false,
field: 'grade'
},
// 创建时间
createdAt:{
type: DataTypes.DATE
},
// 更新时间
updatedAt:{
type: DataTypes.DATE
}
},{
/**
* 如果为true,则表示名称和model相同,即user
* 如果为fasle,mysql创建的表名称会是复数,即users
* 如果指定的表名称本身就是复数,则形式不变
*/
freezeTableName: true
});
}

6.模型应用、使用
在项目中modules目录下创建student.js文件,为学生信息表,该文件为文章的实例。

// 引入mysql的配置文件
const db = require('../config/db'); // 引入sequelize对象
const Sequelize = db.sequelize; // 引入数据表模型
const student = Sequelize.import('../schema/student');
student.sync({force: false}); //自动创建表 class studentModel {
/**
* 创建学生表模型
* @param data
* @returns {Promise<*>}
*/
static async createStudent(data){
return await student.create({
name: data.name, //姓名
age: data.age, //年龄
gender: data.gender, //性别
grade: data.grade //分数
});
} /**
* 查询学生信息的详情
* @param id 学生信息ID
* @returns {Promise<Model>}
*/
static async getStudentDetail(id){
return await student.findOne({
where:{
id
}
});
}
} module.exports = studentModel;

7controller 控制器
控制器的主要作用为功能的处理,项目中controller目录下创建article.js,代码如下:

const StudentModel = require("../modules/student");

class studentController {
/**
* 创建学生信息
* @param ctx
* @returns {Promise.<void>}
*/
static async create(ctx){
//接收客服端
let req = ctx.request.body;
if(req.name && req.age && req.gender && req.grade){
try{
//创建学生信息模型
const ret = await StudentModel.createStudent(req);
//使用刚刚创建的学生信息ID查询学生信息详情,且返回学生信息详情信息
const data = await StudentModel.getStudentDetail(ret.id); ctx.response.status = 200;
ctx.body = {
code: 200,
msg: '创建学生信息成功',
data
}
}catch(err){
ctx.response.status = 412;
ctx.body = {
code: 412,
msg: '创建学生信息失败',
data: err
}
}
}else {
ctx.response.status = 416;
ctx.body = {
code: 200,
msg: '参数不齐全'
}
}
} /**
* 获取文章详情
* @param ctx
* @returns {Promise.<void>}
*/
static async detail(ctx){
let id = ctx.params.id;
if(id){
try{
// 查询学生信息详情模型
let data = await StudentModel.getStudentDetail(id);
ctx.response.status = 200;
ctx.body = {
code: 200,
msg: '查询成功',
data
}
}catch(err){
ctx.response.status = 412;
ctx.body = {
code: 412,
msg: '查询失败',
data
}
}
}else {
ctx.response.status = 416;
ctx.body = {
code: 416,
msg: '学生ID必须传'
}
}
}
} module.exports = studentController;

8.路由

路由,也可以简单理解为路径,主要是作为请求的url,请求的路径来处理一些请求,返回数据。一般情况下,基于node的项目,路由都是在一个叫做routes的目录下面。

routes目录下创建student.js,代码如下:

const router = require('koa-router')()
// 学生
const StudentController = require('../controllers/student'); router.prefix('/student')
/**
* 学生接口
*/
//创建学生
router.post('/student/create',StudentController.create);
//获取学生详情
router.get('/student/:id',StudentController.detail) module.exports = router

然后在app.js添加如下内容

const student = require('./routes/student')
app.use(student.routes(), student.allowedMethods())
9.启动项目服务
基于Koa2框架的项目搭建及实战开发

如果启动过程中出现上图的结果,说明服务启动成功

接下来,就可以测试接口了。

10.解决跨域
跨域是web开发中不可避免的一个必须要解决的问题了。跨域问题,主要是要解决服务器端的通信问题。在node的开发中,只需要实现一个CORS标准就可以了。

cnpm install koa-cors --save

然后在根目录下的app.js加入koa-cors的引用:

const cors = require('koa-cors')
app.use(cors()) //使用cors

然后重新启动服务。

接下来使用postman进行接口的测试

基于Koa2框架的项目搭建及实战开发

接口返回成功

使用Navicat查看test数据库下面的表,如图

基于Koa2框架的项目搭建及实战开发

已经在test下创建了一张student新表,关于koa2的项目搭建先简单介绍到这里吧,算是对所有知识的一个小总结。

上一篇:微服务领域是不是要变天了?Spring Cloud Alibaba正式入驻Spring Cloud官方孵化器!


下一篇:数据库 -- mysql表操作