Spring MVC:基于注解的MVC（上）

2019-11-10 20:04:26

字體：大中小

供稿：網(wǎng)友

本文轉(zhuǎn)自：http://www.cnblogs.com/xrq730/p/5342650.html

什么是SPRing MVC

Spring MVC框架是一個(gè)MVC框架，通過(guò)實(shí)現(xiàn)Model-View-Controller模式來(lái)很好地將數(shù)據(jù)、業(yè)務(wù)與展現(xiàn)進(jìn)行分離。從這樣一個(gè)角度來(lái)說(shuō)，Spring MVC和Structs、Structs2非常類(lèi)似。Spring MVC的設(shè)計(jì)是圍繞DispatcherServlet展開(kāi)的，DispatcherServlet負(fù)責(zé)將請(qǐng)求派發(fā)到特定的handler。通過(guò)可配置的hander mappings、view resolution、locale以及theme resolution來(lái)處理請(qǐng)求并且轉(zhuǎn)到對(duì)應(yīng)的視圖。Spring MVC請(qǐng)求處理的整體流程如圖：

Spring MVC有基于注解版與基礎(chǔ).xml版的兩種用法，不過(guò)現(xiàn)在的企業(yè)級(jí)開(kāi)發(fā)基本都使用的是注解版，沒(méi)別的原因，就是方便而已。因此后面的代碼示例，都是基于注解版本的，想了解基于.xml版本的Spring MVC的朋友可以自行上網(wǎng)查詢(xún)。

Spring MVC環(huán)境搭建

要開(kāi)始本文后面的內(nèi)容，自然要搭建一個(gè)Spring MVC的環(huán)境，那么首先建立一個(gè)java Web的工程，我建立的工程名字叫做SpringMVC，要搭建一個(gè)基礎(chǔ)功能的Spring MVC環(huán)境，必須引入的jar包是beans、context、core、expression、web、webmvc以及commons-logging。

然后，對(duì)web.xml添加一些內(nèi)容：

<?xml version="1.0" encoding="UTF-8"?><web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> <display-name></display-name> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list>  <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener>  <listener> <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class> </listener>  <servlet> <servlet-name>springmvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:springmvc-servlet.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>springmvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping></web-app>

兩個(gè)listener不是必須的，但是servlet是必須的，url-pattern用于開(kāi)發(fā)者選擇哪些路徑是需要讓Spring MVC來(lái)處理的。接著在classpath下按照我們約定的名字springmvc-servlet.xml寫(xiě)一個(gè)xml文件：

<?xml version="1.0" encoding="UTF-8"?><beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.springframework.org/schema/beans" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.2.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd"> <context:annotation-config /> <context:component-scan base-package="com.xrq.controller"/>  <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">  <property name="prefix" value="/" />  <property name="suffix" value=".jsp" /> </bean> </beans>

另外，由于使用了Spring，所以Tomcat啟動(dòng)的時(shí)候默認(rèn)會(huì)去WEB-INF下找applicationContext.xml，所以放一個(gè)空的applicationContext.xml到WEB-INF下：

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://www.springframework.org/schema/beans    http://www.springframework.org/schema/beans/spring-beans-4.2.xsd">    </beans>寫(xiě)一個(gè)Java POJO，用于處理具體的請(qǐng)求：
@Controller@RequestMapping(value = "/test")public class TestController{    @RequestMapping    public String dispatchTest()    {        System.out.println("Enter TestController.dispatchTest");        return "test";    }}注意，這里有一個(gè)@Controller，這個(gè)注解和@Service注解意思差不多，都表示該類(lèi)是一個(gè)Spring Bean，這樣就不需要再在Spring文件中為這個(gè)類(lèi)定義Bean了。
另外，由于我前面在springmvc-servlet.xml中配置了prefix和suffix，因此return的時(shí)候就可以方便一些，不需要寫(xiě)前綴和后綴，Spring MVC默認(rèn)會(huì)轉(zhuǎn)發(fā)到（請(qǐng)求轉(zhuǎn)發(fā)是Spring MVC默認(rèn)的頁(yè)面跳轉(zhuǎn)方式）"/test.jsp"路徑下。
最后別忘了，因?yàn)樵趙eb.xml中設(shè)置了啟動(dòng)激活Spring，因此還需要寫(xiě)一個(gè)applicationContext.xml（Spring文件的默認(rèn)名字），當(dāng)然，里面除了基本的聲明，什么實(shí)際內(nèi)容都不需要。最終，WebRoot文件夾應(yīng)該是這么一個(gè)結(jié)構(gòu)：
最后，啟動(dòng)容器，訪問(wèn)"localhost:8080/SpringMVC/test"，容器就會(huì)把該請(qǐng)求轉(zhuǎn)發(fā)到"localhost:8080/SpringMVC/test.jsp"頁(yè)面下了。
 
@RequestMapping注解
Spring MVC中最重要的注解應(yīng)該就是@RequestMapping了，它是用于處理請(qǐng)求映射的。繼續(xù)看剛才的TestController：
@Controller@RequestMapping(value = "/test")public class TestController{    @RequestMapping    public String dispatchTest()    {        System.out.println("Enter TestController.dispatchTest()");        return "test";    }}類(lèi)上的RequestMapping是用于第一層匹配的。"localhost:8080/SpringMVC/test"和"localhost:8080/SpringMVC/add"，value是test，自然走的是前者。
接著看，比如我在TestController中又定義了三個(gè)方法，此時(shí)類(lèi)上不使用RequestMapping注解：
@RequestMapping(value = "/add")public String dispatchAddTest(){    System.out.println("Enter TestControll.dispatchAddTest()");    return "test";}    @RequestMapping(value = "/add/add")public String dispatchAddAddTest(){    System.out.println("Enter TestControll.dispatchAddAddTest()");    return "test";}@RequestMapping(value = "/del")public String dispatchDelTest(){    System.out.println("Enter TestControll.dispatchDelTest()");    return "test";}那么這三個(gè)方法分別匹配的路徑是：
"localhost:8080/SpringMVC/add""localhost:8080/SpringMVC/add/add""localhost:8080/SpringMVC/del"關(guān)于路徑匹配，再提一點(diǎn)，假如在類(lèi)上和方法上都加了RequestMapping，那么將會(huì)以類(lèi)路徑為基準(zhǔn)，再向方法路徑做匹配，比如：
@Controller@RequestMapping(value = "/test/")public class TestController{    @RequestMapping(value = "common")    public String root()    {        System.out.println("Enter TestController.root()!");        return "result";    }}這種寫(xiě)法，匹配的應(yīng)當(dāng)是：
"localhost:8080/SpringMVC/test/common""localhost:8080/SpringMVC/test/common/""localhost:8080/SpringMVC/test/common.html""localhost:8080/SpringMVC/test/common.jsp""localhost:8080/SpringMVC/test/common.vm"類(lèi)似這種的路徑，如果還想往"localhost:8080/SpringMVC/test/common/"再添加內(nèi)容，那么root()這個(gè)方法就無(wú)法匹配到了，必須再添加方法。多說(shuō)一句，"/"一直是一個(gè)容易弄混的東西，我自己試驗(yàn)的時(shí)候發(fā)現(xiàn)，RequestMapping里面的value屬性，只要路徑不存在多級(jí)的關(guān)系，加不加"/"是沒(méi)有什么影響的。
另外，@RequestMapping還可以匹配請(qǐng)求類(lèi)型，到底是GET還是POST還是其他的，這么做：
@RequestMapping(method = RequestMethod.POST)public String dispatchTest(){    System.out.println("Enter TestController.dispatchTest()");    return "test";}這樣就指定了該方法只匹配"localhost:8080/SpringMVC/test"且請(qǐng)求方式為POST的請(qǐng)求。
前面頁(yè)面跳轉(zhuǎn)的方式都是轉(zhuǎn)發(fā)（dispatch）的方式，轉(zhuǎn)發(fā)在我看來(lái)未必是一種很好的方式，典型的就是處理表單的時(shí)候會(huì)有表單重復(fù)提交的問(wèn)題，那么如何使用重定向（redirect）的方式進(jìn)行頁(yè)面跳轉(zhuǎn)？可以這么寫(xiě)Controller的方法，差別在于return部分：
@RequestMappingpublic String dispatchTest(Test test){    System.out.println("Enter TestController.dispatchTest(), test: " + test);    return "redirect:/test.jsp";}最后，@RequestMapping中還有params、headers、consumes等幾個(gè)屬性，不過(guò)這幾個(gè)都不重要，也不常用，就不講了。
 
參數(shù)匹配
處理url也好、表單提交也好，參數(shù)匹配是非常重要的一個(gè)內(nèi)容，萬(wàn)幸，Spring MVC對(duì)參數(shù)請(qǐng)求的支持做得非常好----它會(huì)自動(dòng)根據(jù)url或者表單中參數(shù)的名字和方法中同名形參進(jìn)行匹配并賦值。
舉一個(gè)例子：
@Controller@RequestMapping(value = "/test")public class TestController{    @RequestMapping    public String dispatchTest(String testId, String ttestId)    {        System.out.println("Enter TestController.dispatchTest(), testId = " + testId +                 ", ttestId = " + ttestId);        return "test";    }}此時(shí)，我訪問(wèn)"localhost:8080/SpringMVC/test?testId=1&ttestId=2"，控制臺(tái)打印出：
Enter TestController.dispatchTest(), testId = 2, ttestId = 3不僅如此，方法中還可以放入一個(gè)實(shí)體類(lèi)對(duì)象：
public class Test{    private String tid;    private String nid;    private String bid;        public void setTid(String tid)    {        this.tid = tid;    }        public void setNid(String nid)    {        this.nid = nid;    }        public void setBid(String bid)    {        this.bid = bid;    }        public String toString()    {        return "tid = " + tid + ", nid = " + nid + ", bid = " + bid;    }}注意，實(shí)體類(lèi)對(duì)象中如果私有屬性不打算對(duì)外提供，getter可以沒(méi)有，但是為了Spring MVC可以將對(duì)應(yīng)的屬性根據(jù)屬性名稱(chēng)進(jìn)行匹配并賦值，setter必須要有。把TestController稍作改造，傳入一個(gè)對(duì)象：
@RequestMappingpublic String dispatchTest(Test test){    System.out.println("Enter TestController.dispatchTest(), test: " + test);    return "test";}此時(shí)我訪問(wèn)"http://localhost:8080/SpringMVC/test?tid=0&bid=1&nid=2"，控制臺(tái)上打印出：
Enter TestController.dispatchTest(), test: tid = 0, nid = 2, bid = 1看到，參數(shù)完全匹配。
不僅如此，再多試驗(yàn)一點(diǎn)：
@RequestMappingpublic String dispatchTest(Test test1, Test test2, String tid, String nid){    System.out.println("Enter TestController.dispatchTest(), test1：" + test1 +             "; test2：" + test2 + "; tid：" + tid + "; nid：" + nid);    return "test";}訪問(wèn)一樣地址"http://localhost:8080/SpringMVC/test?tid=0&bid=1&nid=2"，結(jié)果是：
Enter TestController.dispatchTest(), test1：tid = 0, nid = 2, bid = 1; test2：tid = 0, nid = 2, bid = 1; tid：0; nid：2結(jié)論就是：
假如方法的參數(shù)是普通的字符串，只要字符串名字有和請(qǐng)求參數(shù)中的key完全匹配的，Spring MVC就會(huì)將完全匹配的自動(dòng)賦值假如方法的參數(shù)是實(shí)體類(lèi)，只要實(shí)體類(lèi)中的參數(shù)有和請(qǐng)求參數(shù)中的key完全匹配的，Spring MVC就會(huì)將完全匹配的自動(dòng)賦值對(duì)于url如此，應(yīng)用到表單中也是一樣的，有興趣的可以自己試驗(yàn)一下。