參考資料:(https://www.baeldung.com/spring-request-param) ModifyDate:2019/03/02
@RequestParam 和 屬性，還有 @RequestParam & @PathVariable 的區別
RequestMapping
參考資料:(https://www.baeldung.com/spring-requestmapping)
@RequestMapping(value = "/ex/foos", method = RequestMethod.GET)
@ResponseBody
public String getFoosBySimplePath(){
return "Get some Foos";
}
簡單映射 A Simple Mapping (如何接到 QueryString 的參數)
QueryString 的 key 和程式內的 變數名稱 相同，則可以直接Mapping
@GetMapping("/api/foos")
@ResponseBody
public String getFoos(@RequestParam String id) {
return "ID: " + id;
}
http://localhost:8080/api/foos?id=abc
----
ID: abc
指定請求參數 Specifying the Request Parameter Name
如果希望 QueryString 的 key 和程式內的 變數名稱 不同，則可以使用 name 這個屬性進行配置。
@PostMapping("/api/foos")
@ResponseBody
public String addFoo(@RequestParam(name = "id") String fooId, @RequestParam String name) {
return "ID: " + fooId + " Name: " + name;
}
這三個都可以達到同樣效果
@RequestParam(name = "id") String fooId
@RequestParam(value = "id") String fooId
@RequestParam("id") String fooId
製作可選的請求參數 Making an Optional Request Parameter
通常 @RequestParam 會默認為必填，這樣倘若沒有打參數，就會跳出錯誤
GET /api/foos HTTP/1.1
-----
400 Bad Request
Required String parameter 'id' is not present
所以我們可以將配置，改為可選
@GetMapping("/api/foos")
@ResponseBody
public String getFoos(@RequestParam(required = false) String id) {
return "ID: " + id;
}
這樣，不論是
http://localhost:8080/api/foos?id=abc
----
ID: abc
http://localhost:8080/api/foos
----
ID: null
該呼叫都可以正常調用，但是沒有傳的參數會綁定為Null。
請求參數的默認值 A Default Value for the Request Parameter
利用屬性 defaultValue 設置 默認值
@GetMapping("/api/foos")
@ResponseBody
public String getFoos(@RequestParam(defaultValue = "test") String id) {
return "ID: " + id;
}
http://localhost:8080/api/foos
----
ID: test
http://localhost:8080/api/foos?id=abc
----
ID: abc
當設置 defaultValue 這個屬性時，就像 required = false，而事實上 也的確被設置為 false。
映射所有參數 Mapping All Parameters
直接將 QueryString 的所有參數 key,value ，都放到一個 Map 裡
@PostMapping("/api/foos")
@ResponseBody
public String updateFoos(@RequestParam Map<String,String> allParams) {
return "Parameters are " + allParams.entrySet();
}
curl -X POST -F 'name=abc' -F 'id=123' http://localhost:8080/api/foos
-----
Parameters are {[name=abc], [id=123]}
http://localhost:8080/api/foos?id=12&magic=Brian
-----
Parameters are [id=12, magic=Brian]
映射多值參數 Mapping a Multi-Value Parameter
QueryString 的 一個 key 可以有多個 value
@GetMapping("/api/foos")
@ResponseBody
public String getFoos(@RequestParam List<String> id) {
return "IDs are " + id + " size = " + id.size();
}
分別可以使用下列兩種
http://localhost:8080/api/foos?id=1,2,3
----
IDs are [1, 2, 3] size = 3
http://localhost:8080/api/foos?id=1&id=4
----
IDs are [1, 4] size = 2
但是不可以同時使用
http://localhost:8080/api/foos?id=1,2,3&id=4
-----
IDs are [1,2,3, 4] size = 2
@RequestParam vs @PathVariable
@RequestParam 和 @PathVariable 都可以從URI提取值
查詢參數 & URI路徑
@RequestParam 是從查詢參數(QueryString) @PathVariable 是從URI路徑(ResourcePath)
@PathVariable
@GetMapping("/foos/{id}")
@ResponseBody
public String getFooById(@PathVariable String id) {
return "ID: " + id;
}
http://localhost:8080/foos/abc
----
ID: abc
@RequestParam
@GetMapping("/foos")
@ResponseBody
public String getFooByIdUsingQueryParam(@RequestParam String id) {
return "ID: " + id;
}
http://localhost:8080/foos?id=abc
----
ID: abc
編碼與精確值
@PathVariable 是從URI路徑 獲得參數，所以不會被編碼。 @RequestParam 則會被編碼。
@PathVariable
http://localhost:8080/foos/ab+c
----
ID: ab+c
@RequestParam
http://localhost:8080/foos?id=ab+c
----
ID: ab c
可選值
@PathVariable 從 Spring 4.3.3 開始，required 這個屬性讓其變得可選。
用大括號去配置多個路徑
@GetMapping({"/myfoos/optional", "/myfoos/optional/{id}"}) //注意大括號
@ResponseBody
public String getFooByOptionalId(@PathVariable(required = false) String id){
return "ID: " + id;
}
http://localhost:8080/myfoos/optional/abc
----
ID: abc
http://localhost:8080/myfoos/optional
----
ID: null
當使用 @PathVariable 的可選屬性時，要注意路徑衝突