GVKun编程网logo

Spring Boot 返回 JSON 格式的异常处理（spring boot 返回json 对象）

13

此处将为大家介绍关于SpringBoot返回JSON格式的异常处理的详细内容，并且为您解答有关springboot返回json对象的相关问题，此外，我们还将为您介绍关于04-SpringBoot工程中

此处将为大家介绍关于Spring Boot 返回 JSON 格式的异常处理的详细内容，并且为您解答有关spring boot 返回json 对象的相关问题，此外，我们还将为您介绍关于04-SpringBoot 工程中的异常处理方式【转】、11-SpringBoot 工程中的异常处理方式、11-SpringBoot工程中的异常处理方式、Spring Boot HTTP over JSON 的错误码异常处理的有用信息。

本文目录一览：

Spring Boot 返回 JSON 格式的异常处理（spring boot 返回json 对象）

Spring Boot 返回 JSON 格式的异常处理（spring boot 返回json 对象）

用 Spring Boot 返回 JSON 格式的异常处理可以分下面 5 步

 

一。定义统一的 JSON response 对象

package spring.boot.demo.exception;

public class ApiResponse<T> {

    public static final Integer OK = 0;
    public static final Integer ERROR = 100;
    private Integer code;
    private String message;
    private String url;
    private T data;

    public Integer getCode() {
        return code;
    }

    public void setCode(Integer code) {
        this.code = code;
    }

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }

    public static Integer getOk() {
        return OK;
    }

    public static Integer getError() {
        return ERROR;
    }

}

 

二。自定义异常

package spring.boot.demo.exception;

public class MyException extends Exception {

    private static final long serialVersionUID = 998856042362652953L;

    public MyException(String message) {
        super(message);
    }

}

 

三。在 controller 中抛出自己定义的异常

package spring.boot.demo.controller;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import spring.boot.demo.exception.MyException;

@RestController
public class ExceptionController {

    @RequestMapping("/test-exception.htm")
    public String json() throws MyException {
        throw new MyException("make a error!!!");
    }
}

 

四。创建 GlobalExceptionHandler

package spring.boot.demo.exception;

import javax.servlet.http.HttpServletRequest;

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(value = MyException.class)
    @ResponseBody
    public ApiResponse<String> defaultErrorHandler(HttpServletRequest req, Exception e) throws Exception {
        ApiResponse<String> ar = new ApiResponse<>();
        ar.setMessage(e.getMessage());
        ar.setCode(ApiResponse.ERROR);
        ar.setData("something wrong happened!!!");
        ar.setUrl(req.getRequestURL().toString());
        return ar;
    }
}

这个异常处理类主要是通过使用 @ControllerAdvice 定义统一的异常处理类，

另外通过 @ExceptionHandler 用来指定自定义的异常 MyException

 

五。测试

启动 Application，访问 http://localhost:8080/test-exception.htm，这个时候会看到浏览器返回的是 json 格式的数据

{
  "code": 100,
  "message": "make a error!!!",
  "url": "http://localhost:8080/test-exception.htm",
  "data": "something wrong happened!!!"
}

 

 

由此  THE  END

04-SpringBoot 工程中的异常处理方式【转】

04-SpringBoot 工程中的异常处理方式【转】

背景分析

在项目的开发中，不管是对底层的数据逻辑操作过程，还是业务逻辑的处理过程，还是控制逻辑的处理过程，都不可避免会遇到各种可预知的、不可预知的异常。处理好异常对系统有很好的保护作用，同时会大大提高用户的体验。

异常处理分析

概述

Java项目中处理异常方式无非两种，要么执行trycatch操作，要么执行throw操作(抛给其它对象处理)，无论采用哪种方式，其目的是让我们的系统对异常要有反馈。但现在的问题是我们如何让这种反馈代码的编写即简单又直观、友好。

处理规范

我们在处理异常的过程中通常要遵循一定的设计规范，例如：

  • 捕获异常时与抛出的异常必须完全匹配，或者捕获异常是抛出异常的父类类型。
  • 避免直接抛出RuntimeException,更不允许抛出Exception或者Throwable,应使用有业务含义的自定义异常（例如ServiceException）。
  • 捕获异常后必须进行处理（例如记录日志）。如果不想处理它，需要将异常抛给它的调用者。
  • 最外层的逻辑必须处理异常，将其转化成用户可以理解的内容。
  • 避免出现重复的代码（Don’t Repeat Yourself）,即DAY原则。

SpringBoot 工程下的异常处理

准备工作

第一步：创建项目或module，并添加web依赖，代码如下：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

第二步：修改项目访问端口为80，例如

server.port=80

第三步：定义Controller类，代码如下：

package com.cy.pj.arithmetic.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class ArithmeticController {

  @RequestMapping("doCompute/{n1}/{n2}")
  @ResponseBody
  public String doCompute(@PathVariable  Integer n1, 
  @PathVariable Integer n2){
          Integer result=n1/n2;
          return "Result is "+result;
  }
}

第四步启动项目进行访问测试

在浏览器地址栏输入http://localhost/doCompute/10/2，检测输出结果。

Result is 5

默认异常处理

在浏览器地址栏输入http://localhost/doCompute/10/0，检测输出结果。

image.png

对于这样的默认异常处理(spring boot提供)，用户体验不太友好，为了呈现更加友好的异常信息，我们通常要对异常进行自定义处理。

自己try异常处理

在控制层方法中，我们可以进行try catch处理，例如：

 @RequestMapping("doCompute/{n1}/{n2}")
  @ResponseBody
  public String doCompute(@PathVariable  Integer n1, 
  @PathVariable Integer n2){
          try{
          Integer result=n1/n2;
          return "Result is "+result;
          }catch(ArithmeticException e){
          return "exception is "+e.getMessage();
          }
  }

一个Controller类中通常会有多个方法，这样多个方法中都写try语句进行异常处理会带来大量重复代码的编写，不易维护。

Controller内部定义异常处理方法

在Controller类中添加异常处理方法，代码如下：

@ExceptionHandler(ArithmeticException.class)
@ResponseBody
public String doHandleArithmeticException(ArithmeticException e){
    e.printStackTrace();
    return "计算过程中出现了异常，异常信息为"+e.getMessage();
}

@ExceptionHandler注解描述的方法为异常处理方法(注解中的异常类型为可处理的异常类型)，假如Controller类中的逻辑方法中出现异常后没有处理异常，则会查找Controller类中有没有定义异常处理方法，假如定义了，且可以处理抛出的异常类型，则由异常处理方法处理异常。

控制层中的全局异常处理类及方法定义

当项目由多个控制层类中有多个共性异常的处理方法定义时，我们可以将这些方法提取到公共的父类对象中，但是这种方式是一种强耦合的实现，不利于代码的维护。我们还可以借助spring框架中web模块定义的全局异常处理规范进行实现，例如定义全局异常处理类,代码如下：

package com.cy.pj.common.web;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ArithmeticException.class)
    public String doHandleArithmeticException(ArithmeticException e){
        e.printStackTrace();
        return  "计算过程中出现了异常，异常信息为"+e.getMessage();
    }
}

其中，@RestControllerAdvice 注解描述的类为全局异常处理类，当控制层方法中的异常没有自己捕获,也没有定义其内部的异常处理方法，底层默认会查找全局异常处理类，调用对应的异常处理方法进行异常处理。

总结(Summary)

本小节主要是对springboot中的异常处理机制进行了简单分析和讲解。目的是掌握springboot工程下的异常处理方式，并基于业务的不同进行响应的异常处理。从而有效提高其用户体验，加强系统的容错能力。

11-SpringBoot 工程中的异常处理方式

11-SpringBoot 工程中的异常处理方式

11-SpringBoot 工程中的异常处理方式

springboot

背景分析

在项目的开发中，不管是对底层的数据逻辑操作过程，还是业务逻辑的处理过程，还是控制逻辑的处理过程，都不可避免会遇到各种可预知的、不可预知的异常。处理好异常对系统有很好的保护作用，同时会大大提高用户的体验。

异常处理分析

概述

Java项目中处理异常方式无非两种，要么执行trycatch操作，要么执行throw操作(抛给其它对象处理)，无论采用哪种方式，其目的是让我们的系统对异常要有反馈。但现在的问题是我们如何让这种反馈代码的编写即简单又直观、友好。

处理规范

我们在处理异常的过程中通常要遵循一定的设计规范，例如：

  • 捕获异常时与抛出的异常必须完全匹配，或者捕获异常是抛出异常的父类类型。
  • 避免直接抛出RuntimeException,更不允许抛出Exception或者Throwable,应使用有业务含义的自定义异常（例如ServiceException）。
  • 捕获异常后必须进行处理（例如记录日志）。如果不想处理它，需要将异常抛给它的调用者。
  • 最外层的逻辑必须处理异常，将其转化成用户可以理解的内容。
  • 避免出现重复的代码（Don’t Repeat Yourself）,即DAY原则。

SpringBoot 工程下的异常处理

准备工作

第一步：创建项目或module，并添加web依赖，代码如下：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

第二步：修改项目访问端口为80，例如

server.port=80

第三步：定义Controller类，代码如下：

package com.cy.pj.arithmetic.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class ArithmeticController {

  @RequestMapping("doCompute/{n1}/{n2}")
  @ResponseBody
  public String doCompute(@PathVariable  Integer n1, 
  @PathVariable Integer n2){
          Integer result=n1/n2;
          return "Result is "+result;
  }
}

第四步启动项目进行访问测试

在浏览器地址栏输入http://localhost/doCompute/10/2，检测输出结果。

Result is 5

默认异常处理

在浏览器地址栏输入http://localhost/doCompute/10/0，检测输出结果。

image.png

对于这样的默认异常处理(spring boot提供)，用户体验不太友好，为了呈现更加友好的异常信息，我们通常要对异常进行自定义处理。

自己try异常处理

在控制层方法中，我们可以进行try catch处理，例如：

 @RequestMapping("doCompute/{n1}/{n2}")
  @ResponseBody
  public String doCompute(@PathVariable  Integer n1, 
  @PathVariable Integer n2){
          try{
          Integer result=n1/n2;
          return "Result is "+result;
          }catch(ArithmeticException e){
          return "exception is "+e.getMessage();
          }
  }

一个Controller类中通常会有多个方法，这样多个方法中都写try语句进行异常处理会带来大量重复代码的编写，不易维护。

Controller内部定义异常处理方法

在Controller类中添加异常处理方法，代码如下：

@ExceptionHandler(ArithmeticException.class)
@ResponseBody
public String doHandleArithmeticException(ArithmeticException e){
    e.printStackTrace();
    return "计算过程中出现了异常，异常信息为"+e.getMessage();
}

@ExceptionHandler注解描述的方法为异常处理方法(注解中的异常类型为可处理的异常类型)，假如Controller类中的逻辑方法中出现异常后没有处理异常，则会查找Controller类中有没有定义异常处理方法，假如定义了，且可以处理抛出的异常类型，则由异常处理方法处理异常。

控制层中的全局异常处理类及方法定义

当项目由多个控制层类中有多个共性异常的处理方法定义时，我们可以将这些方法提取到公共的父类对象中，但是这种方式是一种强耦合的实现，不利于代码的维护。我们还可以借助spring框架中web模块定义的全局异常处理规范进行实现，例如定义全局异常处理类,代码如下：

package com.cy.pj.common.web;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ArithmeticException.class)
    public String doHandleArithmeticException(ArithmeticException e){
        e.printStackTrace();
        return  "计算过程中出现了异常，异常信息为"+e.getMessage();
    }
}

其中，@RestControllerAdvice 注解描述的类为全局异常处理类，当控制层方法中的异常没有自己捕获,也没有定义其内部的异常处理方法，底层默认会查找全局异常处理类，调用对应的异常处理方法进行异常处理。如图所示:

image.png

总结(Summary)

本小节主要是对springboot中的异常处理机制进行了简单分析和讲解。目的是掌握springboot工程下的异常处理方式，并基于业务的不同进行响应的异常处理。从而有效提高其用户体验，加强系统的容错能力。

11-SpringBoot工程中的异常处理方式

11-SpringBoot工程中的异常处理方式

背景分析

在项目的开发中，不管是对底层的数据逻辑操作过程，还是业务逻辑的处理过程，还是控制逻辑的处理过程，都不可避免会遇到各种可预知的、不可预知的异常。处理好异常对系统有很好的保护作用，同时会大大提高用户的体验。

异常处理分析

概述

Java项目中处理异常方式无非两种，要么执行trycatch操作，要么执行throw操作(抛给其它对象处理)，无论采用哪种方式，其目的是让我们的系统对异常要有反馈。但现在的问题是我们如何让这种反馈代码的编写即简单又直观、友好。

处理规范

我们在处理异常的过程中通常要遵循一定的设计规范，例如：

  • 捕获异常时与抛出的异常必须完全匹配，或者捕获异常是抛出异常的父类类型。
  • 避免直接抛出RuntimeException,更不允许抛出Exception或者Throwable,应使用有业务含义的自定义异常（例如ServiceException）。
  • 捕获异常后必须进行处理（例如记录日志）。如果不想处理它，需要将异常抛给它的调用者。
  • 最外层的逻辑必须处理异常，将其转化成用户可以理解的内容。
  • 避免出现重复的代码（Don’t Repeat Yourself）,即DAY原则。

SpringBoot 工程下的异常处理

准备工作

第一步：创建项目或module，并添加web依赖，代码如下：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

第二步：修改项目访问端口为80，例如

server.port=80

第三步：定义Controller类，代码如下：

package com.cy.pj.arithmetic.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class ArithmeticController {

  @RequestMapping("doCompute/{n1}/{n2}")
  @ResponseBody
  public String doCompute(@PathVariable  Integer n1, 
  @PathVariable Integer n2){
          Integer result=n1/n2;
          return "Result is "+result;
  }
}

第四步启动项目进行访问测试

在浏览器地址栏输入http://localhost/doCompute/10/2，检测输出结果。

Result is 5

默认异常处理

在浏览器地址栏输入http://localhost/doCompute/10/0，检测输出结果。
image
对于这样的默认异常处理(spring boot提供)，用户体验不太友好，为了呈现更加友好的异常信息，我们通常要对异常进行自定义处理。

自己try异常处理

在控制层方法中，我们可以进行try catch处理，例如：

 @RequestMapping("doCompute/{n1}/{n2}")
  @ResponseBody
  public String doCompute(@PathVariable  Integer n1, 
  @PathVariable Integer n2){
          try{
          Integer result=n1/n2;
          return "Result is "+result;
          }catch(ArithmeticException e){
          return "exception is "+e.getMessage();
          }
  }

一个Controller类中通常会有多个方法，这样多个方法中都写try语句进行异常处理会带来大量重复代码的编写，不易维护。

Controller内部定义异常处理方法

在Controller类中添加异常处理方法，代码如下：

@ExceptionHandler(ArithmeticException.class)
@ResponseBody
public String doHandleArithmeticException(ArithmeticException e){
    e.printStackTrace();
    return "计算过程中出现了异常，异常信息为"+e.getMessage();
}

@ExceptionHandler注解描述的方法为异常处理方法(注解中的异常类型为可处理的异常类型)，假如Controller类中的逻辑方法中出现异常后没有处理异常，则会查找Controller类中有没有定义异常处理方法，假如定义了，且可以处理抛出的异常类型，则由异常处理方法处理异常。

控制层中的全局异常处理类及方法定义

当项目由多个控制层类中有多个共性异常的处理方法定义时，我们可以将这些方法提取到公共的父类对象中，但是这种方式是一种强耦合的实现，不利于代码的维护。我们还可以借助spring框架中web模块定义的全局异常处理规范进行实现，例如定义全局异常处理类,代码如下：

package com.cy.pj.common.web;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ArithmeticException.class)
    public String doHandleArithmeticException(ArithmeticException e){
        e.printStackTrace();
        return  "计算过程中出现了异常，异常信息为"+e.getMessage();
    }
}

其中，@RestControllerAdvice 注解描述的类为全局异常处理类，当控制层方法中的异常没有自己捕获,也没有定义其内部的异常处理方法，底层默认会查找全局异常处理类，调用对应的异常处理方法进行异常处理。

总结(Summary)

本小节主要是对springboot中的异常处理机制进行了简单分析和讲解。目的是掌握springboot工程下的异常处理方式，并基于业务的不同进行响应的异常处理。从而有效提高其用户体验，加强系统的容错能力。

Spring Boot HTTP over JSON 的错误码异常处理

Spring Boot HTTP over JSON 的错误码异常处理

摘要: 原创出处:www.bysocket.com 泥瓦匠BYSocket 希望转载，保留摘要，谢谢！

“年轻人不要怕表现，要敢于出来表现，但还是那句话，要有正确的度，你的表现是分析问题和解决问题的能力。”

– 《你凭什么做好互联网》

本文提纲
一、异常统一处理的使用场景
二、运行 springboot-validation-over-json 工程
三、springboot-validation-over-json 工程代码详解

一、异常统一处理的使用场景

在前后端分离开发中，经常用 HTTP over JSON 作为服务进行前后端联调对接。这里简单介绍下为啥前后端分离开发？我想到如下：

1.低耦合，责权分离，模块化。前后端之间利用轻量级协议对接耦合。
2.便于敏捷开发：后端给出 api 文档 -> 前端根据文档，mock出数据开发 ；同时，后端实现业务逻辑。
3.微服务尤其适用

这时候 HTTP over JSON 形式中很多涉及到返回码，错误码相关的处理。比如xxx参数不完整，权限不足，用户不存在等。

怎么统一处理认为是异常的场景呢？
利用的是 Spring 4.x 提供的 RestControllerAdvice。这里做下说明，也可以根据 ControllerAdvice 去实现。这里案例是 HTTP over JSON 模式，所以直接利用
RestControllerAdvice ，控制层通知器，这里用于统一拦截异常，进行响应处理。工作模式，如图：

二、运行 springboot-validation-over-json 工程

运行环境：JDK 7 或 8，Maven 3.0+
技术栈：SpringBoot 1.5+（内涵 Spring 4.x)

1.git clone 下载工程 springboot-learning-example
项目地址见 GitHub – https://github.com/JeffLi1993/springboot-learning-example：

1

git clone git@github.com:JeffLi1993/springboot-learning-example.git

然后，Maven 编译安装这个工程：

1

2

cd springboot-learning-example

mvn clean install

2.运行 springboot-validation-over-json 工程
右键运行 springboot-validation-over-json 工程 Application 应用启动类的 main 函数。默认端口 8080

3.访问案例
a. 参数不完整案例：
访问浏览器打开下面链接，可得到以下 JSON 返回
http://localhost:8080/api/city?cityName=

1

2

3

4

5

{

    "code": "000001",

    "message": "params no complete",

    "result": null

}

b. 成功案例：
访问浏览器打开下面链接，可得到以下 JSON 返回
http://localhost:8080/api/city?cityName=%E6%B8%A9%E5%B2%AD%E5%B8%82

1

2

3

4

5

6

7

8

9

10

{

    "code": "0",

    "message": "success",

    "result": {

        "id": 1,

        "provinceId": 2,

        "cityName": "温岭",

        "description": "是我的故乡"

    }

}

三、springboot-validation-over-json 工程代码详解

代码详解提纲：
a.控制层通知器
b.响应码设计

同样，代码共享在我的 GitHub 上：
https://github.com/JeffLi1993/springboot-learning-example/tree/master/springboot-validation-over-json

首先，工程代码目录如下：

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

├── pom.xml

└── src

    └── main

        └── java

            └── org

                └── spring

                    └── springboot

                        ├── Application.java

                        ├── constant

                        │   └── CityErrorInfoEnum.java

                        ├── result

                        │   ├── ErrorInfoInterface.java

                        │   ├── GlobalErrorInfoEnum.java

                        │   ├── GlobalErrorInfoException.java

                        │   ├── GlobalErrorInfoHandler.java

                        │   └── ResultBody.java

                        └── web

                            ├── City.java

                            └── ErrorJsonController.java

a.控制层通知器
GlobalErrorInfoHandler.java 代码如下：

1

2

3

4

5

6

7

8

9

10

11

@RestControllerAdvice

public class GlobalErrorInfoHandler {

 

@ExceptionHandler(value = GlobalErrorInfoException.class)

public ResultBody errorHandlerOverJson(HttpServletRequest request,

GlobalErrorInfoException exception) {

    ErrorInfoInterface errorInfo = exception.getErrorInfo();

    ResultBody result = new ResultBody(errorInfo);

    return result;

}

}

@ExceptionHandler 注解，标记了使用 errorHandlerOverJson() 方法来处理 GlobalErrorInfoException 异常。
@RestControllerAdvice 是 @ControllerAdvice 和 @ResponseBody 的语义结合。是控制器增强，直接返回对象。这里用于统一拦截异常，然后返回错误码对象体。
@ResponseBody 作用： 该注解用于将 Controller 的方法返回的对象，通过适当的 HttpMessageConverter 转换为指定格式后，写入到 Response 对象的 body 数据区。

b.响应码设计
简单讲讲，这里定义了一个错误码接口，全局错误码枚举和各个业务错误码枚举去实现接口，并用枚举值枚举出错误码及错误码消息列表。如图：

四、小结

如果实战中，大家遇到什么，或者建议《Spring boot 那些事》还需要一起交流的。请点击留言。

推荐书《腾讯传》，其中几章写的很不错。

欢迎扫一扫我的公众号关注 — 及时得到博客订阅哦！
— http://www.bysocket.com/ —
— https://github.com/JeffLi1993 —

关于Spring Boot 返回 JSON 格式的异常处理和spring boot 返回json 对象的问题我们已经讲解完毕，感谢您的阅读，如果还想了解更多关于04-SpringBoot 工程中的异常处理方式【转】、11-SpringBoot 工程中的异常处理方式、11-SpringBoot工程中的异常处理方式、Spring Boot HTTP over JSON 的错误码异常处理等相关内容，可以在本站寻找。

本文标签：

上一篇如何在Android中处理ConcurrentModificationException（android.intent.action.media_mounted）

下一篇大家觉得这个 jsp 文件上传工具类，好用吗？？（jsp上传文件如何实现）

相关文章