上一篇Blog我们通过两种形式，分别基于配置和基于注解实现了Spring MVC的第一个框架程序，接下来本篇Blog就针对我们的控制器做一个深入的研究和探讨，既然是一个Controller，那么肯定包含两个主题内容：接收请求和返回响应，针对这两个大的方向我们深入研究下，例如在接收请求的时候，参数类型有哪些，如何解决乱码问题，如何使用RestFul风格传参，怎么获取请求附加信息等；在返回响应的时候我们需要搞明白数据的返回形式以及页面的返回形式有哪些。当然顺带附加理解下静态资源的访问问题。接下来的整个测试环境我们使用上篇Blog【Spring MVC学习笔记二】构建第一个Spring MVC框架程序中的base-annotation模块，Spring MVC这一部分还是使用注解更多一些，为什么呢，因为一个注解我们可以拓展很多的方法，而基于配置只能使用一个handleRequest

静态资源访问问题

当对前端控制器设置为拦截资源的路径( url-pattern )为/时,此时出现不能访问静态资源的问题

问题现象

例如我们在webapp下创建文件夹image，然后增加一张图片：

然后请求图片地址访问时出现如下异常：

问题原因

这是为什么呢？因为在Tomcat中处理静态资源的servlet ( default )所映射路径为就是/。启动项目的时候Tomcat中的web.xml是先加载,项目的web.xml是后加载,如果配置了相同的映射路径,项目中的web.xml会覆盖Tomcat中web.xml相同的配置。

<!--配置前端控制器-->
    <servlet>
        <!--1.注册DispatcherServlet-->
        <servlet-name>springMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--通过初始化参数指定SpringMVC配置文件的位置，进行关联-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <!--关联一个springMVC的配置文件:【servlet-name】-servlet.xml-->
            <param-value>classpath:springmvc-servlet.xml</param-value>
        </init-param>
        <!--启动级别-1,在Tomcat启动时就初始化Spring容器-->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>springMVC</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

也就是说, SpringMVC中的DispatcherServlet的映射路径覆盖了Tomcat默认对静态资源的处理的路径。此时SpringMVC会把静态资源当做是Controller寻找并访问，当然结果肯定是找不到

解决方案

在springmvc-servlet.xml中配置<mvc:default-servlet-handler />可以解决该问题，有了该配置后，到达DispatcherServlet的请求会先进行判断，如果是静态资源则不处理，交给Tomcat默认的Servlet处理：

配置后重新服务器再次请求可以请求到该静态资源：

静态资源可以是图片、文件、html、txt等内容。

Controller请求处理

在进行Controller请求测试之前，我们先在dto包下创建两个Model用于测试使用：

User

package com.example.base_annotation.controller.dto;
import lombok.Data;
import java.util.List;
@Data
public class User {
    private Long id;
    private String username;
    private Integer age;
    private List<String> accountIds;
}

Account

package com.example.base_annotation.controller.dto;
import lombok.Data;
@Data
public class Account {
    private Long id;
    private String name;
}

1 常用的入参类型

接下来我们讨论6种常用的入参类型，所有的代码都是在UserController下，其地址映射为：/user，开启注解后进行扫描，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"
       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
       http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!-- 自动扫描包，让指定包下的注解生效,由IOC容器统一管理 -->
    <context:component-scan base-package="com.example.base_annotation.controller"/>
    <!-- 让Spring MVC不处理静态资源 -->
    <mvc:default-servlet-handler />
    <!--
    支持mvc注解驱动
        在spring中一般采用@RequestMapping注解来完成映射关系
        要想使@RequestMapping注解生效
        必须向上下文中注册DefaultAnnotationHandlerMapping
        和一个AnnotationMethodHandlerAdapter实例
        这两个实例分别在类级别和方法级别处理。
        而annotation-driven配置帮助我们自动完成上述两个实例的注入。
     -->
    <mvc:annotation-driven />
    <!--视图解析器-->
    <!--通过视图解析器解析处理器返回的逻辑视图名并传递给DispatcherServlet-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
        <!--前缀-->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!--后缀-->
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

1 Servlet API 参数

我们先来尝试下使用原生的Servlet来进行请求，通过操作原生的Servlet API 参数：

// 可以通过参数来操作Servlet的api
    @RequestMapping("/servletParam")
    public void servletParam(HttpServletRequest request, HttpServletResponse responser, HttpSession session) {
        System.out.println(request.getParameter("username"));
        System.out.println(request);
        System.out.println(responser);
        System.out.println(session);
    }

请求的url如下：

http://localhost:8081/base_annotation/user/servletParam?username=tml

打印出来的结果如下：

2 简单类型参数

获取请求参数，保证请求参数名称和Controller方法的形参(入参)同名，这样就可以获得请求的参数内容。如果名字不同则获取不到参数

@RequestMapping("/simpleParamMatch")
    public void simpleParamMatch(String username, int age) {
        System.out.println("username:" + username);
        System.out.println("age:" + age);
    }

请求的url如下：

http://localhost:8081/base_annotation/user/simpleParamMatch?username=tml&age=30

打印出来的结果如下：

@RequestParam注解设置别名

如果请求参数名称和形参名称不同则使用RequestParam注解，使用@RequestMapping注解后，名字不同也可以获取请求参数的内容

@RequestMapping("/simpleParamDiff")
    public void simpleParamDiff(@RequestParam("name") String username, @RequestParam(value = "age") Integer age) {
        System.out.println("username:" + username);
        System.out.println("age:" + age);
    }

请求的url如下：

http://localhost:8081/base_annotation/user/simpleParamDiff?name=tml&age=30

打印出来的结果如下：

3 数组和List类型参数

接受一个参数有多个值的情况，使用数组可以直接接收传递的多个参数：

@RequestMapping("/arrayParam")
    public void arrayParam(Long[] accountIds) {
        System.out.println(Arrays.asList(accountIds));
    }

请求的url如下：

http://localhost:8081/base_annotation/user/arrayParam?accountIds=10&accountIds=20&accountIds=30&accountIds=40

但是使用集合List不能直接接受，这种时候就需要在对象中存在一个集合，然后以JavaBean的方式传递

@RequestMapping("/listParam")
    public void listParam(User user) {
        System.out.println(user.getAccountIds());
    }

请求的url如下：

http://localhost:8081/base_annotation/user/listParam?accountIds=10&accountIds=20&accountIds=30&accountIds=40

返回结果相同：

4 日期类型处理

从前台到后台传递参数需要由String类型转为日期类型：

@RequestMapping("/dateParam")
    public void dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd") Date date) {
        System.out.println(date);
    }

请求的url如下：

http://localhost:8081/base_annotation/user/dateParam?date=2021-08-31

返回结果如下：

5 JavaBean类型参数

Spring MVC能够自动把参数封装到JavaBean中，当然前提是属性名必须相同

//把数据直接封装到JavaBean对象
    @RequestMapping("/javaBeanParam")
    public void javaBeanParam(User user) {
        System.out.println(user);
    }

请求的url如下：

http://localhost:8081/base_annotation/user/javaBeanParam?id=1&username=tml&age=30&accountIds=50&accountIds=80

返回结果如下：

@ModelAttribute注解设置共享对象

当然我们也可以使用ModelAttribute直接将传入的参数设置为页面共享数据进行展示。

//把数据直接封装到JavaBean对象
    @RequestMapping("/javaBeanModelAttributeParam")
    public String javaBeanModelAttributeParam(@ModelAttribute("userAllies") User user) {
        System.out.println(user);
        return "userInfo";
    }

请求的url如下：

http://localhost:8081/base_annotation/user/javaBeanModelAttributeParam?id=1&username=tml&age=30&accountIds=50&accountIds=80

返回结果如下：

此时的userInfo.jsp 代码如下：

<%--
  Created by IntelliJ IDEA.
  User: 13304
  Date: 2021/8/31
  Time: 11:47
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
${userInfo}
userAllies: ${userAllies}
</body>
</html>

打印结果如下：

6 多对象封装传递参数

如果我们遇到参数是多个JavaBean且它们有同样的属性名称时该怎么处理才能让数据不错乱呢？我们可以使用数据绑定机制，SpringMVC通过反射机制对目标处理方法的签名进行分析，将请求信息绑定到处理方法的形参中，数据绑定的核心组件是DataBinder类。数据绑定流程:

框架把ServletRequest对象和请求参数传递给DataBinder ;
DataBinder 首先调用Spring Web环境中的ConversionService组件进行数据类型转换和格式化等操作，将ServletRequest中的信息填充到形参对象中
DataBinder 调用Validator组件对已经绑定了请求消息数据的形参对象进行数据合法性校验
DataBinder 最后输出数据绑定结果对象BindingResult

我们来实践一下，请求到达时先进行初始化绑定让参数找到对应的JavaBean并赋值，然后再进行Controller处理：

//把以user.开头的参数封装到User对象中
    @InitBinder("user") // 自定义数据绑定注册,用于将请求参数转换到对应的对象的属性中去
    public void initBinderUserType(WebDataBinder binder) {
        binder.setFieldDefaultPrefix("user.");
    }
    @InitBinder("account")
    public void initBinderCatType(WebDataBinder binder) {
        binder.setFieldDefaultPrefix("account.");
    }
    @RequestMapping("/multiModelParam")
    public void multiModelParam(User user, Account account) {
        System.out.println(user);
        System.out.println(account);
    }

请求的url如下：

http://localhost:8081/base_annotation/user/multiModelParam?user.id=1&user.username=tml&user.age=30&accountIds=100&accountIds=200&account.id=12&account.name=chinaBank

返回结果如下：

【Spring MVC学习笔记三】深入实践Spring MVC控制器

静态资源访问问题

问题现象

问题原因

解决方案

Controller请求处理

1 常用的入参类型

1 Servlet API 参数

2 简单类型参数

@RequestParam注解设置别名

3 数组和List类型参数

4 日期类型处理

5 JavaBean类型参数

@ModelAttribute注解设置共享对象

6 多对象封装传递参数

热门文章

最新文章

相关课程

相关电子书

相关实验场景

【Spring MVC学习笔记 三】深入实践Spring MVC控制器

静态资源访问问题

问题现象

问题原因

解决方案

Controller请求处理

1 常用的入参类型

1 Servlet API 参数

2 简单类型参数

@RequestParam注解设置别名

3 数组和List类型参数

4 日期类型处理

5 JavaBean类型参数

@ModelAttribute注解设置共享对象

6 多对象封装传递参数

热门文章

最新文章

相关课程

相关电子书

相关实验场景

【Spring MVC学习笔记三】深入实践Spring MVC控制器