何时使用 ResponseEntity？

有志者，事竟成！如果你在学习文章，那么本文《何时使用 ResponseEntity？》，就很适合你！文章讲解的知识点主要包括，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

让我们来看一个控制器示例，它包含以下端点：

@RestController
@RequestMapping("v1/hello")
public class ExampleController {

    @GetMapping
    public ResponseEntity<String> get() {
        return ResponseEntity.ok("hello world!");
    }
}

Spring 的 @RestController 注解默认将响应体放置在响应的主体中。 因此，当使用 @RestController 时，无需显式使用 ResponseEntity，直接返回响应类型即可，例如：

@RestController
@RequestMapping("v1/hello")
public class ExampleController {

    @GetMapping
    public String get() {
        return "hello world!";
    }
}

此外，成功请求的默认状态码为 200 (OK)。 只有当您需要使用其他状态码时，才需要进行更改。 这可以通过 @ResponseStatus 注解实现，而无需使用 ResponseEntity：

@RestController
@RequestMapping("v1/hello")
public class ExampleController {

    @GetMapping
    @ResponseStatus(HttpStatus.ACCEPTED)
    public String get() {
        return "hello world!";
    }
}

那么，ResponseEntity 存在的意义是什么呢？

ResponseEntity 的优势在于，它允许您向响应中添加比正文和状态码更多的信息，例如自定义 HTTP 头：

@RestController
@RequestMapping("v1/hello")
public class ExampleController {

    @GetMapping
    public ResponseEntity<String> get() {
        return ResponseEntity.ok()
            .header("X-Test", "Blabla")
            .body("Hello World!");
    }
}

简而言之，如果您只需要返回一个简单的响应体和默认的 200 OK 状态码，那么直接返回数据类型即可。 但如果您需要更精细地控制响应，包括添加自定义头信息或设置特定的 HTTP 状态码，那么 ResponseEntity 是最佳选择。

好了，本文到此结束，带大家了解了《何时使用 ResponseEntity？》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！