SpringMVC工程配置

Web開發是Java的一個很常見的應用場景，在企業級開發中基于Web的應用程序也是大多數Java開發者主要的關注點。我們都知道在Web開發中，狀態管理、工作流以及數據驗證都是需要解決的重要特性。而HTTP協議的無狀態性決定了這些問題都不太好解決，而Spring的Web框架就是為了解決這些關注點而設計的。

在介紹SpringMVC之前我們先來簡單提一下MVC模式，MVC是很經典的一個架構模式，早在桌面時代就已經存在了，使用MVC模式我們能夠開發出來一個松耦合的應用，讓應用分為模型 - 控制器 - 視圖。想必各位都對MVC很熟悉了，也都知道MVC有兩種模式，分別為MVC1和MVC2，如下：

MVC1通常用于桌面程序，MVC2則多用于Web程序，而SpringMVC則是基于MVC2模式實現的。Spring MVC屬Spring FrameWork的后續產品，已經融合在Spring Web Flow里面。SpringMVC能幫我們構建像Spring框架那樣靈活、松耦合基于MVC模式的Web應用程序。

不過MVC框架不止SpringMVC一種，例如Struts就是老牌的MVC框架，目前Struts2結合了Webwork，也是非常優秀的MVC框架，優點非常多比如良好的結構，攔截器的思想，豐富的功能。但缺點是Struts2由于采用了值棧、OGNL表達式、Struts2標簽庫等等，會導致應用的性能下降，啟動個服務器都要半天。Struts2的多層攔截器、多實例Action性能都很好。但正是因為攔截器太多，使得Struts2變得更加復雜，讓人使用起來感覺很重不夠輕量。

而SpringMVC是一個典型的教科書式的MVC構架，不像Struts等都是變種或者不是完全基于MVC系統的框架，對于初學者或者想了解MVC的人來說我覺得 SpringMVC 是最好的。第二它Ttapestry一樣是一個純正的Servlet系統，這也是它和Tapestry相比 Struts所具有的優勢。而且框架本身有代碼，看起來容易理解，使用簡單，學習成本低，學習難度要小于Struts2。所以使得SpringMVC成為現在最主流的MVC框架。

簡單介紹完SpringMVC后，我們來看看請求是如何從客戶端發起，經過SpringMVC中的組件，最終再返回到客戶端的。

跟蹤SpringMVC的請求：

每當用戶在web頁面中，點擊鏈接或者點擊提交表單的按鈕時，就會有請求發送到服務器 ，請求會將用戶輸入的數據帶到服務端。當服務端使用了SpringMVC時，請求一般會經歷如下幾個站點：

請求經歷的第一站是DispatcherServlet，使用了SpringMVC后，所有的請求都會通過這個作為前端控制器（front controller）的Servlet，這一點與大多數基于Java的Web框架一樣。DispatcherServlet就是SpringMVC中的前端控制器，DispatcherServlet本質上也是一個Servlet，所以它是單例的。

DispatcherServlet的任務是將請求發送給SpringMVC控制器，控制器是一個用于處理請求的Spring組件。在典型的應用程序中可能會有多個控制器，所以DispatcherServlet需要知道應該將請求發送給哪個控制器，它就會去查詢一個或多個處理器映射來確定請求的下一站在哪里，也就是要將請求發送給哪個控制器，而處理器映射會根據請求所攜帶的URL信息來進行決策發送到哪個控制器。

一旦選擇了合適的控制器，DispatcherServlet會將請求發送給選中的控制器。請求到了控制器后，會卸下用戶提交的數據。而控制器會把這些數據交給服務對象進行處理，如果該控制器設計得良好的話。

控制器在完成邏輯處理后，通常會產生一些信息，這些信息需要返回給用戶并在瀏覽器頁面上顯示出來。這些信息被稱為模型，不過我們不能直接返回這些原始數據，這些數據需要以用戶友好的方式返回，例如渲染成html格式進行返回。所以，這些數據還需要發送給視圖，通常會是JSP。

控制器所做的最后一件事就是將模型數據打包，并且標示出用于渲染輸出的視圖名。它接下來會將請求連同模型和視圖名稱發送回DispatcherServlet。

這樣控制器不會與特定的視圖相耦合，因為傳遞給DispatcherServlet的視圖名并不直接表示某個特定的JSP。實際上，它甚至不能確定視圖就是JSP。它僅僅傳遞了一個名稱，這個名稱將會用來查找產生結果的真正視圖，所以DispatcherServlet將會使用視圖解析器來將邏輯視圖名稱匹配為一個特定的視圖實現。

既然DispatcherServlet已經知道由哪個視圖來渲染結果數據，那請求的任務基本上也就完成了。它的最后一站是視圖的實現，在這里它交付模型數據。請求的任務就完成了。視圖渲染模型數據并進行輸出，這個輸出會通過響應對象傳遞給客戶端。

可以看到，請求要經過很多步驟，最終才能形成返回客戶端的響應。大多數的步驟都是在SpringMVC框架內部完成的。

首先創建一個Maven的Web工程：

在pom.xml文件里配置如下依賴：

    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>4.3.14.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>4.3.14.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>javax</groupId>
            <artifactId>javaee-api</artifactId>
            <version>7.0</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>
    </dependencies>

然后在resource目錄下創建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"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <context:annotation-config/>
    <context:component-scan base-package="org.zero01.test"/>
    <mvc:annotation-driven/>

</beans>

接著就是配置SpringMVC的前端控制器：DispatcherServlet，這個Servlet需要在web.xml中配置，配置內容如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app 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_3_0.xsd"
         version="3.0">

    <!-- 配置DispatcherServlet在服務器啟動時加載，以及其初始化參數 -->
    <servlet>
        <servlet-name>dispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:applicationContext.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>dispatcherServlet</servlet-name>
        <!-- 注意，這里不能寫/*，不然會把jsp給匹配了，導致無法訪問jsp -->
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

最后編寫一個測試類，用于測試SpringMVC是否能夠正常把請求傳遞到控制器上：

package org.zero01.test;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

// 控制器注解，聲明這是一個控制器
@Controller
public class Test {

    // 處理器映射注解，映射URL訪問名稱
    @RequestMapping("/test.do")
    public void method(){
        System.out.println("This is a test output");
    }
}

在瀏覽器里訪問 http://localhost:8080/test.do 后，控制臺輸出內容如下：

This is a test output

除了以上這種通過web.xml文件配置SpringMVC之外，我們還可以通過Java類來進行配置，不過這種配置方式要求Web3.0以上的版本才行。以下簡單介紹一下這種基于Java類的配置方式：

首先把之前在web.xml里配置的內容注釋掉，然后創建一個Java類：

package org.zero01.test;

import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;

public class WebAppInitial extends AbstractAnnotationConfigDispatcherServletInitializer{

    protected Class<?>[] getRootConfigClasses() {
        // 指定根配置類
        return new Class[]{RootConfig.class};
    }

    protected Class<?>[] getServletConfigClasses() {
        // 指定配置類
        return new Class[]{WebConfig.class};
    }

    protected String[] getServletMappings() {
        // 將DispatcherServlet映射到 "/" 上
        return new String[]{"/"};
    }
}

編寫配置類：

package org.zero01.test;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;

@Configuration
@EnableWebMvc  // 啟動SpringMVC
@ComponentScan("org.zero01.test")  // 啟動組件掃描
public class WebConfig extends WebMvcConfigurerAdapter{
}

編寫根配置類：

package org.zero01.test;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.FilterType;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;

@Configuration
@ComponentScan(basePackages = {"org.zero01.test"}, excludeFilters = {
        @ComponentScan.Filter(type = FilterType.ANNOTATION, value = EnableWebMvc.class)
})
public class RootConfig {
}

控制器類和之前一樣，重啟服務器訪問 http://localhost:8080/test.do 后，控制臺輸出內容如下：

This is a test output