写在前面:
- 参考博客:SpringMVC 简介
- 具体代码(可直接运行):
1. 基于 xml 配置文件实现
- 新建一个 Moudle , springmvc-02-hello , 添加 web 的支持!
- 确定导入了 SpringMVC 的依赖!
<dependencies>
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>javax.servlet.jsp-api</artifactId>
<version>2.3.3</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>javax.servlet.jsp.jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.2.0.RELEASE</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
</dependency>
</dependencies>
- 配置 web.xml , 注册 DispatcherServlet;绑定 Spring 配置文件 (spring-servlet.xml)
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
version="5.0">
<!-- 1.注册DispatcherServlet -->
<!-- 接收请求、拦截请求 -->
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 绑定Spring配置文件 -->
<!-- 关联一个springmvc的配置文件:【servlet-name】-servlet.xml-->
<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 的配置文件!名称:springmvc-servlet.xml : [servletname]-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
http://www.springframework.org/schema/beans/spring-beans.xsd">
<!-- 添加 处理映射器 -->
<!-- 根据url查找控制器 -->
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping" />
<!-- 添加 处理器适配器 -->
<!-- 其按照特定的规则去执行Handler -->
<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter "/>
<!--视图解析器:DispatcherServlet给他的ModelAndView-->
<!-- 1.获取了 ModelAndView 的数据
2. 解析了 ModelAndView 的视图名字
3. 拼接视图名字,找到对应的视图 /WEB-INF/jsp/hello.jsp
4. 将数据渲染视图 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
<!--前缀-->
<property name="prefix" value="/WEB-INF/jsp/"/>
<!--后缀-->
<property name="suffix" value=".jsp"/>
</bean>
<!--Handler-->
<!-- 注册HelloController -->
<bean id="/hello" class="com.controller.HelloController"/>
</beans>
- 编写我们要操作业务 Controller ,实现 Controller 接口;需要返回一个
ModelAndView,装数据,封视图;同时在 springmvc-servlet.xml 中注册bean
public class HelloController implements Controller {
@Override
public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
// ModelAndView 模型和视图
ModelAndView mv = new ModelAndView();
// 封装对象,放在 ModelAndView 中
mv.addObject("message","HelloSpringMVC!");
// 封装要跳转的视图,放在 ModelAndView 中
mv.setViewName("hello"); // /WEB-INIF/jsp/hello.jsp
return mv;
}
}
- 写要跳转的 jsp 页面,显示 ModelandView 存放的数据,以及我们的正常页面;
<%@ page contentType="text/html; charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
${message}
</body>
</html>
- 配置 Tomcat 启动测试
2. 基于注解实现 [ 重要!]
注解版实现,才是 SpringMVC 的精髓!
- 新建一个Moudle,springmvc-03-hello-annotation 。添加 web 支持!
建立包结构 com.kuang.controller - 由于 Maven 可能存在资源过滤的问题,我们将配置完善
<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>
-
在 pom.xml 文件引入相关的依赖:主要有 Spring 框架核心库、Spring MVC、servlet , JSTL等。
-
配置web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
version="5.0">
<!-- 1.注册DispatcherServlet -->
<!-- 接收请求、拦截请求 -->
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 绑定Spring配置文件 -->
<!-- 关联一个springmvc的配置文件:【servlet-name】-servlet.xml-->
<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>
注意:/ 和 /* 的区别:
< url-pattern > / </ url-pattern > 不会匹配到.jsp, 只针对我们编写的请求;即:.jsp 不会进入spring的 DispatcherServlet类 。
< url-pattern > /* </ url-pattern > 会匹配*.jsp, 会出现返回 jsp视图 时再次进入spring的DispatcherServlet 类,导致找不到对应的controller所以报404错。
- 添加 Spring MVC 配置文件(spring-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"
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
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="com.controller"/>
<!-- 让Spring MVC不处理静态资源 -->
<mvc:default-servlet-handler />
<!-- 支持mvc注解驱动 在spring中一般采用@RequestMapping注解来完成映射关系
要想使@RequestMapping注解生效
必须向上下文中注册DefaultAnnotationHandlerMapping
和一个AnnotationMethodHandlerAdapter实例
这两个实例分别在类级别和方法级别处理。
而annotation-driven配置帮助我们自动完成上述两个实例的注入。 -->
<mvc:annotation-driven />
<!-- 视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver "
id="internalResourceViewResolver">
<!-- 前缀 -->
<property name="prefix" value="/WEB-INF/jsp/" />
<!-- 后缀 -->
<property name="suffix" value=".jsp" />
</bean>
</beans>
- 创建Controller
编写一个Java控制类: com.controller.HelloController , 注意编码规范
@Controller
@RequestMapping("/HelloController")
public class HelloController {
// 真实访问地址: localhost:8080/HelloController/hello
@RequestMapping("/hello")
public String sayHello(Model model){
// 向模型中添加属性值message,可以与JSP页面中取出并渲染
model.addAttribute("message","Hello SpringMVC!!!");
// WEB-INF/jsp/hello.jsp
return "hello";
}
}
- @Controller 是为了让 Spring IOC 容器初始化时自动扫描到;
- @RequestMapping 是为了映射请求路径,这里因为类与方法上都有映射所以访问时应该是 /HelloController/hello;
- 方法中声明 Model 类型的参数是为了把 Action 中的数据带到视图中;
- 方法返回的结果是视图的名称 hello,加上配置文件中的前后缀变成 WEB-INF/jsp/hello.jsp。
- 创建视图层
在WEB-INF/ jsp目录中创建hello.jsp , 视图可以直接取出并展示从Controller带回的信息;可以通过EL表示取出Model中存放的值,或者对象。
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
${message}
</body>
</html>
- 配置 Tomcat 运行
ok! 运行成功!!!
3. 可能遇到的问题
可能遇到的问题:访问出现404,排查步骤:
- 查看控制台输出,看一下是不是缺少了什么jar包。
- 如果jar包存在,显示无法输出,就在IDEA的项目发布中,添加lib依赖!
- 重启Tomcat 即可解决!
4. 总结
实现步骤其实非常的简单:
- 新建一个web项目
- 导入相关 jar 包 3. 编写 web.xml , 注册 DispatcherServlet
- 编写 springmvc 配置文件
- 接下来就是去创建对应的控制类 , controller
- 最后完善前端视图和 controller 之间的对应
- 测试运行调试.
使用 springMVC 必须配置的三大件:
处理器映射器、处理器适配器、视图解析器
通常,我们只需要手动配置视图解析器,而处理器映射器和处理器适配器只需要开启注解驱动即可,而省去了大段的 xml 配置。