【SpringMVC】SpringMVC搭建框架

開發環境

IDE：idea 2019.3.2

構建工具：maven3.5.4

服務器：tomcat 9.0.30

Spring版本：5.3.1

創建maven工程

添加打包方式：war

引入依賴

<dependencies>
    <!-- SpringMVC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.1</version>
    </dependency>

    <!-- 日志 -->
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.2.3</version>
    </dependency>

    <!-- ServletAPI -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
        <scope>provided</scope>
    </dependency>

    <!-- Spring5和Thymeleaf整合包 -->
    <dependency>
        <groupId>org.thymeleaf</groupId>
        <artifactId>thymeleaf-spring5</artifactId>
        <version>3.0.12.RELEASE</version>
    </dependency>
</dependencies>

配置web.xml

配置SpringMVC的前端控制器，對瀏覽器發送的請求統一進行處理

可通過init-param標簽設置SpringMVC配置文件的位置和名稱，通過load-on-startup標簽設置SpringMVC前端控制器DispatcherServlet的初始化時間

<!-- 設置編碼過濾器 -->
<filter>
	<filter-name>CharacterEncodingFilter</filter-name>
	<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
	<init-param>
		<param-name>encoding</param-name>
		<param-value>UTF-8</param-value>
	</init-param>
	<init-param>
		<param-name>forceResponseEncoding</param-name>
		<param-value>true</param-value>
	</init-param>
</filter>
<filter-mapping>
	<filter-name>CharacterEncodingFilter</filter-name>
	<url-pattern>/*</url-pattern>
</filter-mapping>

<!--  處理請求參數put和delete  -->
<filter>
	<filter-name>HiddenHttpMethodFilter</filter-name>
	<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
	<filter-name>HiddenHttpMethodFilter</filter-name>
	<url-pattern>/*</url-pattern>
</filter-mapping>

<!-- 配置前端控制器 -->
<servlet>
    <servlet-name>springMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 通過初始化參數指定SpringMVC配置文件的位置和名稱 -->
    <init-param>
        <!-- contextConfigLocation為固定值 -->
        <param-name>contextConfigLocation</param-name>
        <!-- 使用classpath:表示從類路徑查找配置文件，例如maven工程中的src/main/resources -->
        <param-value>classpath:springMVC.xml</param-value>
    </init-param>
    <!-- 
 		作為框架的核心組件，在啟動過程中有大量的初始化操作要做
		而這些操作放在第一次請求時才執行會嚴重影響訪問速度
		因此需要通過此標簽將啟動控制DispatcherServlet的初始化時間提前到服務器啟動時
	-->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>springMVC</servlet-name>
    <!--
        設置springMVC的核心控制器所能處理的請求的請求路徑
        /所匹配的請求可以是/login或.html或.js或.css方式的請求路徑
        但是/不能匹配.jsp請求路徑的請求
    -->
    <url-pattern>/</url-pattern>
</servlet-mapping>

\<url-pattern>標簽中使用/和/*的區別：

/所匹配的請求可以是/login或.html或.js或.css方式的請求路徑，但是/不能匹配.jsp請求路徑的請求

因此就可以避免在訪問jsp頁面時，該請求被DispatcherServlet處理，從而找不到相應的頁面

/*則能夠匹配所有請求，例如在使用過濾器時，若需要對所有請求進行過濾，就需要使用\*的寫法

創建springMVC的配置文件

在src/main/resources目錄中創建springmvc.xml配置文件

?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       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
                           http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 自動掃描包 -->
<context:component-scan base-package="com.atguigu.mvc.controller"/>

<!-- 配置Thymeleaf視圖解析器 -->
<bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
    <property name="order" value="1"/>
    <property name="characterEncoding" value="UTF-8"/>
    <property name="templateEngine">
        <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
            <property name="templateResolver">
                <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
    
                    <!-- 視圖前綴 -->
                    <property name="prefix" value="/WEB-INF/templates/"/>
    
                    <!-- 視圖后綴 -->
                    <property name="suffix" value=".html"/>
                    <property name="templateMode" value="HTML5"/>
                    <property name="characterEncoding" value="UTF-8" />
                </bean>
            </property>
        </bean>
    </property>
</bean>

創建請求控制器

由於前端控制器對瀏覽器發送的請求進行了統一的處理，但是具體的請求有不同的處理過程，因此需要創建處理具體請求的類，即請求控制器

請求控制器中每一個處理請求的方法成為控制器方法

因為SpringMVC的控制器由一個POJO（普通的Java類）擔任，因此需要通過@Controller注解將其標識為一個控制層組件，交給Spring的IoC容器管理，此時SpringMVC才能夠識別控制器的存在

@Controller
public class HelloController {
    
}

測試

html文件放在src/main/webapp/WEB-INF/templates目錄中

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>首頁</title>
</head>
<body>
<h1>首頁</h1>
</body>
</html>

在請求控制器中創建處理請求的方法

// @RequestMapping注解：處理請求和控制器方法之間的映射關系
// @RequestMapping注解的value屬性可以通過請求地址匹配請求，/表示的當前工程的上下文路徑
// localhost:8080/springMVC/
@RequestMapping("/")
public String index() {
    //設置視圖名稱
    return "index";
}

通過超鏈接跳轉到指定頁面

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>首頁</title>
</head>
<body>
    <h1>首頁</h1>
    <a th:href="@{/hello}">HelloWorld</a><br/>
</body>
</html>

在請求控制器中創建處理請求的方法

@RequestMapping("/hello")
public String HelloWorld() {
    return "target";
}

配置Tomcat

點擊Debug啟動Tomcat即可