Springboot的异常处理与自定义异常

程序员文章站 2022-06-23 16:46:18

园友们好，元旦很快就到来了，提前祝各位园友们元旦快乐，今天给大家分享一个工作中必用一个知识点，就是使用枚举构建自定义异常并应用于springboot的异常处理器。开始之前我先把这个案例的结构大致说明一下： 1、使用idea创建一个springboot的Gradle/Maven项目，引入web模块即可 ......

园友们好，元旦很快就到来了，提前祝各位园友们元旦快乐，今天给大家分享一个工作中必用一个知识点，就是使用枚举构建自定义异常并应用于springboot的异常处理器。开始之前我先把这个案例的结构大致说明一下：

1、使用idea创建一个springboot的gradle/maven项目，引入web模块即可（由于案例的重点是异常处理，所以跳过其他操作）。

2、创建一个javabean，用来接收前台的参数。

3、创建一个枚举、封装异常的错误码等信息。

4、创建一个自定义异常类继承runtimeexception。

5、创建一个controller，用来处理用户请求。

6、创建一个springboot的异常处理类。

7、运行项目，测试。

ok、接下来就进入正题，先来第一步，创建项目（创建项目的过程就不需要一一演示了吧，^_^），下面是创建项目之后的gradle项目中build.gradle中的依赖：

1 dependencies {
2     implementation('org.springframework.boot:spring-boot-starter-web')
3     testimplementation('org.springframework.boot:spring-boot-starter-test')
4 }

如果各位读者是maven项目的话，pom.xml文件中的依赖应该长这样子：

 1 <dependencies>
 2         <dependency>
 3             <groupid>org.springframework.boot</groupid>
 4             <artifactid>spring-boot-starter-web</artifactid>
 5         </dependency>
 6 
 7         <dependency>
 8             <groupid>org.springframework.boot</groupid>
 9             <artifactid>spring-boot-starter-test</artifactid>
10             <scope>test</scope>
11         </dependency>
12     </dependencies>

ok，下面开始第二步，创建一个javabean：

package com.maolinjava.entity;

import java.io.serializable;

/**
 * created by tml on 2018/12/28.
 */
public class user implements serializable {
    
    private string username;
    
    private string password;

    public string getusername() {
        return username;
    }

    public void setusername(string username) {
        this.username = username;
    }

    public string getpassword() {
        return password;
    }

    public void setpassword(string password) {
        this.password = password;
    }
}

ok，再来第三步，创建一个枚举、封装异常的错误码等信息：

package com.maolinjava.commons.constant;

/**
 * created by tml on 2018/12/28.
 */
public enum serviceerrcode {

    req_param_err(10001,"请求参数异常"),
    notfound_result_err(10004,"未找到结果");

    private int code;

    serviceerrcode(int code,string msg){
        this.code = code;
    }

    public int getcode() {
        return code;
    }
}

再来第四步、创建自定义异常类：

package com.maolinjava.commons.exception;

import com.maolinjava.commons.constant.serviceerrcode;

/**
 * created by tml on 2018/12/28.
 */
public class baseserviceexception extends runtimeexception {

    private int code;

    public baseserviceexception(string message, serviceerrcode serviceerrcode) {//构造器的第二个参数是上面创建的那个枚举，之后把枚举里面定义的code给了这个code
        super(message);
        this.code = serviceerrcode.getcode();
    }

    public int getcode() {
        return code;
    }

    @override
    public string getmessage() {
        return super.getmessage();
    }
}

第五步，创建一个controller：

package com.maolinjava.controller;

import com.fasterxml.jackson.databind.objectmapper;
import com.fasterxml.jackson.databind.node.objectnode;
import com.maolinjava.commons.constant.serviceerrcode;
import com.maolinjava.commons.exception.baseserviceexception;
import com.maolinjava.entity.user;
import org.springframework.web.bind.annotation.postmapping;
import org.springframework.web.bind.annotation.requestbody;
import org.springframework.web.bind.annotation.restcontroller;

import javax.annotation.resource;
import java.util.objects;

/**
 * created by tml on 2018/12/28.
 */
@restcontroller
public class usercontroller {

    @resource
    private objectmapper jsonmapper;

    @postmapping("/login")
    public objectnode login(@requestbody(required = false) user user){
        //如果用户发起的请求参数中user为null的话，就会抛出自定义的异常，之后会被全局的异常处理器所拦截响应到前端
        if(objects.isnull(user)){
            throw new baseserviceexception("用户为空，请填写用户名和密码", serviceerrcode.req_param_err);
        }
        //如果输入了用户名和密码则正常把输入的信息响应回去
        system.out.println(user);
        return jsonmapper.createobjectnode().putpojo("data",user);
    }

}

ok，再来第六步、创建一个springboot的异常处理类：

package com.maolinjava.commons.exception.handler;

import com.fasterxml.jackson.databind.objectmapper;
import com.fasterxml.jackson.databind.node.objectnode;
import com.maolinjava.commons.exception.baseserviceexception;
import org.springframework.web.bind.annotation.exceptionhandler;
import org.springframework.web.bind.annotation.restcontrolleradvice;

import javax.annotation.resource;

/**
 * created by tml on 2018/12/28.
 */
@restcontrolleradvice
public class globalexceptionhandler {

    @resource
    private objectmapper jsonmapper;

    @exceptionhandler(baseserviceexception.class)
    public objectnode baseserviceexception(baseserviceexception e){
        int code = e.getcode();
        string msg = e.getmessage();
        return jsonmapper.createobjectnode().put("code",code).put("msg",msg);
    }

}

这个异常处理类主要用到的两个注解是@restcontrolleradvice和@exceptionhandler(xxx.class)，说明一下：@restcontrolleradvice注解表示全局的异常通知，里面的value属性可以指定一个异常通知的包范围，一般这个不用去指定，就让他对全部的包进行扫描即可；@exceptionhandler(xxx.class)这个注解加在方法上，表示要拦截的某个异常并对该异常进行处理，里面的参数是要拦截的异常的类型，我这里拦截的是baseserviceexception这个异常，如果程序中有抛出baseserviceexception的地方就会进入该方法进行处理。

代码已经全部ok，启动项目，打开postman访问 localhost:8080/login，附一张postman的请求截图：

Springboot的异常处理与自定义异常