已经2018年,本章不在介绍什么是前后端分离,什么是MVC架构,什么是Restful约定,而是用基本的ES6和ES7语法,以NodeJS项目从MVC分层的角度来搭建一个API节点
本章知识点
1、项目配置
2、项目分层架构
3、抽离BaseDAO
4、编写DAO层
5、抽离BaseService
6、编写Service层
7、编写Controller层
8、Mysql建立关联表结构
9、测试基本业务的增删改查接口
10、测试特殊业务接口
一、项目配置
编程语言:NodeJS+ES6/ES7
数据库:mysql
第三方库:Express+Sequelize
二、项目分层架构
项目分层结构bin:启动http/https服务
commons:存放公共方法文件
config:存放配置文件
model:存放dao文件, 负责和数据库交互
service:存放service文件, 负责和dao交互
routers:存放controller文件,负责和service交互
public:存放前端js/cssimage等文件(废弃,由于是前后端分离,已完全用不到)
view:存放前端模板页面( 废弃,由于是前后端分离,已完全用不到)
app.js:项目入口文件
babelrc:babel配置文件
package.json:包依赖管理文件
三、抽离BaseDAO
假设我们有N个Model文件,而每一个Model文件都要基础的方法集,我们不愿意在每一个Model文件里都重写这些基本方法,而是希望将这些基础的方法提取出来,然后采用继承的思想去获得它们,就像数学里的提取公因式,为此,我们抽离这些公共基础方法到BaseDAO文件
操作数据库无非增、删、改、查四大类方法,只是关联表的复杂度不同,查询分精确查询,模糊查询,是否排序,分组,更新/添加/删除是否批量等,这里,我封装的公共方法查找方法为:
findAll:不带过滤条件的查询
findByFilter:带过滤条件的精确查询
findByFilterOrder:带过滤条件的排序精确查询
findLikeByFilter:带过滤条件的模糊查询
findLikeByFilterOrder:带过滤条件的排序模糊查询
封装的更新方法为:
update:批量更新/条件更新
封装的删除方法为:
delete:条件删除
封装的插入方法为:
create:插入单个实体
createBatch:批量插入实体集
而我们希望通过BaseDAO的构造方法来实例化Sequelize的model实例
部分BaseDAO代码截图可以看到后端的代码基本是一个方法一行,返回值都是promise,方便我们用async和await接受,非常优美!
四、编写DAO层
当编写具体DAO实体文件时,显然,我们需要继承BaseDAO让其具有基础方法集
假设我们有两个Model,分别是CompanyModel和PersonModel,下面我们编写CompanyModel文件
CompanyModel代码通过友好的继承,CompanyModel已经拥有所有BaseDAO的调用权限
考虑另一个PersonModel,从业务上,一个公司拥有多个员工,所以CompanyModel和PersonModel是1 :N的关系,现在需要PersonModel拥有一个关联查找CompanyModel的接口,那么对于这种针对其自身的业务接口,我们会将其写入其本身的方法里,保证只有它本身持有这个方法
PersonModel代码可以看到PersonModel类持有自身的业务接口specialDAO2
五、抽离BaseService
同理,在编写service层是,我们也构造出BaseService来调用BaseDAO
我们让具体的dao实例,通过形参传入BaseService的构造函数里,编写出base***的方法集合来通过dao实例调用BaseDAO的方法集
BaseService部分代码六、编写Service层
和DAO层一样,我们编写具体的service文件时需要继承BaseService,让其拥有调用BaseDAO的方法
CompanyService代码可以看到CompanyService可以调用所有baseDAO的方法,同理,dao自身的方法需要在其service里申明
PersonService代码可以看到PersonService单独暴露出了调用PersonModel里自身的方法接口
顺便说一下@AutoWritedPersonModel是利用了es7的装饰器功能,可以给实例注入对象,这里我给每个service类注入了对应的dao对象方便调用
七、编写Controller层
现在,我们可以封装出Controller层接收路由请求来调用service,通过service调用dao来完成请求对数据库的交互过程
companyController代码可以看到对于任何一个客户端请求,我们都通过service调用dao,并用await接收数据后最后输出到客户端
八、Mysql建立关联表结构
下面我们为演示demo,新建person表和company表,person表里存放company表的外键
company表 person表九、测试基本业务的增删改查接口
下面来测试基本的person的baseDAO方法结果
查找所有person,返回所有属性
查找所有person的全部属性查找所有person,只返回id和姓名属性
查找所有person的部分属性按照条件过滤出性别是0的person
按照条件过滤性别为0的person模糊查询过滤出符合条件姓名包含z的person
模糊查询过滤姓名包含z的person更新id=2的person的性别为1
更新id=2的person的性别为1添加一个person
添加一个person删除id=5的person
删除id=5的person十、测试特殊业务接口
演示两个person的业务场景
场景一:单表操作,模糊查询姓名包含z,年纪小于18岁,性别为男的person
场景一dao方法 场景一结果场景二:多表(inner join)操作,查询公司是阿里巴巴的person,并展开company
场景二dao方法 场景二结果项目源码地址:前后端分离之NodeJS+mysql分层之美
网友评论