作者：不一样的科技宅
来源：juejin.im/post/6844904083942277127
前言
建立一个全新的项目，或者把旧的庞大的项目，进行拆分成多个项目。在建立新的项目中，经常需要做一些重复的工作，比如说拷贝一下常用的工具类，通用代码等等。
所以就可以做一个基础的项目方便使用，在经历新项目的时候，直接在基础项目上进行简单配置就可以开发业务代码了。
基础项目该包含哪些东西。
❝
可以在评论区进行补充
❞
Swagger
写接口文档通常是一件比较头疼的事情，然而swagger就用是用来帮我们解决这个问题的。可以在线生成接口文档，并且可以在页面上进行测试。
可以非常清楚的显示，请求数据已经响应数据。当然这一切都需要在代码中进行配置。
「注意的点：接口文档只能在测试/开发环境开启，其他环境请关闭。」
常用的Swagger注解
-
-
@ApiOperation用于Controller内的方法。
-
@ApiResponses用于标识接口返回数据的类型。
-
-
@ApiModelProperty用于标识属性的名称
案例
@RestController
@Api(tags = "用户")
@AllArgsConstructor
@RequestMapping("/user")
public class UserController {
private IUserService userService;
/**
* 获取用户列表
* @param listUserForm 表单数据
* @return 用户列表
*/
@ApiOperation("获取用户列表")
@GetMapping("/listUser")
@ApiResponses(
@ApiResponse(code = 200, message = "操作成功", response = UserVo.class)
)
public ResultVo listUser(@Validated ListUserForm listUserForm){
return ResultVoUtil.success(userService.listUser(listUserForm));
}
}
@Data
@ApiModel("获取用户列表需要的表单数据")
@EqualsAndHashCode(callSuper = false)
public class ListUserForm extends PageForm {
/**
* 用户状态
*/
@ApiModelProperty("用户状态")
@NotEmpty(message = "用户状态不能为空")
@Range(min = -1 , max = 1 , message = "用户状态有误")
private String status;
}
对应的swagger的配置可以查看基础项目内的
SwaggerConfiguration.java
.
CodeGenerator代码生成器。
mybatis_plus代码生成器可以帮我们生成
entity
,
service
,
serviceImpl
,
mapper
,
mapper.xml
。省去了建立一大堆实体类的麻烦。
由于配置太长这里就不贴出来了，对应的CodeGenerator的配置可以查看基础项目内的
CodeGenerator.java
.
常用的封装
统一返回 ResultVo
将所有的接口的响应数据的格式进行统一。
@Data
@ApiModel("固定返回格式")
public class ResultVo {
/**
* 错误码
*/
@ApiModelProperty("错误码")
private Integer code;
/**
* 提示信息
*/
@ApiModelProperty("提示信息")
private String message;
/**
* 具体的内容
*/
@ApiModelProperty("响应数据")
private Object data;
}
抽象表单 BaseForm
public abstract class BaseForm {
/**
* 获取实例
* @return 返回实体类
*/
public abstract T buildEntity();
}
有小伙伴可能有疑问了，这个类有啥用呢。先看一下，下面的代码。
/**
* 添加用户
* @param userForm 表单数据
* @return true 或者 false
*/
@Override
public boolean addUser(AddUserForm userForm) {
User user = new User();
user.setNickname(userForm.getNickname());
user.setBirthday(userForm.getBirthday());
user.setUsername(userForm.getUsername());
user.setPassword(userForm.getPassword());
return save(user);
}
重构一下，感觉清爽了一些。
/**
* 添加用户
* @param userForm 表单数据
* @return true 或者 false
*/
@Override
public boolean addUser(AddUserForm userForm) {
User user = new User();
BeanUtils.copyProperties(this,user);
return save(user);
}
使用BaseForm进行重构 AddUserForm 继承 BaseForm并重写buildEntity
@Data
@EqualsAndHashCode(callSuper = false)
public class AddUserForm extends BaseForm {
/**
* 昵称
*/
private String nickname;
/**
* 生日
*/
private Date birthday;
/**
* 用户名
*/
private String username;
/**
* 密码
*/
private String password;
/**
* 构造实体
* @return 实体对象
*/
@Override
public User buildEntity() {
User user = new User();
BeanUtils.copyProperties(this,user);
return user;
}
}
/**
* 添加用户
* @param userForm 表单数据
* @return true 或者 false
*/
@Override
public boolean addUser(AddUserForm userForm) {
return save(userForm.buildEntity());
}
上面的代码有没有种似曾相识的感觉，很多情况都是将接受到的参数，转变成对应的实体类然后
「保存」
或者
「更新」
。
所以对于这类的
form
可以继承
baseform
并实现
buildEntity()
这样可以更加符合面向对象，
service
不需要关心
form
如何转变成
entity
,只需要在使用的时候调用
buildEntity()
即可，尤其是在
form
->
entity
相对复杂的时候，这样做可以减少
service
内的代码。让代码逻辑看起来更加清晰。
通用的分页对象
涉及到查询的时候，绝大多数都需要用到分页，所以说封装分页对象就很有必要。可以注意下
PageForm.calcCurrent()
、
PageVo.setCurrentAndSize()
、
PageVo.setTotal()
这个几个方法。
PageForm
@Data
@ApiModel(value = "分页数据", description = "分页需要的表单数据")
public class PageForm>{
/**
* 页码
*/
@ApiModelProperty(value = "页码 从第一页开始 1")
@Min(value = 1, message = "页码输入有误")
private Integer current;
/**
* 每页显示的数量
*/
@ApiModelProperty(value = "每页显示的数量 范围在1~100")
@Range(min = 1, max = 100, message = "每页显示的数量输入有误")
private Integer size;
/**
* 计算当前页 ,方便mysql 进行分页查询
* @return 返回 pageForm
*/
@ApiModelProperty(hidden = true)
public T calcCurrent(){
current = (current - 1 ) * size;
return (T) this;
}
}
PageVo
@Data
public class PageVo {
/**
* 分页数据
*/
@ApiModelProperty(value = "分页数据")
private List records;
/**
* 总条数
*/
@ApiModelProperty(value = "总条数")
private Integer total;
/**
* 总页数
*/
@ApiModelProperty(value = "总页数")
private Integer pages;
/**
* 当前页
*/
@ApiModelProperty(value = "当前页")
private Integer current;
/**
* 查询数量
*/
@ApiModelProperty(value = "查询数量")
private Integer size;
/**
* 设置当前页和每页显示的数量
* @param pageForm 分页表单
* @return 返回分页信息
*/
@ApiModelProperty(hidden = true)
public PageVo setCurrentAndSize(PageForm> pageForm){
BeanUtils.copyProperties(pageForm,this);
return this;
}
/**
* 设置总记录数
* @param total 总记录数
*/
@ApiModelProperty(hidden = true)
public void setTotal(Integer total) {
this.total = total;
this.setPages(this.total % this.size > 0 ? this.total / this.size + 1 : this.total / this.size);
}
}
案例
ListUserForm
@Data
@ApiModel("获取用户列表需要的表单数据")
@EqualsAndHashCode(callSuper = false)
public class ListUserForm extends PageForm {
/**
* 用户状态
*/
