RESTful簡單介紹（入門）

1.1      什么是RESTful

http://www.ruanyifeng.com/blog/2011/09/restful.html

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。。

 

1.2      REST的例子

1.2.1     需求

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

 

1.2.2     controller

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

 

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

    //查詢商品信息，輸出json
    ///itemsView/{id}里邊的{id}表示占位符，通過@PathVariable獲取占位符中的參數，
    //如果占位符中的名稱和形參名一致，在@PathVariable可以不指定名稱
    @RequestMapping("/itemsView/{id}")
    public @ResponseBody ItemsCustom itemsView(@PathVariable("id") Integer id)throws Exception{
        
        //調用service查詢商品信息
        ItemsCustom itemsCustom = itemsService.findItemsById(id);
        
        return itemsCustom;
        
    }

 

@RequestMapping(value="/ itemsView/{id}")：{×××}占位符，請求的URL可以是“/viewItems/1”或“/viewItems/2”，通過在方法中使用@PathVariable獲取{×××}中的×××變量。

@PathVariable用於將請求URL中的模板變量映射到功能處理方法的參數上。

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

 

 

1.2.3     REST方法的前端控制器配置

 

在web.xml配置：

    <!-- springmvc前端控制器 -->
    <servlet>
        <servlet-name>springmvc</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</servlet-name>
        <!-- 第一種：*.action，訪問以.action結尾 由DispatcherServlet進行解析 
            第二種：/，所以訪問的地址都由DispatcherServlet進行解析，對於靜態文件的解析需要配置不讓DispatcherServlet進行解析 
            使用此種方式可以實現 RESTful風格的url 
            第三種：/*，這樣配置不對，使用這種配置，最終要轉發到一個jsp頁面時， 仍然會由DispatcherServlet解析jsp地址，不能根據jsp頁面找到handler，會報錯。 -->
        <url-pattern>*.action</url-pattern>
    </servlet-mapping>
    
    
    <!-- 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>

 

1.3      對靜態資源的解析

 

配置前端控制器的url-parttern中指定/，對靜態資源的解析出現問題：

 

 

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

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

1.4      訪問