SpringMVC请求中的普通、POJO、数组集合类型传参与类转换器

itzhuzhu.

已于 2022-05-05 09:58:53 修改

阅读量1k

点赞数 3

分类专栏： SpringMVC 文章标签： java SpringMVC 类转换器 RequestMapping 数组集合类型传参

于 2022-01-14 11:42:49 首次发布

本文链接：https://blog.csdn.net/weixin_45477086/article/details/122487575

版权

SpringMVC 专栏收录该内容

8 篇文章 1 订阅

订阅专栏

SpringMVC将传递的参数封装到处理器方法的形参中，达到快速访问参数的目的。

`普通类型参数传参`

参数名与处理器方法形参名保持一致

访问URL： http://localhost/requestParam1?name=itzhuzhu&age=14

    @RequestMapping("/requestParam1")
    public String requestParam1(String name,Integer age){
        System.out.println(name+","+age);
        return "page.jsp";
    }

@RequestParam 的使用

类型：形参注解
位置：处理器类中的方法形参前方
作用：绑定请求参数与对应处理方法形参间的关系，浏览器传username可以回传给name

访问URL： http://localhost/requestParam2?userName=itzhuzhu

@RequestMapping("/requestParam2")
public String requestParam2(@RequestParam(
                            name = "userName",
                            required = true,// 为true必须传参，否则报错
                            defaultValue = "itzhuzhu") String name){
    
    System.out.println("name="+name);
    return "page.jsp";
}

`POJO类型参数传参`

当POJO中使用简单类型属性时，参数名称与POJO类属性名保持一致

访问URL： http://localhost/requestParam3?name=itzhuzhu&age=14

实体类

public class User {
    private String name;
    private Integer age;
}

Controller

@RequestMapping("/requestParam3")
public String requestParam3(User user){
    System.out.println(user);
    return "page.jsp";
}

参数冲突问题

当POJO类型属性与其他形参出现同名问题时，将被同时赋值
建议使用@RequestParam注解进行区分
访问URL： http://localhost/requestParam4?name=itzhuzhu&age=14

@RequestMapping("/requestParam4")
public String requestParam4(User user,String age){
    System.out.println("user.age="+user.getAge()+",age="+age);
    return "page.jsp";
}

复杂POJO类型参数

当POJO中出现对象属性时，参数名称与对象层次结构名称保持一致

访问URL： http://localhost/requestParam5?address.province=beijing

public class User {
    private String name;
    private Integer age;
    private Address addresses;
}

public class Address {
    private String province;
    private String city;
    private String address;
}

@RequestMapping("/requestParam5")
public String requestParam5(User user){
    System.out.println("user.address="+user.getAddress().getProvince());
    return "page.jsp";
}

当POJO中出现集合，保存简单数据，使用多个相同名称的参数为其进行赋值
访问URL：http://localhost:8080/requestParam6?nick=aa&nick=bb&nick=cc

    @RequestMapping("/requestParam6")
    public String requestParam6(User user){
        System.out.println(user);
        return "page.jsp";
    }

当POJO中出现List，保存对象数据，参数名称与对象层次结构名称保持一致，使用数组格式描述集合中对象的位置

访问URL： http://localhost/requestParam7?addresses[0].city=gz&addresses[1].province=gd

public class User {
    private String name;
    private Integer age;
    private List<Address> addresses;
}

public class Address {
    private String province;
    private String city;
    private String address;
}

@RequestMapping("/requestParam7")
public String requestParam7(User user){
    System.out.println("user.addresses="+user.getAddress());
    return "page.jsp";
}

当POJO中出现Map，保存对象数据，参数名称与对象层次结构名称保持一致，使用映射格式描述集合中对象的位置

访问URL： http://localhost/requestParam8?addressMap[’home’].province=bj&addressMap[’job’].province=tj

public class User {
    private String name;
    private Integer age;
    private Map<String,Address> addressMap;
}
public class Address {
    private String province;
    private String city;
    private String address;
}

@RequestMapping("/requestParam8")
public String requestParam8(User user){
    System.out.println("user.addressMap="+user.getAddressMap());
    return "page.jsp";
}

`数组与集合类型参数传参`

数组类型参数

请求参数名与处理器方法形参名保持一致，且请求参数数量＞ 1个

访问URL： http://localhost/requestParam9?nick=Jockme&nick=abcd

@RequestMapping("/requestParam9")
public String requestParam9(String[] nick){
    System.out.println(nick[0]+","+nick[1]);
    return "page.jsp";
}

集合类型参数

保存简单类型数据，请求参数名与处理器方法形参名保持一致，且请求参数数量＞ 1个

访问URL： http://localhost/requestParam10?nick=Jockme&nick=abcd

@RequestMapping("/requestParam10")
public String requestParam10(@RequestParam("nick") List<String> nick){
    System.out.println(nick);
    return "page.jsp";
}

注意： SpringMVC默认将List作为对象处理，赋值前先创建对象，然后将nick作为对象的属性进行处理。由于List是接口，无法创建对象，报无法找到构造方法异常；修复类型为可创建对象的ArrayList类型后，对象可以创建，但没有nick属性，因此数据为空。此时需要告知SpringMVC的处理器nick是一组数据，而不是一个单一数据。通过@RequestParam注解，将数量大于1个names参数打包成参数数组后， SpringMVC才能识别该数据格式，并判定形参类型是否为数组或集合，并按数组或集合对象的形式操作数据。

`类型转换器`

SpringMVC对接收的数据进行自动类型转换，该工作通过Converter接口实现，它帮我们做了类型转换

标量转换器

方法	解释
StringToBooleanConverter	String→Boolean
ObjectToStringConverter	Object→String
StringToNumberConverterFactory	String→Number（ Integer、 Long等）
NumberToNumberConverterFactory	Number子类型之间(Integer、 Long、 Double等)
StringToCharacterConverter	String→java.lang.Character
NumberToCharacterConverter	Number子类型(Integer、 Long、 Double等)→java.lang.Character
CharacterToNumberFactory	java.lang.Character→Number子类型(Integer、 Long、 Double等)
StringToEnumConverterFactory	String→enum类型
EnumToStringConverter	enum类型→String
StringToLocaleConverter	String→java.util.Local
PropertiesToStringConverter	java.util.Properties→String
StringToPropertiesConverter	String→java.util.Properties

集合、数组相关转换器

方法	解释
ArrayToCollectionConverter	数组→集合（ List、 Set）
CollectionToArrayConverter	集合（ List、 Set） →数组
ArrayToArrayConverter	数组间
CollectionToCollectionConverter	集合间（ List、 Set）
MapToMapConverter	Map间
ArrayToStringConverter	数组→String类型
StringToArrayConverter	String→数组， trim后使用“,”split
ArrayToObjectConverter	数组→Object
ObjectToArrayConverter	Object→单元素数组
CollectionToStringConverter	集合（ List、 Set） →String
StringToCollectionConverter	String→集合（ List、 Set）， trim后使用“,”split
CollectionToObjectConverter	集合→Object
ObjectToCollectionConverter	Object→单元素集合

默认转换器

方法	解释
ObjectToObjectConverter	Object间
IdToEntityConverter	Id→Entity
FallbackObjectToStringConverter	Object→String

SpringMVC对接收的数据进行自动类型转换，该工作通过Converter接口实现

Date类型转换问题，转换器只能识别/类型的分隔符，如果换成2022-01-17的话就识别不了，可以通过设置转换器date类型解决
访问URL： http://localhost/requestParam11?2022/01/17
但是

@RequestMapping("/requestParam11")
public String requestParam11(Date date){
    System.out.println(date);
    return "page.jsp";
}

`日期类型格式转换`

声明自定义的转换格式并覆盖系统转换格式

<!--6.启用自定义Converter-->
<mvc:annotation-driven conversion-service="conversionService"/>
<!--1.设定格式类型Converter，注册为Bean，受SpringMVC管理-->
<bean id="conversionService"
      class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
    <!--2.自定义Converter格式类型设定，该设定使用的是同类型覆盖的思想-->
    <property name="formatters">
        <!--3.使用set保障相同类型的转换器仅保留一个，避免冲突-->
        <set>
            <!--4.设置具体的格式类型-->
            <bean class="org.springframework.format.datetime.DateFormatter">
                <!--5.类型规则-->
                <property name="pattern" value="yyyy-MM-dd"/>
            </bean>
        </set>
    </property>
</bean>

日期类型格式转换（注解简化版）

名称： @DateTimeFormat
类型：形参注解、成员变量注解
位置：形参前面或成员变量上方
作用：为当前参数或变量指定类型转换规则

加在属性上：

public String requestParam12(@DateTimeFormat(pattern = "yyyy-MM-dd") Date date){
    System.out.println("date="+date);
    return "page.jsp";
}

加在POJO上：

@DateTimeFormat(pattern = "yyyy-MM-dd")
private Date birthday;

注意：需要在SpringMVC配置文件中加上注解驱动标签 <mvc:annotation-driven/>

`自定义类型转换器`

自定义类型转换器，实现Converter接口，并制定转换前与转换后的类型

<!--1.将自定义Converter注册为Bean，受SpringMVC管理-->
<bean id="myDateConverter" class="com.itzhuzhu.converter.MyDateConverter"/>
<!--2.设定自定义Converter服务bean-->
<bean id="conversionService"
      class="org.springframework.context.support.ConversionServiceFactoryBean">
    <!--3.注入所有的自定义Converter，该设定使用的是同类型覆盖的思想-->
    <property name="converters">
        <!--4.set保障同类型转换器仅保留一个，去重规则以Converter<S,T>的泛型为准-->
        <set>
            <!--5.具体的类型转换器-->
            <ref bean="myDateConverter"/>
        </set>
    </property>
</bean>

//自定义类型转换器，实现Converter接口，接口中指定的泛型即为最终作用的条件
//本例中的泛型填写的是String，Date，最终出现字符串转日期时，该类型转换器生效
public class MyDateConverter implements Converter<String, Date> {
    //重写接口的抽象方法，参数由泛型决定
    public Date convert(String source) {
        DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
        Date date = null;
        //类型转换器无法预计使用过程中出现的异常，因此必须在类型转换器内部捕获，不允许抛出，框架无法预计此类异常如何处理
        try {
            date = df.parse(source);
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return date;
    }
}

通过注册自定义转换器，将该功能加入到SpringMVC的转换服务ConverterService中

<!--开启注解驱动，加载自定义格式化转换器对应的类型转换服务-->
<mvc:annotation-driven conversion-service="conversionService"/>

`请求映射 @RequestMapping`

当设置了公共的访问前缀后，当前路径发生了变化，需要根据变化修改地址或修改访问页面的路径
如果不在类上配置@RequestMapping，访问的是root路劲下的页面
如果在类上配置了@RequestMapping，访问的是root路径下的user路径下的页面

`方法注解`

名称： @RequestMapping
类型：方法注解
位置：处理器类中的方法定义上方
作用：绑定请求地址与对应处理方法间的关系
访问URL：http://localhost:8080/requestParam13

@Controller
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/requestParam13")
    public String requestParam13() {
        return "page.jsp";
    }
}

`类注解`

名称： @RequestMapping

类型：类注解
位置：处理器类定义上方
作用：为当前处理器中所有方法设定公共的访问路径前缀
访问URL：http://localhost:8080/user/requestParam14
如果返回的有图片，那么图片也要放在user包下

@Controller
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/requestParam14")
    public String requestParam14() {
        return "page.jsp";
        // return "/page.jsp"; 如果类上配置了RequestMapping，在返回文件前加个/也是可以访问到的
    }
}

常用属性

@RequestMapping(
    value="/requestParam15", //设定请求路径，与path属性、 value属性相同
    method = RequestMethod.GET, //设定请求方式
    params = "name", //设定请求参数条件
    headers = "content-type=text/*", //设定请求消息头条件
    consumes = "text/*", //用于指定可以接收的请求正文类型（MIME类型）
    produces = "text/*" //用于指定可以生成的响应正文类型（MIME类型）
)
public String requestParam15() {
    return "/page.jsp";
}