在 Web 开发领域,Spring MVC 是一个强大且广泛使用的框架。今天,我们就通过一个简单的入门案例,来一窥 Spring MVC 的神奇之处,帮助大家迈出掌握这个优秀框架的第一步。
一、前期准备
开发环境
我们需要以下工具和环境:
- JDK:确保已经安装了合适版本的 JDK,本案例使用 JDK 8 及以上版本。
- IDE:这里推荐使用 IntelliJ IDEA 或者 Eclipse,它们都能很好地支持 Java Web 开发。
- Maven:用于项目的依赖管理和构建。
创建 Maven 项目
打开 IDE,创建一个新的 Maven 项目。在创建过程中,需要填写项目的基本信息,如groupId
、artifactId
和version
。这里我们以一个简单的示例为例,groupId
为com.example
,artifactId
为springmvc - demo
,version
为1.0 - SNAPSHOT
。
添加 Spring MVC 依赖
在项目的pom.xml
文件中,添加 Spring MVC 的核心依赖:
<dependencies><!-- Spring MVC 依赖 --><dependency><groupId>org.springframework</groupId><artifactId>spring - webmvc</artifactId><version>5.3.23(你可以根据需要更新版本)</version></dependency><!-- Servlet API 依赖 --><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet - api</artifactId><version>3.1.0</version><scope>provided</scope></dependency>
</dependencies>
二、配置 Spring MVC
创建 Spring 配置文件
在src/main/resources
目录下,创建spring - mvc.xml
配置文件。这个文件是 Spring MVC 的核心配置文件,用于配置各种组件。
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:mvc="http://www.springframework.org/schema/mvc"xmlns:xsi="http://www.w3.org/2010/XMLSchema - in - xmlSchema - Instance"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring - beans - xsd.xsdhttp://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring - mvc - xsd.xsd"><!-- 启用 Spring MVC 注解驱动,自动注册各种必要的组件 --><mvc:annotation - driven /><!-- 配置视图解析器,这里我们使用 InternalResourceViewResolver 来解析 JSP 视图 --><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/WEB - INF/views/"/><property name="suffix" value=".jsp"/></bean>
</beans>
配置 web.xml(传统方式,若使用 Servlet 3.0 + 可使用注解配置)
在src/main/webapp/WEB - INF
目录下,创建web.xml
文件,用于配置 Servlet 和相关的初始化参数。
<?xml version="1.0" encoding="UTF-8"?>
<web - app xmlns:xsi="http://www.w3.org/2010/XMLSchema - in - xmlSchema - Instance"xmlns="http://java.sun.com/xml/ns/javaee"xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web - app_3_0.xsd"version="3.0"><!-- 配置 Spring MVC 的 DispatcherServlet --><servlet><servlet - name>dispatcherServlet</servlet - name><servlet - class>org.springframework.web.servlet.DispatcherServlet</servlet - class><init - param><param - name>contextConfigLocation</param - name><param - value>classpath:spring - mvc.xml</param - value></init - param><load - on - startup>1</load - on - startup></servlet><servlet - mapping><servlet - name>dispatcherServlet</servlet - name><url - pattern>/</url - pattern></servlet - mapping>
</web - app>
三、创建控制器(Controller)
在src/main/java
目录下,创建com.example.controller
包,并在其中创建一个简单的控制器类HelloController
:
package com.example.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;@Controller
public class HelloController {// 使用 @RequestMapping 注解来映射 HTTP 请求路径和方法@RequestMapping(value = "/hello", method = RequestMethod.GET)public String sayHello() {return "hello"; // 返回一个视图名,这个视图名会由视图解析器解析}
}
四、创建视图(View)
在src/main/webapp/WEB - INF/views
目录下,创建hello.jsp
文件。这个文件就是我们的视图,用于向用户展示内容。
<%@ page contentType="text/html;charset=UTF - 8" language="java" %>
<html>
<head><title>Hello Spring MVC</title>
</head>
<body><h1>Hello, World! This is Spring MVC in action.</h1>
</body>
</html>
五、运行项目
将项目部署到一个支持 Servlet 的 Web 服务器上,比如 Tomcat。启动服务器后,在浏览器中输入http://localhost:(你的 Tomcat 端口)/springmvc - demo/hello
,你就会看到hello.jsp
页面的内容显示出来。
通过这个简单的 Spring MVC 入门案例,我们创建了一个基本的 Web 应用程序。从配置 Spring MVC 环境,到创建控制器处理请求,再到通过视图展示内容,希望你已经对 Spring MVC 的工作流程有了初步的理解。在后续的学习中,你可以进一步探索 Spring MVC 的更多高级特性,如数据绑定、表单处理、拦截器等,让你的 Web 开发之旅更加精彩。