当前位置：首页 > Java > 正文

Spring MVC快速入门教程（手把手教你搭建Java Web应用）

主机测评网
Java
2025-12-28
815

在当今的Java Web开发领域，Spring MVC 是最主流的 Web 框架之一。它基于经典的 MVC设计模式（Model-View-Controller），帮助开发者构建结构清晰、易于维护的 Web 应用程序。本篇 Spring MVC教程 将从零开始，带领你一步步搭建一个简单的 Spring MVC 项目，即使你是编程小白，也能轻松上手！

Spring MVC快速入门教程（手把手教你搭建Java Web应用） MVC教程 Java Web开发 Spring框架入门 MVC设计模式第1张

什么是 Spring MVC？

Spring MVC 是 Spring Framework 的一部分，专门用于构建 Web 应用。它将应用程序分为三个核心部分：

Model（模型）：负责处理业务逻辑和数据。
View（视图）：负责展示数据（通常是 JSP、Thymeleaf 等模板）。
Controller（控制器）：接收用户请求，调用 Model 处理数据，并返回 View 渲染结果。

开发环境准备

在开始编码前，请确保你已安装以下工具：

JDK 8 或更高版本
Apache Maven（用于项目依赖管理）
IDE（推荐 IntelliJ IDEA 或 Eclipse）

创建 Spring MVC 项目

我们将使用 Maven 创建一个基础项目。打开终端或命令行，执行以下命令：

mvn archetype:generate \-DgroupId=com.example \-DartifactId=springmvc-demo \-DarchetypeArtifactId=maven-archetype-webapp \-DinteractiveMode=false

这将生成一个标准的 Web 项目结构。

添加 Spring MVC 依赖

打开 pom.xml 文件，在 <dependencies> 节点中添加以下依赖：

<dependencies>    <!-- Spring Web MVC -->    <dependency>        <groupId>org.springframework</groupId>        <artifactId>spring-webmvc</artifactId>        <version>5.3.21</version>    </dependency>    <!-- Servlet API -->    <dependency>        <groupId>javax.servlet</groupId>        <artifactId>javax.servlet-api</artifactId>        <version>4.0.1</version>        <scope>provided</scope>    </dependency>    <!-- JSP JSTL -->    <dependency>        <groupId>jstl</groupId>        <artifactId>jstl</artifactId>        <version>1.2</version>    </dependency></dependencies>

配置 DispatcherServlet

Spring MVC 的核心是 DispatcherServlet，它负责分发所有 HTTP 请求。我们需要在 web.xml 中进行配置：

<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">    <servlet>        <servlet-name>dispatcher</servlet-name>        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>        <init-param>            <param-name>contextConfigLocation</param-name>            <param-value>/WEB-INF/spring-mvc-config.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>

创建 Spring 配置文件

在 src/main/webapp/WEB-INF/ 目录下创建 spring-mvc-config.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: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">    <!-- 启用注解驱动 -->    <mvc:annotation-driven />    <!-- 扫描 Controller 包 -->    <context:component-scan base-package="com.example.controller" />    <!-- 视图解析器 -->    <bean class="hwc2d5-9299-7a50-d7b6 org.springframework.web.servlet.view.InternalResourceViewResolver">        <property name="prefix" value="/WEB-INF/views/" />        <property name="suffix" value=".jsp" />    </bean></beans>

编写 Controller 和 View

首先创建 Controller 类：

package com.example.controller;import org.springframework.stereotype.Controller;import org.springframework.ui.Model;import org.springframework.web.bind.annotation.GetMapping;@Controllerpublic class HelloController {    @GetMapping("/hello")    public String sayHello(Model model) {        model.addAttribute("message", "欢迎学习 Spring MVC 教程！");        return "hello"; // 对应 /WEB-INF/views/hello.jsp    }}

然后在 src/main/webapp/WEB-INF/views/ 目录下创建 hello.jsp：

<%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><html><head>    <title>Spring MVC 示例</title></head><body>    <h2>${message}</h2>    <p>恭喜你！成功运行了你的第一个 Spring MVC 应用。</p></body></html>

启动并测试

使用 Maven 内嵌 Tomcat 启动项目：

mvn tomcat7:run

启动成功后，打开浏览器访问 http://localhost:8080/hello，你将看到欢迎页面！

总结

通过本篇 Spring MVC教程，你已经掌握了如何搭建一个基本的 Spring MVC 项目。我们介绍了 Java Web开发 的核心流程，理解了 MVC设计模式 在实际项目中的应用，并完成了从配置到运行的全过程。希望这篇 Spring框架入门 教程能为你后续深入学习打下坚实基础！

继续加油，你离成为 Java Web 开发高手又近了一步！