Spring Web MVC 是一个建立在 Servlet API 的 Web 框架,它属于 Spring Framework 的产品。Spring Web MVC 名称来源于模块 spring-webmvc ,但它更常用的叫法是 Spring MVC。
本文讲述如何使用 IntelliJ IDEA 来编写一个 Spring MVC Demo。
使用 IntelliJ IDEA 创建一个 Maven 项目,选择 webapp 类型。
创建好 Maven 项目后,我们在 pom.xml 文件中添加依赖。
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.0.7.RELEASE</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.0.1</version>
<scope>provided</scope>
</dependency>
</dependencies>
为编写代码,我们在 main 目录下创建 java 目录,并标记为 Source 目录。接下来在 main 目录下添加 resources 目录,并标记为 Resource 目录。如下图所示:
为运行 Spring MVC 项目,我们还需要配置 tomcat 服务器。 先在官网下载 tomcat,然后在 IntelliJ IDEA 添加 tomcat ,如下图所示:
配置完 tomcat 服务器后,还需要将项目部署到 tomcat 中运行。在 Deployment 选项窗口中将本项目配置进去。
Tomcat 服务器配置完毕,可以点击运行按钮进行测试。如果可以正常打开浏览器,并显示 Hello World 的字样,说明配置成功。
经过以上的配置,Spring MVC 项目的框架就搭建完毕了,接下来就可以编写代码了。
配置 web.xml
我们将 web.xml 配置修改为:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/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_2_5.xsd"
version="2.5">
<display-name>spring-web</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>
classpath:application-context.xml </param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<servlet>
<servlet-name>example</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>example</servlet-name>
<url-pattern>/api/*</url-pattern>
</servlet-mapping>
</web-app>
在 web.xml 文件,我们添加了一个名为example
的 servlet,用于处理 /api/ 的请求;并指定application-context.xml
作为 spring 的上下文配置文件。
创建application-context.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:p="http://www.springframework.org/schema/p"
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">
</beans>
配置 xxx-servlet.xml
配置完 web.xml 后,我们添加 servlet 的 xml 配置。上面我们配置了名为example
的 servlet,故我们创建一个example-servlet.xml
的文件,其内容如下:
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc" 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
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<context:component-scan base-package="com.test.controller" />
</beans>
example-servlet.xml
文件里面指定了 controller 的包为com.test.controller
。
添加 controller
上述 servlet 配置文件中指定了 servlet 的包为com.test.controller
,因此,我们在 java 目录下创建com.test.controller
包,并添加类HelloController
。
package com.test.controller;
import java.io.IOException;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping(value = "/hello")
public class HelloController {
@RequestMapping(value = "/spring")
public void spring(HttpServletResponse response) throws IOException {
response.getWriter().write("Hello, Spring Web!!");
}
}
注解 @Controller
的含义是指类HelloController
为一个处理请求的 Controller。
注解@RequestMapping
用于定义请求 url 的映射,上述代码表明我们将 /hello/spring 的请求映射到方法spring()
中处理。
完成以上步骤后,我们就完成了一个完整 spring mvc 的示例。项目源代码和配置如下图所示:
运行
运行项目,在浏览器中输入http://localhost:8081/
,显示结果如下:
在浏览器中输入http://localhost:8081/api/hello/spring
,显示结果如下:
这表明 Spring MVC 框架将 /api/hello/spring 的请求由类HelloController
中的spring()
方法进行了处理。