文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

SpringBoot全局异常处理方式是什么

2023-06-25 17:05

关注

这篇文章主要讲解了“SpringBoot全局异常处理方式是什么”,文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习“SpringBoot全局异常处理方式是什么”吧!

SpringBoot全局异常处理

为了让客户端能有一个更好的体验,当客户端发送请求到服务端发生错误时服务端应该明确告诉客户端错误信息。

SpringBoot全局异常处理方式是什么

SpringBoot内置的异常处理返回的界面太杂乱,不够友好。我们需要将异常信息做封装处理响应给前端。本文介绍的为将错误信息统一封装成如下格式json响应给前端。

{code:10001,message:xxxxx,request:GET url}

自定义异常类

package com.lin.missyou.exception;public class HttpException extends RuntimeException{    protected Integer code;    protected Integer httpStatusCode;    public Integer getCode() {        return code;    }    public void setCode(Integer code) {        this.code = code;    }    public Integer getHttpStatusCode() {        return httpStatusCode;    }    public void setHttpStatusCode(Integer httpStatusCode) {        this.httpStatusCode = httpStatusCode;    }}
package com.lin.missyou.exception;public class NotFoundException extends HttpException{    public NotFoundException(int code){        this.httpStatusCode = 404;        this.code = code;    }}
package com.lin.missyou.exception;public class ForbiddenException extends HttpException{    public ForbiddenException(int code){        this.httpStatusCode = 403;        this.code = code;    }}

创建一个用于封装异常信息的类UnifyResponse

package com.lin.missyou.core;public class UnifyResponse {    private int code;    private String message;    private String request;    public int getCode() {        return code;    }    public String getMessage() {        return message;    }    public String getRequest() {        return request;    }    public UnifyResponse(int code, String message, String request) {        this.code = code;        this.message = message;        this.request = request;    }}

将异常信息写在配置文件exception-code.properties里

lin.codes[10000] = 通用异常lin.codes[10001] = 通用参数错误

自定义配置类管理配置文件

package com.lin.missyou.core.configuration;import org.springframework.boot.context.properties.ConfigurationProperties;import org.springframework.context.annotation.PropertySource;import org.springframework.stereotype.Component;import java.util.HashMap;import java.util.Map;@PropertySource(value="classpath:config/exception-code.properties")@ConfigurationProperties(prefix = "lin")@Componentpublic class ExceptionCodeConfiguration {    private Map<Integer,String> codes = new HashMap<>();    public Map<Integer, String> getCodes() {        return codes;    }    public void setCodes(Map<Integer, String> codes) {        this.codes = codes;    }    public String getMessage(int code) {        String message = codes.get(code);        return message;    }}

创建一个全局异常处理类GlobalExceptionAdvice,用@ControllerAdvice标明异常处理类。@ResponseStatus用于指定http状态码。

@ExceptionHandler标明异常处理器,传入参数指定当前函数要处理哪种类型的异常。Springboot会帮我们把这些异常信息传入到函数。第一个函数用于处理未知异常,不需要向前端提供详细的错误原因,只需提示统一的文本信息即可。

第二个函数用于处理已知异常,需要指明具体的错误原因,需要根据Exception传递过来的信息灵活的定制httpStatusCode。ResponseEntity可以自定义很多属性,包括可以设置httpheaders,httpbodys,httpStatus。

package com.lin.missyou.core;import com.lin.missyou.core.config.ExceptionCodeConfiguration;import com.lin.missyou.exception.HttpException;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.http.HttpHeaders;import org.springframework.http.HttpStatus;import org.springframework.http.MediaType;import org.springframework.http.ResponseEntity;import org.springframework.validation.ObjectError;import org.springframework.web.bind.MethodArgumentNotValidException;import org.springframework.web.bind.annotation.ControllerAdvice;import org.springframework.web.bind.annotation.ExceptionHandler;import org.springframework.web.bind.annotation.ResponseBody;import org.springframework.web.bind.annotation.ResponseStatus;import javax.servlet.http.HttpServletRequest;import javax.validation.ConstraintViolation;import javax.validation.ConstraintViolationException;import java.util.List;@ControllerAdvicepublic class GlobalExceptionAdvice {    @Autowired    ExceptionCodeConfiguration exceptionCodeConfiguration ;    @ExceptionHandler(Exception.class)    @ResponseBody    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)    public UnifyResponse handleException(HttpServletRequest req,Exception e){        String method = req.getMethod();        String requestUrl = req.getRequestURI();        System.out.println(e);        UnifyResponse unifyResponse = new UnifyResponse(9999,"服务器错误",method+" "+requestUrl);        return unifyResponse;    }    @ExceptionHandler(HttpException.class)    public ResponseEntity<UnifyResponse> handleHttpException(HttpServletRequest req, HttpException e){        String method = req.getMethod();        String requestUrl = req.getRequestURI();        System.out.println(e);        UnifyResponse unifyResponse = new UnifyResponse(e.getCode(),exceptionCodeConfiguration.getMessage(e.getCode()),method+" "+requestUrl);        HttpHeaders httpHeaders = new HttpHeaders();        httpHeaders.setContentType(MediaType.APPLICATION_JSON);        HttpStatus httpStatus = HttpStatus.resolve(e.getHttpStatusCode());        ResponseEntity<UnifyResponse> responseEntity = new ResponseEntity(unifyResponse,httpHeaders,httpStatus);        return responseEntity;    }    //参数校验    @ExceptionHandler(MethodArgumentNotValidException.class)    @ResponseBody    @ResponseStatus(HttpStatus.BAD_REQUEST)    public UnifyResponse handleBeanValidation(HttpServletRequest req, MethodArgumentNotValidException e){        String method = req.getMethod();        String requestUrl = req.getRequestURI();        List<ObjectError> errors = e.getBindingResult().getAllErrors();        String message = formatAllErrorMessages(errors);        return new UnifyResponse(10001,message,method+" "+requestUrl);    }    private String formatAllErrorMessages(List<ObjectError> errors){        StringBuffer errorMsg = new StringBuffer();        errors.forEach(error ->                errorMsg.append(error.getDefaultMessage()).append(";")        );        return errorMsg.toString();    }    @ExceptionHandler(ConstraintViolationException.class)    @ResponseBody    @ResponseStatus(HttpStatus.BAD_REQUEST)    public UnifyResponse handleConstrainException(HttpServletRequest req, ConstraintViolationException e){        String method = req.getMethod();        String requestUrl = req.getRequestURI();        String message = e.getMessage();        return new UnifyResponse(10001,message,method+" "+requestUrl);    }}

响应信息可能会出现乱码现象,修改配置文件编码。在设置面板搜索File Encodings,Default encoding for properties files选择UTF-8,勾选Transparent native-to-ascii conversion

springboot全局异常处理——@ControllerAdvice+ExceptionHandler

一、全局捕获异常后,返回json给浏览器

项目结构:

SpringBoot全局异常处理方式是什么

自定义异常类 MyException.java

package com.gui.restful;public class MyException extends RuntimeException{    private String code;    private String msg;    public MyException(String code,String msg){        this.code=code;        this.msg=msg;    }    public String getCode() {        return code;    }    public void setCode(String code) {        this.code = code;    }    public String getMsg() {        return msg;    }    public void setMsg(String msg) {        this.msg = msg;    }}

控制器 MyController.java

package com.gui.restful;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.ResponseBody;import org.springframework.web.bind.annotation.RestController;@RestControllerpublic class MyController {    @RequestMapping("hello")    public String hello() throws Exception{        throw new MyException("101","系统异常");    }}

全局异常处理类 MyControllerAdvice

package com.gui.restful;import org.springframework.web.bind.annotation.ControllerAdvice;import org.springframework.web.bind.annotation.ExceptionHandler;import org.springframework.web.bind.annotation.RequestBody;import org.springframework.web.bind.annotation.ResponseBody;import java.util.HashMap;import java.util.Map;@ControllerAdvice //controller增强器public class MyControllerAdvice {    @ResponseBody    @ExceptionHandler(value=MyException.class) //处理的异常类型    public Map myExceptionHandler(MyException e){        Map<String,String> map=new HashMap<>();        map.put("code",e.getCode());        map.put("msg",e.getMsg());        return map;    }}

运行结果

启动应用,访问 http://localhost:8080/hello,出现以下结果,说明自定义异常被成功拦截

SpringBoot全局异常处理方式是什么

二、全局捕获异常后,返回页面给浏览器

自定义异常类 MyException.java(同上)

控制器 MyController.java(同上)

全局异常处理类 MyControllerAdvice

package com.gui.restful;import org.springframework.web.bind.annotation.ControllerAdvice;import org.springframework.web.bind.annotation.ExceptionHandler;import org.springframework.web.bind.annotation.RequestBody;import org.springframework.web.bind.annotation.ResponseBody;import org.springframework.web.servlet.ModelAndView;import java.util.HashMap;import java.util.Map;@ControllerAdvice //controller增强器public class MyControllerAdvice {    @ExceptionHandler(value=MyException.class) //处理的异常类型    public ModelAndView myExceptionHandler(MyException e){        ModelAndView modelAndView=new ModelAndView();        modelAndView.setViewName("error");        modelAndView.addObject("code",e.getCode());        modelAndView.addObject("msg",e.getMsg());        return modelAndView;    }}

页面渲染 error.ftl(用freemarker渲染)

pom.xml中引入freemarker依赖

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

error.ftl

<!DOCTYPE><html><head><title>错误页面</title></head><body><h2>code:$[code]</h2><h2>msg:${msg}</h2></body></html>

运行结果

启动应用,访问 http://localhost:8080/hello,出现以下结果,说明自定义异常被成功拦截

SpringBoot全局异常处理方式是什么

感谢各位的阅读,以上就是“SpringBoot全局异常处理方式是什么”的内容了,经过本文的学习后,相信大家对SpringBoot全局异常处理方式是什么这一问题有了更深刻的体会,具体使用情况还需要大家实践验证。这里是编程网,小编将为大家推送更多相关知识点的文章,欢迎关注!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯