javascript
SpringMVC _Controller认识(1)
一、簡介
???????? 在SpringMVC中,控制器Controller負(fù)責(zé)處理由DispatcherServlet分發(fā)的請求,它把用戶請求的數(shù)據(jù)經(jīng)過業(yè)務(wù)處理層處理之后封裝成一個Model,然后再把該Model返回給對應(yīng)的View進(jìn)行展示。在SpringMVC中提供了一個非常簡便的定義Controller的方法,你無需繼承特定的類或?qū)崿F(xiàn)特定的接口,只需使用@Controller標(biāo)記一個類是Controller,然后使用@RequestMapping和@RequestParam等一些注解用以定義URL請求和Controller方法之間的映射,這樣的Controller就能被外界訪問到。此外Controller不會直接依賴于HttpServletRequest和HttpServletResponse等HttpServlet對象,它們可以通過Controller的方法參數(shù)靈活的獲取到。為了先對Controller有一個初步的印象,以下先定義一個簡單的Controller:
@Controller public?class?MyController?{@RequestMapping?(?"/showView"?)public?ModelAndView?showView()?{ModelAndView?modelAndView?=?new?ModelAndView();modelAndView.setViewName(?"viewName"?);modelAndView.addObject(?"?需要放到?model?中的屬性名稱?"?,?"?對應(yīng)的屬性值,它是一個對象?"?);return?modelAndView;}}在上面的示例中,@Controller是標(biāo)記在類MyController上面的,所以類MyController就是一個SpringMVC Controller對象了,然后使用@RequestMapping(“/showView”)標(biāo)記在Controller方法上,表示當(dāng)請求/showView.do的時候訪問的是MyController的showView方法,該方法返回了一個包括Model和View的ModelAndView對象。這些在后續(xù)都將會詳細(xì)介紹。
二、使用@Controller定義一個Controller控制器
???????? @Controller用于標(biāo)記在一個類上,使用它標(biāo)記的類就是一個SpringMVCController對象。分發(fā)處理器將會掃描使用了該注解的類的方法,并檢測該方法是否使用了@RequestMapping注解。@Controller只是定義了一個控制器類,而使用@RequestMapping注解的方法才是真正處理請求的處理器,這個接下來就會講到。
?? 單單使用@Controller標(biāo)記在一個類上還不能真正意義上的說它就是SpringMVC的一個控制器類,因為這個時候Spring還不認(rèn)識它。那么要如何做Spring才能認(rèn)識它呢?這個時候就需要我們把這個控制器類交給Spring來管理。拿MyController來舉一個例子
?
@Controller public?class?MyController?{@RequestMapping?(?"/showView"?)public?ModelAndView?showView()?{ModelAndView?modelAndView?=?new?ModelAndView();modelAndView.setViewName(?"viewName"?);modelAndView.addObject(?"?需要放到?model?中的屬性名稱?"?,?"?對應(yīng)的屬性值,它是一個對象?"?);return?modelAndView;}}這個時候有兩種方式可以把MyController交給Spring管理,好讓它能夠識別我們標(biāo)記的@Controller。
?? 第一種方式是在SpringMVC的配置文件中定義MyController的bean對象。
<beanclass="com.host.app.web.controller.MyController"/>
?? 第二種方式是在SpringMVC的配置文件中告訴Spring該到哪里去找標(biāo)記為@Controller的Controller控制器。
????<?context:component-scan?base-package?=?"com.host.app.web.controller"?><?context:exclude-filter?type?=?"annotation"expression?=?"org.springframework.stereotype.Service"?/></?context:component-scan?>注:
?????? 上面context:exclude-filter標(biāo)注的是不掃描@Service標(biāo)注的類
三、使用@RequestMapping來映射Request請求與處理器
???????? 可以使用@RequestMapping來映射URL到控制器類,或者是到Controller控制器的處理方法上。當(dāng)@RequestMapping標(biāo)記在Controller類上的時候,里面使用@RequestMapping標(biāo)記的方法的請求地址都是相對于類上的@RequestMapping而言的;當(dāng)Controller類上沒有標(biāo)記@RequestMapping注解時,方法上的@RequestMapping都是絕對路徑。這種絕對路徑和相對路徑所組合成的最終路徑都是相對于根路徑“/”而言的。
@Controller public?class?MyController?{@RequestMapping?(?"/showView"?)public?ModelAndView?showView()?{ModelAndView?modelAndView?=?new?ModelAndView();modelAndView.setViewName(?"viewName"?);modelAndView.addObject(?"?需要放到?model?中的屬性名稱?"?,?"?對應(yīng)的屬性值,它是一個對象?"?);return?modelAndView;}}在這個控制器中,因為MyController沒有被@RequestMapping標(biāo)記,所以當(dāng)需要訪問到里面使用了@RequestMapping標(biāo)記的showView方法時,就是使用的絕對路徑/showView.do請求就可以了。
@Controller @RequestMapping?(?"/test"?) public?class?MyController?{@RequestMapping?(?"/showView"?)public?ModelAndView?showView()?{ModelAndView?modelAndView?=?new?ModelAndView();modelAndView.setViewName(?"viewName"?);modelAndView.addObject(?"?需要放到?model?中的屬性名稱?"?,?"?對應(yīng)的屬性值,它是一個對象?"?);return?modelAndView;}}?
?? 這種情況是在控制器上加了@RequestMapping注解,所以當(dāng)需要訪問到里面使用了@RequestMapping標(biāo)記的方法showView()的時候就需要使用showView方法上@RequestMapping相對于控制器MyController上@RequestMapping的地址,即/test/showView.do。
(一)使用URI模板
?? URI模板就是在URI中給定一個變量,然后在映射的時候動態(tài)的給該變量賦值。如URI模板http://localhost/app/{variable1}/index.html,這個模板里面包含一個變量variable1,那么當(dāng)我們請求http://localhost/app/hello/index.html的時候,該URL就跟模板相匹配,只是把模板中的variable1用hello來取代。在SpringMVC中,這種取代模板中定義的變量的值也可以給處理器方法使用,這樣我們就可以非常方便的實現(xiàn)URL的RestFul風(fēng)格。這個變量在SpringMVC中是使用@PathVariable來標(biāo)記的。
?? 在SpringMVC中,我們可以使用@PathVariable來標(biāo)記一個Controller的處理方法參數(shù),表示該參數(shù)的值將使用URI模板中對應(yīng)的變量的值來賦值。
?
@Controller @RequestMapping?(?"/test/{variable1}"?) public?class?MyController?{@RequestMapping?(?"/showView/{variable2}"?)public?ModelAndView?showView(?@PathVariable?String?variable1,?@PathVariable?(?"variable2"?)?int?variable2)?{ModelAndView?modelAndView?=?new?ModelAndView();modelAndView.setViewName(?"viewName"?);modelAndView.addObject(?"?需要放到?model?中的屬性名稱?"?,?"?對應(yīng)的屬性值,它是一個對象?"?);return?modelAndView;} }?? 在上面的代碼中我們定義了兩個URI變量,一個是控制器類上的variable1,一個是showView方法上的variable2,然后在showView方法的參數(shù)里面使用@PathVariable標(biāo)記使用了這兩個變量。所以當(dāng)我們使用/test/hello/showView/2.do來請求的時候就可以訪問到MyController的showView方法,這個時候variable1就被賦予值hello,variable2就被賦予值2,然后我們在showView方法參數(shù)里面標(biāo)注了參數(shù)variable1和variable2是來自訪問路徑的path變量,這樣方法參數(shù)variable1和variable2就被分別賦予hello和2。方法參數(shù)variable1是定義為String類型,variable2是定義為int類型,像這種簡單類型在進(jìn)行賦值的時候Spring是會幫我們自動轉(zhuǎn)換的,關(guān)于復(fù)雜類型該如何來轉(zhuǎn)換在后續(xù)內(nèi)容中將會講到。
?? 在上面的代碼中我們可以看到在標(biāo)記variable1為path變量的時候我們使用的是@PathVariable,而在標(biāo)記variable2的時候使用的是@PathVariable(“variable2”)。這兩者有什么區(qū)別呢?第一種情況就默認(rèn)去URI模板中找跟參數(shù)名相同的變量,但是這種情況只有在使用debug模式進(jìn)行編譯的時候才可以,而第二種情況是明確規(guī)定使用的就是URI模板中的variable2變量。當(dāng)不是使用debug模式進(jìn)行編譯,或者是所需要使用的變量名跟參數(shù)名不相同的時候,就要使用第二種方式明確指出使用的是URI模板中的哪個變量。
?? 除了在請求路徑中使用URI模板,定義變量之外,@RequestMapping中還支持通配符“*”。如下面的代碼我就可以使用/myTest/whatever/wildcard.do訪問到Controller的testWildcard方法。
?
@Controller @RequestMapping?(?"/myTest"?) public?class?MyController?{@RequestMapping?(?"*/wildcard"?)public?String?testWildcard()?{System.?out?.println(?"wildcard------------"?);return?"wildcard"?;}?? }(二)使用@RequestParam綁定HttpServletRequest請求參數(shù)到控制器方法參數(shù)
????@RequestMapping?(?"requestParam"?)public?String?testRequestParam(?@RequestParam(required=false)?String?name,?@RequestParam?(?"age"?)?int?age)?{return?"requestParam"?;}在上面代碼中利用@RequestParam從HttpServletRequest中綁定了參數(shù)name到控制器方法參數(shù)name,綁定了參數(shù)age到控制器方法參數(shù)age。值得注意的是和@PathVariable一樣,當(dāng)你沒有明確指定從request中取哪個參數(shù)時,Spring在代碼是debug編譯的情況下會默認(rèn)取更方法參數(shù)同名的參數(shù),如果不是debug編譯的就會報錯。此外,當(dāng)需要從request中綁定的參數(shù)和方法的參數(shù)名不相同的時候,也需要在@RequestParam中明確指出是要綁定哪個參數(shù)。在上面的代碼中如果我訪問/requestParam.do?name=hello&age=1則Spring將會把request請求參數(shù)name的值hello賦給對應(yīng)的處理方法參數(shù)name,把參數(shù)age的值1賦給對應(yīng)的處理方法參數(shù)age。
在@RequestParam中除了指定綁定哪個參數(shù)的屬性value之外,還有一個屬性required,它表示所指定的參數(shù)是否必須在request屬性中存在,默認(rèn)是true,表示必須存在,當(dāng)不存在時就會報錯。在上面代碼中我們指定了參數(shù)name的required的屬性為false,而沒有指定age的required屬性,這時候如果我們訪問/requestParam.do而沒有傳遞參數(shù)的時候,系統(tǒng)就會拋出異常,因為age參數(shù)是必須存在的,而我們沒有指定。而如果我們訪問/requestParam.do?age=1的時候就可以正常訪問,因為我們傳遞了必須的參數(shù)age,而參數(shù)name是非必須的,不傳遞也可以。
(三)使用@CookieValue綁定cookie的值到Controller方法參數(shù)
????@RequestMapping?(?"cookieValue"?)public?String?testCookieValue(?@CookieValue?(?"hello"?)?String?cookieValue,?@CookieValue?String?hello)?{System.?out?.println(cookieValue?+?"-----------"?+?hello);return?"cookieValue"?;}?? 在上面的代碼中我們使用@CookieValue綁定了cookie的值到方法參數(shù)上。上面一共綁定了兩個參數(shù),一個是明確指定要綁定的是名稱為hello的cookie的值,一個是沒有指定。使用沒有指定的形式的規(guī)則和@PathVariable、@RequestParam的規(guī)則是一樣的,即在debug編譯模式下將自動獲取跟方法參數(shù)名同名的cookie值。
(四)使用@RequestHeader注解綁定HttpServletRequest頭信息到Controller方法參數(shù)
@RequestMapping?(?"testRequestHeader"?) public?String?testRequestHeader(?@RequestHeader?(?"Host"?)?String?hostAddr,?@RequestHeader?String?Host,?@RequestHeader?String?host?)?{System.?out?.println(hostAddr?+?"-----"?+?Host?+?"-----"?+?host?);return?"requestHeader"?; }???????? 在上面的代碼中我們使用了@RequestHeader綁定了HttpServletRequest請求頭host到Controller的方法參數(shù)。上面方法的三個參數(shù)都將會賦予同一個值,由此我們可以知道在綁定請求頭參數(shù)到方法參數(shù)的時候規(guī)則和@PathVariable、@RequestParam以及@CookieValue是一樣的,即沒有指定綁定哪個參數(shù)到方法參數(shù)的時候,在debug編譯模式下將使用方法參數(shù)名作為需要綁定的參數(shù)。但是有一點@RequestHeader跟另外三種綁定方式是不一樣的,那就是在使用@RequestHeader的時候是大小寫不敏感的,即@RequestHeader(“Host”)和@RequestHeader(“host”)綁定的都是Host頭信息。記住在@PathVariable、@RequestParam和@CookieValue中都是大小寫敏感的。
(五)@RequestMapping的一些高級應(yīng)用
???????? 在RequestMapping中除了指定請求路徑value屬性外,還有其他的屬性可以指定,如params、method和headers。這樣屬性都可以用于縮小請求的映射范圍。
?
1.params屬性
?
?? params屬性用于指定請求參數(shù)的,先看以下代碼。
????@RequestMapping?(value=?"testParams"?,?params={?"param1=value1"?,?"param2"?,?"!param3"?})public?String?testParams()?{System.?out?.println(?"test?Params..........."?);return?"testParams"?;}?? 在上面的代碼中我們用@RequestMapping的params屬性指定了三個參數(shù),這些參數(shù)都是針對請求參數(shù)而言的,它們分別表示參數(shù)param1的值必須等于value1,參數(shù)param2必須存在,值無所謂,參數(shù)param3必須不存在,只有當(dāng)請求/testParams.do并且滿足指定的三個參數(shù)條件的時候才能訪問到該方法。所以當(dāng)請求/testParams.do?param1=value1¶m2=value2的時候能夠正確訪問到該testParams方法,當(dāng)請求/testParams.do?param1=value1¶m2=value2¶m3=value3的時候就不能夠正常的訪問到該方法,因為在@RequestMapping的params參數(shù)里面指定了參數(shù)param3是不能存在的。
?
2.method屬性
?
?? method屬性主要是用于限制能夠訪問的方法類型的。
?
????@RequestMapping?(value=?"testMethod"?,?method={RequestMethod.?GET?,?RequestMethod.?DELETE?})public?String?testMethod()?{return?"method"?;}在上面的代碼中就使用method參數(shù)限制了以GET或DELETE方法請求/testMethod.do的時候才能訪問到該Controller的testMethod方法。
?
3.headers屬性
?
???????? 使用headers屬性可以通過請求頭信息來縮小@RequestMapping的映射范圍。
????@RequestMapping?(value=?"testHeaders"?,?headers={?"host=localhost"?,?"Accept"?})public?String?testHeaders()?{return?"headers"?;}?
?? headers屬性的用法和功能與params屬性相似。在上面的代碼中當(dāng)請求/testHeaders.do的時候只有當(dāng)請求頭包含Accept信息,且請求的host為localhost的時候才能正確的訪問到testHeaders方法。
(六)以@RequestMapping標(biāo)記的處理器方法支持的方法參數(shù)和返回類型
1.支持的方法參數(shù)類型
???????? (1)HttpServlet對象,主要包括HttpServletRequest、HttpServletResponse和HttpSession對象。這些參數(shù)Spring在調(diào)用處理器方法的時候會自動給它們賦值,所以當(dāng)在處理器方法中需要使用到這些對象的時候,可以直接在方法上給定一個方法參數(shù)的申明,然后在方法體里面直接用就可以了。但是有一點需要注意的是在使用HttpSession對象的時候,如果此時HttpSession對象還沒有建立起來的話就會有問題。
?? (2)Spring自己的WebRequest對象。使用該對象可以訪問到存放在HttpServletRequest和HttpSession中的屬性值。
?? (3)InputStream、OutputStream、Reader和Writer。InputStream和Reader是針對HttpServletRequest而言的,可以從里面取數(shù)據(jù);OutputStream和Writer是針對HttpServletResponse而言的,可以往里面寫數(shù)據(jù)。
?? (4)使用@PathVariable、@RequestParam、@CookieValue和@RequestHeader標(biāo)記的參數(shù)。
?? (5)使用@ModelAttribute標(biāo)記的參數(shù)。
?? (6)java.util.Map、Spring封裝的Model和ModelMap。這些都可以用來封裝模型數(shù)據(jù),用來給視圖做展示。
?? (7)實體類。可以用來接收上傳的參數(shù)。
?? (8)Spring封裝的MultipartFile。用來接收上傳文件的。
?? (9)Spring封裝的Errors和BindingResult對象。這兩個對象參數(shù)必須緊接在需要驗證的實體對象參數(shù)之后,它里面包含了實體對象的驗證結(jié)果。
2.支持的返回類型
???????? (1)一個包含模型和視圖的ModelAndView對象。
?? (2)一個模型對象,這主要包括Spring封裝好的Model和ModelMap,以及java.util.Map,當(dāng)沒有視圖返回的時候視圖名稱將由RequestToViewNameTranslator來決定。
?? (3)一個View對象。這個時候如果在渲染視圖的過程中模型的話就可以給處理器方法定義一個模型參數(shù),然后在方法體里面往模型中添加值。
?? (4)一個String字符串。這往往代表的是一個視圖名稱。這個時候如果需要在渲染視圖的過程中需要模型的話就可以給處理器方法一個模型參數(shù),然后在方法體里面往模型中添加值就可以了。
?? (5)返回值是void。這種情況一般是我們直接把返回結(jié)果寫到HttpServletResponse中了,如果沒有寫的話,那么Spring將會利用RequestToViewNameTranslator來返回一個對應(yīng)的視圖名稱。如果視圖中需要模型的話,處理方法與返回字符串的情況相同。
?? (6)如果處理器方法被注解@ResponseBody標(biāo)記的話,那么處理器方法的任何返回類型都會通過HttpMessageConverters轉(zhuǎn)換之后寫到HttpServletResponse中,而不會像上面的那些情況一樣當(dāng)做視圖或者模型來處理。
?? (7)除以上幾種情況之外的其他任何返回類型都會被當(dāng)做模型中的一個屬性來處理,而返回的視圖還是由RequestToViewNameTranslator來決定,添加到模型中的屬性名稱可以在該方法上用@ModelAttribute(“attributeName”)來定義,否則將使用返回類型的類名稱的首字母小寫形式來表示。使用@ModelAttribute標(biāo)記的方法會在@RequestMapping標(biāo)記的方法執(zhí)行之前執(zhí)行。
(七)使用@ModelAttribute和@SessionAttributes傳遞和保存數(shù)據(jù)
?????? SpringMVC支持使用@ModelAttribute和@SessionAttributes在不同的模型和控制器之間共享數(shù)據(jù)。@ModelAttribute主要有兩種使用方式,一種是標(biāo)注在方法上,一種是標(biāo)注在Controller方法參數(shù)上。
當(dāng)@ModelAttribute標(biāo)記在方法上的時候,該方法將在處理器方法執(zhí)行之前執(zhí)行,然后把返回的對象存放在session或模型屬性中,屬性名稱可以使用@ModelAttribute(“attributeName”)在標(biāo)記方法的時候指定,若未指定,則使用返回類型的類名稱(首字母小寫)作為屬性名稱。關(guān)于@ModelAttribute標(biāo)記在方法上時對應(yīng)的屬性是存放在session中還是存放在模型中,我們來做一個實驗,看下面一段代碼。
@Controller @RequestMapping?(?"/myTest"?) public?class?MyController?{@ModelAttribute?(?"hello"?)public?String?getModel()?{System.?out?.println(?"-------------Hello---------"?);return?"world"?;}@ModelAttribute?(?"intValue"?)public?int?getInteger()?{System.?out?.println(?"-------------intValue---------------"?);return?10;}@RequestMapping?(?"sayHello"?)public?void?sayHello(?@ModelAttribute?(?"hello"?)?String?hello,?@ModelAttribute?(?"intValue"?)?int?num,?@ModelAttribute?(?"user2"?)?User?user,?Writer?writer,?HttpSession?session)?throws?IOException?{writer.write(?"Hello?"?+?hello?+?"?,?Hello?"?+?user.getUsername()?+?num);writer.write(?"\r"?);Enumeration?enume?=?session.getAttributeNames();while?(enume.hasMoreElements())writer.write(enume.nextElement()?+?"\r"?);}@ModelAttribute?(?"user2"?)public?User?getUser()?{System.?out?.println(?"---------getUser-------------"?);return?new?User(3,?"user2"?);} }當(dāng)我們請求/myTest/sayHello.do的時候使用@ModelAttribute標(biāo)記的方法會先執(zhí)行,然后把它們返回的對象存放到模型中。最終訪問到sayHello方法的時候,使用@ModelAttribute標(biāo)記的方法參數(shù)都能被正確的注入值。執(zhí)行結(jié)果如下圖所示:
?????? 由執(zhí)行結(jié)果我們可以看出來,此時session中沒有包含任何屬性,也就是說上面的那些對象都是存放在模型屬性中,而不是存放在session屬性中。那要如何才能存放在session屬性中呢?這個時候我們先引入一個新的概念@SessionAttributes,它的用法會在講完@ModelAttribute之后介紹,這里我們就先拿來用一下。我們在MyController類上加上@SessionAttributes屬性標(biāo)記哪些是需要存放到session中的。看下面的代碼:
@Controller @RequestMapping?(?"/myTest"?) @SessionAttributes?(value={?"intValue"?,?"stringValue"?},?types={User.?class?}) public?class?MyController?{@ModelAttribute?(?"hello"?)public?String?getModel()?{System.?out?.println(?"-------------Hello---------"?);return?"world"?;}@ModelAttribute?(?"intValue"?)public?int?getInteger()?{System.?out?.println(?"-------------intValue---------------"?);return?10;}@RequestMapping?(?"sayHello"?)public?void?sayHello(Map<String,?Object>?map,?@ModelAttribute?(?"hello"?)?String?hello,?@ModelAttribute?(?"intValue"?)?int?num,?@ModelAttribute?(?"user2"?)?User?user,?Writer?writer,?HttpServletRequest?request)?throws?IOException?{map.put(?"stringValue"?,?"String"?);writer.write(?"Hello?"?+?hello?+?"?,?Hello?"?+?user.getUsername()?+?num);writer.write(?"\r"?);HttpSession?session?=?request.getSession();Enumeration?enume?=?session.getAttributeNames();while?(enume.hasMoreElements())writer.write(enume.nextElement()?+?"\r"?);System.?out?.println(session);}@ModelAttribute?(?"user2"?)public?User?getUser()?{System.?out?.println(?"---------getUser-------------"?);return?new?User(3,?"user2"?);} }?? 在上面代碼中我們指定了屬性為intValue或stringValue或者類型為User的都會放到Session中,利用上面的代碼當(dāng)我們訪問/myTest/sayHello.do的時候,結(jié)果如下:
?????? 仍然沒有打印出任何session屬性,這是怎么回事呢?怎么定義了把模型中屬性名為intValue的對象和類型為User的對象存到session中,而實際上沒有加進(jìn)去呢?難道我們錯啦?我們當(dāng)然沒有錯,只是在第一次訪問/myTest/sayHello.do的時候@SessionAttributes定義了需要存放到session中的屬性,而且這個模型中也有對應(yīng)的屬性,但是這個時候還沒有加到session中,所以session中不會有任何屬性,等處理器方法執(zhí)行完成后Spring才會把模型中對應(yīng)的屬性添加到session中。所以當(dāng)請求第二次的時候就會出現(xiàn)如下結(jié)果:
當(dāng)@ModelAttribute標(biāo)記在處理器方法參數(shù)上的時候,表示該參數(shù)的值將從模型或者Session中取對應(yīng)名稱的屬性值,該名稱可以通過@ModelAttribute(“attributeName”)來指定,若未指定,則使用參數(shù)類型的類名稱(首字母小寫)作為屬性名稱。
@Controller @RequestMapping?(?"/myTest"?) public?class?MyController?{@ModelAttribute?(?"hello"?)public?String?getModel()?{return?"world"?;}@RequestMapping?(?"sayHello"?)public?void?sayHello(?@ModelAttribute?(?"hello"?)?String?hello,?Writer?writer)?throws?IOException?{writer.write(?"Hello?"?+?hello);}??? }在上面代碼中,當(dāng)我們請求/myTest/sayHello.do的時候,由于MyController中的方法getModel使用了注解@ModelAttribute進(jìn)行標(biāo)記,所以在執(zhí)行請求方法sayHello之前會先執(zhí)行g(shù)etModel方法,這個時候getModel方法返回一個字符串world并把它以屬性名hello保存在模型中,接下來訪問請求方法sayHello的時候,該方法的hello參數(shù)使用@ModelAttribute(“hello”)進(jìn)行標(biāo)記,這意味著將從session或者模型中取屬性名稱為hello的屬性值賦給hello參數(shù),所以這里hello參數(shù)將被賦予值world,所以請求完成后將會在頁面上看到Hello world字符串。
@SessionAttributes用于標(biāo)記需要在Session中使用到的數(shù)據(jù),包括從Session中取數(shù)據(jù)和存數(shù)據(jù)。@SessionAttributes一般是標(biāo)記在Controller類上的,可以通過名稱、類型或者名稱加類型的形式來指定哪些屬性是需要存放在session中的。
@Controller @RequestMapping?(?"/myTest"?) @SessionAttributes?(value={?"user1"?,?"blog1"?},?types={User.?class?,?Blog.?class?}) public?class?MyController?{@RequestMapping?(?"setSessionAttribute"?)public?void?setSessionAttribute(Map<String,?Object>?map,?Writer?writer)?throws?IOException?{User?user?=?new?User(1,?"user"?);User?user1?=?new?User(2,?"user1"?);Blog?blog?=?new?Blog(1,?"blog"?);Blog?blog1?=?new?Blog(2,?"blog1"?);map.put(?"user"?,?user);map.put(?"user1"?,?user1);map.put(?"blog"?,?blog);map.put(?"blog1"?,?blog1);writer.write(?"over."?);}@RequestMapping?(?"useSessionAttribute"?)public?void?useSessionAttribute(Writer?writer,?@ModelAttribute?(?"user1"?)?User?user1,?@ModelAttribute?(?"blog1"?)?Blog?blog1)?throws?IOException?{writer.write(user1.getId()?+?"--------"?+?user1.getUsername());writer.write(?"\r"?);writer.write(blog1.getId()?+?"--------"?+?blog1.getTitle());}@RequestMapping?(?"useSessionAttribute2"?)public?void?useSessionAttribute(Writer?writer,?@ModelAttribute?(?"user1"?)?User?user1,?@ModelAttribute?(?"blog1"?)?Blog?blog1,?@ModelAttribute?User?user,?HttpSession?session)?throws?IOException?{writer.write(user1.getId()?+?"--------"?+?user1.getUsername());writer.write(?"\r"?);writer.write(blog1.getId()?+?"--------"?+?blog1.getTitle());writer.write(?"\r"?);writer.write(user.getId()?+?"---------"?+?user.getUsername());writer.write(?"\r"?);Enumeration?enume?=?session.getAttributeNames();while?(enume.hasMoreElements())writer.write(enume.nextElement()?+?"?\r"?);}@RequestMapping?(?"useSessionAttribute3"?)public?void?useSessionAttribute(?@ModelAttribute?(?"user2"?)?User?user)?{} }?
?? 在上面代碼中我們可以看到在MyController上面使用了@SessionAttributes標(biāo)記了需要使用到的Session屬性。可以通過名稱和類型指定需要存放到Session中的屬性,對應(yīng)@SessionAttributes注解的value和types屬性。當(dāng)使用的是types屬性的時候,那么使用的Session屬性名稱將會是對應(yīng)類型的名稱(首字母小寫)。當(dāng)value和types兩個屬性都使用到了的時候,這時候取的是它們的并集,而不是交集,所以上面代碼中指定要存放在Session中的屬性有名稱為user1或blog1的對象,或類型為User或Blog的對象。在上面代碼中我們首先訪問/myTest/setSessionAttribute.do,該請求將會請求到MyController的setSessionAttribute方法,在該方法中,我們往模型里面添加了user、user1、blog和blog1四個屬性,因為它們或跟類上的@SessionAttributes定義的需要存到session中的屬性名稱相同或類型相同,所以在請求完成后這四個屬性都將添加到session屬性中。接下來訪問/myTest/useSessionAttribute.do,該請求將會請求MyController的useSessionAttribute(Writerwriter, @ModelAttribute(“user1”) User user1, @ModelAttribute(“blog1”) Blog blog)方法,該方法參數(shù)中用@ModelAttribute指定了參數(shù)user1和參數(shù)blog1是需要從session或模型中綁定的,恰好這個時候session中已經(jīng)有了這兩個屬性,所以這個時候在方法執(zhí)行之前會先綁定這兩個參數(shù)。執(zhí)行結(jié)果如下圖所示:
?? 接下來訪問/myTest/useSessionAttribute2.do,這個時候請求的是上面代碼中對應(yīng)的第二個useSessionAttribute方法,方法參數(shù)user、user1和blog1用@ModelAttribute聲明了需要session或模型屬性注入,我們知道在請求/myTest/setSessionAttribute.do的時候這些屬性都已經(jīng)添加到了session中,所以該請求的結(jié)果會如下圖所示:
?? 接下來訪問/myTest/useSessionAttribute3.do,這個時候請求的是上面代碼中對應(yīng)的第三個useSessionAttribute方法,我們可以看到該方法的方法參數(shù)user使用了@ModelAttribute(“user2”)進(jìn)行標(biāo)記,表示user需要session中的user2屬性來注入,但是這個時候我們知道session中是不存在user2屬性的,所以這個時候就會報錯了。執(zhí)行結(jié)果如圖所示:
(八)定制自己的類型轉(zhuǎn)換器
???????? 在通過處理器方法參數(shù)接收request請求參數(shù)綁定數(shù)據(jù)的時候,對于一些簡單的數(shù)據(jù)類型Spring會幫我們自動進(jìn)行類型轉(zhuǎn)換,而對于一些復(fù)雜的類型由于Spring沒法識別,所以也就不能幫助我們進(jìn)行自動轉(zhuǎn)換了,這個時候如果我們需要Spring來幫我們自動轉(zhuǎn)換的話就需要我們給Spring注冊一個對特定類型的識別轉(zhuǎn)換器。Spring允許我們提供兩種類型的識別轉(zhuǎn)換器,一種是注冊在Controller中的,一種是注冊在SpringMVC的配置文件中。聰明的讀者看到這里應(yīng)該可以想到它們的區(qū)別了,定義在Controller中的是局部的,只在當(dāng)前Controller中有效,而放在SpringMVC配置文件中的是全局的,所有Controller都可以拿來使用。
1.在@InitBinder標(biāo)記的方法中定義局部的類型轉(zhuǎn)換器
???????? 我們可以使用@InitBinder注解標(biāo)注在Controller方法上,然后在方法體里面注冊數(shù)據(jù)綁定的轉(zhuǎn)換器,這主要是通過WebDataBinder進(jìn)行的。我們可以給需要注冊數(shù)據(jù)綁定的轉(zhuǎn)換器的方法一個WebDataBinder參數(shù),然后給該方法加上@InitBinder注解,這樣當(dāng)該Controller中在處理請求方法時如果發(fā)現(xiàn)有不能解析的對象的時候,就會看該類中是否有使用@InitBinder標(biāo)記的方法,如果有就會執(zhí)行該方法,然后看里面定義的類型轉(zhuǎn)換器是否與當(dāng)前需要的類型匹配。
@Controller @RequestMapping?(?"/myTest"?) public?class?MyController?{@InitBinderpublic?void?dataBinder(WebDataBinder?binder)?{DateFormat?dateFormat?=?new?SimpleDateFormat(?"yyyyMMdd"?);PropertyEditor?propertyEditor?=?new?CustomDateEditor(dateFormat,?true?);?//?第二個參數(shù)表示是否允許為空binder.registerCustomEditor(Date.?class?,?propertyEditor);}@RequestMapping?(?"dataBinder/{date}"?)public?void?testDate(?@PathVariable?Date?date,?Writer?writer)?throws?IOException?{writer.write(String.valueOf?(date.getTime()));}}?????? 在上面的代碼中當(dāng)我們請求/myTest/dataBinder/20121212.do的時候,Spring就會利用@InitBinder標(biāo)記的方法里面定義的類型轉(zhuǎn)換器把字符串20121212轉(zhuǎn)換為一個Date對象。這樣定義的類型轉(zhuǎn)換器是局部的類型轉(zhuǎn)換器,一旦出了這個Controller就不會再起作用。類型轉(zhuǎn)換器是通過WebDataBinder對象的registerCustomEditor方法來注冊的,要實現(xiàn)自己的類型轉(zhuǎn)換器就要實現(xiàn)自己的PropertyEditor對象。Spring已經(jīng)給我們提供了一些常用的屬性編輯器,如CustomDateEditor、CustomBooleanEditor等。
?????? PropertyEditor是一個接口,要實現(xiàn)自己的PropertyEditor類我們可以實現(xiàn)這個接口,然后實現(xiàn)里面的方法。但是PropertyEditor里面定義的方法太多了,這樣做比較麻煩。在java中有一個封裝類是實現(xiàn)了PropertyEditor接口的,它是PropertyEditorSupport類。所以如果需要實現(xiàn)自己的PropertyEditor的時候只需要繼承PropertyEditorSupport類,然后重寫其中的一些方法。一般就是重寫setAsText和getAsText方法就可以了,setAsText方法是用于把字符串類型的值轉(zhuǎn)換為對應(yīng)的對象的,而getAsText方法是用于把對象當(dāng)做字符串來返回的。在setAsText中我們一般先把字符串類型的對象轉(zhuǎn)為特定的對象,然后利用PropertyEditor的setValue方法設(shè)定轉(zhuǎn)換后的值。在getAsText方法中一般先使用getValue方法取代當(dāng)前的對象,然后把它轉(zhuǎn)換為字符串后再返回給getAsText方法。下面是一個示例:
????@InitBinderpublic?void?dataBinder(WebDataBinder?binder)?{//?定義一個?User?屬性編輯器PropertyEditor?userEditor?=?new?PropertyEditorSupport()?{@Overridepublic?String?getAsText()?{//?TODO?Auto-generated?method?stubUser?user?=?(User)?getValue();return?user.getUsername();}@Overridepublic?void?setAsText(String?userStr)?throws?IllegalArgumentException?{//?TODO?Auto-generated?method?stubUser?user?=?new?User(1,?userStr);setValue(user);}};//?使用?WebDataBinder?注冊?User?類型的屬性編輯器binder.registerCustomEditor(User.?class?,?userEditor);}??
2.實現(xiàn)WebBindingInitializer接口定義全局的類型轉(zhuǎn)換器
?????? 如果需要定義全局的類型轉(zhuǎn)換器就需要實現(xiàn)自己的WebBindingInitializer對象,然后把該對象注入到AnnotationMethodHandlerAdapter中,這樣Spring在遇到自己不能解析的對象的時候就會到全局的WebBindingInitializer的initBinder方法中去找,每次遇到不認(rèn)識的對象時,initBinder方法都會被執(zhí)行一遍。
public?class?MyWebBindingInitializer?implements?WebBindingInitializer?{@Overridepublic?void?initBinder(WebDataBinder?binder,?WebRequest?request)?{//?TODO?Auto-generated?method?stubDateFormat?dateFormat?=?new?SimpleDateFormat(?"yyyyMMdd"?);PropertyEditor?propertyEditor?=?new?CustomDateEditor(dateFormat,?true?);binder.registerCustomEditor(Date.?class?,?propertyEditor);}}定義了這么一個WebBindingInitializer對象之后Spring還是不能識別其中指定的對象,這是因為我們只是定義了WebBindingInitializer對象,還沒有把它交給Spring,Spring不知道該去×××解析器。要讓Spring能夠識別還需要我們在SpringMVC的配置文件中定義一個AnnotationMethodHandlerAdapter類型的bean對象,然后利用自己定義的WebBindingInitializer覆蓋它的默認(rèn)屬性webBindingInitializer。
?
????<?bean?class?=?"org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter"?><?property?name?=?"webBindingInitializer"?><?bean?class?=?"com.host.app.web.util.MyWebBindingInitializer"?/></?property?></?bean?>?
3.觸發(fā)數(shù)據(jù)綁定方法的時間
當(dāng)Controller處理器方法參數(shù)使用@RequestParam、 @PathVariable、@RequestHeader、@CookieValue和@ModelAttribute標(biāo)記的時候都會觸發(fā) initBinder方法的執(zhí)行,這包括使用WebBindingInitializer定義的全局方法和在Controller中使用 @InitBinder標(biāo)記的局部方法。而且每個使用了這幾個注解標(biāo)記的參數(shù)都會觸發(fā)一次initBinder方法的執(zhí)行,這也意味著有幾個參數(shù)使用了上 述注解就會觸發(fā)幾次initBinder方法的執(zhí)行。
?
轉(zhuǎn)載于:https://blog.51cto.com/wuwen2011/1567879
總結(jié)
以上是生活随笔為你收集整理的SpringMVC _Controller认识(1)的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Lucene工具箱之OpenBitSet
- 下一篇: Reveal使用步骤和 破解Reveal