SpringBoot整合springmvc、扩展springmvc

[一、 SpringMVC三大组件](#一、 SpringMVC三大组件)
[二、 Spring MVC 组件的自动管理](#二、 Spring MVC 组件的自动管理)
- [2.1 中央转发器（DispatcherServlet）](#2.1 中央转发器（DispatcherServlet）)
- [2.2 控制器](#2.2 控制器)
- [2.3 视图解析器自动管理](#2.3 视图解析器自动管理)
- [2.4 静态资源访问](#2.4 静态资源访问)
- [2.5 消息转换和格式化](#2.5 消息转换和格式化)
- [2.6 欢迎页面的自动配置](#2.6 欢迎页面的自动配置)
三、Springboot扩展springmvc
- [3.1 视图控制器注册（请求转发）](#3.1 视图控制器注册（请求转发）)
- [3.2 注册格式化器](#3.2 注册格式化器)
- [3.3 消息转换器扩展 Fastjson](#3.3 消息转换器扩展 Fastjson)
- [3.4 拦截器注册](#3.4 拦截器注册)
四、结语

一、 SpringMVC三大组件

在学习SpringBoot整合springmvc，首先要了解SpringMVC三大组件：

1. HandlerMapping处理器映射器 :建立地址与方法的映射,
  HandlerMapping负责根据用户请求url找到Handler即处理器，springmvc提供了不同的映射器实现不同的映射方式，例如:配置文件方式，实现接口方式，注解方式等。
1. HandlerAdapter处理器适配器 :根据地址调用方法。
  Handler 是继DispatcherServlet前端控制器的后端控制器，在DispatcherServlet的控制下Handler对具体的用户请求进行处理。
1. ViewResolver 视图解析器 :处理ModelAndView数据和视图。
  ViewResolver通过HandlerAdapter对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行。

二、 Spring MVC 组件的自动管理

在Spring Boot项目中，一旦引入了 Web依赖启动器 : spring-boot-starter-web ，那么SpringBoot 整合Spring MVC框架默认实现的一些 xxxAutoConfiguration 自动配置类就会自动生效 ( 通过配置类把相关的类加入到IOC容器中 ) ，几乎可以在无任何额外配置的情况下进行Web 开发。

SpringBoot为整合SpringMVC框架实现Web开发，主要提供了以下自动化配置的功能特性：

(1）内置了两个视图解析器 : ContentNegotiatingViewResolver 和 BeanNameViewResolver。

(2) 支持静态资源以及 WebJars。

(3）自动注册了转换器和格式化器。

(4）支持 Http消息转换器。

(5）自动注册了消息代码解析器。

(6）支持静态项目首页 index.html。

(7）支持定制应用图标 favicon.ico。

(8）自动初始化Web数据绑定器： ConfigurableWebBindingInitializer。

Spring Boot 整合Spring MVC进行 Web开发时提供了很多默认配置，而且大多数时候使用默认配置即可满足开发需求。

例如，Spring Boot整合Spring MVC进行Web开发时，不需要额外配置视图解析器。

2.1 中央转发器（DispatcherServlet）

在传统的 Spring MVC 项目中，需要在 web.xml 中配置中央转发器，示例如下：

xml 复制代码

<servlet>
    <servlet-name>chapter2</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>chapter2</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

而在 Spring Boot 中，中央转发器被自动接管，无需在 web.xml 中配置（Spring Boot 项目一般不存在 web.xml），相关自动配置类为

2.2 控制器

在 Spring Boot 中，控制器（Controller）在注解扫描范围内自动管理，开发者只需编写控制器类并使用相应的注解（如 @Controller、@RequestMapping 等）即可。

2.3 视图解析器自动管理

Spring Boot 自动配置了视图解析器相关内容，会自动包含 ContentNegotiatingViewResolver 和 BeanNameViewResolver 这两个 bean。
ContentNegotiatingViewResolver：组合所有的视图解析器。

在传统的 Spring MVC 项目中，配置视图解析器可能如下：

xml 复制代码

<bean id="de" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/jsp/"></property>
    <property name="suffix" value="*.jsp"></property>
</bean>

在 Spring Boot 中，通过源码配置：

java 复制代码

public ContentNegotiatingViewResolver viewResolver(BeanFactory beanFactory) {
    ContentNegotiatingViewResolver resolver = new ContentNegotiatingViewResolver();
    resolver.setContentNegotiationManager((ContentNegotiationManager)beanFactory.getBean(ContentNegotiationManager.class));
    resolver.setOrder(-2147483648);
    return resolver;
}

此外，当涉及文件上传时，multipartResolver 也会被自动配置好。

2.4 静态资源访问

具体内容可参见 SpringBoot对静态资源的映射规则

2.5 消息转换和格式化

消息转换器：Spring Boot 自动配置了消息转换器，例如通过 @RequestBody 注解，将请求体中的 JSON/XML 数据转换为 Java 对象。
格式化转换器：自动注册了格式化转换器。对于时间类型，可以在配置文件中指定时间的模式，例如：

properties 复制代码

# 配置时间格式
spring.mvc.format.date=yyyy-MM-dd

2.6 欢迎页面的自动配置

Spring Boot 会自动指定 resources 下的 index.html 作为欢迎页面。

三、Springboot扩展springmvc

在实际开发中springboot并非完全自动化，我们往往需要根据业务需求进行自定义配置。Spring Boot 提供了多种接口和配置类，允许开发者扩展和自定义功能。

3.1 视图控制器注册（请求转发）

Spring Boot 允许我们通过实现 WebMvcConfigurer 接口的 addViewControllers 方法来注册视图控制器。

java 复制代码

@Configuration
public class MyMVCCofnig implements WebMvcConfigurer {
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/tx").setViewName("success");
    }
}

@Configuration 注解表明这是一个配置类。

MyMVCCofnig 类实现了 WebMvcConfigurer 接口。

addViewControllers 方法用于注册视图控制器。在这里，我们添加了一个视图控制器，当访问 /tx 路径时，会转发到名为 success 的视图。

3.2 注册格式化器

格式化器在处理日期等数据类型时非常有用。通过实现 addFormatters 方法，我们可以自定义如何格式化和解析日期。

java 复制代码

@Override
public void addFormatters(FormatterRegistry registry) {
    registry.addFormatter(new Formatter<Date>() {
        @Override
        public String print(Date date, Locale locale) {
            return null;
        }
        @Override
        public Date parse(String s, Locale locale) throws ParseException {
            return new SimpleDateFormat("yyyy-MM-dd").parse(s);
        }
    });
}

FormatterRegistry 用于注册自定义的格式化器。

我们创建了一个 Formatter 实现，定义了如何解析字符串为 Date 对象（parse 方法）和如何将 Date 对象格式化为字符串（print 方法）。在这里，我们只实现了 parse 方法，用于将符合 "yyyy-MM-dd" 格式的字符串解析为 Date 对象。

3.3 消息转换器扩展 Fastjson

Spring Boot 默认使用 Jackson 作为 JSON 库，但有时我们需要使用 Fastjson 来处理 JSON 数据。我们可以通过配置消息转换器来扩展 Fastjson。
（1）引入 Fastjson 依赖

在 pom.xml 中添加 Fastjson 依赖：

xml 复制代码

<dependency>
   <groupId>com.alibaba</groupId>
   <artifactId>fastjson</artifactId>
   <version>1.2.47</version>
</dependency>

（2）配置消息转换器

java 复制代码

@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
    FastJsonHttpMessageConverter fc = new FastJsonHttpMessageConverter();
    FastJsonConfig fastJsonConfig = new FastJsonConfig();
    fastJsonConfig.setSerializerFeatures(SerializerFeature.PrettyFormat);
    fc.setFastJsonConfig(fastJsonConfig);
    converters.add(fc);
}

configureMessageConverters 方法允许我们配置消息转换器。

我们创建了一个 FastJsonHttpMessageConverter 实例，并设置了序列化特性 SerializerFeature.PrettyFormat，使得 JSON 输出格式化。

将 Fastjson 转换器添加到转换器列表中，从而扩展了 Spring Boot 的消息转换功能。

（3）控制实体类序列化

在实体类中，我们可以使用 @JSONField 注解来控制字段的序列化和反序列化。

java 复制代码

public class User {
    private String username;
    private String password;
    private int age;
    private int score;
    private int gender;
    @JSONField(format = "yyyy-MM-dd")
    private Date date;
}

@JSONField 注解用于指定字段的序列化和反序列化格式。在这个例子中，date 字段被格式化为 "yyyy-MM-dd"。

3.4 拦截器注册

拦截器在请求处理过程中扮演着重要角色，可以用来进行权限检查、日志记录等。
（1）创建拦截器

java 复制代码

public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("前置拦截");
        return true;
    }
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("后置拦截");
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("最终拦截");
    }
}

（2）注册拦截器

java 复制代码

@Override
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(new MyInterceptor())
            .addPathPatterns("/**")
            .excludePathPatterns("/hello2");
}

addInterceptors 方法用于注册拦截器。

我们添加了 MyInterceptor 拦截器，并指定它拦截所有路径（"/**"），除了 /hello2 路径。

四、结语

Spring Boot在整合Spring MVC过程中提供了许多默认自动化配置和特性，开发者可以通过Spring Boot提供的 WebMvcConfigurer接口对 MVC功能进行定制和扩展。
如果开发者不想使用Spring Boot整合MVC时提供的一些默认配置，而是想要绝对的自定义管理，那么可以编写一个 @Configuration注解配置类，同时添加 @EnableWebMvc注解来关闭Spring Boot提供的所有关于MVC功能的默认配置。

SpringBoot整合springmvc、扩展springmvc

目录

一、 SpringMVC三大组件

二、 Spring MVC 组件的自动管理

2.1 中央转发器（DispatcherServlet）

2.2 控制器

2.3 视图解析器自动管理

2.4 静态资源访问

2.5 消息转换和格式化

2.6 欢迎页面的自动配置

三、Springboot扩展springmvc

3.1 视图控制器注册（请求转发）

3.2 注册格式化器

3.3 消息转换器扩展 Fastjson

3.4 拦截器注册

四、结语