什麼是RESTful？

        RESTful架構，就是目前最流行的一種網際網路軟體架構。它結構清晰、符合標準、易於理解、擴充套件方便，所以正得到越來越多網站的採用。RESTful（即Representational State Transfer的縮寫）是一種開發理念，是對於http的很好的詮釋。

        對url進行規範，寫成RESTful格式的url：

        特點：url簡潔，將引數通過url傳入服務端進行處理。

        RESTful對http的方法進行規範，不管是刪除、新增、更新，使用的url是一致的，若要進行刪除，需要設定http的方法為delete，put，post等；

        後臺Controller方法：判斷http方法，若為delete則執行刪除，post執行新增等操作；

        對http的contentType進行規範，請求時指定contentType，要json資料，設定成json格式的type等。

SSM框架 + RESTful開發

搭建SSM環境

        1、需要在專案中新增將結果轉為json資料返回的jar包

        jackson-annotations-2.8.4.jar

        jackson-core-2.8.4.jar

        jackson-databind-2.8.4.jar

        如果不新增這3個jar包，會輸出錯誤如下：

        java.lang.IllegalArgumentException:No converter found for return value of type。

         jackson-2.9.4.jar包將上述的3個jar包整合在一起。

        2、springmvc前端控制器的配置

<!-- springmvc配置前端控制器 -->
<servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework
 
.web.servlet.DispatcherServlet</servlet-class>
    <!--contextConfigLocation配置springmvc載入的配置檔案（配置檔案裡面配置處理器介面卡，處理器等等），如果不配置contextConfigLocation，則預設載入/WEB-INF/servlet名稱-servlet.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>/</url-pattern>
</servlet-mapping>

        注意：要實現RESTful風格的url則需要配置：<url-pattern>/</url-pattern>。同時需要解決靜態資源直接返回，不需要解析的問題，需要在springmvc.xml中新增資源對映：

        <!– 靜態資源對映 –>
        <mvc:resources location=”/js/”mapping=”/js/” />
        <mvc:resources location=”/css/”mapping=”/css/” />
        <mvc:resources location=”/img/”mapping=”/img/” />
        <mvc:resources location=”/fonts/”mapping=”/fonts/” />

        或者也可以在springmvc.xml配置檔案中使用<mvc:default-servlet-handler/> 配置該指令放行預設的靜態資源。

應用例項

1、需求：查詢商品資訊，返回json資料。

編寫mapper和service介面以及實現類

ItemsMapper.xml

<!-- 根據商品id查詢商品資訊 -->
<select id="selectItemsById" parameterType="int" resultType="com.zxt.ssm.po.Items">
    select * from items where id=#{id}
</select>

ItemsMapper.java

// 根據商品id獲取商品資訊
public Items selectItemsById(intid) throwsException;

ItemsService介面

/
* @Description: 根據商品id獲取商品資訊
 @param id：使用int無法判斷是否為空，所以一般使用Integer
/
public ItemsCustom selectItemsById(Integer id) throws Exception;

ItemsServiceImpl新增介面實現

@Override
public ItemsCustom selectItemsById(Integer id) throws Exception {
    Items items = itemsMapper.selectItemsById(id);
    /
     中間對商品資訊進行業務處理，返回Items的擴充套件類：ItemsCustom
    * 例如商品類中只有生產日期，而沒有是否過期的資訊，可以做一定的操作得到該資訊，封裝到ItemsCustom，顯示給使用者
    /
    ItemsCustom itemsCustom = new ItemsCustom();
    // 將Items中的屬性複製到ItemsCustom中
    BeanUtils.copyProperties(items, itemsCustom);
    return itemsCustom;
}

2、controller

        定義一個方法：使用url模板對映，進行url對映，使用REST風格的url，能將查詢商品資訊的id傳入controller，輸出json，使用@ResponseBody將java物件輸出為json至前端頁面。

@Controller
public class TestController {
    @Autowired
    private ItemsService itemsService;
    @RequestMapping("/itemsview/{id}")
    public @ResponseBody ItemsCustom findItemsById(@PathVariable("id")Integer id) throws Exception {
        ItemsCustom itemsCustom = itemsService.selectItemsById(id);
        return itemsCustom;
    }
}

        ”/itemsview/{id}”這裡的｛id｝傳入到(@PathVariable(“id”)Integer id) 的id裡面。

        如果有多個引數，例如增加name欄位：@RequestMapping(“/itemsview/{id}/{name}”)

   (@PathVariable(“id”)Integer id ,  @PathVariable(“name”) String diffname )，return itemsCustom會經過@ResponseBody註解轉換為json資料格式。

3、測試，瀏覽器輸入：

常見問題總結

資料轉換

    Java中沒有將資料轉換成JSON格式的jar包，所以需要依賴外部jackson包，否則會出現：java.lang.IllegalArgumentException錯誤。

靜態資源訪問處理

        採用RESTful架構後，必須將web.xml中控制器攔截的請求設定為‘/ ’；但是這樣會產生一個問題，就是會將css，js，圖片等靜態資源攔截，發生404錯誤。

        解決方案如下：

        方法一：配置<mvc:resources/>

        springmvc配置檔案中這樣使用：<mvc:resources mapping=”請求URI” location=”資源位置”>。

        方法二：在springmvc配置檔案中使用<mvc:default-servlet-handler/>配置該指令放行預設的靜態資源。

版本不相容問題

        當出現spring版本和java jdk版本不相容時也會出現：java.lang.IllegalArgumentException異常。

        通常來說spring3.x版本對應JDK7.0及以下版本，使用spring4.x以後版本，可以使用JDK8.0。

        右擊專案—> properties —>project facets : 修改JDK版本，需要將1.8降為1.7版本。

SSM中常用註解

@RequestMapping

        通過RequestMapping註解可以定義不同的處理器對映規則。

        @RequestMapping(value=”/items”)或@RequestMapping(“/items），value的值是陣列，可以將多個url對映到同一個方法。

窄化請求對映

        在class上新增@RequestMapping(url)指定通用請求字首， 限制此類下的所有方法請求url必須以請求字首開頭，通過此方法對url進行分類管理。

請求方法限定

        1、限定GET方法：@RequestMapping(method = RequestMethod.GET)

        如果通過Post訪問則報錯：HTTP Status 405 - Request method ‘POST’ not supported。

        例如：@RequestMapping(value=”/editItems”,method=RequestMethod.GET)

        2、限定POST方法：@RequestMapping(method =RequestMethod.POST)

        如果通過Post訪問則報錯：HTTP Status 405 - Request method ‘GET’ not supported。

        3、GET和POST都可以：@RequestMapping(method={RequestMethod.GET,RequestMethod.POST})

@PathVariable

        @PathVariable對映 URL 繫結的佔位符，帶佔位符的URL 是 Spring3.0 新增的功能，該功能在SpringMVC向 REST 目標挺進發展過程中具有里程碑的意義。通過@PathVariable 可以將 URL 中佔位符引數繫結到控制器處理方法的入參中：URL中的 {xxx} 佔位符可以通過@PathVariable(“xxx“)繫結到操作方法的入參中。

/*
* @RequestMapping(value = "user/login/{id}/{name}/{status}") 中的 {id}/{name}/{status}
* 與 @PathVariable int id、@PathVariable Stringname、@PathVariableboolean status
* 一一對應，按名匹配。
*/
@RequestMapping(value = "user/login/{id}/{name}/{status}")
@ResponseBody
// @PathVariable註解下的資料型別均可用
public User login(@PathVariable int id, @PathVariableString name, @PathVariable boolean status) {
    // 返回一個User物件響應ajax的請求
    returnnew User(id, name, status);
}

@ResponseBody

        @Responsebody註解表示該方法的返回的結果直接寫入 HTTP 響應正文（ResponseBody）中，一般在非同步獲取資料時使用，通常是在使用@RequestMapping 後，返回值通常解析為跳轉路徑，加上@Responsebody 後返回結果不會被解析為跳轉路徑，而是直接寫入HTTP 響應正文中。

        作用：該註解用於將Controller的方法返回的物件，通過適當的HttpMessageConverter轉換為指定格式後，寫入到Response物件的body資料區。

        使用時機：返回的資料不是html標籤的頁面，而是其他某種格式的資料時（如json、xml等）使用。

@RequestBody

        @RequestBody註解則是將 HTTP 請求正文插入方法中，使用適合的HttpMessageConverter 將請求體寫入某個物件。

        作用：1)、該註解用於讀取Request請求的body部分資料，使用系統預設配置的HttpMessageConverter進行解析，然後把相應的資料繫結到要返回的物件上；

        2)、再把HttpMessageConverter返回的物件資料繫結到controller中方法的引數上。

        使用時機：

        A)、GET、POST方式提時，根據requestheader Content-Type的值來判斷：

        application/x-www-form-urlencoded，可選（即非必須，因為這種情況的資料@RequestParam,@ModelAttribute也可以處理，當然@RequestBody也能處理）；

        multipart/form-data，不能處理（即使用@RequestBody不能處理這種格式的資料）；

        其他格式，必須（其他格式包括application/json,application/xml等。這些格式的資料，必須使用@RequestBody來處理）；

        B)、PUT方式提交時，根據requestheader Content-Type的值來判斷：

        application/x-www-form-urlencoded，必須；multipart/form-data,不能處理；其他格式，必須；

        說明：request的body部分的資料編碼格式由header部分的Content-Type指定。

@RequestMapping(value = "user/login")
@ResponseBody
// 將ajax（datas）發出的請求寫入 User 物件中
public User login(@RequestBody User user){  
    // 這樣就不會再被解析為跳轉路徑，而是直接將user物件寫入 HTTP 響應正文中
    return user;
}

@RequestParam

        使用@RequestParam常用於處理簡單型別的繫結。當形參名稱與頁面提交的引數的名稱不一致時就要使用這個註解。

        value：引數名字，即入參的請求引數名字，如value=“item_id”表示請求的引數區中的名字為item_id的引數的值將傳入；

        required：是否必須，預設是true，表示請求中一定要有相應的引數，否則將報：TTP Status 400 - RequiredInteger parameter ‘XXXX’ is not present。

        defaultValue：預設值，表示如果請求中沒有同名引數時的預設值。

// 商品修改頁面的展示
@RequestMapping("/editItems")
public ModelAndView editItems(@RequestParam(value = "id", required = true) Integer item_id) throws Exception {
}

        形參名稱為item_id，但是這裡使用value=”id”限定請求的引數名為id，所以頁面傳遞引數的名必須為id。

        注意：如果請求引數中沒有id將跑出異常：HTTP Status 500 - RequiredInteger parameter ‘item_id’ is not present。這裡通過required=true限定id引數為必需傳遞，如果不傳遞則報400錯誤，可以使用defaultvalue設定預設值，即使required=true也可以不傳id引數值。