前言

在我們的日常工作和學習中，Web 開發(fā)是一個無法回避的重要環(huán)節(jié)。而在 Java Web 開發(fā)領域，SpringMVC 無疑是一個重量級選手。它以其靈活性、強大功能和清晰的 MVC 結構，贏得了大量開發(fā)者的青睞。但是，對于初學者來說，SpringMVC 的學習曲線可能會比較陡峭。因此，我決定寫這篇博客，希望通過一個簡單的入門案例，幫助大家快速理解和掌握 SpringMVC。

在這篇博客中，我將會以一個簡單的 "Hello, SpringMVC!" 為例，逐步引導大家了解 SpringMVC 的基本概念和使用方法。我們將從環(huán)境配置開始，然后逐步介紹如何定義 Controller、如何配置視圖解析器、如何處理請求等基本操作。我將盡可能地解釋每一步的原理和目的，希望能幫助大家更好地理解 SpringMVC。

無論你是剛接觸 Web 開發(fā)，還是已經(jīng)有一定經(jīng)驗的開發(fā)者，我都希望這篇博客能對你有所幫助。如果在閱讀過程中有任何問題，歡迎在評論區(qū)留言，我會盡力回答。

那么，讓我們開始吧！

一、開始學習

1、新建 Maven 項目，結構如下

2、導入依賴

    <dependencies><!-- springmvc 依賴，會將spring的核心包一并添加進來 --><!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc --><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>5.3.23</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.30</version></dependency><dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId><version>1.4.5</version></dependency></dependencies>

?這些 Maven 依賴項主要包括：

1. spring-webmvc：Spring Web MVC 框架的核心依賴項，用于開發(fā)基于 Spring 的 Web 應用程序。

2. lombok：一個 Java 庫，可以通過注解來簡化 Java 代碼的編寫，例如自動生成 getter/setter 方法、構造函數(shù)等。

3. logback-classic：一個 Java 日志框架，提供了比 JDK 自帶日志更強大的功能，例如異步日志、多線程安全、自定義日志格式等。

這些依賴項可以滿足開發(fā)基于 Spring 的 Web 應用程序的需求，其中 lombok 和 logback-classic 是可選的，可以根據(jù)實際需求選擇是否使用。

3、在 resources 下新建一個springmvc.xml，完成相應配置

<?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:mvc="http://www.springframework.org/schema/mvc"xmlns:context="http://www.springframework.org/schema/context"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd"><!-- 啟用注解掃描 --><context:component-scan base-package="edu.nf.ch01"/><!-- 啟用 mvc 注解處理器這個注解驅動注冊了 RequestMappingHandlerMapping （請求映射處理器）和一個 RequestMappingHandlerAdapter (請求處理適配器)，同時提供了 @RequestBody 、@ResponseBody注解支持，數(shù)據(jù)綁定等支持--><mvc:annotation-driven/><!-- 配置視圖解析器，springmvc 支持多種試圖，不同的視圖由不同的視圖解析器來解析，例如：想要使用 jsp 作為視圖，那么就需要配置InternalResourceViewResolver 這個視圖解析器，用于解析內(nèi)部的 JSP 資源--><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"><!-- 設置 jsp 資源的前綴，用于指定 JSP 存放的目錄 --><property name="prefix" value="/WEB-INF/jsp/"/><!-- 設置 jsp 資源的后綴名,以 “.jsp” 結尾 --><property name="suffix" value=".jsp"/></bean></beans>

這段 Spring 配置主要用于配置 Spring MVC 視圖解析器。

1. <context:component-scan>：啟用注解掃描，該標簽會自動掃描指定包下的所有類，并將帶有 @Controller、@Service、@Repository、@Component 等注解的類注冊為 Spring Bean。

2. <mvc:annotation-driven/>：啟用 Spring MVC 注解驅動，該標簽會自動注冊各種基于注解的 Spring MVC 組件，例如 @RequestMapping、@RequestBody、@ResponseBody 等。

3. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">：配置 Spring MVC 視圖解析器，該標簽會創(chuàng)建一個名為 internalResourceViewResolver 的 Spring Bean，并將它注冊到 Spring 容器中。

4. <property name="prefix" value="/WEB-INF/jsp/"/>：配置視圖前綴，該屬性指定了 JSP 文件的存放路徑，即所有 JSP 文件都存放在 /WEB-INF/jsp/ 目錄下。

5. <property name="suffix" value=".jsp"/>：配置視圖后綴，該屬性指定了 JSP 文件的后綴名，即所有 JSP 文件的后綴名都是 .jsp。

這段 Spring 配置主要用于配置 Spring MVC 的視圖解析器，它會將 JSP 文件的存放路徑和后綴名配置成固定值，以便于在控制器中返回視圖名稱時可以直接使用邏輯視圖名，而無需顯式指定 JSP 文件的路徑和后綴名。

注意：以后這個文件都寫在 web-inf 里面和web.xml 放在一起。

4、完成配置 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"><!-- 核心請求總控制器，負責接受的所有的請求，并根據(jù)映射的 url地址將請求分發(fā)給具體控制器的方法來處理 --><servlet><servlet-name>dispatcher</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!-- springmvc 默認會從 webapp-info 目錄下查找名為[servletName]-servlet.xml的配置文件、這里是spring 官方默認的約定命名、如果想要自定義文件名并且想存放在其他目錄下則需要通過 contextConfigLocation 初始化參數(shù)來配置例如自定義一個 springmvc.xml 配置文件放在 resources 目錄下--><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:springmvc.xml</param-value></init-param><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>dispatcher</servlet-name><url-pattern>/</url-pattern></servlet-mapping></web-app>

這是一個 Java Web 應用程序的 web.xml 配置文件，其中主要配置了一個名為 dispatcher 的 Servlet，并將它映射到根路徑 / 上。

具體來說，這個 web.xml 文件的作用如下：

1. 定義了一個名為 dispatcher 的 Servlet，并將它的類路徑設置為 org.springframework.web.servlet.DispatcherServlet，這個 Servlet 是 Spring MVC 框架的核心控制器，負責接受所有的 HTTP 請求，并將它們分發(fā)給合適的控制器進行處理。

2. 通過 contextConfigLocation 初始化參數(shù)，指定了 Spring MVC 的配置文件路徑為 classpath:springmvc.xml，這個配置文件中包含了 Spring MVC 的各種配置信息，例如控制器、視圖解析器、攔截器等。

3. 將 dispatcher Servlet 映射到根路徑 / 上，這樣所有的 HTTP 請求都會被轉發(fā)到 dispatcher Servlet 上進行處理，然后根據(jù)請求的 URL 路徑將請求分發(fā)給合適的控制器進行處理。

這個 web.xml 文件是一個 Java Web 應用程序的核心配置文件，它定義了 Servlet、Servlet 映射和初始化參數(shù)等信息，使得應用程序能夠正確地處理 HTTP 請求并返回響應。

5、在 controller 包下新建一個 HelloController 控制器

/*** @Date 2023-10-19* @Author qiu* 控制層使用 @controller 注解標識*/
@Controller
@Slf4j
public class HelloController {@RequestMapping("/hello")public ModelAndView hello() {log.info("Hello word");// 響應視圖,JSP 視圖解析器都是基于轉發(fā)的機制ModelAndView index = new ModelAndView("index");return index;}}

這是一個使用 Spring MVC 編寫的 Controller 類，它使用了 @Controller 注解將該類標記為 Spring MVC 的控制器，使用 @RequestMapping 注解將該方法映射到 /hello 路徑上，當用戶訪問 /hello 路徑時，該方法會被調用。

具體來說，這個 Controller 類的作用如下：

1. 使用 @Controller 注解將該類標記為 Spring MVC 的控制器，這樣 Spring MVC 框架就能夠自動將該類注冊為一個 Spring Bean，并將其管理起來。

2. 使用 @RequestMapping 注解將該方法映射到 /hello 路徑上，這樣當用戶訪問 /hello 路徑時，該方法就會被調用。

3. 在該方法中，使用?log.info?輸出一條日志，表示該方法已經(jīng)被調用。

4. 使用 ModelAndView 類創(chuàng)建一個名為 index 的視圖模型，該模型表示要返回的視圖名稱為 index。

5. 將該視圖模型返回給 Spring MVC，由 Spring MVC 負責將其轉發(fā)到 index.jsp 視圖進行渲染。

這個 Controller 類的作用是處理 /hello 路徑的 HTTP 請求，將請求轉發(fā)到 index.jsp 視圖進行渲染，并在控制臺輸出一條日志。

我們具體來說一下 ModelAndView :

ModelAndView 是 Spring MVC 框架中的一個類，它用于封裝控制器處理請求后需要返回的視圖名稱和模型數(shù)據(jù)。

具體來說，ModelAndView 類中包含了兩部分信息：

1. 視圖名稱：表示控制器處理請求后需要返回的視圖名稱，可以是 JSP 視圖、Thymeleaf 視圖、FreeMarker 視圖等。

2. 模型數(shù)據(jù)：表示控制器處理請求后需要返回給視圖的數(shù)據(jù)，可以是任意類型的 Java 對象，例如字符串、數(shù)字、日期、集合、Map 等。

在控制器中，通過創(chuàng)建 ModelAndView 對象并設置視圖名稱和模型數(shù)據(jù)，就可以將控制器處理請求后的結果返回給 Spring MVC 框架，然后由框架將其轉發(fā)到對應的視圖進行渲染。

?6、新建?index.jsp 頁面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>Title</title>
</head>
<body>
<h1>welcome to SpringMVC!</h1>
</body>
</html>

?在頁面中輸出一句話：welcome to SpringMVC 。

7、打包項目

?1）、配置 jetty 服務器

點擊 ＋ artifact

?二、運行項目

?到這里我們的第一個入門案例“welcome to SpringMVC”就完成了。

三、使用 Springmvc 和使用 javaweb 的區(qū)別

Spring MVC 是一種基于 Spring 框架的 Web 應用程序開發(fā)框架，而 JavaWeb 是指使用 Java 技術開發(fā) Web 應用程序的一種方式。它們之間的區(qū)別主要在以下幾個方面：

1. 開發(fā)模式：JavaWeb 開發(fā)通常采用傳統(tǒng)的 Servlet/JSP 開發(fā)模式，而 Spring MVC 則是采用 MVC（Model-View-Controller）設計模式，將應用程序分為模型、視圖和控制器三層。

2. 框架特性：Spring MVC 提供了更加完善的 IoC（Inversion of Control）和 AOP（Aspect Oriented Programming）功能，可以更加方便地進行組件的管理和切面編程；而 JavaWeb 的開發(fā)則需要手動進行對象的創(chuàng)建和配置，并且相對缺乏 AOP 的支持。

3. 可擴展性：Spring MVC 框架具有很好的可擴展性，可以與其他 Spring 框架集成，如 Spring Boot、Spring Security 等，以及與第三方框架集成，如 MyBatis、Hibernate 等；而 JavaWeb 的可擴展性相對較弱。

4. 學習曲線：相對于 JavaWeb，Spring MVC 的學習曲線可能會稍微陡峭一些，需要掌握更多的概念和技術。

Spring MVC 框架相對于傳統(tǒng)的 JavaWeb 開發(fā)，提供了更加靈活、高效、可擴展的開發(fā)方式，并且具有更好的代碼重用性和可維護性。

四、gitee 案例

案例地址：ch01 · qiuqiu/SpringMVC - 碼云 - 開源中國 (gitee.com)?