当前位置:   article > 正文

SpringMVC 学习(二)之第一个 SpringMVC 案例

SpringMVC 学习(二)之第一个 SpringMVC 案例

目录

1 通过 Maven 创建一个 JavaWeb 工程

2 配置 web.xml 文件

3 创建 SpringMVC 配置文件 spring-mvc.xml

4 创建控制器 HelloController 

5 创建视图 index.jsp 和 success.jsp 

6 运行过程

7 参考文档


1 通过 Maven 创建一个 JavaWeb 工程

可以参考以下博文:IDEA 2023.2 配置 JavaWeb 工程-CSDN博客icon-default.png?t=N7T8https://blog.csdn.net/zjs246813/article/details/136199249导入依赖

  1. <dependencies>
  2. <!-- Spring 相关依赖-->
  3. <dependency>
  4. <groupId>org.springframework</groupId>
  5. <artifactId>spring-context</artifactId>
  6. <version>5.2.7.RELEASE</version>
  7. </dependency>
  8. <dependency>
  9. <groupId>org.springframework</groupId>
  10. <artifactId>spring-web</artifactId>
  11. <version>5.2.7.RELEASE</version>
  12. </dependency>
  13. <dependency>
  14. <groupId>org.springframework</groupId>
  15. <artifactId>spring-webmvc</artifactId>
  16. <version>5.2.7.RELEASE</version>
  17. </dependency>
  18. <!-- Servlet 相关依赖-->
  19. <dependency>
  20. <groupId>javax.servlet</groupId>
  21. <artifactId>servlet-api</artifactId>
  22. <version>2.5</version>
  23. <scope>provided</scope>
  24. </dependency>
  25. <!-- jsp 相关依赖-->
  26. <dependency>
  27. <groupId>javax.servlet.jsp</groupId>
  28. <artifactId>jsp-api</artifactId>
  29. <version>2.0</version>
  30. <scope>provided</scope>
  31. </dependency>
  32. <!--单元测试的依赖-->
  33. <dependency>
  34. <groupId>junit</groupId>
  35. <artifactId>junit</artifactId>
  36. <version>4.11</version>
  37. <scope>test</scope>
  38. </dependency>
  39. <!-- Spring5和Thymeleaf整合包 -->
  40. <dependency>
  41. <groupId>org.thymeleaf</groupId>
  42. <artifactId>thymeleaf-spring5</artifactId>
  43. <version>3.0.12.RELEASE</version>
  44. </dependency>
  45. </dependencies>

工程目录

2 配置 web.xml 文件

通过 web.xml 配置 Spring 提供的 CharacterEncodingFilter 过滤器和核心控制器 DispatcherServlet。其中 CharacterEncodingFilter 过滤器用于防止乱码。

关于 Servlet 和 Filter 知识可以看下以下博文:

Tomcat 学习之 Servlet-CSDN博客icon-default.png?t=N7T8https://blog.csdn.net/zjs246813/article/details/136183562?spm=1001.2014.3001.5501Tomcat 学习之 Filter 过滤器-CSDN博客icon-default.png?t=N7T8https://blog.csdn.net/zjs246813/article/details/136221542?spm=1001.2014.3001.5501

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
  5. version="4.0">
  6. <!-- 配置编码过滤器,防止乱码 -->
  7. <filter>
  8. <filter-name>encodingFilter</filter-name>
  9. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  10. <!--支持异步处理-->
  11. <async-supported>true</async-supported>
  12. <!-- 配置encoding,告诉指定的编码格式,这里设置为UTF-8 -->
  13. <init-param>
  14. <param-name>encoding</param-name>
  15. <param-value>UTF-8</param-value>
  16. </init-param>
  17. <!-- 解决请求乱码 -->
  18. <init-param>
  19. <param-name>forceRequestEncoding</param-name>
  20. <param-value>true</param-value>
  21. </init-param>
  22. <!-- 解决响应乱码 -->
  23. <init-param>
  24. <param-name>forceResponseEncoding</param-name>
  25. <param-value>true</param-value>
  26. </init-param>
  27. </filter>
  28. <filter-mapping>
  29. <filter-name>encodingFilter</filter-name>
  30. <url-pattern>/*</url-pattern>
  31. </filter-mapping>
  32. <!-- 配置SpringMVC核心控制器 DispatcherServlet -->
  33. <servlet>
  34. <servlet-name>springmvc</servlet-name>
  35. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  36. <!-- 通过初始化参数指定SpringMVC配置文件的位置和名称 -->
  37. <init-param>
  38. <param-name>contextConfigLocation</param-name>
  39. <!-- 使用classpath:表示从类路径查找配置文件,例如maven工程中的src/main/resources -->
  40. <param-value>classpath:spring-mvc.xml</param-value>
  41. </init-param>
  42. <!-- servlet 启动时加载 -->
  43. <load-on-startup>1</load-on-startup>
  44. <!--支持异步处理-->
  45. <async-supported>true</async-supported>
  46. </servlet>
  47. <servlet-mapping>
  48. <servlet-name>springmvc</servlet-name>
  49. <url-pattern>/</url-pattern>
  50. </servlet-mapping>
  51. </web-app>

3 创建 SpringMVC 配置文件 spring-mvc.xml

配置包扫描和注册视图解析器

当使用 @Controller 或 @RestController 注解来定义控制器,并在控制器方法上使用 @RequestMapping 注解来映射请求路径时,SpringMVC 框架会为 @RequestMapping 注解自动配置必要的组件。如果自定义了一个 Handler 实现类,需要通过<mvc:annotation-driven> 标签启用注解驱动,它会自动添加相应的注解驱动配置。

  • RequestMappingHandlerMapping 是负责管理请求 URL 和处理器方法之间映射关系的组件。它会在容器启动时扫描所有的控制器类和方法,解析 @RequestMapping 注解,并建立起请求 URL 与相应处理器方法之间的映射关系
  • RequestMappingHandlerAdapter 是负责执行由 RequestMappingHandlerMapping 映射到的处理器方法的组件。它会根据请求的 URL 找到对应的处理器方法,并调用该方法来生成响应
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xmlns:context="http://www.springframework.org/schema/context"
  5. xmlns:mvc="http://www.springframework.org/schema/mvc"
  6. xsi:schemaLocation="http://www.springframework.org/schema/beans
  7. http://www.springframework.org/schema/beans/spring-beans.xsd
  8. http://www.springframework.org/schema/context
  9. http://www.springframework.org/schema/context/spring-context.xsd
  10. http://www.springframework.org/schema/mvc
  11. https://www.springframework.org/schema/mvc/spring-mvc.xsd">
  12. <!-- 扫描指定包下的注解 -->
  13. <context:component-scan base-package="com.controller"/>
  14. <!-- 配置注解驱动,它的主要的作用是:注册映射器HandlerMapping和适配器HandlerAdapter 两个类型的Bean -->
  15. <!--HandlerMapping的实现为实现类RequestMappingHandlerMapping,它会处理 @RequestMapping 注解,并将其注册到请求映射表中-->
  16. <!--HandlerAdapter的实现为实现类RequestMappingHandlerAdapter,它是处理请求的适配器,确定调用哪个类的哪个方法,并且构造方法参数,返回值 -->
  17. <!--在使用SpringMVC是一般都会加上该配置 -->
  18. <mvc:annotation-driven/>
  19. <!-- InternalResourceViewResolver 是 SpringMVC 中用于解析和渲染内部资源视图(通常是 JSP 页面)的视图解析器。
  20. 它根据视图名称查找并加载对应的 JSP 文件,并将模型数据传递给 JSP 进行展示 -->
  21. <!-- 注册视图解析器 -->
  22. <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  23. <!-- 配置前缀 -->
  24. <property name="prefix" value="/WEB-INF/pages/"/>
  25. <!-- 配置后缀 -->
  26. <property name="suffix" value=".jsp"/>
  27. </bean>
  28. </beans>

4 创建控制器 HelloController 

  1. package com.thr.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.bind.annotation.RequestMapping;
  4. @Controller //声明Bean对象,为一个控制器组件
  5. public class HelloController {
  6. /**
  7. * 1. @RequestMapping 注解是用来映射请求的 URL
  8. * 2. 返回值会通过视图解析器解析为实际的物理视图, 对应 InternalResourceViewResolver 视图解析器,它会做如下的解析:
  9. * -通过 prefix + returnVal + suffix 这样的方式得到实际的物理视图, 然后做转发操作.
  10. * -这里得到的物理视图为:/WEB-INF/pages/success.jsp
  11. */
  12. @RequestMapping("/hello")
  13. public String sayHello(){
  14. System.out.println("Hello SpringMVC");
  15. //访问成功后跳转到success页面
  16. return "success";
  17. }
  18. }

5 创建视图 index.jsp 和 success.jsp 

index.jsp

  1. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" isELIgnored="false" %>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  3. <html>
  4. <head>
  5. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  6. <title>Insert title here</title>
  7. </head>
  8. <body>
  9. <a href="${pageContext.request.contextPath}/hello">第一个Spring MVC程序 </a>
  10. <div>${pageContext.request.contextPath}/hello</div>
  11. </body>
  12. </html>

success.jsp

  1. <%@ page language="java" contentType="text/html; charset=UTF-8"
  2. pageEncoding="UTF-8" %>
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  4. <html>
  5. <head>
  6. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. <title>Hello</title>
  8. </head>
  9. <body>
  10. <h1>成功访问!!!</h1>
  11. </body>
  12. </html>

6 运行过程

启动 Tomcat,进入首页文件 index.jsp

点击链接跳转到 hello.jsp

运行过程:  

        启动 Tomcat,服务器解析 web.xml,创建名称为 encodingFilter 的 CharacterEncodingFilter 过滤器并初始化,创建名称为 springmvc 的 DispatcherServlet (前端控制器)并初始化(DispatcherServlet  的 <load-on-startup> 设置为 1服务器启动时会创建并初始化,然后进入首页文件 index.jsp,因为过滤器 encodingFilter 的 <url-pattern> 为 /*,会拦截所有请求进行编码设置,之后才显示 index.jsp 的内容。

  1.  点击链接,客户端请求访问 http://localhost:8080/SpringMVCTest/hello,被 <url-pattern> 为 / 的 DispatcherServlet (前端控制器)拦截处理。
  2. DispatcherServlet (前端控制器)会读取 SpringMVC 的核心配置文件 spring-mvc.xml,通过扫描组件找到控制器 (HelloController)(@Controller 注解将其标识为一个控制层组件,交给 Spring 的 IoC 容器管理,此时 SpringMVC 才能够识别控制器的存在)。
  3. HandlerMapping (处理器映射器,该案例中 HandlerMapping 为 RequestMappingHandlerMapping根据 RequestMapping 注解中的信息(如 value 属性值)来确定 URL 请求应该给哪个 Handler (处理器),@RequestMapping 注解标识的方法在 SpringMVC 中充当处理器的角色,它们负责处理具体的请求并返回相应的响应。
  4. HandlerAdapter (处理器适配器,该案例中 HandlerAdapter 为 RequestMappingHandlerAdapter)调用由 HandlerMapping(处理器映射器)定位到的处理器,处理器处理请求的方法并返回一个字符串类型的逻辑视图名称 (success)。
  5. 该逻辑视图名称 (success) 会被视图解析器解析,加上前缀 (/WEB-INF/pages/) 后缀 (.jsp) 组成物理视图名称,即具体的页面的路径 (/WEB-INF/pages/success.jsp),生成并返回具体对象 View(SpringMVC 封装对象,是一个接口)给 DispatcherServlet (前端控制器)
  6. 前端控制器向客户端返回响应。

注:以上为自己理解的过程,有问题 敬请指正!

加一张大家应该都见过的图

7 参考文档

SpringMVC入门学习(二)----SpringMVC的第一个案例 - 唐浩荣 - 博客园 (cnblogs.com)

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/笔触狂放9/article/detail/143665
推荐阅读
相关标签
  

闽ICP备14008679号