快捷導(dǎo)航

使用ResponseEntity作為的返回值的應(yīng)用

更新時(shí)間：2024年07月05日 08:39:54 作者：DanceDonkey

這篇文章主要介紹了使用ResponseEntity作為的返回值的應(yīng)用方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

ResponseEntity作為的返回值

通常如果后端想響應(yīng)json數(shù)據(jù)，我們需要在方法體上添加@Response注解，標(biāo)注這個(gè)注解的方法的返回值會(huì)被spingmvc轉(zhuǎn)為json形式并寫(xiě)入到響應(yīng)體中。

但ResponseEntity則不會(huì)被springmvc轉(zhuǎn)換，可以使用這個(gè)類定義響應(yīng)頭，狀態(tài)碼，響應(yīng)體等。

@Controller
public class ResponseBodyTest {

    @ResponseBody
    @GetMapping("b1")
    public R b1(){
        //將方法的返回值轉(zhuǎn)為json寫(xiě)入到響應(yīng)體中
        return R.ok().put("msg","success");
    }

	@ResponseBody
    @GetMapping("b2")
    public ResponseEntity<String> b2(){
        HttpHeaders httpHeaders = new HttpHeaders();
        httpHeaders.setContentType(MediaType.TEXT_PLAIN);
        String str = "hello,world";
        ResponseEntity responseEntity = new ResponseEntity<String>(str,httpHeaders,HttpStatus.OK);
        return responseEntity;
    }

}

我們 /b2 請(qǐng)求設(shè)置了@ResponseBody注解，但由于返回的是ResponseEntity對(duì)象，而且我們又重新設(shè)置了響應(yīng)類型為 text/plain，我們?cè)L問(wèn)b2請(qǐng)求查看結(jié)果：

心得

ResponseEntity的優(yōu)先級(jí)高于@ResponseBody。

在不是ResponseEntity的情況下才去檢查有沒(méi)有@ResponseBody注解。如果響應(yīng)類型是ResponseEntity可以不寫(xiě)@ResponseBody注解，寫(xiě)了也沒(méi)有關(guān)系。

簡(jiǎn)單的說(shuō)@ResponseBody可以直接返回Json結(jié)果， @ResponseEntity不僅可以返回json結(jié)果，還可以定義返回的HttpHeaders和HttpStatus。

統(tǒng)一結(jié)果返回 ResponseEntity

在正規(guī)的嚴(yán)格的企業(yè)的前后端系統(tǒng)開(kāi)發(fā)中,返回嚴(yán)謹(jǐn)?shù)臓顟B(tài)碼很有必要

平常大家為了統(tǒng)一格式返回,或許會(huì)自己封裝一個(gè)ResultUtils,然后自定義ResultCode枚舉類來(lái)返回,這樣有些麻煩;

我們可以使用SpringMVC為我們封裝的ResponseEntity對(duì)象來(lái)自定義狀態(tài)碼

源碼：

public class ResponseEntity<T> extends HttpEntity<T> {
    private final Object status;

    public ResponseEntity(HttpStatus status) {
        this((Object)null, (MultiValueMap)null, (HttpStatus)status);
    }

    public ResponseEntity(@Nullable T body, HttpStatus status) {
        this(body, (MultiValueMap)null, (HttpStatus)status);
    }

    public ResponseEntity(MultiValueMap<String, String> headers, HttpStatus status) {
        this((Object)null, headers, (HttpStatus)status);
    }

    public ResponseEntity(@Nullable T body, @Nullable MultiValueMap<String, String> headers, HttpStatus status) {
        super(body, headers);
        Assert.notNull(status, "HttpStatus must not be null");
        this.status = status;
    }

    private ResponseEntity(@Nullable T body, @Nullable MultiValueMap<String, String> headers, Object status) {
        super(body, headers);
        Assert.notNull(status, "HttpStatus must not be null");
        this.status = status;
    }

@param body: the entity body

ResponseEntity需要一個(gè)泛型T
代表我們需要傳入的數(shù)據(jù)對(duì)象

@param headers : the entity headers

我們可以new MultiValueMap<String, String> headers
設(shè)置響應(yīng)頭信息

@param status: the status code

我們可以使用HttpStatus
也可以自己定義狀態(tài)碼(Object)

HttpStatus status是一個(gè)包含了各種響應(yīng)狀態(tài)碼的枚舉類

// 201:創(chuàng)建成功   Created
// 203 :沒(méi)有認(rèn)證   NON_AUTHORITATIVE_INFORMATION
// 204: 成功沒(méi)有返回值 No-content  一般是delete,update時(shí)使用
.....

例子：

	@GetMapping("/categories")
    public ResponseEntity<List<Category>> getCategoryList(String token){
        return new ResponseEntity<>(categoryService.queryAll(), HttpStatus.OK);
    }

    @PostMapping("/categories")
    public ResponseEntity<Category> AddCategory(String token, @RequestBody Category category){
        
        return new ResponseEntity<>(categoryService.insert(category),HttpStatus.CREATED);
    }