springmvc學習筆記(19)-RESTful支持

springmvc學習筆記(19)-RESTful支持

標籤： springmvc

---

---

本文介紹RESTful的概念，並通過一個小例子展示如何編寫RESTful風格的controller和配置前端控制器，最後展示靜態資源的解析

概念

首先附上兩篇博客鏈接

• 理解RESTful架構 - 阮一峯的網絡日誌
• RESTful API 設計指南- 阮一峯的網絡日誌

RESTful架構，就是目前最流行的一種互聯網軟件架構。它結構清晰、符合標準、易於理解、擴展方便，所以正得到越來越多網站的採用。

RESTful（即Representational State Transfer的縮寫）其實是一個開發理念，是對http的很好的詮釋。

1.對url進行規範，寫RESTful格式的url

• 非REST的url：http://...../queryItems.action?id=001&type=T01
• REST的url風格：http://..../items/001

特點：url簡潔，將參數通過url傳到服務端

2.http的方法規範

不管是刪除、添加、更新，等等。使用url是一致的，如果進行刪除，需要設置http的方法爲delete，其他同理。

後臺controller方法：判斷http方法，如果是delete執行刪除，如果是post執行添加。

3.對http的contentType規範

請求時指定contentType，要json數據，設置成json格式的type。

REST的例子

查詢商品信息，返回json數據。

controller

定義方法，進行url映射使用REST風格的url，將查詢商品信息的id傳入controller .

輸出json使用@ResponseBody將java對象輸出json。

//查詢商品信息，輸出json
//itemsView/{id}裏邊的{id}表示佔位符，通過@PathVariable獲取佔位符中的參數，
//@PathVariable中名稱要和佔位符一致，形參名無需和其一致
//如果佔位符中的名稱和形參名一致，在@PathVariable可以不指定名稱
@RequestMapping("/itemsView/{id}")
public @ResponseBody ItemsCustom itemsView(@PathVariable("id") Integer items_id)throws Exception{

    //調用service查詢商品信息
    ItemsCustom itemsCustom = itemsService.findItemsById(items_id);

    return itemsCustom;

}

@RequestMapping(value="/ itemsView/{id}")：{×××}佔位符，請求的URL可以是/viewItems/1或/viewItems/2，通過在方法中使用@PathVariable獲取{×××}中的×××變量。@PathVariable用於將請求URL中的模板變量映射到功能處理方法的參數上。

如果@RequestMapping中表示爲/itemsView/{id}，id和形參名稱一致，@PathVariable不用指定名稱。

REST方法的前端控制器配置

<!-- springmvc前端控制器，rest配置 -->
<servlet>
    <servlet-name>springmvc_rest</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- contextConfigLocation配置springmvc加載的配置文件（配置處理器映射器、適配器等等） 如果不配置contextConfigLocation，默認加載的是/WEB-INF/servlet名稱-serlvet.xml（springmvc-servlet.xml） -->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring/springmvc.xml</param-value>
    </init-param>
</servlet>

<servlet-mapping>
    <servlet-name>springmvc_rest</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

訪問結果如圖：

對靜態資源的解析

配置前端控制器的url-parttern中指定/，對靜態資源的解析會出現問題，報404錯誤。

在springmvc.xml中添加靜態資源解析方法。

<!-- 靜態資源解析
    包括 ：js、css、img、..
     -->
<mvc:resources location="/js/" mapping="/js/**"/>

這時訪問http://localhost:8080/ssm1/js/jquery-1.4.4.min.js，可以在瀏覽器中看到js的內容

---

作者@brianway更多文章：個人網站 | CSDN | oschina