SpringBoot统一api返回风格的实现

 更新时间:2021年03月07日 09:27:11   作者:wz_app  
这篇文章主要介绍了SpringBoot统一api返回风格的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

学过上一章的人也许发现问题了,接口返回的格式基本都是固定的,例如

{
 "code": 200,
 "msg": "",
 "data": "Object ....",
}

而我们的登陆却返回

密码必须传!等等返回值

显然我们的返回格式不符合常规开发,因为前台并不知道这是错误信息还是正确返回信息!
所以我们简单封装一个返回类,代码如下

添加base包,新建BaseResult类

import lombok.Data;

@Data
public class BaseResult {
  private int code;//200=成功,否则失败
  private String msg;//失败时的提示信息
  private Object data;//成功返回的内容

  public BaseResult(int code, String msg, Object data) {
    this.code = code;
    this.msg = msg;
    this.data = data;
  }
}

在修改下登陆的controller

  @PostMapping("login")
  public BaseResult login(@RequestParam(value = "user", defaultValue = "") String user,
              @RequestParam(value = "pass", defaultValue = "") String pass) {
    if (user.equals("")) return new BaseResult(400, "账号必须传!", "");
    if (pass.equals("")) return new BaseResult(400, "密码必须传!", "");
    User user1 = mapper.login(user, pass);
    if (user1 == null) return new BaseResult(500, "账号密码不正确!", "");
    user1.setPass("");
    return new BaseResult(200, "", user1);
  }

接下来我们看下返回值

{
  "code": 400,
  "msg": "密码必须传!",
  "data": ""
}
{
  "code": 200,
  "msg": "",
  "data": {
    "id": 1,
    "user": "wz",
    "pass": ""
  }
}

上边这种返回格式,前端就非常好解析

http各个状态码的含义:由三位数字组成,第一位定义了状态码的类型

2开头:(请求成功)表示成功处理了请求的状态代码
200:(成功)服务器已成功处理了请求。通常,这表示服务器提供了请求的网页。
201:(已创建)请求成功并且服务器创建了新的资源
202:(已接受)服务器已接受请求,但尚未处理
203:(非授权信息)服务器已成功处理了请求,但返回的信息可能来自另一资源。
204:(无内容)服务器成功处理了请求,但没有返回任何内容
205:(重置内容)服务器成功处理了请求,但没有返回任何内容
206:(部分内容)服务器成功处理了部分 GET 请求

3开头:(请求被重定向)表示要完成请求,需要进一步操作。通常,这些状态代码用来重定向
300:(多种选择)针对请求,服务器可执行多种操作。服务器可根据请求者(user agent)选择一项操作,或提供操作列表供请求者选择
301:(永久移动)请求的网页已永久移动到新位置。服务器返回此响应(对 GET 或 HEAD 请求的响应)时,会自动将请求者转到新的位置
302:(临时移动)服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求
303:(查看其他位置)请求者应当对不同的位置使用单独的 GET 请求来检索响应时,服务器返回此代码
304:(未修改)自从上次请求后,请求的网页未修改过。服务器返回此响应,不会返回网页内容
305:(使用代理)请求者只能使用代理访问请求的网页。如果服务器返回此响应,还表示请求者应使用代理
307:(临时重定向)服务器目前从不同位置的网页响应请求,但请求者继续使用原有位置来进行以后的请求

4开头:(请求错误)这些状态码表示请求可能出错,妨碍了服务器的处理
400:(错误请求)服务器不理解请求的语法
401:(未授权)请求要求身份验证。对于需要登录的网页,服务器可能返回此响应
403:(禁止)服务器拒绝请求
404:(未找到)服务器找不到请求的网页
405:(方法禁用)禁用请求中指定的方法
406:(不接受)无法使用请求的内容特性响应请求的网页
407:(需要代理授权)此状态代码与 401 (未授权)类似,但指定请求者应当授权使用代理
408:(请求超时)服务器等候请求时发生超时
409:(冲突)服务器在完成请求时发生冲突。服务器必须在响应中包含有关冲突的信息
410:(已删除)如果请求的资源已永久删除,服务器就会返回此响应
411:(需要有效长度)服务器不接受不含有效内容长度标头字段的请求
412:(未满足前提条件)服务器未满足请求者在请求中设置的其中一个前提条件
413:(请求实体过大)服务器无法处理请求,因为请求实体过大,超出服务器的处理能力
414:(请求的 URI 过长)请求的URI(通常为网址)过长,服务器无法处理
415:(不支持的媒体类型)请求的格式不受请求页面的支持
416:(请求范围不符合)如果页面无法提供请求的范围,则服务器返回此状态代码
417:(未满足期望值)服务器未满足“期望”请求标头字段要求

5开头:(服务器错误)这些状态代码表示服务器在尝试处理请求时发生内部错误。这些错误可能是服务器本身的错误,而不是请求出错。
500:(服务器内部错误)服务器遇到错误,无法完成请求
501:(尚未实施)服务器不具备完成请求的功能。例如,服务器无法识别请求方法时可能会返回此代码
502:(错误网关)服务器作为网关或代理,从上游服务器收到无效响应
503:(服务不可用)服务器目前无法使用(由于超载或停机维护)。通常,这只是暂时状态
504:(网关超时)服务器作为网关或代理,但是没有及时从上游服务器收到请求
505:(HTTP 版本不受支持)服务器不支持请求中所用的 HTTP 协议版本

到此这篇关于SpringBoot统一api返回风格的实现的文章就介绍到这了,更多相关SpringBoot统一api返回内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家! 

相关文章

  • java反射实现javabean转json实例代码

    java反射实现javabean转json实例代码

    基于java反射机制实现javabean转json字符串实例,大家参考使用吧
    2013-12-12
  • Spring Security基于json登录实现过程详解

    Spring Security基于json登录实现过程详解

    这篇文章主要介绍了Spring Security基于json登录实现过程详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-08-08
  • Maven项目无法加载jdbc.properties的问题解决

    Maven项目无法加载jdbc.properties的问题解决

    本文主要介绍了Maven项目无法加载jdbc.properties的问题解决,文章首先分析了问题的原因,然后提供了解决方法,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-08-08
  • springboot + vue 实现递归生成多级菜单(实例代码)

    springboot + vue 实现递归生成多级菜单(实例代码)

    这篇文章主要介绍了springboot + vue 实现递归生成多级菜单,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-12-12
  • java对于JSON的解析方法举例详解

    java对于JSON的解析方法举例详解

    在编写应用时,我们经常要解析JSON,下面这篇文章主要给大家介绍了关于java对于JSON的解析方法,文中通过代码示例介绍的非常详细,需要的朋友可以参考下
    2023-09-09
  • 使用idea和gradle编译spring5源码的方法步骤

    使用idea和gradle编译spring5源码的方法步骤

    这篇文章主要介绍了详解使用idea和gradle编译spring5源码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-12-12
  • Java设计模式编程中简单工厂与抽象工厂模式的使用实例

    Java设计模式编程中简单工厂与抽象工厂模式的使用实例

    这篇文章主要介绍了Java设计模式编程中简单工厂与抽象工厂模式的使用实例,简单工厂与抽象工厂都可以归类于设计模式中的创建型模式,需要的朋友可以参考下
    2016-04-04
  • Spring Boot Web 开发注解篇

    Spring Boot Web 开发注解篇

    在 Spring Boot 快速入门中,只要在 pom.xml 加入了 spring-boot-starter-web 依赖,即可快速开发 web 应用。下文给大家详细介绍了spring boot web 开发注解,感兴趣的朋友参考下吧
    2017-08-08
  • Java获取项目路径方式System.getProperty(“user.dir“)

    Java获取项目路径方式System.getProperty(“user.dir“)

    这篇文章主要介绍了Java获取项目路径方式System.getProperty(“user.dir“),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-12-12
  • java操作excel表格详解

    java操作excel表格详解

    在日常工作中,对Excel工作表格的操作处理可是多的数不清楚,下面是java语言对其的操作,有需要的小伙伴可以参考下
    2021-10-10

最新评论