SpringBoot2.x如何統(tǒng)一返回值

這篇文章主要介紹了Spring Boot 2.x如何統(tǒng)一返回值，具有一定借鑒價值，感興趣的朋友可以參考下，希望大家閱讀完這篇文章之后大有收獲，下面讓小編帶著大家一起了解一下。

創(chuàng)新互聯(lián)公司服務項目包括廬陽網(wǎng)站建設、廬陽網(wǎng)站制作、廬陽網(wǎng)頁制作以及廬陽網(wǎng)絡營銷策劃等。多年來，我們專注于互聯(lián)網(wǎng)行業(yè)，利用自身積累的技術(shù)優(yōu)勢、行業(yè)經(jīng)驗、深度合作伙伴關(guān)系等，向廣大中小型企業(yè)、政府機構(gòu)等提供互聯(lián)網(wǎng)行業(yè)的解決方案，廬陽網(wǎng)站推廣取得了明顯的社會效益與經(jīng)濟效益。目前，我們服務的客戶以成都為中心已經(jīng)輻射到廬陽省份的部分城市，未來相信會繼續(xù)擴大服務區(qū)域并繼續(xù)獲得客戶的支持與信任！

為什么要統(tǒng)一返回值

在我們做后端應用的時候，前后端分離的情況下，我們經(jīng)常會定義一個數(shù)據(jù)格式，通常會包含code，message，data這三個必不可少的信息來方便我們的交流，下面我們直接來看代碼

ReturnVO

package indi.viyoung.viboot.util;

import java.util.Properties;

/**
 * 統(tǒng)一定義返回類
 *
 * @author yangwei
 * @since 2018/12/20
 */
public class ReturnVO {

    private static final Properties properties = ReadPropertiesUtil.getProperties(System.getProperty("user.dir") + "/viboot-common/src/main/resources/response.properties");

    /**
     * 返回代碼
     */
    private String code;

    /**
     * 返回信息
     */
    private String message;

    /**
     * 返回數(shù)據(jù)
     */
    private Object data;


    public Object getData() {
        return data;
    }

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

    public String getMessage() {
        return message;
    }

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

    public String getCode() {
        return code;
    }

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

    /**
     * 默認構(gòu)造，返回操作正確的返回代碼和信息
     */
    public ReturnVO() {
        this.setCode(properties.getProperty(ReturnCode.SUCCESS.val()));
        this.setMessage(properties.getProperty(ReturnCode.SUCCESS.msg()));
    }

    /**
     * 構(gòu)造一個返回特定代碼的ReturnVO對象
     * @param code
     */
    public ReturnVO(ReturnCode code) {
        this.setCode(properties.getProperty(code.val()));
        this.setMessage(properties.getProperty(code.msg()));
    }

    /**
     * 默認值返回，默認返回正確的code和message
     * @param data
     */
    public ReturnVO(Object data) {
        this.setCode(properties.getProperty(ReturnCode.SUCCESS.val()));
        this.setMessage(properties.getProperty(ReturnCode.SUCCESS.msg()));
        this.setData(data);
    }

    /**
     * 構(gòu)造返回代碼，以及自定義的錯誤信息
     * @param code
     * @param message
     */
    public ReturnVO(ReturnCode code, String message) {
        this.setCode(properties.getProperty(code.val()));
        this.setMessage(message);
    }

    /**
     * 構(gòu)造自定義的code，message，以及data
     * @param code
     * @param message
     * @param data
     */
    public ReturnVO(ReturnCode code, String message, Object data) {
        this.setCode(code.val());
        this.setMessage(message);
        this.setData(data);
    }

    @Override
    public String toString() {
        return "ReturnVO{" +
                "code='" + code + '\'' +
                ", message='" + message + '\'' +
                ", data=" + data +
                '}';
    }
}

在這里，我提供了幾個構(gòu)造方法以供不同情況下使用。代碼的注釋已經(jīng)寫得很清楚了，大家也可以應該看的比較清楚~

ReturnCode

細心的同學可能發(fā)現(xiàn)了，我單獨定義了一個ReturnCode枚舉類用于存儲代碼和返回的Message：

package indi.viyoung.viboot.util;

/**
 * @author yangwei
 * @since 2018/12/20
 */
public enum ReturnCode {

    /** 操作成功 */
    SUCCESS("SUCCESS_CODE", "SUCCESS_MSG"),

    /** 操作失敗 */
    FAIL("FAIL_CODE", "FAIL_MSG"),

    /** 空指針異常 */
    NullpointerException("NPE_CODE", "NPE_MSG"),

    /** 自定義異常之返回值為空 */
    NullResponseException("NRE_CODE", "NRE_MSG");


    private ReturnCode(String value, String msg){
        this.val = value;
        this.msg = msg;
    }

    public String val() {
        return val;
    }

    public String msg() {
        return msg;
    }

    private String val;
    private String msg;
}

這里，我并沒有將需要存儲的數(shù)據(jù)直接放到枚舉中，而是放到了一個配置文件中，這樣既可以方便我們進行相關(guān)信息的修改，并且閱讀起來也是比較方便。

SUCCESS_CODE=2000
SUCCESS_MSG=操作成功

FAIL_CODE=5000
FAIL_MSG=操作失敗

NPE_CODE=5001
NPE_MSG=空指針異常

NRE_CODE=5002
NRE_MSG=返回值為空

注意，這里的屬性名和屬性值分別與枚舉類中的value和msg相對應，這樣，我們才可以方便的去通過I/O流去讀取。

這里需要注意一點，如果你使用的是IDEA編輯器，需要修改以下的配置，這樣你編輯配置文件的時候?qū)懙氖侵形?，實際上保存的是ASCII字節(jié)碼。

Spring Boot 2.x如何統(tǒng)一返回值

下面，來看一下讀取的工具類：

package indi.viyoung.viboot.util;

import java.io.*;
import java.util.Iterator;
import java.util.Properties;

/**
 * 讀取*.properties中的屬性
 * @author vi
 * @since 2018/12/24 7:33 PM
 */
public class ReadPropertiesUtil {

    public static Properties getProperties(String propertiesPath){
        Properties properties = new Properties();
        try {
            InputStream inputStream = new BufferedInputStream(new FileInputStream(propertiesPath));
            properties.load(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
        return properties;
    }
}

這里我直接寫了一個靜態(tài)的方法，傳入的參數(shù)是properties文件的位置，這樣的話，本文最初代碼中的也就得到了解釋。

    private static final Properties properties = ReadPropertiesUtil.getProperties(System.getProperty("user.dir") + "/viboot-common/src/main/resources/response.properties");

使用ReturnVO

    @RequestMapping("/test")
    public ReturnVO test(){
        try {
           //省略
            //省略
        }  catch (Exception e) {
            e.printStackTrace();
        }
        return new ReturnVO();
    }

下面我們可以去訪問這個接口，看看會得到什么：

Spring Boot 2.x如何統(tǒng)一返回值

但是，現(xiàn)在問題又來了，因為try...catch...的存在，總是會讓代碼變得重復度很高，一個接口你都至少要去花三到十秒去寫這個接口，如果不知道編輯器的快捷鍵，更是一種噩夢。我們只想全心全意的去關(guān)注實現(xiàn)業(yè)務，而不是花費大量的時間在編寫一些重復的"剛需"代碼上。

使用AOP進行全局異常的處理

（這里，我只是對全局異常處理進行一個簡單的講解，后面也就是下一節(jié)中會詳細的講述）

/**
 * 統(tǒng)一封裝返回值和異常處理
 *
 * @author vi
 * @since 2018/12/20 6:09 AM
 */
@Slf4j
@Aspect
@Order(5)
@Component
public class ResponseAop {

    private static final Properties properties = ReadPropertiesUtil.getProperties(System.getProperty("user.dir") + "/viboot-common/src/main/resources/response.properties");

    /**
     * 切點
     */
    @Pointcut("execution(public * indi.viyoung.viboot.*.controller..*(..))")
    public void httpResponse() {
    }

    /**
     * 環(huán)切
     */
    @Around("httpResponse()")
    public ReturnVO handlerController(ProceedingJoinPoint proceedingJoinPoint) {
        ReturnVO returnVO = new ReturnVO();
        try {
             //獲取方法的執(zhí)行結(jié)果
            Object proceed = proceedingJoinPoint.proceed();
            //如果方法的執(zhí)行結(jié)果是ReturnVO，則將該對象直接返回
            if (proceed instanceof ReturnVO) {
                returnVO = (ReturnVO) proceed;
            } else {
                //否則，就要封裝到ReturnVO的data中
                returnVO.setData(proceed);
            }
        }  catch (Throwable throwable) {
             //如果出現(xiàn)了異常，調(diào)用異常處理方法將錯誤信息封裝到ReturnVO中并返回
            returnVO = handlerException(throwable);
        }
        return returnVO;
    }

    /**
     * 異常處理
     */ 
    private ReturnVO handlerException(Throwable throwable) {
        ReturnVO returnVO = new ReturnVO();
        //這里需要注意，返回枚舉類中的枚舉在寫的時候應該和異常的名稱相對應，以便動態(tài)的獲取異常代碼和異常信息
        //獲取異常名稱的方法
        String errorName = throwable.toString();
        errorName = errorName.substring(errorName.lastIndexOf(".") + 1);
        //直接獲取properties文件中的內(nèi)容
         returnVO.setMessage(properties.getProperty(ReturnCode.valueOf(errorName).msg()));
        returnVO.setCode(properties.getProperty(ReturnCode.valueOf(errorName).val()));
        return returnVO;
    }
}

如果，我們需要在每一個項目中都可以這么去做，需要將這個類放到一個公用的模塊中，然后在pom中導入這個模塊

        <dependency>
            <groupId>indi.viyoung.course</groupId>
            <artifactId>viboot-common</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>

這里需要注意一點，必須保證你的切點的正確書寫！！否則就會導致切點無效，同時需要在啟動類中配置：

@ComponentScan(value = "indi.viyoung.viboot.*")

導入的正是common包下的所有文件，以保證可以將ResponseAop這個類加載到Spring的容器中。

下面我們來測試一下，訪問我們經(jīng)過修改后的編寫的findAll接口：

    @RequestMapping("/findAll")
    public Object findAll(){
        return userService.list();
    }

PS：這里我將返回值統(tǒng)一為Object，以便數(shù)據(jù)存入data，實際類型應是Service接口的返回類型。如果沒有返回值的話，那就可以new一個ReturnVO對象直接通過構(gòu)造方法賦值即可。關(guān)于返回類型為ReturnVO的判斷，代碼中也已經(jīng)做了特殊的處理，并非存入data，而是直接返回。

Spring Boot 2.x如何統(tǒng)一返回值

下面，我們修改一下test方法，讓他拋出一個我們自定義的查詢返回值為空的異常：

    @RequestMapping("/test")
    public ReturnVO test(){
        throw new NullResponseException();
    }

下面，我們再來訪問以下test接口：

Spring Boot 2.x如何統(tǒng)一返回值

可以看到，正如我們properties中定義的那樣，我們得到了我們想要的消息。

感謝你能夠認真閱讀完這篇文章，希望小編分享的“Spring Boot 2.x如何統(tǒng)一返回值”這篇文章對大家有幫助，同時也希望大家多多支持創(chuàng)新互聯(lián)，關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道，更多相關(guān)知識等著你來學習!

新聞標題：SpringBoot2.x如何統(tǒng)一返回值
網(wǎng)站網(wǎng)址：http://muchs.cn/article46/isjghg.html

成都網(wǎng)站建設公司_創(chuàng)新互聯(lián)，為您提供網(wǎng)站維護、用戶體驗、電子商務、網(wǎng)站營銷、全網(wǎng)營銷推廣、云服務器

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時需注明來源： 創(chuàng)新互聯(lián)

網(wǎng)站優(yōu)化排名