SpringMVC RESTFul及REST架構風格介紹

Posted on by

一、RESTful 簡介

REST 是一種軟件架構風格。

REST：Representational State Transfer，表現層資源狀態轉移。

對此，有幾個名字需要理解一下：

表現層：實際上就是前端的頁面到後端的控制層。

資源：當應用部署到服務器上之後，萬物皆資源，比如一個類、一個html頁面等等。

  • 1-資源是一種看待服務器的方式，即將服務器看作是由很多離散的資源組成。每個資源是服務器上一個可命名的抽象概念。
  • 2-因為資源是一個抽象的概念，所以它不僅僅能代表服務器文件系統中的一個文件、數據庫中的一張表等等具體的東西，可以將資源設計的要多抽象有多抽象，隻要想象力允許而且客戶端應用開發者能夠理解。
  • 3-與面向對象設計類似，資源是以名詞為核心來組織的，首先關註的是名詞。
  • 4-一個資源可以由一個或多個URI來標識。
  • 5-URI既是資源的名稱，也是資源在Web上的地址。
  • 6-對某個資源感興趣的客戶端應用，可以通過資源的URI與其進行交互。

資源的表述：是一段對於資源在某個特定時刻的狀態的描述。

  • 1-可以在客戶端-服務器端之間轉移(交換)。
  • 2-資源的表述可以有多種格式，例如HTML/XML/JSON/純文本/圖片/視頻/音頻等等。
  • 3-資源的表述格式可以通過協商機制來確定。
  • 4-請求-響應方向的表述通常使用不同的格式。

狀態轉移：在客戶端和服務器端之間轉移(transfer)代表資源狀態的表述。通過轉移和操作資源的表述，來間接實現操作資源的目的。

二、RESTful 的實現

具體說，就是 HTTP 協議裡面，四個表示操作方式的動詞：GET、POST、PUT、DELETE。

它們分別對應四種基本操作：

  • GET 用來獲取資源
  • POST 用來新建資源
  • PUT 用來更新資源
  • DELETE 用來刪除資源

REST 風格提倡 URL 地址使用統一的風格設計，從前到後各個單詞使用斜杠分開。

不使用問號鍵值對方式攜帶請求參數，而是將要發送給服務器的數據作為 URL 地址的一部分，以保證整體風格的一致性。比如：

實踐一下

使用 RESTFul 模擬一下用戶資源的增刪改查。

1. get 和 post 請求

控制器方法：

@Controller
public class UserController {
    /**
     * /user    GET     查詢所有用戶信息
     * /user/1  GET     根據用戶 id 查詢用戶信息
     * /user    POST    添加用戶信息
     * /user/1  DELETE  刪除用戶信息
     * /user    PUT     更新用戶信息
     */
    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public String getAllUser() {
        System.out.println("查詢所有用戶信息");
        return "success";
    }
    @RequestMapping(value = "/user/{id}", method = RequestMethod.GET)
    public String getUserById() {
        System.out.println("根據用戶 id 查詢用戶信息");
        return "success";
    }
    @RequestMapping(value = "/user", method = RequestMethod.POST)
    public String addUser(String username, String password) {
        System.out.println("添加用戶信息:" + username + "," + password);
        return "success";
    }
}

test_rest.html:

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <p>test_rest 頁面</p>
    <a th:href="@{/user}" rel="external nofollow" >查詢所有用戶信息</a><br>
    <a th:href="@{/user/1}" rel="external nofollow" >根據用戶 id 查詢用戶信息</a><br>
    <form th:action="@{/user}" method="post">
        用戶名：<input type="text" name="username"><br>
        密碼：<input type="password" name="password"><br>
        <input type="submit" name="添加用戶"><br>
    </form>
</body>
</html>

配置文件裡，加上視圖控制：

<mvc:view-controller path="/testRest" view-name="test_rest"></mvc:view-controller>

這樣就可以通過http://localhost:8080/springmvc/testRest訪問到test_rest.html的頁面瞭。

點擊測試一下。

2. put 和 delete 請求

由於瀏覽器隻支持發送 get 和 post 方式的請求，那麼該如何發送 put 和 delete 請求呢？

答案：使用 HiddenHttpMethodFilter 過濾器，可以幫助我們將 POST 請求轉換為 DELETE 或 PUT 請求。

在web.xml中註冊HiddenHttpMethodFilter，這個過濾器要配置在編碼過濾器之後，防止更新操作獲取到的參數是亂碼:

<filter>
    <filter-name>HiddenHttpMethodFilter</filter-name>
    <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>HiddenHttpMethodFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

註意使用的前提條件有 2 個：

  • 當前請求的請求方式必須為 post當
  • 前請求必須傳輸請求參數 _method

那麼前端頁面裡修改的表單應該是成這樣：

<p>修改用戶信息的表單</p>
    <form th:action="@{/user}" method="post">
        <input type="hidden" name="_method" value="put">
        用戶名：<input type="text" name="username"><br>
        密碼：<input type="password" name="password"><br>
        <input type="submit" name="修改"><br>
    </form>

註意這裡name="_method" value="put"，value 的值才是真正的方法名。

提交測試一下：

感謝《尚矽谷》的學習資源。

以上就是SpringMVC RESTFul及REST架構風格介紹的詳細內容，更多關於SpringMVC RESTFul架構風格的資料請關註WalkonNet其它相關文章！

推薦閱讀：