189 8069 5689

在SpringBoot中统一RestfulAPI返回值格式与统一处理异常怎么解决

这篇文章主要为大家分析了在Spring Boot中统一Restful API返回值格式与统一处理异常怎么解决的相关知识点,内容详细易懂,操作细节合理,具有一定参考价值。如果感兴趣的话,不妨跟着跟随小编一起来看看,下面跟着小编一起深入学习“在Spring Boot中统一Restful API返回值格式与统一处理异常怎么解决”的知识吧。

让客户满意是我们工作的目标,不断超越客户的期望值来自于我们对这个行业的热爱。我们立志把好的技术通过有效、简单的方式提供给客户,将通过不懈努力成为客户在信息化领域值得信任、有价值的长期合作伙伴,公司提供的服务项目有:申请域名、网页空间、营销软件、网站建设、廉江网站维护、网站推广。

统一返回值

在前后端分离大行其道的今天,有一个统一的返回值格式不仅能使我们的接口看起来更漂亮,而且还可以使前端可以统一处理很多东西,避免很多问题的产生。

比较通用的返回值格式如下:

public class Result {      // 接口调用成功或者失败      private Integer code = 0;      // 失败的具体code      private String errorCode = "";      // 需要传递的信息,例如错误信息      private String msg;      // 需要传递的数据      private T data;      ...  }

最原始的接口如下: 

@GetMapping("/test")      public User test() {          return new User();      }

当我们需要统一返回值时,可能会使用这样一个办法:

@GetMapping("/test")    public Result test() {        return Result.success(new User());    }

这个方法确实达到了统一接口返回值的目的,但是却有几个新问题诞生了:

  •  接口返回值不明显,不能一眼看出来该接口的返回值。

  •  每一个接口都需要增加额外的代码量。

所幸Spring Boot已经为我们提供了更好的解决办法,只需要在项目中加上以下代码,就可以无感知的为我们统一全局返回值。

/**   * 全局返回值统一封装   */  @EnableWebMvc  @Configuration  public class GlobalReturnConfig {      @RestControllerAdvice      static class ResultResponseAdvice implements ResponseBodyAdvice {          @Override          public boolean supports(MethodParameter methodParameter, Class> aClass) {              return true;          }          @Override          public Object beforeBodyWrite(Object body, MethodParameter methodParameter, MediaType mediaType, Class> aClass, ServerHttpRequest serverHttpRequest, ServerHttpResponse serverHttpResponse) {              if (body instanceof Result) {                  return body;              }              return new Result(body);          }      }  }

在Spring Boot中统一Restful API返回值格式与统一处理异常怎么解决

而我们的接口只需要写成最原始的样子就行了。

@GetMapping("/test")   public User test() {       return new User();   }

统一处理异常

将返回值统一封装时我们没有考虑当接口抛出异常的情况。当接口抛出异常时让用户直接看到服务端的异常肯定是不够友好的,而我们也不可能每一个接口都去try/catch进行处理,此时只需要使用@ExceptionHandler注解即可无感知的全局统一处理异常。

@RestControllerAdvice  public class GlobalExceptionHandler {      private static final Logger LOG = LoggerFactory.getLogger(GlobalExceptionHandler.class);      /**       * 全局异常处理       */      @ExceptionHandler      public JsonData handleException(HttpServletRequest request, HttpServletResponse response, final Exception e) {          LOG.error(e.getMessage(), e);          if (e instanceof AlertException) {//可以在前端Alert的异常              if (((AlertException) e).getRetCode() != null) {//预定义异常                  return new Result(((AlertException) e).getRetCode());              } else {                  return new Result(1, e.getMessage() != null ? e.getMessage() : "");              }          } else {//其它异常              if (Util.isProduct()) {//如果是正式环境,统一提示                  return new Result(RetCode.ERROR);              } else {//测试环境,alert异常信息                  return new Result(1, StringUtils.isNotBlank(e.getMessage()) ? e.getMessage() : e.toString());              }          }      }  }

其中的AlertException为我们自定义的异常,因此当业务中需要抛出错误时,可以手动抛出AlertException。

以上就是统一处理返回值和统一处理异常的两步。

关于“在Spring Boot中统一Restful API返回值格式与统一处理异常怎么解决”就介绍到这了,更多相关内容可以搜索创新互联以前的文章,希望能够帮助大家答疑解惑,请多多支持创新互联网站!


网页题目:在SpringBoot中统一RestfulAPI返回值格式与统一处理异常怎么解决
浏览地址:http://cdxtjz.cn/article/gsigsg.html

联系我们

您好HELLO!
感谢您来到成都网站建设公司,若您有合作意向,请您为我们留言或使用以下方式联系我们, 我们将尽快给你回复,并为您提供真诚的设计服务,谢谢。
  • 电话:028- 86922220 18980695689
  • 商务合作邮箱:631063699@qq.com
  • 合作QQ: 532337155
  • 成都网站设计地址:成都市青羊区锣锅巷31号五金站写字楼6楼

小谭建站工作室

成都小谭网站建设公司拥有多年以上互联网从业经验的团队,始终保持务实的风格,以"帮助客户成功"为已任,专注于提供对客户有价值的服务。 我们已为众企业及上市公司提供专业的网站建设服务。我们不只是一家网站建设的网络公司;我们对营销、技术、管理都有自己独特见解,小谭建站采取“创意+综合+营销”一体化的方式为您提供更专业的服务!

小谭观点

相对传统的成都网站建设公司而言,小谭是互联网中的网站品牌策划,我们精于企业品牌与互联网相结合的整体战略服务。
我们始终认为,网站必须注入企业基因,真正使网站成为企业vi的一部分,让整个网站品牌策划体系变的深入而持久。