总结Spring Boot中6种API请求参数读取方式笔记

目录
文章目录隐藏
  1. @RequestParam
  2. @PathVariable
  3. @MatrixVariable
  4. @RequestBody
  5. @RequestHeader
  6. @CookieValue
  7. 结语

后端在使用 Spring Boot 开发 API 的时候,读取请求参数是服务端编码中最基本的一项操作,Spring Boot 中也提供了多种机制来满足不同的 API 设计要求。

总结 Spring Boot 中 6 种 API 请求参数读取方式笔记

接下来,我将为大家总结 6 种常用的请求参数读取方式。如果你发现自己知道的不到 6 种,那么赶紧来查漏补缺一下。如果你知道的不止 6 种,那么告诉大家,一起互相学习一下吧~

@RequestParam

这是最最最最最最常用的一个了吧,用来加载 URL 中?之后的参数。

比如:这个请求/user?name=didispace 就可以如下面这样,使用@RequestParam来加载 URL 中的 name 参数。

@GetMapping("/user")
@ResponseBody()
public User findUserByName(@RequestParam("name") String name){ 
    return userRepo.findByName(name);
}

@PathVariable

这是 RESTful 风格 API 中常用的注解,用来加载 URL 路径中的参数。

比如:这个请求/user/1 就可以如下面这样,使用@PathVariable来加载 URL 中的 id 参数。

@GetMapping("/user/{id}")
@ResponseBody()
public User findUserById(@PathVariable("id") String id){ 
    return userRepo.findById(id);
}

@MatrixVariable

这个我们用的并不是很多,但一些国外系统有提供这类 API 参数,这种 API 的参数通过;分割。

比如:这个请求/books/reviews;isbn=1234;topN=5; 就可以如下面这样,使用@MatrixVariable来加载 URL 中用;分割的参数。

@GetMapping("/books/reviews")
@ResponseBody()
public List<BookReview> getBookReviews( 
  @MatrixVariable String isbn,  @MatrixVariable Integer topN) {
  return bookReviewsLogic.getTopNReviewsByIsbn(isbn, topN);
}

@RequestBody

这也是最常用的一个注解,用来加载 POST/PUT 请求的复杂请求体(也叫:payload)。比如,客户端需要提交一个复杂数据的时候,就要将这些数据放到请求体中,然后服务端用@RequestBody来加载请求体中的数据。

@PostMapping("/add")
public boolean addAccounts(@RequestBody List<Account> accounts) throws SQLException {
     accounts.stream().forEach(a -> {
         a.setCreatedOn(Timestamp.from(Instant.now()));
         a.setLastLogin(Timestamp.from(Instant.now()));
     });
     return notificationLogic.addAccounts(accounts);
}

@RequestHeader

@RequestHeader注解用来加载请求头中的数据,一般在业务系统中不太使用,但在基础设施的建设中会比较常用,比如传递分布式系统的 TraceID 等。用法也很简单,比如,假设我们将鉴权数据存在 http 请求头中,那么就可以像下面这样用@RequestHeader来加载请求头中的Authorization参数。

@GetMapping("/user")
@ResponseBody()
public List<User> getUserList(@RequestHeader("Authorization") String authToken) {
     return userRepo.findAll();
}

@CookieValue

当我们需要与客户端保持有状态的交互时,就需要用到 Cookie。此时,服务端读取 Cookie 数据的时候,就可以像下面这样用@CookieValue来读取 Cookie 中的SessionId数据。

@GetMapping("/user")
@ResponseBody()
public List<User> getUserList(@CookieValue(name = "SessionId") String sessionId) {
     return userRepo.findAll();
}

结语

好了,今天的后端 Spring Boot 中 6 种 API 请求参数读取方式笔记就分享就到这里。这些方式你都知道吗?如果有学到新知识,欢迎点赞支持。如果你还知道其他方式,也欢迎评论分享。更多请关注码云笔记其它相关文章!

「点点赞赏,手留余香」

1

给作者打赏,鼓励TA抓紧创作!

微信微信 支付宝支付宝

还没有人赞赏,快来当第一个赞赏的人吧!

声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系maynote@foxmail.com处理
码云笔记 » 总结Spring Boot中6种API请求参数读取方式笔记

发表回复