【框架】----＞SpringMVC-优快云博客

本文链接：https://blog.youkuaiyun.com/qq_56932454/article/details/124978500

本文详细介绍SpringMVC框架的核心概念、开发步骤与执行流程。涵盖组件解析、注解使用、XML配置、数据响应方式等内容，深入讲解请求处理机制、数据绑定与类型转换、文件上传等高级特性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、简介

SpringMVC是一种基于java的实现MVC设计模型的请求驱动类型的轻量级Web框架，属于 SpringFrameWork的后续产品，已经融合在Spring Web Flow中,SpringMVC就是基于MVC设计模式来实现的。

我们的POJO就是Model层，我们的JSP就是视图层，我们的Controller就是控制层。

SpringMVC 已经成为目前最主流的MVC框架之一，它通过一套注解，让一个简单的 Java 类成为处理请求的控制器，而无须实现任何接口。同时它还支持 RESTful 编程风格的请求。
在这里插入图片描述

流程图：

在这里插入图片描述

二、开发步骤

在这里插入图片描述
按例：

1、导入SpringMVC包

  <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.0.5.RELEASE</version>
            <scope>compile</scope>
   </dependency>

2、配置Servlet
导入坐标：

<dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.0.1</version>
            <scope>compile</scope>
</dependency>
  <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>javax.servlet.jsp-api</artifactId>
            <version>2.2.1</version>
            <scope>provided</scope>
        </dependency>

在web.xml中配置：

 <servlet>
        <servlet-name>UserServlet</servlet-name>
        <servlet-class>com.web.UserServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>UserServlet</servlet-name>
        <url-pattern>/userServlet</url-pattern>
    </servlet-mapping>

3、编写controller并将其配置到Spring容器中

  //请求映射
    @RequestMapping("/quick")
    public String save() {
        System.out.println("Controller save running.....");
        return "/jsp/success.jsp";
    }

4、配置Spring-mvc.xml文件

   <!--Controller的组件扫描-->
    <context:component-scan base-package="com.controller">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

执行流程

在这里插入图片描述

① 用户发送请求至前端控制器DispatcherServlet。

② DispatcherServlet收到请求调用HandlerMapping处理器映射器。

③ 处理器映射器找到具体的处理器(可以根据xml配置、注解进行查找)，生成处理器对象及处理器拦截器(如果有则生成)一并返回给DispatcherServlet。

④ DispatcherServlet调用HandlerAdapter处理器适配器。

⑤ HandlerAdapter经过适配调用具体的处理器(Controller，也叫后端控制器)。

⑥ Controller执行完成返回ModelAndView。

⑦ HandlerAdapter将controller执行结果ModelAndView返回给DispatcherServlet。

⑧ DispatcherServlet将ModelAndView传给ViewReslover视图解析器。

⑨ ViewReslover解析后返回具体View。

⑩ DispatcherServlet根据View进行渲染视图（即将模型数据填充至视图中）。DispatcherServlet响应用户。

三、组件解析

前端控制：DispatcherServlet
用户请求到达前端控制器，它就相当于 MVC 模式中的 C，DispatcherServlet 是整个流程控制的中心，由它调用其它组件处理用户的请求，DispatcherServlet 的存在降低了组件之间的耦合性。
处理器映射器：HandlerMapping
HandlerMapping 负责根据用户请求找到 Handler 即处理器，SpringMVC 提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等
处理器适配器：HandlerAdapter
通过 HandlerAdapter 对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行
处理器：Handler
它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由Handler 对具体的用户请求进行处理。
视图解析器：View Resolver
View Resolver 负责将处理结果生成 View 视图，View Resolver 首先根据逻辑视图名解析成物理视图名，即具体的页面地址，再生成 View 视图对象，最后对 View 进行渲染将处理结果通过页面展示给用户。
视图：View
SpringMVC 框架提供了很多的 View 视图类型的支持，包括：jstlView、freemarkerView、pdfView等。最常用的视图就是 jsp。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户，需要由程序员根据业务需求开发具体的页面

四、注解解析

@RequestMapping(请求映射)：

作用：用于建立请求URL和处理请求方法之间的对应关系。

属性：
value：用于指定请求的URL。它和path属性的作用是一样的
method：用于指定请求的方式
params：用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的key和value必须和配置的一模一样
params = {“accountName”}，表示请求参数必须有accountName
params = {“moeny!100”}，表示请求参数中money不能是100

使用位置：
1、用在类上，请求URL的第一级访问目录。此处不写的话就相当于应用的根目录。
2、方法上，请求 URL 的第二级访问目录，与类上的使用@ReqquestMapping标注的一级目录一起组成访问虚拟路径。

MVC命名空间引入：

在这里插入图片描述

组件扫描：

SpringMVC基于Spring容器，所以在进行SpringMVC操作时，需要将Controller存储到Spring容器中，如果使用@Controller注解标注的话，就需要使用<context:component-scan base-package=“com.itheima.controller"/>进行组件扫描。

五、XML配置解析

SpringMVC有默认组件配置，默认组件都是DispatcherServlet.properties配置文件中配置的，该配置文件地址org/springframework/web/servlet/DispatcherServlet.properties，该文件中配置了默认的视图解析器。
在这里插入图片描述

在这里插入图片描述

六、数据响应方式

1、页面跳转

直接返回字符串

在这里插入图片描述
会将返回的字符串与视图解析器的前后缀拼接后跳转。

通过ModelAndView对象返回

    @RequestMapping(value = "/quick3")
    public ModelAndView save3(ModelAndView modelAndView) {
        //设置模型数据
        modelAndView.addObject("username", "...");
        //设置视图名称
        modelAndView.setViewName("success");
        return modelAndView;
    }

Spring-mvc.xml中配置：

<!--配置内部资源视图解析器-->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!--  /jsp/success.jsp  -->
        <property name="prefix" value="/jsp/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>

2、回写数据

直接返回字符串

1、通过SpringMVC框架注入的response对象，使用response.getWriter().print(“hello world”) 回写数据，此时不需要视图跳转，业务方法返回值为void。

  @RequestMapping(value = "/quick6")
    public void save6(HttpServletResponse response) throws IOException {
        response.getWriter().println("hello...");
    }

2、将需要回写的字符串直接返回，但此时需要通过@ResponseBody注解告知SpringMVC框架，方法返回的字符串不是跳转是直接在http响应体中返回。

  @RequestMapping(value = "/quick7")
    @ResponseBody//告知SpringMVC框架不进行页面跳转
    public String save7() {
        return "hello...";
    }

返回对象或集合

1、通过SpringMVC帮助我们对对象或集合进行json字符串的转换并回写，为处理器适配器配置消息转换参数，指定使用jackson进行对象或集合的转换，因此需要在spring-mvc.xml中进行如下配置：

    <!-- 配置处理器映射器   -->
        <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
            <property name="messageConverters">
                <list>
                    <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
                </list>
            </property>
        </bean>

@RequestMapping(value = "/quick10")
    @ResponseBody//告知SpringMVC框架不进行页面跳转
    //期望SpringMVC自动将User成json格式
    public User save10() throws JsonProcessingException {
        User user = new User();
        user.setName("小张");
        user.setAge(18);
        return user;
    }

2、在方法上添加@ResponseBody就可以返回json格式的字符串，但是这样配置比较麻烦，配置的代码比较多，因此，我们可以使用mvc的注解驱动代替上述配置。
在这里插入图片描述
需要配置命名空间：

    <!-- MVC的注解驱动   -->
    <mvc:annotation-driven/>

七、获得请求数据

客户端请求参数的格式是：name=value&name=value……
服务器端要获得请求参数，有时还需要进行数据的封装。

1、SpringMVC可以接收的类型参数

基本类型参数
Controller中的业务方法的参数名称要与请求参数的name一致，参数数值会自动映射匹配。并且能自动类型转换。(自动类型转换是从String向其他类型的转换)
POJO类型参数
Controller中的业务方法的POJO参数的属性名与请求参数的name一致，参数值会自动映射匹配
数组类型参数
Controller中的业务方法数组名称与请求参数的name一致，参数值会自动映射匹配。
集合类型参数
方式一：
获得集合参数时，要将集合参数包装到一个POJO中才可以。

方式二：
当使用ajax提交时，可以指定contentType为json形式，那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装。

开放资源的访问
mapping:访问地址
location:具体资源所在目录

    <mvc:resources mapping="/js/**" location="/js/"/>

上面方法找不到资源还可用以下方法：

    <!--  Tomcat找静态资源  -->
    <mvc:default-servlet-handler/>

2、请求数据乱码问题

当post请求时，数据会出现乱码，我们可以设置一个过滤器来进行编码的过滤。

    <!-- 配置全局过滤的filter-->
    <filter>
        <filter-name>CharacterEncodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
    </filter>

    <filter-mapping>
        <filter-name>CharacterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

3、参数绑定注解@requestParam

当请求的参数名称与Controller的业务方法名称不一致时，就需要通过该注解显示的绑定。
在这里插入图片描述
value:请求的参数名称
required:在指定的请求参数是否必须包括，默认是true，提交时如果没有此参数则报错。
defaultValue:当没有指定请求参数时，则使用指定的默认值赋值。

4、SpringMVC获得Restful风格的参数

在这里插入图片描述
Restful风格的请求是使用“url+请求方式”表示一次请求目的的，HTTP 协议里面四个表示操作方式的动词如:
GET:用于获取资源
POST:用于新建资源
PUT：用于更新资源
DELETE：用于删除资源

在这里插入图片描述

上述url地址/user/1中的1就是要获得的请求参数，在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成/user/{id}，占位符{id}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作。

在这里插入图片描述

5、自定义类型转换器

SpringMVC默认已经提供了一些常用的类型转换器，例如客户端提交的字符串转换成int型进行参数设置。

不是所有的数据类型都提供了转换器，没有提供的就需要自定义转换器，例如：日期类型的数据就需要自定义转换器。

自定义类型转换器的开发步骤：

1、定义转换器类实现Converter接口

public class DateConverter implements Converter<String, Date> {
    @Override
    public Date convert(String dateStr) {
        //将日期字符串转换成日期对象 返回
        SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
        Date date = null;
        try {
            date = format.parse(dateStr);
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return date;
    }
}

2、在配置文件中声明转换器

 <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="converters">
            <list>
                <bean class="com.converter.DateConverter"></bean>
            </list>
        </property>
    </bean>

3、在中引用转换器

 <!-- MVC的注解驱动   -->
    <mvc:annotation-driven conversion-service="conversionService"/>

6、获得Servlet相关API

SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数注入，常用对象有:

	HttpServletRequest
	HttpServletResponse
	HttpSession

  @RequestMapping(value = "/quick19")
    @ResponseBody//告知SpringMVC框架不进行页面跳转
    public void save19(HttpServletRequest request, HttpServletResponse response, HttpSession session) throws Exception {
        System.out.println(request);
        System.out.println(response);
        System.out.println(session);
    }

7、获得请求头

@RequestHeader：
使用@RequestHeader可以获得请求头信息，相当于web阶段学习的request.getHeader(name)。

  @RequestMapping(value = "/quick20")
    @ResponseBody//告知SpringMVC框架不进行页面跳转
    public void save20(@RequestHeader(value = "User-Agent", required = false) String user_agent) throws Exception {
        System.out.println(user_agent);
    }

value:请求头名称
required:是否必须携带请求头

@CookieValue:
使用@CookieValue可以获得指定Cookie的值。

   @RequestMapping(value = "/quick21")
    @ResponseBody//告知SpringMVC框架不进行页面跳转
    public void save21(@CookieValue(value = "JSESSIONID", required = false) String jsessionId) throws Exception {
        System.out.println(jsessionId);
    }

value:指定cookie的名称
required:是否必须携带此cookie

8、文件上传

文件上传客户端三要素：
1、表单项type=“file”
2、表单的提交方式是post
3、表单的enctype属性是多部分表单形式，及enctype=“multipart/form-data”

<form action="${pageContext.release().contexPath}/user/quick20" method="post" enctype="multipart/form-data">
    名称：<input type="text" name="name"><br>
    文件：<input type="file" name="file"><br>
    <input type="submit" value="提交">
</form>

文件上传原理：
在这里插入图片描述

单文件上传步骤

1、导入fileupload和io坐标

<dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>1.3.1</version>
        </dependency>
        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>2.6</version>
        </dependency>

2、配置文件上传解析器

 <!--配置文件上传解析器-->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="defaultEncoding" value="UTF-8"/>
        <property name="maxInMemorySize" value="500000"/>
    </bean>

3、编写文件上传代码
在这里插入图片描述
MultipartFile与from表单中file名字一致

<form action="${pageContext.release().contexPath}/user/quick20" method="post" enctype="multipart/form-data">
    名称：<input type="text" name="name"><br>
    文件：<input type="file" name="file"><br>
    <input type="submit" value="提交">
</form>

多文件上传

在这里插入图片描述

八、SpringMVC拦截器

作用：SpringMVC的拦截器类似于Servlet开发中的过滤器Filter,用于处理器进行预处理和后处理。

将拦截器按一定顺序连接成一条链，这条链称为拦截器链（Interceptor Chain）。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用。拦截器也是AOP思想的具体实现。

拦截器和过滤器的区别

区别	过滤器	拦截器
使用范围	是servlet规范中的一部分，任何Java Web 工程都可以使用	是SpringMVC框架自己的，只有使用了SpringMVC框架的工程才能用
拦截范围	在url-pattern中配置了/*之后，可以对所有要访问的资源拦截	只会拦截访问的控制器方法，如果访问的是jsp,html,css,image或者是js是不会进行拦截的

自定义拦截器的步骤

1、创建拦截器类实现HandlerInterceptor接口

public class Myinterceptor implements HandlerInterceptor {
    //在目标方法执行之前执行
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("preHandle");
        String param = request.getParameter("param");
        if ("yes".equals(param)) {
            return true;
        } else {
            request.getRequestDispatcher("/error.jsp").forward(request, response);
            return false;//代表放不放行
        }
    }

    //在目标方法执行之后 视图对象返回之前执行
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        modelAndView.addObject("name", "xiaozhang");
        System.out.println("postHandle");
    }

    //在整个流程都执行完毕后执行
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("afterCompletion");
    }
}

在这里插入图片描述

2、配置拦截器

 <!--配置拦截器-->
    <mvc:interceptors>
        <mvc:interceptor>
            <!--对哪些资源执行拦截操作-->
            <mvc:mapping path="/**"/>
            <bean class="com.interceptor.Myinterceptor"/>
        </mvc:interceptor>

        <mvc:interceptor>
            <!--对哪些资源执行拦截操作-->
            <mvc:mapping path="/**"/>
            <bean class="com.interceptor.Myinterceptor2"/>
        </mvc:interceptor>
    </mvc:interceptors>

3、测试拦截器的拦截效果

@Controller
public class TargetController {
    @RequestMapping("/target")
    public ModelAndView show() {
        System.out.println("目标资源执行.....");
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("name", "xiaozhang");
        modelAndView.setViewName("index");
        return modelAndView;
    }
}

九、异常处理机制

异常处理思路

在这里插入图片描述
系统中异常包括两类：
预期异常：通过捕获异常从而获取异常信息
运行时异常RuntimeException：通过规范代码开发、测试等手段减少运行时异常的发生

异常处理的两种方式

1、使用SpringMVC提供的简单异常处理器SimpleMappingExceptionResolver(简单映射异常处理器)

SpringMVC已经定义好了类型转换器，在使用时可以根据项目情况进行相应异常与视图的映射配置

在这里插入图片描述

2、使用Spring的异常处理接口HandlerExceptionResolver自定义自己的异常处理器

处理步骤:
1、创建异常处理类实现HandlerExceptionResolver
在这里插入图片描述
instanceof是Java的一个保留关键字，左边是对象，右边是类，返回类型是Boolean类型。它的具体作用是测试左边的对象是否是右边类或者该类的子类创建的实例对象，是，则返回true，否则返回false。
2、配置异常处理器

//自定义异常处理器
<bean class="com.MyExceptionRedolver"/>

3、编写异常页面
4、测试异常跳转