關於請求參數取得對於開發 API 或是運行任何服務來說是相當重要，特別是我們需要根據使用者請求中所帶有的資訊進行後續的處理，所以這篇就來了解 Spring MVC 中主要用來取得參數的一些方法吧。

Spring Boot 常使用取得請求的方式有下面這些：

• @RequestParam
• @RequestBody
• @PathVariable
• @RequestHeader

@RequestParam

用法：

• GET
• required = true/false (預設 true)，如果是 false 就不用代入但可能會因此有 null 報 exception
• defaultValue = xxx，設置預設值，設置後 required 就會被忽略

用途：取得放在 URL 的參數

http:localhost:8080/test1?id=123

@RestController
public class RequestController {
    @RequestMapping("/test1")
    public String test1(@RequestParam Integer id,
                        @RequestParam(defaultValue = "Sean") String name,
                        @RequestParam(value = "nickname", required = false) String nickname
    ) {
        System.out.println("id:" + id);
        System.out.println("name:" + name);
        System.out.println("name:" + nickname);
        return "your request id is " + id + " and name is " + name + ", or you can called me " + nickname;
    }
}

發送 request，帶入 id =1, name = Sean，故意不帶入第3個參數 nickname，可以看到最後會回傳 null 但也不會出錯誤，但如果把 required = true 就會出現 400 Bad Request 錯誤。

server console 上面顯示

@RequestBody

用法：

• POST, PUT
• required = true/false (預設 true)
• 需要先定義對應參數的 java class
• RequestBody 裡面多傳參數也不會報錯，有定義的才會被使用，少傳就會有 null

用途：取得 Request body 裡面的參數（將 Json 轉為自定義 Java Object）

http:localhost:8080/test2

controller

@RequestMapping("/test2")
public String test2(@RequestBody Student student){
    System.out.println("student id: " + student.getId() );
    System.out.println("student name: " + student.getName() );
    return "hello test2";
}

Student class

public class Student {
    Integer id;
    String name;
    
    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

發送 request，帶入{ “id” =1, “name” = “Sean” }的 JSON 物件，如果請求內所帶的物件屬性不是Student 物件設定的，不管多或少其實都不會有問題，但如果希望參數設定可以驗證避免使用者傳錯參數的話，就必須要透過驗證註解像是@Valid, @NotNull, @NotBlank 等等的部分才可以做到了，這部分後續文章會有進一步說明。

server console 上面顯示

@RequestHeader

用法：

• GET, POST
• 只能加在方法參數上
• name(或用 value): 指定 request header 的 header 名字（比 requestparam 的 name 常用）
• required = true/false 同 @RequestParam
• defaultValue: 預設值 同 @RequestParam

用途：取得放在 requestHeader 的參數，可以用 GET 請求中設定 header; 如果用 POST 一般都會帶入 Content-Type = application/json

@RequestMapping("/test3")
public String test3(@RequestHeader String info,
                    @RequestHeader (name = "gogo", required = false) String gogo){
    System.out.println("header info: " + info);
    System.out.println("header gogo: " + gogo);
    return "hello test3";
}

發送 request，header上面帶入指定的 header 名稱，如果是參數定義的就可以抓到

console 上面顯示

@PathVariable

用法：

• GET, PUT, DELETE
• 路徑上寫的參數要和 @PathVariable 定義的一樣用途：取得放在 URL 路徑裡面的值
• required = true/false (預設 true)，如果是 false 就不用代入但可能會因此有 null 報 exception

http://localhost:8080/test4/123/Sean

@RequestMapping("/test4/{id}/{name}")
    public String test4(@PathVariable Integer id,
                        @PathVariable String name
    ){
        System.out.println("path id: " + id);
        System.out.println("path name: " + name);
        return "hello test4";
    }

發送 request，URL 上針對 {id}, {name} 部分帶入參數，後端就可以取得，注意定義的參數類型如果不匹配也會出現 400 bad request，像是如果你把 id 部分用文字帶入請求。

console 上面顯示

小總結:

針對一些用法上大家可以注意一下

Ref：

1. Java 工程師必備！Spring Boot 零基礎入門 （hahow 課程）

相關文章也會同步更新我的部落格，有興趣也可以在裡面找其他的技術分享跟資訊。

• Sean's Blog