1.控制器的響應(yīng)結(jié)果

當(dāng)控制器處理了請(qǐng)求之后，向客戶端響應(yīng)的結(jié)果中，應(yīng)該至少包含：

• 業(yè)務(wù)狀態(tài)碼：通常是數(shù)值類型的，客戶端可以根據(jù)此數(shù)值來(lái)判斷操作成功與否，或者，失敗時(shí)是哪一種失敗，具體值應(yīng)該是由服務(wù)器端和客戶端協(xié)商的
• 消息：是字符串類型的，客戶端可以將此消息直接顯示在軟件的界面中（例如顯示在網(wǎng)頁(yè)中、顯示在手機(jī)APP中……），有了這個(gè)數(shù)據(jù)，客戶端就不必自行組織語(yǔ)言來(lái)描述操作結(jié)果

由于響應(yīng)結(jié)果只有1個(gè)，但是需要同時(shí)包含業(yè)務(wù)狀態(tài)和消息，應(yīng)該使用JSON格式來(lái)組織這樣的結(jié)果，例如：

{

"state": 1,

"message": "添加相冊(cè)成功！"

}

或者：

{

"state": 2,

"message": "添加相冊(cè)失敗，嘗試添加的相冊(cè)名稱已經(jīng)被使用！"

}

2.相關(guān)配置

在Spring MVC框架中，當(dāng)需要響應(yīng)JSON格式的字符串時(shí)，需要：

使用自定義的數(shù)據(jù)類型作為處理請(qǐng)求的方法的返回值類型，并返回自定義數(shù)據(jù)類型的對(duì)象

需要在項(xiàng)目中添加jackson-databind依賴項(xiàng)

• 在spring-boot-starter-web中已經(jīng)包含jackson-databind

需要開(kāi)啟注解驅(qū)動(dòng)

• 在基于XML配置的Spring MVC項(xiàng)目中，需要在XML配置中添加<annotation-driven/>標(biāo)簽
• 在基于注解配置的Spring MVC項(xiàng)目中，需要在配置類上添加@EnableWebMvc注解
• 在Spring Boot項(xiàng)目中，不需要額外配置

則在項(xiàng)目的根包下創(chuàng)建web.JsonResult類，在類中聲明JSON結(jié)果中對(duì)應(yīng)的屬性：

package cn.tedu.csmall.product.web;
import lombok.Data;
@Data
public class JsonResult {
    private Integer state;
    private String message;
    public static JsonResult ok() {
        JsonResult jsonResult = new JsonResult();
        jsonResult.state = ServiceCode.OK;
        return jsonResult;
    }
}

然后，調(diào)整控制器中處理請(qǐng)求的方法的返回結(jié)果：

@ApiOperation("添加相冊(cè)")
@PostMapping("/add-new")
public JsonResult addNew(AlbumAddNewDTO albumAddNewDTO) {
    albumService.addNew(albumAddNewDTO);
    return JsonResult.ok();
}

if (response.data.state == 1) {
    // 成功
} else if (response.data.state == 2) {
    // 失?。好Q被占用
    alert(response.data.message);
}

    login(){
        axios.post("/login",v.user).then(function (response) {
            if (response.data==1){
                location.href="/admin.html" rel="external nofollow" ; //跳轉(zhuǎn)到后臺(tái)管理頁(yè)面
            }else if(response.data==2){
                v.\$message.error("用戶名不存在!");
            }else{
                v.\$message.error("密碼錯(cuò)誤!");
            }
        })
    }

3.使用枚舉優(yōu)化代碼

在JsonResult中設(shè)計(jì)了Integer state屬性，用于表示“業(yè)務(wù)狀態(tài)碼”，由于此值是可以由客戶端和服務(wù)器端協(xié)商的值，所以，值的大小不一定是固定的，例如“成功”，可以使用1表示，也可以使用200表示，只要協(xié)商一致即可，所以，在應(yīng)用時(shí)，不應(yīng)該直接將數(shù)值常量賦值到state屬性上，否則，代碼的可讀性較差！

**反例：**jsonResult.state = 200;

應(yīng)該將數(shù)值聲明為常量來(lái)使用，以增加代碼的可讀性！

**正例：**jsonResult.state = ServiceCode.OK;

在設(shè)計(jì)方法時(shí)，如果使用Integer state作為參數(shù)，方法的調(diào)用者仍可能不使用聲明的常量，而是直接傳入某個(gè)未協(xié)商的直接常量值，例如，當(dāng)設(shè)計(jì)了fail()方法時(shí)：

public static JsonResult fail(Integer state, String message) { 
    // ... 
}

則可能調(diào)用時(shí)傳入錯(cuò)誤的值：

JsonResult.fail(99999, e.getMessage());

由于state對(duì)應(yīng)的值是相對(duì)有限的，是可以窮舉的，則可以使用枚舉來(lái)解決問(wèn)題！

package cn.tedu.csmall.product.web;
public enum ServiceCode {
    OK(200),
    ERR_NOT_FOUND(404),
    ERR_CONFLICT(409);
    private Integer value;
    ServiceCode(Integer value) {
        this.value = value;
    }
    public Integer getValue() {
        return value;
    }
}

如果將方法的參數(shù)設(shè)計(jì)為以上枚舉類型，則方法的調(diào)用者只能傳入以上列舉的3個(gè)值中的某1個(gè)！例如將方法調(diào)整為：

public static JsonResult fail(ServiceCode serviceCode, String message) { 
    // ... 
}

調(diào)用時(shí)則是：

JsonResult.fail(ServiceCode.ERR_CONFLICT, e.getMessage());

到此這篇關(guān)于SpringMVC框架和SpringBoot項(xiàng)目中控制器的響應(yīng)結(jié)果深入分析的文章就介紹到這了,更多相關(guān)SpringMVC控制器響應(yīng)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論