一、RESTful 核心概念

1. 請求類型與操作對應(yīng)關(guān)系

• POST → 新增數(shù)據(jù)
• PUT → 修改數(shù)據(jù)
• GET → 查詢數(shù)據(jù)
• DELETE → 刪除數(shù)據(jù)

2. RESTful 設(shè)計原則

• 路徑代表資源（使用名詞，不用動詞）
• 請求類型代表動作
• 瀏覽器默認發(fā)送 GET 請求

二、傳統(tǒng)傳參 vs RESTful 傳參

傳統(tǒng)方式（查詢參數(shù)）

https://google.com/search?q=keyword&page=1

• 使用 ? 和 & 拼接參數(shù)

RESTful 風(fēng)格（路徑參數(shù)）

/api/users/123

• 參數(shù)值直接放在路徑中
• 使用 / 分隔多個參數(shù)
• 不需要參數(shù)名

三、Spring MVC 實現(xiàn)示例

1. 無參 GET 請求

@RestController
@RequestMapping("/api")
public class ApiController {
    
    @GetMapping("/test")
    public String getNoParam() {
        return "無參GET請求API接口方法";
    }
}

2. RESTful 風(fēng)格帶參 GET 請求

@GetMapping("/user/{id}")
public String getWithPathParam(@PathVariable String id) {
    return "RESTful請求傳值方法，ID: " + id;
}

訪問路徑：/api/user/123

3. 傳統(tǒng)方式帶參 GET 請求

@GetMapping("/user")
public String getWithQueryParam(@RequestParam String id) {
    return "GET普通請求傳值方法，ID: " + id;
}

訪問路徑：/api/user?id=123

4. POST 請求（接收請求體）

@PostMapping("/save")
public String postMethod(@RequestBody Map<String, Object> map) {
    return "POST請求接收成功: " + map;
}

5. PUT 請求

@PutMapping("/update/{id}")
public String putMethod(@PathVariable String id, @RequestBody Map<String, Object> map) {
    return "PUT請求接收成功，ID: " + id + ", 數(shù)據(jù): " + map;
}

6. DELETE 請求

@DeleteMapping("/delete/{id}")
public String deleteMethod(@PathVariable String id) {
    return "DELETE請求接收成功，ID: " + id;
}

四、關(guān)鍵注解說明

• @RestController: 組合注解，包含 @Controller 和 @ResponseBody
• @RequestMapping: 類級別的路徑映射
• @GetMapping/@PostMapping/@PutMapping/@DeleteMapping: 方法級別的請求映射
• @PathVariable: 從路徑中獲取參數(shù)值
• @RequestParam: 從查詢參數(shù)中獲取值
• @RequestBody: 從請求體中獲取數(shù)據(jù)

五、測試工具

• API Fox
• Postman
• 其他接口調(diào)試工具

六、Spring MVC 匹配機制

Spring MVC 會根據(jù)：

1. 請求類型（GET/POST/PUT/DELETE）
2. 請求路徑
3. 參數(shù)傳遞方式

自動匹配對應(yīng)的控制器方法。

實際開發(fā)建議

1. 保持 RESTful 風(fēng)格的一致性
2. 合理設(shè)計資源路徑（使用名詞）
3. 根據(jù)操作類型選擇合適的 HTTP 方法
4. 在實際項目中，這些方式都會用到，根據(jù)場景靈活選擇

以上就是一文詳解如何使用Spring MVC實現(xiàn)RESTful API接口的詳細內(nèi)容，更多關(guān)于Spring MVC實現(xiàn)RESTful API接口的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論