快捷導(dǎo)航

SpringBoot?獲取請(qǐng)求參數(shù)的常用注解及用法

更新時(shí)間：2025年07月26日 10:42:04 作者：Full?Stack?Developme

Spring?Boot通過@RequestParam、@PathVariable等注解支持從HTTP請(qǐng)求中獲取參數(shù),涵蓋查詢、路徑、請(qǐng)求體、頭、Cookie等類型,還可綁定到對(duì)象或使用Servlet?API,需注意參數(shù)匹配規(guī)則及配置支持隱藏方法過濾器,本文介紹SpringBoot獲取請(qǐng)求參數(shù)的常用注解,感興趣朋友一起看看吧

SpringBoot 提供了多種注解來方便地從 HTTP 請(qǐng)求中獲取參數(shù)

以下是主要的注解及其用法：

1.@RequestParam

用于獲取查詢參數(shù)(URL 參數(shù))，適用于 GET 請(qǐng)求或 POST 表單提交。

@GetMapping("/user")
public String getUser(@RequestParam("id") Long userId) {
    return "User ID: " + userId;
}
// 可選參數(shù)，設(shè)置默認(rèn)值
@GetMapping("/search")
public String search(@RequestParam(value = "q", required = false, defaultValue = "") String query) {
    return "Search: " + query;
}

2.@PathVariable

用于獲取 URL 路徑中的變量。

@GetMapping("/user/{id}")
public String getUser(@PathVariable("id") Long userId) {
    return "User ID: " + userId;
}
// 當(dāng)變量名與方法參數(shù)名相同時(shí)可省略
@GetMapping("/article/{slug}")
public String getArticle(@PathVariable String slug) {
    return "Article: " + slug;
}

3.@RequestBody

用于獲取請(qǐng)求體中的 JSON/XML 數(shù)據(jù)，通常用于 POST/PUT 請(qǐng)求。

@PostMapping("/user")
public String createUser(@RequestBody User user) {
    return "Created user: " + user.getName();
}

4.@RequestHeader

用于獲取 HTTP 請(qǐng)求頭中的值。

@GetMapping("/info")
public String getInfo(@RequestHeader("User-Agent") String userAgent) {
    return "User Agent: " + userAgent;
}

5.@CookieValue

用于獲取 HTTP 請(qǐng)求中的 Cookie 值。

@GetMapping("/home")
public String home(@CookieValue("JSESSIONID") String sessionId) {
    return "Session ID: " + sessionId;
}

6.@ModelAttribute

用于綁定請(qǐng)求參數(shù)到模型對(duì)象，適用于表單提交。

@PostMapping("/register")
public String register(@ModelAttribute User user) {
    return "Registered: " + user.getName();
}

7.@RequestPart

用于處理 multipart/form-data 請(qǐng)求中的文件上傳。

@PostMapping("/upload")
public String uploadFile(@RequestPart("file") MultipartFile file) {
    return "Uploaded: " + file.getOriginalFilename();
}

8. 直接使用 Servlet API

SpringBoot 也支持直接使用 Servlet API 對(duì)象：

@GetMapping("/example")
public String example(HttpServletRequest request, HttpServletResponse response) {
    String param = request.getParameter("param");
    return "Parameter: " + param;
}

9. 獲取所有參數(shù)

@RequestParam Map獲取所有查詢參數(shù)

@GetMapping("/params")
public String getAllParams(@RequestParam Map<String, String> allParams) {
    return "All params: " + allParams.toString();
}

@RequestParam MultiValueMap獲取可能有多個(gè)值的參數(shù)

@GetMapping("/multiParams")
public String getMultiParams(@RequestParam MultiValueMap<String, String> params) {
    return "Multi params: " + params.toString();
}

10. 參數(shù)綁定到對(duì)象

SpringBoot 支持自動(dòng)將請(qǐng)求參數(shù)綁定到 Java 對(duì)象：

@GetMapping("/filter")
public String filterUsers(UserFilter filter) {
    return "Filtering by: " + filter.toString();
}
// UserFilter 類示例
public class UserFilter {
    private String name;
    private Integer age;
    // getters and setters
}

注意事項(xiàng)

請(qǐng)求示例：/filter?name=John&age=25

大多數(shù)注解都有 required 和 defaultValue 屬性可以配置
對(duì)于復(fù)雜嵌套對(duì)象，SpringBoot 也能自動(dòng)綁定
參數(shù)名稱默認(rèn)會(huì)與方法參數(shù)名匹配，除非在注解中指定
可以通過配置 spring.mvc.hiddenmethod.filter.enabled=true 來支持 PUT/DELETE 等方法的表單提交

到此這篇關(guān)于SpringBoot 獲取請(qǐng)求參數(shù)的常用注解的文章就介紹到這了,更多相關(guān)SpringBoot 請(qǐng)求參數(shù)注解內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: