Spring MVC的示例分析

這篇文章主要介紹Spring MVC的示例分析，文中介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們一定要看完！

概述

Sping MVC 正式的名字為 Spring Web MVC，是 Spring Framework 框架中的其中一個模塊，基于 Servlet API 構(gòu)建，同時使用 MVC 的架構(gòu)模式，主要用以簡化傳統(tǒng)的 Servlet + JSP 進行 web 開發(fā)的工作。

MVC 架構(gòu)模式

Spring MVC 基于 MVC 模式，因此理解 Spring MVC 需要先對 MVC 模式有所了解。

傳統(tǒng) MVC 架構(gòu)模式

MVC 即 Model-View-Controller 是軟件開發(fā)中一種常用的架構(gòu)模式，將軟件系統(tǒng)分為三層：模型(Model)、視圖(View)、控制器(Controller)，各部分根據(jù)職責(zé)進行分離，使程序的結(jié)構(gòu)更為直觀，增加了程序的可擴展性、可維護性、可復(fù)用性?？梢杂萌缦碌膱D形來表示三者之間的關(guān)系。

• 模型(Model)：模型封裝了數(shù)據(jù)及對數(shù)據(jù)的操作，可以直接對數(shù)據(jù)庫進行訪問，不依賴視圖和控制器，也就是說模型并不關(guān)注數(shù)據(jù)如何展示，只負責(zé)提供數(shù)據(jù)。GUI 程序模型中數(shù)據(jù)的變化一般會通過觀察者模式通知視圖，而在 web 中則不會這樣。

• 視圖(View)：視圖從模型中拉取數(shù)據(jù)，只負責(zé)展示，沒有具體的程序邏輯。

• 控制器(Controller)：控制器用于控制程序的流程，將模型中的數(shù)據(jù)展示到視圖中。

Java Web MVC 架構(gòu)模式

上世紀(jì) 90 年代，隨著互聯(lián)網(wǎng)的發(fā)展，基于瀏覽器的 B/S 模式隨之流行，最初瀏覽器向服務(wù)器請求的都是一些靜態(tài)的資源，如 HTML，CSS 等，為了支持根據(jù)用戶的請求動態(tài)的獲取資源，Java 提出了 Servlet 規(guī)范。

此時 Servlet 可以說是一個大雜燴，瀏覽器接收的 HTML 都是通過 Servelt 一行一行的輸出，比較繁瑣，并且寫后端代碼的程序員還要熟悉前端技術(shù)，為了解決這個問題，sun 公司又借鑒 ASP 提出了 JSP。

JSP 和 HTML 相似，只是在 JSP 文件中可以嵌入 Java 代碼，減少了直接使用 Servlet 產(chǎn)生的大量冗余代碼。此時 JSP 同時充當(dāng)模型、視圖、控制器的角色，為了解決前后端代碼仍然揉在一起的問題，Java Web MVC 模式后來被提出，JavaBean 充當(dāng)模型、JSP 充當(dāng)視圖，Servlet 充當(dāng)控制器，流程如下圖所示。

瀏覽器的請求先經(jīng)過 Servlet，Servlet 控制整個流程，使用 JavaBean 查詢并存儲數(shù)據(jù)，然后攜帶 JavaBean 中的數(shù)據(jù)到 JSP 頁面中，這個就是 Java 中早期的 Web MVC 架構(gòu)模式了。

Spring MVC 架構(gòu)模式

Spring MVC 架構(gòu)模式對 Java Web 中的 MVC 架構(gòu)模式加以擴展，將控制器拆分為前端控制器 DispatcherServlet 和后端控制器 Controller，將 Model 拆分成業(yè)務(wù)層(Service) 和數(shù)據(jù)訪問層(Respository)，并且支持不同的視圖，如 JSP、FreeMarker 等，設(shè)計更為靈活，請求處理流程如下。

瀏覽器的請求先經(jīng)過 DispatcherServlet，DispatcherServlet 負責(zé)分發(fā)請求，因此 DispatcherServlet 又被稱為前端控制器。DispatcherServlet 其后的 Controller 又被稱為后端控制器，Controller 可以選擇性的調(diào)用 Service、Repository 實現(xiàn)業(yè)務(wù)邏輯，DispatcherServlet 拿到 Controller 提供的模型和視圖后，進行渲染并返回給瀏覽器。當(dāng)然了，這里只是為了方便理解 Spring MVC 描述的大概流程，具體流程會在后文介紹。

Hello，Spring MVC

雖然現(xiàn)在 SpringBoot 已經(jīng)成為主流，但是我仍然想從單純的 Spring MVC 講起，因為 SpringBoot 也只是在 Spring Framework 其上添加了一些自動化的配置，這些自動化的配置會讓我們忽略背后的技術(shù)原理。

幾年的 Spring 的教程中都會提出使用 Spring MVC 首先需要去 Spring 官網(wǎng)下載一大堆的依賴，而現(xiàn)在有了 maven 之后再也不必關(guān)系這些亂七八糟的依賴及其依賴關(guān)系。如果你不了解 maven，建議先去了解 maven 后再回頭看下面的內(nèi)容。

Spring MVC 依賴引入

新建 maven 項目，并引入 Spring MVC 的依賴，注意這里引入的版本號是 5.2.6，Spring Framework 5 開始對 JDK 版本的要求是 1.8 及以上。完整的 pom 內(nèi)容如下。

<?xml version="1.0" encoding="UTF-8"?>

<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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.zzuhkp</groupId>
    <artifactId>mvc-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>

    <dependencies>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.2.6.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>4.0.1</version>
            <scope>provided</scope>
        </dependency>

    </dependencies>

    <build>
        <finalName>mvc-demo</finalName>
    </build>
</project>

DispatcherServlet 聲明

傳統(tǒng)的 Java Web 項目使用 Servlet 處理請求，Spring MVC 遵循了 Servlet 規(guī)范，提供了一個名稱為 DispatcherServlet 的 Servlet 類，使用 Spring MVC 需要先聲明這個 Servlet。

DispatcherServlet 整合了 IOC 容器，所有處理 Web 請求的組件都存至 IOC 容器中，然后使用這些 bean 處理控制整個請求過程。

有兩種聲明 DispatcherServlet 的方式，第一種方式是直接在類路徑下的/WEB-INF/web.xml文件中配置。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
          http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
    version="4.0">

    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

第二種方式基于 Servlet 3.0 提出的 ServletContainerInitializer 接口，Servlet 容器會從類路徑中查找實現(xiàn)了這個接口的類，并在啟動時回調(diào)這個接口中的方法，Spring MVC 已經(jīng)將這個接口實現(xiàn)為 SpringServletContainerInitializer，在其內(nèi)部調(diào)用了 WebApplicationInitializer 接口完成初始化，因此實現(xiàn) WebApplicationInitializer 接口再添加 DispatcherServlet 也可以，和上述 xml 等效的 java 代碼如下。

public class MvcXmlInitializer implements WebApplicationInitializer {

    @Override
    public void onStartup(ServletContext servletContext) throws ServletException {
        XmlWebApplicationContext context = new XmlWebApplicationContext();
        DispatcherServlet dispatcher = new DispatcherServlet(context);
        Dynamic dynamic = servletContext.addServlet("dispatcher", dispatcher);
        dynamic.addMapping("/");
        dynamic.setLoadOnStartup(1);
    }
}

除了上述用戶自定義的 WebApplicationInitializer，Spring 還自定義了一個支持注解配置的抽象實現(xiàn)類 AbstractAnnotationConfigDispatcherServletInitializer，這個類會自動向 Servlet 上下文中注冊 DispatcherServlet，實現(xiàn)這個類然后指定配置類即可。

public class MvcAnnotationInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return null;
    }

    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{MvcConfig.class};
    }

    @Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

這里我們使用 web.xml 配置進行演示，我們配置的 DispatcherServlet 聲明的映射路徑是/，因此，所有的請求都會到達 DispatcherServlet，然后再分派給不同的處理器處理。

Spring 上下文配置

Spring MVC 使用 IOC 容器存儲處理請求的組件，包括處理器在內(nèi)的所有自定義的與 Web 請求有關(guān)的組件都需要添加到 Spring 的配置中。

Spring 上下文配置文件指定

DispatcherServlet 初始化時默認使用的容器是 XmlWebApplicationContext，雖然 Spring 預(yù)留了擴展點用于修改容器類型，非必要情況下還是建議不要修改，這個容器默認情況下會使用類路徑下/WEB-INF/{servlet-name}-servlet.xml文件作為容器的配置文件，我們聲明的 DispatcherServlet 名為 dispatcher，因此我們創(chuàng)建/WEB-INF/dispatcher-servlet.xml文件作為容器的配置。另外還可以使用 Servlet 的初始化參數(shù) configLocation 指定 Spring 容器配置文件路徑。

<servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/dispatcher-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

Spring 上下文配置文件內(nèi)容

Spring 配置文件內(nèi)容如下。

<?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.xsd">

    <bean id="/hellohandler" class="com.zzuhkp.mvc.handler.HelloSpringMVCHttpRequestHandler"/>
        
</beans>

這里聲明了一個類型為 HelloSpringMVCHttpRequestHandler 的 bean，其 id 為請求路徑/hellohandler，這個類的定義如下。

public class HelloSpringMVCHttpRequestHandler implements HttpRequestHandler {


    @Override
    public void handleRequest(HttpServletRequest request, HttpServletResponse response)
        throws ServletException, IOException {
        response.getWriter().write("Hello,HelloSpringMVCHttpRequestHandler");
    }

}

這樣配置的目的是希望當(dāng)/hellohandler請求到達時，能夠使用我們提供的 HelloSpringMVCHttpRequestHandler 處理請求。

到了這里，將項目發(fā)布到 Tomcat，我這里使用的 Tomcat 版本號是 9.0.54，可以看到效果如下。

HandlerMapping 配置

那為什么將處理器的 bean id 配置為請求路徑就可以使用這個處理器進行處理呢？Spring MVC 為了靈活的查找處理器內(nèi)部使用了 HandlerMapping 將請求映射到處理器，Spring 默認情況下會使用BeanNameUrlHandlerMapping映射請求，這個映射器將請求路徑作為 id 查找處理器。除了默認情況下使用的這個映射器，我們還可以配置 SimpleUrlHandlerMapping 映射器，和上述等效的 Spring 配置如下。

<?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.xsd">

    <bean id="hellohandler" class="com.zzuhkp.mvc.handler.HelloSpringMVCHttpRequestHandler"/>

    <bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
        <property name="urlMap">
            <map>
                <entry key="/hellohandler" value-ref="hellohandler"/>
            </map>
        </property>
    </bean>
    
</beans>

處理器配置

看到這里，細心的小伙伴可能會有疑問，說好的 DispatcherServlet 將請求分派給 Controller 呢？這里暫時不用著急，Controller 其實是 Spring MVC 的處理器類型之一，這里的 HttpRequestHandler 同樣是 Spring MVC 的處理器。

Spring 對多種處理器進行了支持，具體則是使用 HandlerAdapter 對處理器進行適配，Spring MVC 內(nèi)部已經(jīng)默認了一些適配器，HttpRequestHandler 的適配器是 HttpRequestHandlerAdapter，Controller 的適配器 SimpleControllerHandlerAdapter 也是 Spring MVC 默認支持的。

默認的 HandlerAdapter 已經(jīng)足夠支持日常所需，一般不會自定義 HandlerAdapter。

下面嘗試使用 Controller 作為處理器處理請求，定義實現(xiàn) Controller 接口的 HelloSpringMVCController 類如下。

public class HelloSpringMVCController implements Controller {

    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.setViewName("/WEB-INF/view/welcome.jsp");
        modelAndView.addObject("hello", "HelloSpringMVCController");
        return modelAndView;
    }
}

然后在 Spring 配置文件中添加這個類作為 bean。

<bean id="/hellocontroller" class="com.zzuhkp.mvc.handler.HelloSpringMVCController"/>

到了這里，終于可以看到 Controller 了，Controller 處理請求，返回了一個類型為 ModelAndView 的對象。

ModelAndView 包含模型和視圖，這里向模型中添加了屬性 hello，并且指定了/WEB-INF/view/welcome.jsp 文件作為視圖名，這個文件內(nèi)容如下。

<html>
<body>
<h3>Hello,${requestScope.hello}</h3>
</body>
</html>

啟動 Tomcat 訪問 /hellocontroller 效果如下。

成功將模型中的數(shù)據(jù)展示到視圖。

ViewResolver 配置

為了支持不同的視圖，如 JSP、FreeMarker 等，ModelAndView 中的視圖名稱被設(shè)計成虛擬的，具體的視圖由視圖解析器 ViewResolver 進行解析，默認情況下使用的視圖解析器是 InternalResourceViewResolver ，這個視圖解析器基于 URL 解析視圖。同時也可以向應(yīng)用上下文中配置自己的視圖解析器。添加自定義的 InternalResourceViewResolver 到 Spring 配置文件。

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/view"/>
        <property name="suffix" value=".jsp"/>
    </bean>

然后設(shè)置視圖名時就可以忽略路徑前綴/WEB-INF/view和后綴.jsp，配置前綴后綴后上述示例中 HelloSpringMVCController 就可以將視圖名從 /WEB-INF/view/welcome.jsp 簡化為 welcome。

DispatcherServlet 組件默認配置

上述示例中使用了不少 DispatcherServlet 使用的組件，Spring MVC 默認情況下已經(jīng)提供了一些，如果需要自定義，則將自定義的組件添加到上下文配置中接口，十分方便，那么 Spring 默認情況下使用了哪些組件處理請求呢？

spring-webmvc 模塊類路徑下 org/springframework/web/servlet/DispatcherServlet.properties 文件定義了這些默認的配置，具體如下。

基于注解的 Spring WebMVC

基于配置文件的 Spring Web MVC 項目在前些年確實比較流行，然而現(xiàn)在注解已經(jīng)成為 Spring 開發(fā)的主流。下面通過純注解的方式對上面的示例進行改造。

pom 文件不需要進行變化，首先要提供 Spring 配置類。

@ComponentScan("com.zzuhkp.mvc")
public class MvcConfig {

}

這里只添加了組件掃描能力，Spring 會將給定包下標(biāo)注了 @Component 的類作為 bean 進行處理。然后將將這個類設(shè)置為配置類即可，這里可以參見使用上述提供的 DispatcherServlet 第二種聲明方式。

然后提供基于注解的控制器。

@Controller
public class HelloSpringMVCAnnotationController {

    @GetMapping("/helloAnnotationController")
    public String helloMVC(@RequestParam("hello") String hello, Model model) {
        model.addAttribute("hello", hello);
        return "/WEB-INF/view/welcome.jsp";
    }

}

基于注解的控制器不需要實現(xiàn)特定的接口，直接在類上添加 @Controller 注解即可，這里定義了一個處理 /helloAnnotationController 路徑 GET 請求方式的方法，并且接收 hello 參數(shù)，存放至 model 中，然后返回了視圖名。這里直接復(fù)用了上面示例中的視圖。最終效果如下。

基于注解的控制器是 Spring MVC 中設(shè)計最為靈活的地方，這里可以先考慮下，Spring 是怎么適配用戶自定義的控制器的？控制器方法中的參數(shù)如何賦值呢？如何將控制器方法的返回值解析為視圖？Spring 如何支持 RESTFUL 風(fēng)格的接口的？后面會寫幾篇文章繼續(xù)分析。

DispatcherServlet 請求處理流程

DispatcherServlet 請求處理流程已經(jīng)穿插在前面的示例中介紹，直接看前面的描述可能不是很直觀，這里總結(jié)了一張圖來梳理整個流程。

整個流程串聯(lián)起來如下。

1. DispatcherServlet 處理瀏覽器發(fā)起的請求。

2. DispatcherServlet 根據(jù)用戶或默認的配置使用 HandlerMapping 查找可處理請求的處理器。

3. DispatcherServlet 拿到 HandlerMapping 返回的處理器鏈 HandlerExecutionChain。整個處理器鏈包含攔截器和處理。

4. DispatcherServlet 將處理器適配為 HandlerAdapter。

5. DispatcherServlet 使用攔截器進行請求前置處理。

6. DispatcherServlet 使用處理器進行請求處理。

7. DispatcherServlet 使用攔截器進行請求后置處理。

8. DispatcherServlet 從攔截器或處理器中提取到模型及視圖 ModelAndView。

9. DispatcherServlet 使用視圖解析器 ViewResolver 解析視圖出視圖 View。

10. DispatcherServlet 渲染視圖，響應(yīng)請求。
    

以上是“Spring MVC的示例分析”這篇文章的所有內(nèi)容，感謝各位的閱讀！希望分享的內(nèi)容對大家有幫助，更多相關(guān)知識，歡迎關(guān)注億速云行業(yè)資訊頻道！