如何利用Spring?MVC實現(xiàn)RESTful風格
SpringMVC實現(xiàn)RESTful風格
RESTful
中文釋義為”表現(xiàn)層狀態(tài)轉(zhuǎn)換“,它不是一種標準,而是一種設(shè)計風格。
它的主要作用是充分并正確利用HTTP協(xié)議的特性,規(guī)范資源獲取的URI路徑。
通俗的講,RESTful風格的設(shè)計允許將參數(shù)通過URL拼接傳到服務(wù)端,目的是讓URL看起來更簡潔實用。
并且對于不同的操作,要指定不同的HTTP方法(POST/GET/PUT/DELETE)。可以這么說,只要是具有上述相關(guān)條件和原則的應(yīng)用程序或設(shè)計就可以被稱為RESTful風格的應(yīng)用。
一個滿足RESTful的程序或設(shè)計應(yīng)滿足以下條件和約束:
第一:對請求的URL進行規(guī)范,在URL中不會出現(xiàn)動詞,而是使用HTTP協(xié)議的動詞
第二:充分利用HTTP方法,HTTP方法名包括:GET、POST、PUT、PATCH、DELETE
使用Spring MVC實現(xiàn)RESTful風格
Spring mvc可以使用@RequestMapping的路徑設(shè)置,結(jié)合@PathVariable的參數(shù)指定,來實現(xiàn)RESTful風格的請求。
樣例要實現(xiàn),通過拼接水果商品的id來實現(xiàn)一個RESTful風格的請求,并向后臺發(fā)送該請求,以此來獲取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注解的請求路徑中添加了一個動態(tài)數(shù)據(jù)"{id}",它的作用是解析前臺的請求路徑,將動態(tài)數(shù)據(jù)所在的位置解析為名為id的請求參數(shù)。
@PathVariable注解,在其中指定請求參數(shù)的key名稱,并映射在后面定義的形參上,這里定義fruitId形參來接收名為id的請求參數(shù),最后使用@ResponseBody注解加上之前配置的類型轉(zhuǎn)換器,返回客戶端JSON類型的水果詳細信息,總的來說,利用SprngMVC實現(xiàn)RESTful風格主要就是在于請求路徑和請求參數(shù)的映射,以及RequestMapping的指定,更改web.xml中配置文件的內(nèi)容,將*.do改成"/",這樣編寫的RESTful風格的請求才能被前端控制器攔截到并解析。
<servlet-mapping> <servlet-name>springmvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping>
然后重啟工程,輸入網(wǎng)址:http://localhost:8080/工程名/queryFruit/1
上面的代碼為查詢類型的請求代碼,而新增、修改以及刪除的請求與此類似,區(qū)別就是需要指定不同的RequestMethod(POST/PUT/DELETE),樣例代碼如下:
//添加水果邏輯 @RequestMapping(value="/addFruit",method= {RequestMethod.POST}) public String addFruit(Model model,Fruits fruit)throws Exception{ //implements return "..."; } //通過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 "..."; }
前端在訪問RESTful風格的增、刪、該請求時,需要配置HTTP請求的方法(method參數(shù))。如果是在JSP頁面上使用form表單的提交方式來請求RESTful風格的服務(wù),需要根據(jù)請求的類型,在form表單標簽中指定HTTP請求的相關(guān)method參數(shù)。
靜態(tài)資源訪問問題
前面在web.xml中配置了符合RESTful風格的DispatcherServlet前端控制器過濾器。但是這種過濾方式會造成靜態(tài)資源無法訪問的問題,例如:在webContent下的image文件夾下放置一張圖片logo.jpg。
由于圖片放置在WEB-INF文件外(由于JavaWEB的保護機制,WEB-INF文件夾下的文件不可直接訪問),所以原則上是可以通過直接訪問靜態(tài)資源的方式獲取該圖片的,但是輸入http://localhost:8080/工程名/image/logo.jpg的請求后,不能獲取到圖片資源。
原因:
在web.xml中配置了前端控制器的請求過濾機制,為了接收RESTful風格的請求,將過濾的后綴去除了,變成過濾所有后綴的請求路徑,此時靜態(tài)資源會被當做一個業(yè)務(wù)請求被前端控制器處理,前端控制器沒有發(fā)現(xiàn)能夠處理該請求的Controller控制器方法,所以對外拋出了404錯誤。
解決方式一:
在類加載配置文件springmvc中使用"mvc:resources"配置靜態(tài)資源的解析路徑,將需要加載的靜態(tài)資源的URI路徑配置在標簽中,然后配置該URI映射的真是資源路徑。
<mvc:resources location="/js/" mapping="/js/**"/> <mvc:resources location="/img/" mapping="/img/**"/> <mvc:resources location="/css/" mapping="/css/**"/>
當在springmvc.xml中配置了靜態(tài)資源文件的解析路徑后,前端控制器就會根據(jù)請求URL中的具體子路徑來映射出靜態(tài)資源的真是路徑,然后為前端反饋真實的靜態(tài)資源信息。
解決方式二:
在springmvc.xml中使用"<mvc:default-servlet-handler/>"配置默認的Servlet處理器,該配置將在SpringMVC上下文中定義一個DefaultServletHttpRequestHandler,他會對進入DispatcherServlet的請求進行篩選,若發(fā)現(xiàn)沒有經(jīng)過映射的請求,就將該請求交由Web應(yīng)用服務(wù)器默認的Servlet處理,如果不是靜態(tài)資源的請求,才由DispatcherServlet前端控制器繼續(xù)處理,此時就可以將請求中的靜態(tài)資源和其他業(yè)務(wù)請求分開處理,從而正常地返回靜態(tài)資源信息。
Spring MVC的RESTful學習
什么RESTful
RESTful也稱為REST(Representational State Transfer),可以將它理解為一種軟件架構(gòu)風格或設(shè)計風格
RESTful風格就是把請求參數(shù)編程請求路徑的一種風格。
例如,傳統(tǒng)的URL請求如下:
http://.../requestparam?id=1
而采用RESTful風格后,URL請求變?yōu)椋?/strong>
http://.../param/1
RESTful風格在HTTP請求中使用put,delete,post和get方式分別對應(yīng)添加,刪除,修改和查詢的操作。不過國內(nèi)開發(fā)目前只使用post和get方式實現(xiàn)增刪改查操作。
使用簡單的加法計算
@Controller public class RestFulController { //原來的: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>
以上為個人經(jīng)驗,希望能給大家一個參考,也希望大家多多支持腳本之家。
- springmvc使用REST出現(xiàn):Request?method?'PUT'?not?supported問題
- springmvc Rest風格介紹及實現(xiàn)代碼示例
- SpringMVC開發(fā)restful API之用戶查詢代碼詳解
- Spring MVC利用Swagger2如何構(gòu)建動態(tài)RESTful API詳解
- SpringMVC Restful api接口實現(xiàn)的代碼
- SpringMVC數(shù)據(jù)頁響應(yīng)ModelAndView實現(xiàn)頁面跳轉(zhuǎn)
- Spring MVC 文件、cookies的接收 與REST響應(yīng)詳解
相關(guān)文章
java數(shù)據(jù)結(jié)構(gòu)與算法之桶排序?qū)崿F(xiàn)方法詳解
這篇文章主要介紹了java數(shù)據(jù)結(jié)構(gòu)與算法之桶排序?qū)崿F(xiàn)方法,結(jié)合具體實例形式詳細分析了桶排序的概念、原理、實現(xiàn)方法與相關(guān)操作技巧,需要的朋友可以參考下2017-05-05java 查找list中重復(fù)數(shù)據(jù)實例詳解
這篇文章主要介紹了java 查找list中重復(fù)數(shù)據(jù)實例詳解的相關(guān)資料,需要的朋友可以參考下2017-01-01springboot之Validation參數(shù)校驗詳細解讀
這篇文章主要介紹了springboot之Validation參數(shù)校驗詳細解讀,本篇是關(guān)于springboot的參數(shù)校驗知識,當然也適用其它java應(yīng)用,讀完本篇將學會基本的參數(shù)校驗,自定義參數(shù)校驗和分組參數(shù)校驗,需要的朋友可以參考下2023-10-10