-
SpringBoot中API接口参数获取方式小结
在Spring Boot中,API接口参数可以通过多种方式获取,具体取决于你定义的API接口参数类型(如路径参数、查询参数、请求体参数、请求头等),本文给大家就介绍了一些常见的参数获取方式,需要的朋友可以参考下
引言
在Spring Boot中,API接口参数可以通过多种方式获取,具体取决于你定义的API接口参数类型(如路径参数、查询参数、请求体参数、请求头等)。以下是一些常见的参数获取方式以及对应的Java样例代码:
1.路径参数(Path Variable)
使用@PathVariable注解从URL路径中获取参数。
@RestController
@RequestMapping("/users")
public class UserController {
@GetMapping("/{id}")
public ResponseEntity<String> getUserById(@PathVariable Long id) {
// 处理逻辑
return ResponseEntity.ok("User with ID: " + id);
}
}
2.查询参数(Query Parameter)
使用@RequestParam注解从URL查询字符串中获取参数。
@RestController
@RequestMapping("/users")
public class UserController {
@GetMapping("/search")
public ResponseEntity<String> searchUsers(@RequestParam String name) {
// 处理逻辑
return ResponseEntity.ok("Searching for user with name: " + name);
}
// 也可以设置默认值
@GetMapping("/searchWithDefault")
public ResponseEntity<String> searchUsersWithDefault(@RequestParam(defaultValue = "John") String name) {
// 处理逻辑
return ResponseEntity.ok("Searching for user with name: " + name);
}
}
3.请求体参数(Request Body)
使用@RequestBody注解从HTTP请求体中获取参数,通常用于POST或PUT请求。
@RestController
@RequestMapping("/users")
public class UserController {
@PostMapping("/")
public ResponseEntity<String> createUser(@RequestBody User user) {
// 处理逻辑
return ResponseEntity.ok("User created with name: " + user.getName());
}
// 假设User类如下
static class User {
private String name;
// getters and setters
}
}
4.请求头参数(Request Header)
通常不直接使用注解来获取请求头参数,但可以通过HttpServletRequest对象或@RequestHeader注解来获取。
使用@RequestHeader注解:
@RestController
@RequestMapping("/users")
public class UserController {
@GetMapping("/")
public ResponseEntity<String> getUsers(@RequestHeader("Authorization") String authToken) {
// 处理逻辑
return ResponseEntity.ok("Authorization token: " + authToken);
}
}
使用HttpServletRequest对象:
@RestController
@RequestMapping("/users")
public class UserController {
@GetMapping("/")
public ResponseEntity<String> getUsers(HttpServletRequest request) {
String authToken = request.getHeader("Authorization");
// 处理逻辑
return ResponseEntity.ok("Authorization token from HttpServletRequest: " + authToken);
}
}
5.@CookieValue
当我们需要与客户端保持有状态的交互时,就需要用到Cookie。此时,服务端读取Cookie数据的时候,就可以像下面这样用@CookieValue来读取Cookie中的SessionId数据。
@GetMapping("/user")
@ResponseBody()
public List<User> getUserList(@CookieValue(name = "SessionId") String sessionId) {
return userRepo.findAll();
}
6.@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);
}
7.表单数据(Form Data)
对于POST请求中的表单数据,通常可以使用@ModelAttribute或@RequestParam来获取。但如果表单数据作为请求体发送(Content-Type: application/x-www-form-urlencoded),则可以直接使用@RequestParam。如果表单数据是JSON格式,则应使用@RequestBody。
8.Servlet API的其他部分
你还可以使用HttpServletResponse、HttpSession等Servlet API的其他部分来处理请求和响应。但在Spring Boot中,通常推荐使用Spring MVC提供的高级抽象来简化开发。
注:为了正确解析请求体中的JSON数据,需要在Spring Boot项目中添加适当的JSON库(如Jackson),并且确保请求的Content-Type设置为application/json。
以上就是SpringBoot中API接口参数获取方式小结的详细内容,更多关于SpringBoot API接口参数的资料请关注
原文链接:https://blog.csdn.net/qq_38790096/article/details/139912105