前言
????????Spring MVC作為Spring框架中的核心組件之一，其強大的功能在于能簡潔高效地處理HTTP請求和響應。在開發Web應用時，理解和正確使用Spring MVC的注解，尤其是@RequestMapping注解，至關重要。本文將詳細講解@RequestMapping注解的使用方法，及其如何綁定請求參數到控制器方法的參數。
一、@RequestMapping注解的使用
@RequestMapping注解是Spring MVC中最常用的注解之一，主要用于處理HTTP請求。它通過建立請求URL和處理方法之間的映射關系，從而確定請求的處理邏輯。
1.1 作用與基本使用
@RequestMapping可以作用在方法上和類上：
- 作用在類上：指定請求的一級路徑。
- 作用在方法上：指定請求的二級路徑。
路徑可以省略“/”，表示從應用的根目錄開始。
@Controller
@RequestMapping(path = "/role") // 一級請求路徑
public class RoleController {/*** 處理請求 /role/save* method="GET" 指定請求方式* params="請求路徑上傳的參數"*/@RequestMapping(path = "/save", method = RequestMethod.GET)public String save() {System.out.println("保存角色...");return "suc";}@RequestMapping(value = "/delete")public String delete() {System.out.println("刪除角色...");return "suc";}
}
1.2 RequestMapping的屬性
@RequestMapping注解的常用屬性包括：
path或value：指定請求的路徑。method：指定請求方式，如GET、POST等。params：指定請求參數，當請求包含特定參數時，才會匹配該方法。
@RequestMapping(path = "/save", method = RequestMethod.POST, params = "action=save")
public String save() {// 處理POST請求，且必須包含參數action=savereturn "suc";
}
二、請求參數綁定
Spring MVC提供了自動綁定請求參數到控制器方法的功能。無論是簡單的基礎類型，還是復雜的JavaBean，Spring都能自動進行類型轉換。
2.1 參數綁定機制
當用戶提交一個表單時，Spring MVC會自動將表單提交的參數（k=v格式）與控制器方法的參數進行綁定。默認情況下，表單的name屬性值與方法的參數名稱需要一致。
2.2 支持的數據類型
Spring MVC支持以下類型的請求參數綁定：
- 基本數據類型：如
int,boolean,String等。 - 實體類型（JavaBean）：當參數為一個Java對象時，Spring MVC會將請求參數映射到該對象的屬性。
- 集合類型：如
List,Map等集合類。
例子：基本數據類型和JavaBean
@Controller
@RequestMapping("/user")
public class UserController {// 綁定基礎數據類型@RequestMapping("/save")public String save(String username, Integer age) {System.out.println("Username: " + username);System.out.println("Age: " + age);return "suc";}// 綁定JavaBean@RequestMapping("/save1")public String save1(User user) {System.out.println(user);return "suc";}// 綁定JavaBean包含對象的情況@RequestMapping("/save2")public String save2(User user) {System.out.println(user);return "suc";}// 綁定JavaBean包含集合的情況@RequestMapping("/save3")public String save3(User user) {System.out.println(user);return "suc";}
}
JSP頁面：表單提交
<html>
<head><meta charset="utf-8"><title>請求參數綁定</title>
</head>
<body><h1>基礎數據類型綁定</h1><form action="/user/save" method="get"><input type="text" name="username"/><br/><input type="text" name="age"/><br/><input type="submit"/></form><h1>JavaBean綁定</h1><form action="/user/save1" method="post"><input type="text" name="username"/><br/><input type="text" name="age"/><br/><input type="submit"/></form><h1>JavaBean包含對象綁定</h1><form action="/user/save2" method="post"><input type="text" name="username"/><br/><input type="text" name="age"/><br/><input type="text" name="account.money"/><br/><input type="submit"/></form><h1>JavaBean包含集合綁定</h1><form action="/user/save3" method="post"><input type="text" name="username"/><br/><input type="text" name="age"/><br/><input type="text" name="account.money"/><br/><input type="text" name="accounts[0].money"/><br/><input type="text" name="accounts[1].money"/><br/><input type="submit"/></form>
</body>
</html>
2.3 實體類與集合類型的綁定
- JavaBean：通過
name和JavaBean中的屬性名匹配進行綁定。如果JavaBean包含其他引用類型，表單字段需要采用對象.屬性的方式命名。 - 集合類型：當表單中包含多個同名參數時，Spring MVC會自動封裝成
List或Map等集合。
2.4 使用原生ServletAPI對象
除了使用Spring MVC的自動綁定功能外，我們還可以直接使用Servlet API（HttpServletRequest，HttpServletResponse等）進行操作：
@RequestMapping(value = "/save6.do", method = RequestMethod.POST)
public String save6(HttpServletRequest request, HttpServletResponse response) {String username = request.getParameter("username");System.out.println("Username: " + username);HttpSession session = request.getSession();System.out.println(session);System.out.println(response);return "suc";
}
三、不常用的注解
3.1 @RequestParam注解
@RequestParam注解用于將HTTP請求中的指定參數綁定到方法參數中。它常用于請求參數的個別處理，特別是當請求參數的名稱與方法參數的名稱不一致時。
使用方法
@Controller
@RequestMapping("/dept")
public class DeptController {@RequestMapping("/save")public String save(@RequestParam(value = "username", required = false) String name) {System.out.println("Username: " + name);return "suc";}
}
- value：指定請求參數的名稱。
- required：指定該參數是否必須提供，默認值是
true，如果未提供，則拋出MissingServletRequestParameterException。
3.2 @RequestParam常見用法
- 指定請求參數名稱：
@RequestParam("username")
public String saveUser(@RequestParam("username") String username) {return "suc";
}
- 設置默認值：
@RequestParam(value = "username", defaultValue = "guest")
public String saveUser(@RequestParam("username") String username) {return "suc";
}
結論
????????通過@RequestMapping及其相關注解，Spring MVC簡化了Web請求的處理過程，使得控制器能夠更方便地與請求進行交互。掌握請求參數綁定、@RequestParam的使用方法，以及如何處理表單數據和復雜類型，能幫助我們更高效地開發Web應用。在實際項目中，我們可以根據需求選擇合適的注解進行處理，提高開發效率和代碼可讀性。
)
