使用 Spring Framework 构建 Spring MVC 应用程序：逐步指南

目录

1. 介绍 - 第1页
2. 设置 Maven 项目 - 第2页
   • 创建新的 Maven Web 应用程序
   • 配置 pom.xml
3. 配置 Spring Framework - 第5页
   • 更新 Java 版本
   • 设置 web.xml
   • 创建 Spring 配置
4. 开发 MVC 组件 - 第9页
   • 创建 Controller
   • 设计视图
5. 运行应用程序 - 第13页
6. 结论 - 第15页

介绍

欢迎阅读本全面指南，学习如何使用 Spring Framework 构建基于 Spring MVC 的应用程序。虽然 Spring Boot 在行业中因其易于设置和配置而越来越流行，但理解底层的 Spring Framework 为高级配置和定制提供了坚实的基础。

重要性和目的

本指南旨在为初学者和开发人员提供基本知识，以使用 Spring Framework 创建强大的 MVC（Model-View-Controller）Web 应用程序。通过本指南的学习，您将了解如何设置 Maven 项目、配置 Spring 依赖项、开发 MVC 组件以及成功运行您的应用程序。

使用 Spring Framework 的优缺点

何时何地使用 Spring Framework

当您需要对应用程序的配置进行细粒度控制时，特别是在需要高度定制的大型企业环境中，选择 Spring Framework 是理想的。

设置 Maven 项目

创建新的 Maven Web 应用程序

首先，启动一个基于 Maven 的新 Web 应用程序。Maven 通过处理依赖项和构建配置来简化项目管理。

1. 启动一个新的 Maven 项目：
   • 打开您的 IDE 并创建一个新的 Maven 项目。
   • 选择 apache.maven 原型。
   • 选择创建一个 Web 应用程序，因为我们正在开发基于 MVC 的 Web 应用程序。
2. 项目命名规范：
   • Group ID： org.studyeasy
   • Artifact ID： S05L01-SpringMinimalSetup

   这种命名规范有助于高效地组织和管理您的项目。

3. 完成项目设置：
   • 点击 Finish 生成项目结构。
   • Maven 将根据指定的配置构建项目。

配置 pom.xml

pom.xml 文件至关重要，因为它管理项目依赖项和构建配置。

1. 导航到 pom.xml：
   • 在您的项目目录中找到 pom.xml 文件。
2. 添加必要的依赖项：

   确保包含以下 Spring MVC 所需的依赖项：

   Java

   <dependencies> <!-- Spring Core --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>5.3.20</version> </dependency> <!-- Spring Context --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>5.3.20</version> </dependency> <!-- Spring Web MVC --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.3.20</version> </dependency> <!-- Jakarta Servlet --> <dependency> <groupId>jakarta.servlet</groupId> <artifactId>jakarta.servlet-api</artifactId> <version>5.0.0</version> <scope>provided</scope> </dependency> <!-- JSP Support --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <!-- JUnit for Testing (Optional) --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.13.2</version> <scope>test</scope> </dependency> </dependencies>

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47

   <dependencies>     <!-- Spring Core -->     <dependency>         <groupId>org.springframework</groupId>         <artifactId>spring-core</artifactId>         <version>5.3.20</version>     </dependency>          <!-- Spring Context -->     <dependency>         <groupId>org.springframework</groupId>         <artifactId>spring-context</artifactId>         <version>5.3.20</version>     </dependency>          <!-- Spring Web MVC -->     <dependency>         <groupId>org.springframework</groupId>         <artifactId>spring-webmvc</artifactId>         <version>5.3.20</version>     </dependency>          <!-- Jakarta Servlet -->     <dependency>         <groupId>jakarta.servlet</groupId>         <artifactId>jakarta.servlet-api</artifactId>         <version>5.0.0</version>         <scope>provided</scope>     </dependency>          <!-- JSP Support -->     <dependency>         <groupId>javax.servlet</groupId>         <artifactId>jstl</artifactId>         <version>1.2</version>     </dependency>          <!-- JUnit for Testing (Optional) -->     <dependency>         <groupId>junit</groupId>         <artifactId>junit</artifactId>         <version>4.13.2</version>         <scope>test</scope>     </dependency> </dependencies>

3. 更新 Maven 项目：
   • 右键点击项目，选择 Maven > Update Project。
   • 勾选 Force Update of Snapshots/Releases，然后点击 OK。
   • Maven 将下载并集成指定的依赖项。

配置 Spring Framework

更新 Java 版本

确保您的项目使用适当的 Java 版本以实现兼容性和性能。

1. 设置 Java 版本为 17：

   打开 pom.xml 并更新 Java 版本：

   Java

   <properties> <maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target> </properties>

   1 2 3 4 5 6

   <properties>     <maven.compiler.source>17</maven.compiler.source>     <maven.compiler.target>17</maven.compiler.target> </properties>

2. 重新加载 Maven 项目：

   更新后，刷新 Maven 项目以应用更改。

设置 web.xml

web.xml 文件配置您的 Web 应用程序的部署设置。

1. 找到 web.xml：
   • 导航到 src/main/webapp/WEB-INF/web.xml。
2. 基本配置：
   
   Java

   <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://jakarta.ee/xml/ns/jakartaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jakarta.ee/xml/ns/jakartaee http://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd" version="5.0"> <display-name>SpringMinimalSetup</display-name> <!-- Dispatcher Servlet 配置 --> <servlet> <servlet-name>SpringSample</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/SpringSample-servlet.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>SpringSample</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28

   <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://jakarta.ee/xml/ns/jakartaee"          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"          xsi:schemaLocation="http://jakarta.ee/xml/ns/jakartaee                              http://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"          version="5.0">          <display-name>SpringMinimalSetup</display-name>          <!-- Dispatcher Servlet 配置 -->     <servlet>         <servlet-name>SpringSample</servlet-name>         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>         <init-param>             <param-name>contextConfigLocation</param-name>             <param-value>/WEB-INF/SpringSample-servlet.xml</param-value>         </init-param>         <load-on-startup>1</load-on-startup>     </servlet>          <servlet-mapping>         <servlet-name>SpringSample</servlet-name>         <url-pattern>/</url-pattern>     </servlet-mapping>      </web-app>

3. 说明：
   • DispatcherServlet： 处理传入请求的核心组件。
   • contextConfigLocation： 指定 Spring 配置文件。
   • Servlet Mapping： 将所有请求 (/) 定向到 DispatcherServlet。

创建 Spring 配置

定义特定于 Spring 的配置以管理 beans 和 MVC 设置。

1. 创建 SpringSample-servlet.xml：
   • 导航到 src/main/webapp/WEB-INF/ 并创建 SpringSample-servlet.xml。
2. 添加配置细节：
   
   Java

   <?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="org.studyeasy"/> <!-- 视图解析器 --> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/"/> <property name="suffix" value=".jsp"/> </bean> </beans>

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

   <?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="org.studyeasy"/>          <!-- 视图解析器 -->     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">         <property name="prefix" value="/WEB-INF/views/"/>         <property name="suffix" value=".jsp"/>     </bean>      </beans>

3. 说明：
   • 组件扫描： 使 Spring 能在指定的包中检测和管理 beans。
   • 视图解析器： 配置视图模板（JSP）的路径和文件扩展名。

开发 MVC 组件

创建 Controller

Controller 管理传入请求，处理它们，并返回适当的视图。

1. 创建 MainController.java：
   • 导航到 src/main/java/org/studyeasy/ 并创建 MainController.java。
2. 带注释的 Controller 代码：
   
   Java

   package org.studyeasy; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; @Controller public class MainController { @RequestMapping(value = "/", method = RequestMethod.GET) public String home() { // 返回要渲染的视图名称 return "home"; } }

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

   package org.studyeasy;   import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod;   @Controller public class MainController {       @RequestMapping(value = "/", method = RequestMethod.GET)     public String home() {         // 返回要渲染的视图名称         return "home";     } }

3. 说明：
   • @Controller： 表示该类作为 Spring MVC 控制器。
   • @RequestMapping： 将 HTTP 请求映射到处理方法。
   • home 方法： 处理根 URL (/) 的 GET 请求并返回 home 视图。

设计视图

视图定义呈现给用户的用户界面。

1. 创建 home.jsp：
   • 导航到 src/main/webapp/WEB-INF/views/ 并创建 home.jsp。
2. 视图代码：
   
   Java

   <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>主页</title> </head> <body> <h3>欢迎进入 Spring MVC 的世界</h3> </body> </html>

   1 2 3 4 5 6 7 8 9 10 11 12 13 14

   <%@ page language="java" contentType="text/html; charset=UTF-8"     pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head>     <meta charset="UTF-8">     <title>主页</title> </head> <body>     <h3>欢迎进入 Spring MVC 的世界</h3> </body> </html>

3. 说明：
   • HTML 结构： 基本 HTML 用于显示欢迎消息。
   • JSP 文件： 由控制器渲染的视图。

运行应用程序

在完成所有配置和开发 MVC 组件后，是时候运行和测试应用程序了。

1. 构建项目：
   • 右键点击项目，选择 Run As > Maven build...
   • 在 Goals 字段中输入 package，然后点击 Run。
2. 部署到服务器：
   • 确保已将 Apache Tomcat 配置为您的服务器。
   • 右键点击项目，选择 Run As > Run on Server。
   • 选择 Apache Tomcat（最好是版本 9）并继续。
3. 访问应用程序：
   • 打开网页浏览器，导航到 http://localhost:8080/S05L01-SpringMinimalSetup/。
   • 您应该会看到带有消息 "Welcome to the World of Spring MVC" 的 主页。
4. 故障排除：
   • 常见问题：
     • 依赖错误： 确保所有 Maven 依赖项都已正确指定和下载。
     • Servlet 错误： 验证 web.xml 和 SpringSample-servlet.xml 配置。
     • 版本兼容性： 确保项目和服务器之间的 Java 版本兼容。

结论

在本指南中，我们详细介绍了如何使用 Spring Framework 构建基于 Spring MVC 的 Web 应用程序。从设置 Maven 项目、配置必要的依赖项、开发 MVC 组件到运行应用程序，每一步都经过细致的讲解，确保顺利的开发体验。

关键要点

• Maven 集成： 高效管理项目依赖项和构建配置。
• Spring 配置： 正确设置 web.xml 和 Spring 配置文件确保请求处理顺畅。
• MVC 组件： 通过模型、视图和控制器的清晰职责分离，提高可维护性。
• 部署： 理解服务器配置和部署流程对于应用程序的可访问性至关重要。

进一步学习

为了巩固您的理解，建议探索以下主题：

• 高级 Spring MVC 功能： 表单处理、验证和异常处理。
• Spring Boot 集成： 通过自动配置简化 Spring 应用程序。
• RESTful API 开发： 使用 Spring MVC 构建现代 Web 应用程序的 API。
• 使用 JUnit 进行测试： 引入测试框架以确保代码的可靠性。

SEO 关键词：Spring MVC 教程, Spring Framework 指南, Maven Spring 项目, Spring MVC 控制器设置, Spring Web 应用程序, Spring 配置步骤, Java Spring MVC, Spring MVC 初学者, 构建 Spring MVC 应用程序, Spring MVC 部署。

本文由 AI 生成。