首先颖系，回顧并詳細說明一下在快速入門中使用的@Controller、@RestController、@RequestMapping注解秃踩。如果您對Spring MVC不熟悉并且還沒有嘗試過快速入門案例，建議先看一下快速入門的內(nèi)容业筏。

• @Controller：修飾class憔杨，用來創(chuàng)建處理http請求的對象
• @RestController：Spring4之后加入的注解，原來在@Controller中返回json需要@ResponseBody來配合蒜胖，如果直接用@RestController替代@Controller就不需要再配置@ResponseBody消别，默認返回json格式
• @RequestMapping：配置url映射∨自椋現(xiàn)在更多的也會直接用以Http Method直接關(guān)聯(lián)的映射注解來定義，比如：GetMapping寻狂、PostMapping霉颠、DeleteMapping、PutMapping等

下面我們通過使用Spring MVC來實現(xiàn)一組對User對象操作的RESTful API荆虱，配合注釋詳細說明在Spring MVC中如何映射HTTP請求蒿偎、如何傳參、如何編寫單元測試怀读。

** RESTful API具體設(shè)計如下：**

定義User實體

@Data
public class User {

    private Long id;
    private String name;
    private Integer age;

}

注意：相比1.x版本教程中自定義set和get函數(shù)的方式诉位，這里使用@Data注解可以實現(xiàn)在編譯器自動添加set和get函數(shù)的效果。該注解是lombok提供的菜枷，只需要在pom中引入加入下面的依賴就可以支持：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
</dependency>

實現(xiàn)對User對象的操作接口

@RestController
@RequestMapping(value = "/users")     // 通過這里配置使下面的映射都在/users下
public class UserController {

    // 創(chuàng)建線程安全的Map苍糠，模擬users信息的存儲
    static Map<Long, User> users = Collections.synchronizedMap(new HashMap<Long, User>());

    /**
     * 處理"/users/"的GET請求，用來獲取用戶列表
     *
     * @return
     */
    @GetMapping("/")
    public List<User> getUserList() {
        // 還可以通過@RequestParam從頁面中傳遞參數(shù)來進行查詢條件或者翻頁信息的傳遞
        List<User> r = new ArrayList<User>(users.values());
        return r;
    }

    /**
     * 處理"/users/"的POST請求啤誊，用來創(chuàng)建User
     *
     * @param user
     * @return
     */
    @PostMapping("/")
    public String postUser(@RequestBody User user) {
        // @RequestBody注解用來綁定通過http請求中application/json類型上傳的數(shù)據(jù)
        users.put(user.getId(), user);
        return "success";
    }

    /**
     * 處理"/users/{id}"的GET請求岳瞭，用來獲取url中id值的User信息
     *
     * @param id
     * @return
     */
    @GetMapping("/{id}")
    public User getUser(@PathVariable Long id) {
        // url中的id可通過@PathVariable綁定到函數(shù)的參數(shù)中
        return users.get(id);
    }

    /**
     * 處理"/users/{id}"的PUT請求，用來更新User信息
     *
     * @param id
     * @param user
     * @return
     */
    @PutMapping("/{id}")
    public String putUser(@PathVariable Long id, @RequestBody User user) {
        User u = users.get(id);
        u.setName(user.getName());
        u.setAge(user.getAge());
        users.put(id, u);
        return "success";
    }

    /**
     * 處理"/users/{id}"的DELETE請求蚊锹，用來刪除User
     *
     * @param id
     * @return
     */
    @DeleteMapping("/{id}")
    public String deleteUser(@PathVariable Long id) {
        users.remove(id);
        return "success";
    }

}

這里相較1.x版本教程中瞳筏，用更細化的@GetMapping、@PostMapping等系列注解替換了以前的@RequestMaping注解牡昆；另外姚炕，還使用@RequestBody替換了@ModelAttribute的參數(shù)綁定。

編寫單元測試

下面針對該Controller編寫測試用例驗證正確性丢烘，具體如下柱宦。當(dāng)然也可以通過瀏覽器插件等進行請求提交驗證。

@RunWith(SpringRunner.class)
@SpringBootTest
public class Chapter21ApplicationTests {

    private MockMvc mvc;

    @Before
    public void setUp() {
        mvc = MockMvcBuilders.standaloneSetup(new UserController()).build();
    }

    @Test
    public void testUserController() throws Exception {
        // 測試UserController
        RequestBuilder request;

        // 1播瞳、get查一下user列表掸刊，應(yīng)該為空
        request = get("/users/");
        mvc.perform(request)
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("[]")));

        // 2、post提交一個user
        request = post("/users/")
                .contentType(MediaType.APPLICATION_JSON)
                .content("{\"id\":1,\"name\":\"測試大師\",\"age\":20}");
        mvc.perform(request)
                .andExpect(content().string(equalTo("success")));

        // 3赢乓、get獲取user列表忧侧，應(yīng)該有剛才插入的數(shù)據(jù)
        request = get("/users/");
        mvc.perform(request)
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("[{\"id\":1,\"name\":\"測試大師\",\"age\":20}]")));

        // 4、put修改id為1的user
        request = put("/users/1")
                .contentType(MediaType.APPLICATION_JSON)
                .content("{\"name\":\"測試終極大師\",\"age\":30}");
        mvc.perform(request)
                .andExpect(content().string(equalTo("success")));

        // 5骏全、get一個id為1的user
        request = get("/users/1");
        mvc.perform(request)
                .andExpect(content().string(equalTo("{\"id\":1,\"name\":\"測試終極大師\",\"age\":30}")));

        // 6苍柏、del刪除id為1的user
        request = delete("/users/1");
        mvc.perform(request)
                .andExpect(content().string(equalTo("success")));

        // 7、get查一下user列表姜贡，應(yīng)該為空
        request = get("/users/");
        mvc.perform(request)
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("[]")));

    }

}

對MockMvc不熟悉的讀者试吁，可能會碰到一些函數(shù)不存在而報錯。必須引入下面這些靜態(tài)函數(shù)的引用：

import static org.hamcrest.Matchers.equalTo;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

這里相較1.x版本教程中，主要有兩個地方不同熄捍。測試類采用@RunWith(SpringRunner.class)和@SpringBootTest修飾啟動烛恤；另外，由于POST和PUT接口的參數(shù)采用@RequestBody注解余耽，所以提交的會是一個json字符串缚柏，而不是之前的參數(shù)形式，這里在定義請求的時候使用contentType(MediaType.APPLICATION_JSON)指定提交內(nèi)容為json格式碟贾，使用content傳入要提交的json字符串币喧。如果用@ModelAttribute的話就得用param方法添加參數(shù)，具體可以看1.x版本的教程袱耽。

至此杀餐，我們通過引入web模塊（沒有做其他的任何配置），就可以輕松利用Spring MVC的功能朱巨，以非常簡潔的代碼完成了對User對象的RESTful API的創(chuàng)建以及單元測試的編寫史翘。其中同時介紹了Spring MVC中最為常用的幾個核心注解：@RestController,RequestMapping以及一些參數(shù)綁定的注解：@PathVariable,@RequestBody等。

代碼示例

本文的相關(guān)例子可以查看下面?zhèn)}庫中的chapter2-1目錄：

• Github：https://github.com/dyc87112/SpringBoot-Learning/tree/2.x
• Gitee：https://gitee.com/didispace/SpringBoot-Learning/tree/2.x

如果您覺得本文不錯冀续，歡迎Star支持琼讽，您的關(guān)注是我堅持的動力！

歡迎關(guān)注我的公眾號：程序猿DD洪唐，獲得獨家整理的學(xué)習(xí)資源和日常干貨推送钻蹬。如果您對我的專題內(nèi)容感興趣，也可以關(guān)注我的博客：didispace.com