SpringMVC框架和SpringBoot項(xiàng)目中控制器的響應(yīng)結(jié)果深入分析
1.控制器的響應(yīng)結(jié)果
當(dāng)控制器處理了請(qǐng)求之后,向客戶(hù)端響應(yīng)的結(jié)果中,應(yīng)該至少包含:
- 業(yè)務(wù)狀態(tài)碼:通常是數(shù)值類(lèi)型的,客戶(hù)端可以根據(jù)此數(shù)值來(lái)判斷操作成功與否,或者,失敗時(shí)是哪一種失敗,具體值應(yīng)該是由服務(wù)器端和客戶(hù)端協(xié)商的
- 消息:是字符串類(lèi)型的,客戶(hù)端可以將此消息直接顯示在軟件的界面中(例如顯示在網(wǎng)頁(yè)中、顯示在手機(jī)APP中……),有了這個(gè)數(shù)據(jù),客戶(hù)端就不必自行組織語(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è)名稱(chēng)已經(jīng)被使用!"
}
2.相關(guān)配置
在Spring MVC框架中,當(dāng)需要響應(yīng)JSON格式的字符串時(shí),需要:
使用自定義的數(shù)據(jù)類(lèi)型作為處理請(qǐng)求的方法的返回值類(lèi)型,并返回自定義數(shù)據(jù)類(lèi)型的對(duì)象
需要在項(xiàng)目中添加jackson-databind依賴(lài)項(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)目中,需要在配置類(lèi)上添加
@EnableWebMvc注解 - 在Spring Boot項(xiàng)目中,不需要額外配置
則在項(xiàng)目的根包下創(chuàng)建web.JsonResult類(lèi),在類(lèi)中聲明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) {
// 失敗:名稱(chēng)被占用
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("用戶(hù)名不存在!");
}else{
v.\$message.error("密碼錯(cuò)誤!");
}
})
}3.使用枚舉優(yōu)化代碼
在JsonResult中設(shè)計(jì)了Integer state屬性,用于表示“業(yè)務(wù)狀態(tài)碼”,由于此值是可以由客戶(hù)端和服務(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ì)為以上枚舉類(lèi)型,則方法的調(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)文章希望大家以后多多支持腳本之家!
相關(guān)文章
tomcat啟動(dòng)完成執(zhí)行 某個(gè)方法 定時(shí)任務(wù)(Spring)操作
這篇文章主要介紹了tomcat啟動(dòng)完成執(zhí)行 某個(gè)方法 定時(shí)任務(wù)(Spring)操作,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-09-09
Spring-Web與Spring-WebFlux沖突問(wèn)題解決
Spring WebFlux是一套全新的Reactive Web技術(shù)棧,實(shí)現(xiàn)完全非阻塞,支持Reactive Streams背壓等特性,這篇文章主要給大家介紹了關(guān)于Spring-Web與Spring-WebFlux沖突問(wèn)題解決的相關(guān)資料,需要的朋友可以參考下2024-04-04
java swing框架實(shí)現(xiàn)貪吃蛇游戲
這篇文章主要為大家詳細(xì)介紹了java swing框架實(shí)現(xiàn)貪吃蛇游戲,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2020-12-12
淺析Java IO相關(guān)知識(shí)點(diǎn)
本篇文章給大家分享了關(guān)于java io的一些相關(guān)知識(shí)點(diǎn)以及相關(guān)內(nèi)容,對(duì)此有需要的朋友可以學(xué)習(xí)參考下。2018-05-05
java實(shí)戰(zhàn)技巧之if-else代碼優(yōu)化技巧大全
代碼中如果if-else比較多,閱讀起來(lái)比較困難,維護(hù)起來(lái)也比較困難,很容易出bug,下面這篇文章主要給大家介紹了關(guān)于java實(shí)戰(zhàn)技巧之if-else代碼優(yōu)化技巧的相關(guān)資料,需要的朋友可以參考下2022-02-02
Java設(shè)計(jì)模式UML之類(lèi)圖精解
在UML類(lèi)圖中,類(lèi)使用包含類(lèi)名、屬性(field) 和方法(method) 且?guī)в蟹指罹€(xiàn)的矩形來(lái)表示,比如下圖表示一個(gè)Employee類(lèi),它包含name,age和email這3個(gè)屬性,以及modifyInfo()方法2022-02-02
Spring實(shí)現(xiàn)數(shù)據(jù)庫(kù)讀寫(xiě)分離詳解
這篇文章主要介紹了Spring?實(shí)現(xiàn)數(shù)據(jù)庫(kù)讀寫(xiě)分離,大多數(shù)系統(tǒng)都是讀多寫(xiě)少,為了降低數(shù)據(jù)庫(kù)的壓力,可以對(duì)主庫(kù)創(chuàng)建多個(gè)從庫(kù),從庫(kù)自動(dòng)從主庫(kù)同步數(shù)據(jù),程序中將寫(xiě)的操作發(fā)送到主庫(kù),將讀的操作發(fā)送到從庫(kù)去執(zhí)行,需要的朋友可以參考下2024-01-01

