洞察如何利用移动警务平台提高安全保障效率,数字化转型助力合规运营
1140
2022-12-23
如何使用spring ResponseEntity处理http响应
简介
使用spring时,达到同一目的通常有很多方法,对处理http响应也是一样。本文我们学习如何通过ResponseEntity设置http相应内容、状态以及头信息。
ResponseEntity
ResponseEntity标识整个http相应:状态码、头部信息以及相应体内容。因此我们可以使用其对http响应实现完整配置。
如果需要使用ResponseEntity,必须在请求点返回,通常在spring rest中实现。ResponseEntity是通用类型,
因此可以使用任意类型作为响应体:
@GetMapping("/hello")
ResponseEntity
return new ResponseEntity<>("Hello World!", HttpStatus.OK);
}
可以通过编程方式指明响应状态,所以根据不同场景返回不同状态:
@GetMapping("/age")
ResponseEntity
@RequestParam("yearOfBirth") int yearOfBirth) {
if (isInFuture(yearOfBirth)) {
return new ResponseEntity<>(
"Year of birth cannot be in the future",
HttpStahttp://tus.BAD_REQUEST);
}
return new ResponseEntity<>(
"Your age is " + calculateAge(yearOfBirth),
HttpStatus.OK);
}
另外,还可以设置http响应头:
@GetMapping("/customHeader")
ResponseEntity
HttpHeaders headers = new HttpHeaders();
headers.add("Custom-Header", "foo");
return new ResponseEntity<>(
"Custom header set", headers, HttpStatus.OK);
}
而且, ResponseEntity提供了两个内嵌的构建器接口: HeadersBuilder 和其子接口 BodyBuilder。因此我们能通过ResponseEntity的静态方法直接访问。
最简单的情况是相应包括一个主体及http 200响应码:
@GetMapping("/hello")
ResponseEntity
return ResponseEntity.ok("Hello World!");
}
大多数常用的http 响应码,可以yMAjzF通过下面static方法:
BodyBuilder accepted();
BodyBuilder badRequest();
BodyBuilder created(java-.URI location);
HeadersBuilder> noContent();
HeadersBuilder> notFound();
BodyBuilder ok();
另外,可以能使用BodyBuilder status(HttpStatus status)和BodyBuilder status(int status) 方法设置http状态。使用ResponseEntity BodyBuilder.body(T body)设置http响应体:
@GetMapping("/age")
ResponseEntity
if (isInFuture(yearOfBirth)) {
return ResponseEntity.badRequest()
.body("Year of birth cannot be in the future");
}
return ResponseEntity.status(HttpStatus.OK)
.body("Your age is " + calculateAge(yearOfBirth));
}
也可以自定义头信息:
@GetMapping("/customHeader")
ResponseEntity
return ResponseEntity.ok()
.header("Custom-Header", "foo")
.body("Custom header set");
}
因为BodyBuilder.body()返回ResponseEntity 而不是 BodyBuilder,需要最后调用。注意使用HeaderBuilder 不能设置任何响应体属性。
尽管ResponseEntity非常强大,但不应该过度使用。在一些简单情况下,还有其他方法能满足我们的需求,使代码更整洁。
替代方法
@ResponseBody
典型spring mvc应用,请求点通常返回html页面。有时我们仅需要实际数据,如使用ajax请求。这时我们能通过@ResponseBody注解标记请求处理方法,审批人能够处理方法结果值作为http响应体。
@ResponseStatus
当请求点成功返回,spring提供http 200(ok)相应。如果请求点抛出异常,spring查找异常处理器,由其返回相应的http状态码。对这些方法增加@ResponseStatus注解,spring会返回自定义http状态码。
直接操作相应
Spring 也允许我们直接 javax.servlet.http.HttpServletResponse 对象;只需要申明其作为方法参数:
@GetMapping("/manual")
void manual(HttpServletResponse response) throws IOException {
response.setHeader("Custom-Header", "foo");
response.setStatus(200);
response.getWriter().println("Hello World!");
}
但需要说明,既然spring已经提供底层实现的抽象和附件功能,我们不建议直接操作response。
总结:本文我们介绍了spring提供多种方式处理http响应,以及各自的优缺点,希望对你有帮助。
ResponseEntity的基本简介
1、ResponseEntity继承了HttpEntity
可以添加HttpStatus状态码的HttpEntity的扩展类。被用于RestTemplate和Controller层方法
2、ResponseEntity可以定义返回的HttpStatus(状态码)
和HttpHeaders(消息头:请求头和响应头)HttpStatus的状态码有以下几种
3、ResponseEntity的优先级高于@ResponseBody
在不是ResponseEntity的情况下才去检查有没有@ResponseBody注解。如果响应类型是ResponseEntity可以不写@ResponseBody注解,写了也没有关系。
简单的说@ResponseBody可以直接返回json结果,@ResponseEntity不仅可以返回json结果,还可以定义返回的HttpHeaders和HttpStatus
public ResponseEntity> queryCategoriesByPid(@RequestParam(value = "pid",defaultValue = "0") Long pid){
if(pid == null || pid.longValue()<0){
// 响应400,相当于ResponseEntity.status(HttpStatus.BAD_REQUEST).build();
return ResponseEntity.badRequest().build();
}
//ResponseEntity.status(HttpStatus.NOT_FOUND).body(null);
// ResponseEntity.notFound().build();
// ResponseEntity.ok(null);
List
if(CollectionUtils.isEmpty(categoryList)){
// 响应404
return ResponseEntity.notFound().build();
}
return ResponseEntity.ok(categoryList);
}
版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。
发表评论
暂时没有评论,来抢沙发吧~