SpringMVC實(shí)現(xiàn)RESTful風(fēng)格

RESTful

中文釋義為”表現(xiàn)層狀態(tài)轉(zhuǎn)換“，它不是一種標(biāo)準(zhǔn)，而是一種設(shè)計(jì)風(fēng)格。

它的主要作用是充分并正確利用HTTP協(xié)議的特性，規(guī)范資源獲取的URI路徑。

通俗的講，RESTful風(fēng)格的設(shè)計(jì)允許將參數(shù)通過(guò)URL拼接傳到服務(wù)端，目的是讓URL看起來(lái)更簡(jiǎn)潔實(shí)用。

并且對(duì)于不同的操作，要指定不同的HTTP方法(POST/GET/PUT/DELETE)?？梢赃@么說(shuō)，只要是具有上述相關(guān)條件和原則的應(yīng)用程序或設(shè)計(jì)就可以被稱(chēng)為RESTful風(fēng)格的應(yīng)用。

一個(gè)滿足RESTful的程序或設(shè)計(jì)應(yīng)滿足以下條件和約束：

第一：對(duì)請(qǐng)求的URL進(jìn)行規(guī)范，在URL中不會(huì)出現(xiàn)動(dòng)詞，而是使用HTTP協(xié)議的動(dòng)詞

第二：充分利用HTTP方法，HTTP方法名包括：GET、POST、PUT、PATCH、DELETE

使用Spring MVC實(shí)現(xiàn)RESTful風(fēng)格

Spring mvc可以使用@RequestMapping的路徑設(shè)置，結(jié)合@PathVariable的參數(shù)指定，來(lái)實(shí)現(xiàn)RESTful風(fēng)格的請(qǐng)求。

樣例要實(shí)現(xiàn)，通過(guò)拼接水果商品的id來(lái)實(shí)現(xiàn)一個(gè)RESTful風(fēng)格的請(qǐng)求，并向后臺(tái)發(fā)送該請(qǐng)求，以此來(lái)獲取JSON格式的水果數(shù)據(jù)

@RequestMapping(value="/queryFruit/{id}",method={RequestMethod.GET})
public @ResponseBody Fruits getFruitById(Model model,@PathVariable("id") Integer fruitId) throws Exception{
    Fruits fruit = fruitsServices.queryFruitById(fruitId);
    return fruit; 
}

在該方法中，在@RequestMapping注解的請(qǐng)求路徑中添加了一個(gè)動(dòng)態(tài)數(shù)據(jù)"{id}"，它的作用是解析前臺(tái)的請(qǐng)求路徑，將動(dòng)態(tài)數(shù)據(jù)所在的位置解析為名為id的請(qǐng)求參數(shù)。

@PathVariable注解，在其中指定請(qǐng)求參數(shù)的key名稱(chēng)，并映射在后面定義的形參上，這里定義fruitId形參來(lái)接收名為id的請(qǐng)求參數(shù)，最后使用@ResponseBody注解加上之前配置的類(lèi)型轉(zhuǎn)換器，返回客戶端JSON類(lèi)型的水果詳細(xì)信息，總的來(lái)說(shuō)，利用SprngMVC實(shí)現(xiàn)RESTful風(fēng)格主要就是在于請(qǐng)求路徑和請(qǐng)求參數(shù)的映射，以及RequestMapping的指定，更改web.xml中配置文件的內(nèi)容，將*.do改成"/"，這樣編寫(xiě)的RESTful風(fēng)格的請(qǐng)求才能被前端控制器攔截到并解析。

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

然后重啟工程，輸入網(wǎng)址：http://localhost:8080/工程名/queryFruit/1

上面的代碼為查詢(xún)類(lèi)型的請(qǐng)求代碼，而新增、修改以及刪除的請(qǐng)求與此類(lèi)似，區(qū)別就是需要指定不同的RequestMethod(POST/PUT/DELETE),樣例代碼如下：

        //添加水果邏輯
	@RequestMapping(value="/addFruit",method= {RequestMethod.POST})
	public String addFruit(Model model,Fruits fruit)throws Exception{
		//implements
		return "...";
	}
	//通過(guò)id刪除水果商品
		@RequestMapping(value="/deleteFruit/{id}",method= {RequestMethod.DELETE})
		public String deleteFruitById(Model model,@PathVariable Integer fruitId)throws Exception{
			//implements
			return "...";
		}
	//修改水果商品信息
	@RequestMapping(value="/editFruit",method= {RequestMethod.PUT})
	public String editFruitById(Model model,Fruits fruit)throws Exception{
		//implements
		return "...";
	}

前端在訪問(wèn)RESTful風(fēng)格的增、刪、該請(qǐng)求時(shí)，需要配置HTTP請(qǐng)求的方法(method參數(shù))。如果是在JSP頁(yè)面上使用form表單的提交方式來(lái)請(qǐng)求RESTful風(fēng)格的服務(wù)，需要根據(jù)請(qǐng)求的類(lèi)型，在form表單標(biāo)簽中指定HTTP請(qǐng)求的相關(guān)method參數(shù)。

靜態(tài)資源訪問(wèn)問(wèn)題

前面在web.xml中配置了符合RESTful風(fēng)格的DispatcherServlet前端控制器過(guò)濾器。但是這種過(guò)濾方式會(huì)造成靜態(tài)資源無(wú)法訪問(wèn)的問(wèn)題，例如：在webContent下的image文件夾下放置一張圖片logo.jpg。

由于圖片放置在WEB-INF文件外（由于JavaWEB的保護(hù)機(jī)制，WEB-INF文件夾下的文件不可直接訪問(wèn)），所以原則上是可以通過(guò)直接訪問(wèn)靜態(tài)資源的方式獲取該圖片的，但是輸入http://localhost:8080/工程名/image/logo.jpg的請(qǐng)求后，不能獲取到圖片資源。

原因：

在web.xml中配置了前端控制器的請(qǐng)求過(guò)濾機(jī)制，為了接收RESTful風(fēng)格的請(qǐng)求，將過(guò)濾的后綴去除了，變成過(guò)濾所有后綴的請(qǐng)求路徑，此時(shí)靜態(tài)資源會(huì)被當(dāng)做一個(gè)業(yè)務(wù)請(qǐng)求被前端控制器處理，前端控制器沒(méi)有發(fā)現(xiàn)能夠處理該請(qǐng)求的Controller控制器方法，所以對(duì)外拋出了404錯(cuò)誤。

解決方式一：

在類(lèi)加載配置文件springmvc中使用"mvc:resources"配置靜態(tài)資源的解析路徑，將需要加載的靜態(tài)資源的URI路徑配置在標(biāo)簽中，然后配置該URI映射的真是資源路徑。

<mvc:resources location="/js/" mapping="/js/**"/>
<mvc:resources location="/img/" mapping="/img/**"/>
<mvc:resources location="/css/" mapping="/css/**"/>

當(dāng)在springmvc.xml中配置了靜態(tài)資源文件的解析路徑后，前端控制器就會(huì)根據(jù)請(qǐng)求URL中的具體子路徑來(lái)映射出靜態(tài)資源的真是路徑，然后為前端反饋真實(shí)的靜態(tài)資源信息。

解決方式二：

在springmvc.xml中使用"<mvc:default-servlet-handler/>"配置默認(rèn)的Servlet處理器，該配置將在SpringMVC上下文中定義一個(gè)DefaultServletHttpRequestHandler，他會(huì)對(duì)進(jìn)入DispatcherServlet的請(qǐng)求進(jìn)行篩選，若發(fā)現(xiàn)沒(méi)有經(jīng)過(guò)映射的請(qǐng)求，就將該請(qǐng)求交由Web應(yīng)用服務(wù)器默認(rèn)的Servlet處理，如果不是靜態(tài)資源的請(qǐng)求，才由DispatcherServlet前端控制器繼續(xù)處理，此時(shí)就可以將請(qǐng)求中的靜態(tài)資源和其他業(yè)務(wù)請(qǐng)求分開(kāi)處理，從而正常地返回靜態(tài)資源信息。

Spring MVC的RESTful學(xué)習(xí)

什么RESTful

RESTful也稱(chēng)為REST（Representational State Transfer），可以將它理解為一種軟件架構(gòu)風(fēng)格或設(shè)計(jì)風(fēng)格

RESTful風(fēng)格就是把請(qǐng)求參數(shù)編程請(qǐng)求路徑的一種風(fēng)格。

例如，傳統(tǒng)的URL請(qǐng)求如下：

http://.../requestparam?id=1

而采用RESTful風(fēng)格后，URL請(qǐng)求變?yōu)椋?/strong>

http://.../param/1

@Controller
public class RestFulController {
    //原來(lái)的：localhost:8080/add?a=1&b=1
    //RestFul:   localhost:8080/add/a/b
    @RequestMapping(value = "/add/{a}/",method = RequestMethod.GET)
    public String test(@PathVariable int a,@PathVariable int b, Model model) {
        int res = a + b;
        model.addAttribute("msg","結(jié)果為："+res);
        return "test";
    }
}

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
${msg}
</body>
</html>