【SpringMVC】SpringMVC搭建框架

gonghr發表於2021-08-26

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的初始化時間

<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>