目标
各位同学,我们在前一天已经学习了若依框架,并利用生成代码功能实现了服务管理的相关模块单体开发的CRUD操作,我们也进行了测试,但是其实目前还不完整,还有一些问题如下:
问题1:目前我们测试都是基于前端项目完成的,如果后期开发中,前端还未开发完成,我们也需要对后端的接口进行测试,这个怎么做呢?
问题2:若依生成的实体类中书写了大量的getter、setter、toString方法,看上去特别不优雅,能不能在若依生成的基础代码上也优化一下?
问题3:若依生成的Mapper层代码采用的还是MyBatis框架,能不能改造成它的好搭档MyBatisPlus呢?
答案是可以的。
问题1的解决办法是,利用postman或者apifox,还有在线接口工具swagger进行接口测试。
问题2和问题3的解决办法是,修改若依的代码生成模块,而若依的代码生成模块背后采用的是Velocity模板引擎。
Velocity是一款静态模板引擎,类似的还有freemarker,一般用在秒杀场景使用居多
所以今天的目标是:
● 学习使用swagger并集成到项目中
● 能够清楚Velocity的使用场景
● 能够了解Velocity的常见指令有哪些?
● 能够使用Velocity改造若依框架的代码生成模版
Swagger
现在如果我们与前端对接,需要提供详细的接口文档才行,不过在开发的过程中,接口文档可能不能及时的提供,或者是更新不及时,就会造成信息闭塞,造成不必要的效率降低。
所以,一般的前后端分离的项目,都会采用在线的接口工具进行调试,可以实时的展示接口的详细数据,也可以很方便的对接口进行测试。
Swagger介绍
Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务
官网:https://swagger.io/
它的主要作用是:
● 使得前后端分离开发更加方便,有利于团队协作
● 接口的文档在线自动生成,降低后端开发人员编写接口文档的负担
● 功能测试
Spring已经将Swagger纳入自身的标准,建立了Spring-swagger项目,现在叫Springfox。通过在项目中引入Springfox ,就可以非常简单快捷的使用Swagger啦。