概述

记得之前跟前端同事联调接口的时候，后端SpringMVC需要接收数组类型的参数，然后跟前端说需要传数组类型过来。后来前端童鞋传了数组，但是后端接收不成功，联调失败。那时候由于时间关系没有仔细研究这块，当时想了个办法就是前端传一个json字符串，后端换成接收json字符串然后转成需要的数组对象。这显然不是一种好的做法，框架帮我们做好的事我们没有用上，还平白多了两次数据的转换。所以今天花时间研究了下，将springMVC的数据绑定做个总结。

1. 简单类型参数

即几种java原生的基本数据类型已经其封装类以及String类型。比较简单，选一种布尔类型来讲解。
测试代码：

    @RequestMapping(value = "test")@ResponseBodypublic Object testDataBind(@RequestParam(name = "test") Boolean test) {System.out.println(test);return "success";}

使用postman工具发送请求：

控制台输出：

true1

这种的比较简单，没有太多可说的。**这里需要注意的是，参数如果没有加@RequestParam注解的话，传参需要默认参数的名称test作为传参参数的名称，而且没有加注解的话，前端在发送http请求的时候可以不传该参数，也不会报错。但是如果加了该注解，在没有设置注解的属性required = false的前提下，该参数必传，不然会报400错误。如果该注解中指定了name属性，name前端需要以name的值作为前端传参名称，如果没有指定name属性，在按参数名称test为前端传参名称。**大家可逐一验证。

2. 简单类型数组/list

分别为两种情况：

1） 直接使用数组作为方法的参数，可以用@RequestParam注解修饰,如果使用List，必须使用@RequestParam注解修饰

接口代码：

    @RequestMapping(value = "test")@ResponseBodypublic Object testDataBind(String[] tests) {System.out.println(tests[0] + "    " + tests[1]);return "success";}

这种前端传参需要遵守一定格式。

• form表单
  表单元素name的值必须一样

name="tests" value="arony1"
name="tests" value="arony2"12

postman发送请求：

控制台输出：

arony1    arony21

• ajax
  数组各个元素值需用“,”隔开。

data:{"tests":"arony1,arony2"}1

值得注意的是，如果后端的springMVC方法参数用的是数组来接收的话，前端用ajax发送请求，那么只能用上面这一种格式传参，使用下面说的tests[0],tests[1]传参是不行的。
postman发送请求：

控制台输出：

arony1    arony21

2）使用自定义类里面封装一个数组或者List，用自定义类实例作为方法参数，不能用@RequestParam注解修饰

接口代码：

    @RequestMapping(value = "test")@ResponseBodypublic Object testDataBind(Person person) {System.out.println(person.getTests()[0] + "    " + person.getTests()[1]);return "success";}

Person：

    public class Person {private String[] tests;public String[] getTests() {return tests;}public void setTests(String[] tests) {this.tests = tests;}}

• form表单

有两种形式进行传值

name="tests" value="arony1"
name="tests" value="arony2"12
name="tests[0]" value="arony1"
name="tests[1]" value="arony2"12

postman发送请求：

控制台输出：

arony1    arony21

• ajax

  ajax也有两种方式传值：

data:{"tests":"arony1,arony2"}1
data:{"tests[0]":"arony1","tests[1]":"arony2"}1

效果跟表单完全一样。

3. 自定义类型

首先定义一个自定类型User，包含以下属性，生成get/set方法，toString方法：

    private Integer id;private String loginname;12

接口代码：

    @RequestMapping(value = "test")@ResponseBodypublic Object testDataBind(User user) {System.out.println(user);return "success";}

postman发送请求：

控制台输出：

User{id=1, loginname='arony'}1

可以看到，跟User属性名一样的参数如果传了值，就可以被User对象所接受，没有传的为默认值。
我们尝试下，给参数user加上@RequestParam注解看看。使用postman发送请求，会发现返回400。所以我们要理解@RequestParam注解含义，它标示的是该方法参数接受的是一个http参数。因此，如果是用一个自定义对象作为参数的话，不要在之前加上@RequestParam，因为SpringMVC在解析http请求的参数user的时候，不能将接收到的参数转化成一个User对象。

4. 自定义类型数组/list

注意：这种情况只能使用一个自定义类来包装数组/list。
再定义一个参数类：

public class Parameter {private Person[] person;public Person[] getPerson() {return person;}public void setPerson(Person[] person) {this.person = person;}
}

Person:

public class Person {private String tests;public String getTests() {return tests;}public void setTests(String tests) {this.tests = tests;}
}

接口代码：

    @RequestMapping(value = "test")@ResponseBodypublic Object testDataBind(Parameter parameter) {System.out.println(parameter.getPerson()[0].getTests() + "    " + parameter.getPerson()[1].getTests());return "success";}

• form表单传参

name="person[0].tests" value="arony1"
name="person[1].tests" value="arony2"12

• ajax传参

data:{"person[0].tests":"arony1","person[1].tests":"arony2"}1

postman发送请求：

控制台输出：

arony1    arony21

5. Map<String,基本类型>

与上面一样 这种情况只能使用一个自定义类来包装map。

Parameter:

public class Parameter {private Map<String, String> map;public Map<String, String> getMap() {return map;}public void setMap(Map<String, String> map) {this.map = map;}
}

接口代码：

    @RequestMapping(value = "test")@ResponseBodypublic Object testDataBind(Parameter parameter) {parameter.getMap().forEach((key, value) -> {System.out.println(key + "   " + value);});return "success";}

前端传参格式：

• form表单

name="map[key1]" value="arony1"
name="map[key2]" value="arony2"
或者
name="map.key1" value="arony1"
name="map.key2" value="arony2"12345

• ajax

data:{"map[key1]":"arony1","map[key2]":"arony2"}
或者
data:{"map.key1":"arony1","map.key2":"arony2"}123

postman发送请求：

控制台输出：

key1   arony1
key2   arony212

6. Map<String, 自定义类>

跟5是很类似的。
Parameter：

public class Parameter {private Map<String, Person> map;public Map<String, Person> getMap() {return map;}public void setMap(Map<String, Person> map) {this.map = map;}
}

Person:

public class Person {private String tests;public String getTests() {return tests;}public void setTests(String tests) {this.tests = tests;}
}

接口代码：

    @RequestMapping(value = "test")@ResponseBodypublic Object testDataBind(Parameter parameter) {parameter.getMap().forEach((key, value) -> {System.out.println(key + "   " + value.getTests());});return "success";}

前端传参格式：

• form表单

name="map[key1].tests" value="arony1"
name="map[key2].test2" value="arony2"12

这里注意，name=”map.key1.tests” value=”arony1”这样传值是不行的。必须用方括号。

• ajax

data={"map[key1].tests":"arony1","map[key2].test2":"arony2"}1

这里也必须使用方括号。

使用postman发送请求：

控制台输出：

key1   arony1
key2   arony212

总结

以上的SpringMVC参数绑定可以总结为下图：

其中，Map<String, ①> 前端还可以使用“.”代替方括号。