SpringBoot2.1 RESTful API项目脚手架(种子)项目

时间:2021-05-20

最近在做一个大型的J2EE项目,后端语言选择了Java,理所当然的选择了Spring,使用Spring MVC来做restful风格的api开发很是方便,Spring下面有很多子项目通过Springboot集成也很舒服。程序员都知道沟通很重要,实际项目中,往往是各自为战,尽管使用的是相同的框架、工具,编写的代码却千差万别,为了统一基础代码风格,编写了这个项目种子。

除此之外,在开发一个Web后端api项目时,通常都会经历搭建项目、选择依赖管理工具、引入基础包依赖、配置框架等,为了加快项目的开发进度(早点下班)还需要封装一些常用的类和工具,如标准的响应结构体封装、统一异常处理切面、接口签名认证、初始化运行方法、轮询方法、api版本控制封装、异步方法配置等。

每次开始一个类型的新项目,以上这些步骤又要重复一遍,虽然能够将老项目拿过来删删减减达到目的,但还是很费时费力,还容易出问题。所以,可以利用面向对象的思想,抽取这类Web后端api项目的共同之处封装成一个项目种子。以后再开发类似的项目,就能直接在这个项目种子上迭代,减少重复劳动。

项目地址:https://github.com/ocubexo/springboot-restful-starter

简介

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

快速开始

  • 构建数据库
  • 运行/src/test下的CodeGenerator.java进行代码生成
  • 开始编写业务代码
  • 内置功能与使用方法

    RESTful风格Result生成器

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

    // 不带数据的成功结果return new Result().success();

    返回结果示例:

    { "code": 200, "message": "Success", "data": null}

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

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

    返回结果示例:

    { "code": 200, "message": "Success", "data": "Hello,world"}

    或者是:

    { "code": 200, "message": "Success", "data": { "name": "jack", "age": 20 }}

    3.错误结果:

    // fail方法的参数(错误代码,错误信息)return new Result().fail(10400, "登陆失败,密码错误");// 你还可以自定义错误结果的codereturn new Result().fail(null, "未登录", 401);

    返回结果示例:

    { "code": 400, "message": "登陆失败,密码错误", "data": 10400}

    或者:

    { "code": 401, "message": "未登录", "data": null}

    RESTful风格的异常接管

    // 参数说明(错误信息, 错误Code)throw new ServiceException("未登录", 401);// 你也可以返回错误代码throw new ServiceException(10404, "服务器维护中", 404);

    返回结果示例:

    { "code": 401, "message": "未登录", "data": null}

    或者:

    { "code": 404, "message": "服务器维护中", "data": 10404}

    基于JWT的认证机制

    @Autowiredprivate TokenService tokenService;// 生成PayloadMap<String,Object> payload = new HashMap<String,Object>();payload.put("id",1);// 生成TokentokenService.generate(TokenType.ACCESS, payload, 1);// 格式化TokenString token = getYourToken();tokenService.parse(token); // 返回的结果是一个Jwt对象,详见JJWT文档Auth注解Auth注解用于获取当前用户的Token中的userId,在获取的同时会自动校验用户Token,若用户未登录则会抛出未登录的异常。// 在controller中使用@PostMapping("/user/1/edit")public Result edit(@Auth int userId, @ResponseBody sthPosted) { // 根据ID判断权限}

    以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。

    声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。

    相关文章