SpringMVC 参数绑定详解

x33g5p2x  于2022-05-16 转载在 Spring  
字(5.4k)|赞(0)|评价(0)|浏览(368)

概述

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

1. 简单类型参数

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

@RequestMapping(value = "test")
    @ResponseBody
    public 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")
    @ResponseBody
    public 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")
    @ResponseBody
    public 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")
    @ResponseBody
    public 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")
    @ResponseBody
    public 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")
    @ResponseBody
    public 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")
    @ResponseBody
    public 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, ①> 前端还可以使用“.”代替方括号。

相关文章