Java Web系列:Spring MVC 基礎
1.Web MVC基礎
MVC的本質是表現層模式,我們以視圖模型為中心,將視圖和控制器分離出來。就如同分層模式一樣,我們以業務邏輯為中心,把表現層和數據訪問層代碼分離出來是一樣的方法。框架只能在技術層面上給我們幫助,無法在思考和過程上幫助我們,而我們很多人都不喜歡思考和嘗試。
2.實現Web MVC的基礎
實現Web MVC基礎可以概括為1個前段控制器和2個映射。
(1)前端控制器FrontController
ASP.NET和JSP都是以Page路徑和URL一一對應,Web MVC要通過URL映射Controller和View,就需要一個前端控制器統一接收和解析請求,再根據的URL將請求分發到Controller。由于ASP.NET和Java分別以IHttpHandler和Servlet作為核心,因此ASP.NET MVC和Spring MVC分別使用實現了對應接口的 MvcHandler 和 DispatcherServlet 作為前段控制器。
ASP.NET中通過HttpModule的實現類處理URL映射,UrlRoutingModule根據URL將請求轉發給前端控制器MvcHandler。Spring MVC中,則根據URL的配置,直接將請求轉發給前端控制器DispatcherServlet。
(2)URL和Contrller的映射
ASP.NET MVC將URL和Controller的映射規則存儲在 RouteCollection 中,前端控制器MvcHandler通過 IController 接口查找控制器。Spring MVC則通過 RequestMapping 和 Controller 注解標識映射規則,無需通過接口依賴實現控制i器。
(3)URL和View的映射
ASP.NET MVC 默認通過 RazorViewEngine 來根據URL和視圖名稱查找視圖,核心接口是 IViewEngine 。Spring MVC 通過 internalResourceViewResolver 根據URL和視圖名稱查找視圖,核心接口是 ViewResolver 。
3.Spring MVC快速上手
(1)Spring MVC初始化
ASP.NET MVC初始化需要我們在HttpApplication.Application_Start方法中注冊默認的URL和Controller規則,Spring MVC由于采用注解映射URL和Controller,因此沒有對應的步驟。ASP.NET在根web.config中配置了UrlRoutingModule可以將請求轉發給MvcHandler,Spring MVC我們需要我們配置DispatcherServlet以及其對應的URL來達到接管所有請求的目的,Spring已經利用Servlet3.0定義的ServletContainerInitializer機制,為我們提供了默認的AbstractAnnotationConfigDispatcherServletInitializer,只要只需要像繼承HttpApplication的MvcApplication一樣,寫一個MyWebApplicationInitializer。
(2)URL和View的映射
ASP.NET的RazorViewEngine內置了View的Path和擴展名.cshtml的規則。Spring MVC的internalResourceViewResolver沒有提供默認值,因此如果我們如果不定義Path和擴展名,只需要MyWebApplicationInitializer即可。一般我們會指定將View放置在統一的視圖目錄中,使用特定的擴展名。Spring同樣提供了DelegatingWebMvcConfiguration,我們只需寫一個自己的AppConfig繼承它,重寫configureViewResolvers方法即可。完整的代碼如下:
package s4s; import org.springframework.context.annotation.ComponentScan; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.config.annotation.DelegatingWebMvcConfiguration; import org.springframework.web.servlet.config.annotation.ViewResolverRegistry; import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer; import org.springframework.web.servlet.view.InternalResourceViewResolver; public class MyWebApplicationInitializer extends AbstractAnnotationConfigDispatcherServletInitializer { @Override protected Class<?>[] getRootConfigClasses() { return new Class[] { AppConfig.class }; } @Override protected Class<?>[] getServletConfigClasses() { return new Class[] { AppConfig.class }; } @Override protected String[] getServletMappings() { return new String[] { "/" }; } } @Configuration @ComponentScan class AppConfig extends DelegatingWebMvcConfiguration { @Override protected void configureViewResolvers(ViewResolverRegistry registry) { InternalResourceViewResolver viewResolver = new InternalResourceViewResolver(); viewResolver.setPrefix("/WEB-INF/views/"); viewResolver.setSuffix(".jsp"); registry.viewResolver(viewResolver); } }
(3)URL和Controller的映射
上文提到過Spring MVC和ASP.NET MVC的不同,不通過IController接口標識Controller,也不通過RouteCollection定義URL和Controller,取而代之的是兩個注解:Controller和RequestMapping。我們簡單的定義一個POJO MyController以及其簡單的Home方法。并應用上述注解:
package s4s; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; @Controller public class MyController { @RequestMapping("/") public String Home() { return "home"; } }
添加/WEB-INF/views/home.jsp視圖文件,就完成了最簡單的示例。無需web.xml的任何配置。
(4)使用Model
ASP.NET將視圖最終編譯為WebViewPage<object>,View和Model是一一對應并且類型匹配的,Model可以是任意的POCO。Spring MVC中View和Model是一對多的,提供了ModelMap和其子類ModelAndView提供類似ASP.NET MVC中ViewResult的功能。ModelMap的基類是LinkedHashMap<String, Object>。
我們修改MyController的代碼,使用ModelAndView來傳遞一個簡單UserModel模型,作為參數的UserModel對象model和ASP.NET MVC中一樣,會自動將請求參數映射到model的屬性。返回值ModelAndView時和ASP.NET MVC的return View(viewName,model)類似。只不過因為Spring MVC模型是多個模型的列表,我們還需要指定返回模型的Name。
package s4s; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.ModelAttribute; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.servlet.ModelAndView; @Controller public class MyController { @RequestMapping("/") public ModelAndView Home(@ModelAttribute UserModel model) { model.setUserName(model.getUserName() + "~"); return new ModelAndView("home", "model", model); } } class UserModel { String userName = ""; public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } }
(5)使用View
修改home.jsp,添加jstl和spring的tag支持。由于Spring MVC中的View和ASP.NET MVC中的區別較大,沒有辦法指定View持有的Model類型也就沒有了智能提示和錯誤檢測的優勢,一切回歸到了腳本語言的時代。
<%@ taglib prefix="spring" uri="http://www.springframework.org/tags"%> <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <!DOCTYPE HTML> <html xmlns:th="http://www.thymeleaf.org"> <head> <title>Getting Started: Serving Web Content</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> </head> <body> <h2>spring tag</h2> <form action="<%=request.getContextPath()%>" method="get"> <spring:bind path="model.userName"> <input type="text" name="userName" value="${status.value}" /> </spring:bind> <input type="submit" value="submit"> </form> <h2>spring form tag</h2> <form:form modelAttribute="model" method="get"> <form:input path="userName" /> <input type="submit" value="submit"> </form:form> </html>
附上pom.xml。其中junit是可選的,jstl是View中使用jstl語法需要引入的。
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>me.test</groupId> <artifactId>s4s</artifactId> <packaging>war</packaging> <version>0.0.1-SNAPSHOT</version> <name>s4s Maven Webapp</name> <url>http://maven.apache.org</url> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>4.2.4.RELEASE</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies> <build> <finalName>s4s</finalName> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.3</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> </build> </project> View Code
4.Spring MVC的初始化機制
(1)應用初始化:
Spring實現了Servlet 3.0規范定義的javax.servlet.ServletContainerInitializer接口并通過javax.servlet.annotation.HandlesTypes注解引用了WebApplicationInitializer接口。因此在Servlet容器初始化時,在當前class path路徑下的WebApplicationInitializer實現類的onStartup方法會自動執行(這和ASP.NET的Application_Start作用類似,在系列中的Java Web基礎時曾經提到過)。
(2)依賴注入的初始化:
ASP.NET中我們在Application_Start中初始化依賴注入容器。在Spring MVC中,我們實現WebApplicationInitializer接口同樣可以執行依賴注入的初始化。在Web環境中,我們使用的ApplicationContext接口的實現類為基于注解的AnnotationConfigWebApplicationContext(在系列中的Spring依賴注入基礎中曾經提到過),但我們無需直接實現WebApplicationInitializer并手動初始化AnnotationConfigWebApplicationContext對象,因為Spring已經定義了AbstractAnnotationConfigDispatcherServletInitializer作為WebApplicationInitializer接口的實現類,已經包含了AnnotationConfigWebApplicationContext的初始化。
(3)依賴注入配置:
采用基于Annotation注解時可以通過@ Configurateion 指定POJO來替代web.xml配置依賴注入。同樣,@ComponentScan可以替代web.xml中的掃描配置功能,使用ComponentScan配合Configurateion可以達到0xml配置的方式。上文中提到的Contrller相關的注解,都是啟用ComponentScan后才會被掃描生效。
(4)DispatcherServlet的初始化:
AbstractAnnotationConfigDispatcherServletInitializer類的父類AbstractDispatcherServletInitializer中已經包含DispatcherServlet的初始化。相關類圖如下:
5.Spring MVC的Action Filter
.NET MVC提供了眾多Filter接口和一個ActionFilterAttribute抽象類作為Filter的基礎,其中以實現了IAuthorizationFilter接口的AuthorizeAttribute攔截器最為我們熟知。Spring MVC則提供了基于HandlerInterceptor接口的眾多接口、抽象類和實現類,其中也有和.NET MVC類似的權限驗證UserRoleAuthorizationInterceptor攔截器。內置的攔截器可以滿足大部分需求,為了省事圖就畫在一張上了,上面是Spring MVC的,下面是.NET MVC的。
關于模型驗證和權限驗證的部分以后再續。