快捷導(dǎo)航

Java SSM整合開(kāi)發(fā)統(tǒng)一結(jié)果封裝詳解

更新時(shí)間：2022年08月19日 16:10:28 作者：十八歲討厭編程

這篇文章主要介紹了Java SSM整合開(kāi)發(fā)實(shí)現(xiàn)統(tǒng)一結(jié)果封裝，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

表現(xiàn)層與前端數(shù)據(jù)傳輸協(xié)議定義

SSM整合以及功能模塊開(kāi)發(fā)完成后，接下來(lái)，我們?cè)谏鲜霭咐幕A(chǔ)上分析下有哪些問(wèn)題需要我們?nèi)ソ鉀Q下。首先第一個(gè)問(wèn)題是:

在Controller層增刪改返回給前端的是boolean類(lèi)型數(shù)據(jù)

在Controller層查詢(xún)單個(gè)返回給前端的是對(duì)象

在Controller層查詢(xún)所有返回給前端的是集合對(duì)象

目前我們就已經(jīng)有三種數(shù)據(jù)類(lèi)型返回給前端，如果隨著業(yè)務(wù)的增長(zhǎng)，我們需要返回的數(shù)據(jù)類(lèi)型會(huì)越來(lái)越多。對(duì)于前端開(kāi)發(fā)人員在解析數(shù)據(jù)的時(shí)候就比較凌亂了，所以對(duì)于前端來(lái)說(shuō)，如果后臺(tái)能夠返回一個(gè)統(tǒng)一的數(shù)據(jù)結(jié)果，前端在解析的時(shí)候就可以按照一種方式進(jìn)行解析。開(kāi)發(fā)就會(huì)變得更加簡(jiǎn)單。

所以我們就想能不能將返回結(jié)果的數(shù)據(jù)進(jìn)行統(tǒng)一，具體如何來(lái)做，大體的思路為:

為了封裝返回的結(jié)果數(shù)據(jù):創(chuàng)建結(jié)果模型類(lèi)，封裝數(shù)據(jù)到data屬性中
為了封裝返回的數(shù)據(jù)是何種操作及是否操作成功:封裝操作結(jié)果到code屬性中
操作失敗后為了封裝返回的錯(cuò)誤信息:封裝特殊消息到message(msg)屬性中

根據(jù)分析，我們可以設(shè)置統(tǒng)一數(shù)據(jù)返回結(jié)果類(lèi)

public class Result{
	private Object data;
	private Integer code;
	private String msg;
}

注意：Result類(lèi)名及類(lèi)中的字段并不是固定的，可以根據(jù)需要自行增減提供若干個(gè)構(gòu)造方法，方便操作。

表現(xiàn)層與前端數(shù)據(jù)傳輸協(xié)議實(shí)現(xiàn)

結(jié)果封裝

對(duì)于結(jié)果封裝，我們應(yīng)該是在表現(xiàn)層進(jìn)行處理，所以我們把結(jié)果類(lèi)放在controller包下，當(dāng)然你也可以放在domain包，這個(gè)都是可以的，具體如何實(shí)現(xiàn)結(jié)果封裝，具體的步驟為:

步驟1:創(chuàng)建Result類(lèi)

public class Result {
    //描述統(tǒng)一格式中的數(shù)據(jù)
    private Object data;
    //描述統(tǒng)一格式中的編碼，用于區(qū)分操作，可以簡(jiǎn)化配置0或1表示成功失敗
    private Integer code;
    //描述統(tǒng)一格式中的消息，可選屬性
    private String msg;
    public Result() {
    }
    //構(gòu)造方法是方便對(duì)象的創(chuàng)建
    public Result(Integer code,Object data) {
        this.data = data;
        this.code = code;
    }
    //構(gòu)造方法是方便對(duì)象的創(chuàng)建
    public Result(Integer code, Object data, String msg) {
        this.data = data;
        this.code = code;
        this.msg = msg;
    }
    public Object getData() {
        return data;
    }
    public void setData(Object data) {
        this.data = data;
    }
    public Integer getCode() {
        return code;
    }
    public void setCode(Integer code) {
        this.code = code;
    }
    public String getMsg() {
        return msg;
    }
    public void setMsg(String msg) {
        this.msg = msg;
    }
    @Override
    public String toString() {
        return "Result{" +
                "data=" + data +
                ", code=" + code +
                ", msg='" + msg + '\'' +
                '}';
    }
}

注意：

可以不寫(xiě)toString方法，他最后會(huì)被被轉(zhuǎn)為json格式。但是getter和setter方法是一定要有的！

步驟2:定義返回碼Code類(lèi)

//狀態(tài)碼
public class Code {
    public static final Integer SAVE_OK = 20011;
    public static final Integer DELETE_OK = 20021;
    public static final Integer UPDATE_OK = 20031;
    public static final Integer GET_OK = 20041;
    public static final Integer SAVE_ERR = 20010;
    public static final Integer DELETE_ERR = 20020;
    public static final Integer UPDATE_ERR = 20030;
    public static final Integer GET_ERR = 20040;
}

注意：code類(lèi)中的常量設(shè)計(jì)也不是固定的，可以根據(jù)需要自行增減，例如將查詢(xún)?cè)龠M(jìn)行細(xì)分為GET_OK,GET_ALL_OK,GET_PAGE_OK等。

步驟3:修改Controller類(lèi)的返回值

//統(tǒng)一每一個(gè)控制器方法返回值
@RestController
@RequestMapping("/books")
public class BookController {
    @Autowired
    private BookService bookService;
    @PostMapping
    public Result save(@RequestBody Book book) {
        boolean flag = bookService.save(book);
        return new Result(flag ? Code.SAVE_OK:Code.SAVE_ERR,flag);
    }
    @PutMapping
    public Result update(@RequestBody Book book) {
        boolean flag = bookService.update(book);
        return new Result(flag ? Code.UPDATE_OK:Code.UPDATE_ERR,flag);
    }
    @DeleteMapping("/{id}")
    public Result delete(@PathVariable Integer id) {
        boolean flag = bookService.delete(id);
        return new Result(flag ? Code.DELETE_OK:Code.DELETE_ERR,flag);
    }
    @GetMapping("/{id}")
    public Result getById(@PathVariable Integer id) {
        Book book = bookService.getById(id);
        Integer code = book != null ? Code.GET_OK : Code.GET_ERR;
        String msg = book != null ? "" : "數(shù)據(jù)查詢(xún)失敗，請(qǐng)重試！";
        return new Result(code,book,msg);
    }
    @GetMapping
    public Result getAll() {
        List<Book> bookList = bookService.getAll();
        Integer code = bookList != null ? Code.GET_OK : Code.GET_ERR;
        String msg = bookList != null ? "" : "數(shù)據(jù)查詢(xún)失敗，請(qǐng)重試！";
        return new Result(code,bookList,msg);
    }
}

這里拿bookList和null比較是因?yàn)?，如果查?xún)?nèi)繘](méi)有查到結(jié)果，那么就會(huì)直接返回一個(gè)null，而不是返回一個(gè)空列表！

在根據(jù)id查book的時(shí)候，如果沒(méi)有查到也是返回一個(gè)null

最后我們的項(xiàng)目結(jié)構(gòu)：