Spring MVC是Spring Framework的一部分,是基于Java实现MVC的轻量级Web框架。
下面写一下我们的第一个 Spring MVC 程序:
- 创建一个Spring MVC 项目,我是先创建了一个普通Module项目,然后为这个Module添加MVC框架支持:
- 在web.xml文件中注册DispatcherServlet:
<?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">
<!--注册DispatcherServlet,这是SpringMVC的核心:请求分发器、前端控制器-->
<servlet>
<servlet-name>springMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!--绑定SpringMVC的配置文件:-->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springMVC-servlet.xml</param-value>
</init-param>
<!--启动级别:1-->
<load-on-startup>1</load-on-startup>
</servlet>
<!--/ : 匹配所有的请求,不包括.jsp-->
<!--/* : 匹配所有的请求,包括.jsp)-->
<servlet-mapping>
<servlet-name>springMVC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
- 创建springMVC-servlet.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"
xsi:schemaLocation="http://www.springframework.org/schema/beans
https://www.springframework.org/schema/beans/spring-beans.xsd">
<!--处理器映射器-->
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>
<!--处理器适配器,不加这个也可以-->
<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>
<!--视图解析器-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="internalResourceViewResolver">
<!--前缀-->
<property name="prefix" value="/WEB-INF/jsp/"></property>
<!--后缀-->
<property name="suffix" value=".jsp"></property>
</bean>
<!--因为使用的是BeanNameUrlHandlerMapping所以要为Controller配置Bean-->
<bean id="/hello" class="controller.HelloController"></bean>
</beans>
这就是web.xml文件中关联的SpringMVC配置文件
- 创建一个HelloController类并实现org.springframework.web.servlet.mvc.Controller接口:
public class HelloController implements Controller {
@Override
public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
// 模型和视图
ModelAndView mv = new ModelAndView();
// 封装数据对象
mv.addObject("msg","Hello SpringMVC!");
// 封装即将要跳转的视图,被视图解析器解析拼装前缀后缀后:/WEB-INF/jsp/hello.jsp
mv.setViewName("hello");
return mv;
}
}
- 准备hello.jsp页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h3>${msg}</h3>
</body>
</html>
- 部署 Tomcat 及相关环境
- 启动Tomcat测试:
如果出现404错误解决方法:
或者Ctrl+Alt+Shift+S打开Project Structure:
跟踪 Spring MVC 的请求:
Spring的Web框架围绕DispatcherServlet设计,DispatcherServlet的作用是将请求分发到不同的处理器。Spring MVC框架像许多其他的MVC框架一样,以请求为驱动,围绕一个中心Servlet分派请求及提供其他功能,DispatcherServlet实际上就是一个Servlet(继承FrameWorkServlet->HttpServletBean->HttpServlet)
- DispatcherServlet表示前端控制器,是整个Spring MVC的控制核心,用户发出的请求,DispatcherServlet接受并拦截请求,然后发送给 HandlerMapping
- HandlerMapping是处理器映射,由DispatcherServlet自动调用,HandlerMapping根据URL查找对应的Handler
- HandlerMapping通过HandlerExecution解析URL找到具体的Handler
- HandlerExecution将解析后的信息传递给DispatcherServlet
- DispatcherServlet将解析后的信息交给HandlerAdapter(处理器适配器),其按照特定的规则去执行Handler
- Handler让具体的Controller执行
- Controller将具体的执行返回结果信息(ModelAndView)返回给DispatcherServlet
- DispatcherServlet调用视图解析器(ViewResolver)来解析返回结果信息(ModelAndView)
- 视图解析器根据返回的信息解析出具体要跳转哪个页面并返回给DispatcherServlet
- DispatcherServlet根据解析的页面结果和携带的信息渲染视图页面
- 将渲染后的页面呈现给用户
使用注解配置 Spring MVC:
① 以上面的例子为例,web.xml文件不变,修改springMVC-servlet.xml:
<?xml version="1.0" encoding="UTF8"?>
<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
https://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">
<!--自动扫描包,让指定包下的注解生效,有IOC容器统一管理-->
<context:component-scan base-package="Controller" />
<!--让SpringMVC不处理静态资源,如.css、.js等等-->
<mvc:default-servlet-handler />
<mvc:annotation-driven />
<!--
支持MVC注解驱动,在Spring一般采用@RequestMapping注解来完成映射关系
要想使@RequestMapping注解生效,
必须向上下文中注册DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter实例
这两个实例分别在类级别和方法级别处理,而annotation-driven配置帮助我们自动完成上述两个实例的配置注入
-->
<!-- 处理器映射器-->
<!-- <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>-->
<!-- 处理器适配器,不加这个也可以-->
<!-- <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>-->
<!--视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="internalResourceViewResolver">
<!--前缀 -->
<property name="prefix" value="/WEB-INF/jsp/"></property>
<!--后缀 -->
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
此时我们不需要再自己配置处理器映射器和处理器适配器,只要配置视图解析器
② 为 HelloController 添加注解:
@Controller
public class HelloController {
@RequestMapping("/hello1") // 这里就是URL中的请求路径
public String hello(){
model.addAttribute("msg","Hello SpringMVC Annotation!");
return "hello"; // 就是视图名字,要跳转的页面,会被视图解析器拼接前缀后缀处理
}
// public ModelAndView hello(){
// ModelAndView modelAndView = new ModelAndView();
// modelAndView.addObject("msg","Hello SpringMVC Annotation!");
// modelAndView.setViewName("hello");
// return modelAndView;
// }
}
- @Controller:标志这个类为一个控制器类,此时不用再实现Controller接口
- @RequestMapping("/hello1"):表示请求路径 /hello1 会映射到该方法上,@RequestMapping既可以放在类上也可以放在方法上,如果 @RequestMapping 作用在类上,那么就相当于是给该类所有配置的映射地址前加上了一个地址,如上面的HelloController类若被注解@RequestMapping("/first"),则表示/first/hello1才会映射到该hello方法上
上面hello方法返回的是一个字符串hello,这就是视图的名字,会被视图解析器拼接前缀后缀成为即将要跳转的页面名 /WEB-INF/jsp/hello.jsp
③ 此时再启动Tomcat测试: