SpringBoot21脚手架（种子）项目

发表于

项目地址：github.com/ocubexo/spr…

项目已更新至2.0.0 Beta 查看更新内容

简介

这是一个基于SpringBoot 2.1.1 RELEASE，用于搭建RESTful API工程的脚手架，只需三分钟你就可以开始编写业务代码，不再烦恼于构建项目与风格统一。

快速开始

  1. 构建数据库
  2. 运行/src/test下的CodeGenerator.java进行代码生成
  3. 开始编写业务代码

内置功能与使用方法

RESTful风格Result生成器

1.成功且不带数据的结果

1
2
复制代码// 不带数据的成功结果
return new Result().success();

返回结果示例：

1
2
3
4
5
复制代码{
    "code": 200,
    "message": "Success",
    "data": null
}

2.成功且带返回数据的结果

1
2
3
4
5
复制代码return new Result().success("Hello,world");

// 当然你也可以返回对象或其他类型的数据
User user = new User();
return new Result().success(user);

返回结果示例：

1
2
3
4
5
复制代码{
    "code": 200,
    "message": "Success",
    "data": "Hello,world"
}

或者是：

1
2
3
4
5
6
7
8
复制代码{
    "code": 200,
    "message": "Success",
    "data": {
        "name": "jack",
        "age": 20
    }
}

3.错误结果：

1
2
3
4
5
复制代码// fail方法的参数(错误代码,错误信息)
return new Result().fail(10400, "登陆失败，密码错误");

// 你还可以自定义错误结果的code
return new Result().fail(null, "未登录", 401);

返回结果示例：

1
2
3
4
5
复制代码{
    "code": 400,
    "message": "登陆失败，密码错误",
    "data": 10400
}

或者：

1
2
3
4
5
复制代码{
    "code": 401,
    "message": "未登录",
    "data": null
}

RESTful风格的异常接管

1
2
3
4
5
复制代码// 参数说明(错误信息, 错误Code)
throw new ServiceException("未登录", 401);

// 你也可以返回错误代码
throw new ServiceException(10404, "服务器维护中", 404);

返回结果示例：

1
2
3
4
5
复制代码{
    "code": 401,
    "message": "未登录",
    "data": null
}

或者：

1
2
3
4
5
复制代码{
    "code": 404,
    "message": "服务器维护中",
    "data": 10404
}

基于JWT的认证机制

1
2
3
4
5
6
7
8
9
10
11
12
13
复制代码@Autowired
private TokenService tokenService;

// 生成Payload
Map<String,Object> payload = new HashMap<String,Object>();
payload.put("id",1);
// 生成Token
tokenService.generate(TokenType.ACCESS, payload, 1);


// 格式化Token
String token = getYourToken();
tokenService.parse(token); // 返回的结果是一个Jwt对象，详见JJWT文档

Auth注解

Auth注解用于获取当前用户的Token中的userId，在获取的同时会自动校验用户Token，若用户未登录则会抛出未登录的异常。

1
2
3
4
5
复制代码// 在controller中使用
@PostMapping("/user/1/edit")
public Result edit(@Auth int userId, @RequestBody sthPosted) {
    // 根据ID判断权限
}

更新内容：

  1. 更加详细全面的功能文档
  2. 重构部分代码
  3. 添加更多的异常接管
  4. 添加自动插入创建与更新日期功能（基于MybatisPlus 特性）
  5. 优化代码结构，将功能性的部分模块化，便于后期的维护或升级为 SpringCloud 项目
  6. 增强@Auth 注解的代码健壮性

本文转载自: 掘金

开发者博客 – 和开发相关的 这里全都有

0%