Spring Boot 学习笔记(六) 整合 RESTful 参数传递

Spring Boot 学习笔记(六) 整合 RESTful 参数传递


0. 前言

前后端菜单参数传递一直是初学时的痛点,不知道参数类型与注解到底怎么样去配合。

其实整理一下就会发现。前后端参数传递大概有这么几种情况:

常见参数数据类型:

  • 基本类型(Stirng,int等)
  • 引用数据类型(POJO等简单对象)
  • 复杂的引用数据类型(数组、集合等)

常见传参方式:

  • URL传参
  • RequestBody 传参

组合一下大概有6种常见的场景。

1. 环境准备

环境说明:

  • RESTful 风格传参
  • 前端js: jQuery.js
  • 参数格式: json格式
  • 编码格式:UTF-8

引入 jQuery, 下载地址,将下载好的jquery.min.js放到resources/static/js下面

然后在 templates 下面创建一个 parameterPassing.html作为参数传递的测试页面。添加以下代码:

<head>
    ....
    <script src="/learning/js/jquery.min.js"></script>
</head>

别忘了在 PageController 里面添加一个获取 parameterPassing 页面的接口

再创建一个 ParameterController 用于接收参数的controller。

这篇文章的所有代码都只在这两个文件中,如果文章中有不太详细的地方,可以下载源码看一下。

PS: 本来js是需要单独一个文件的,但是为了方便学习,这里就直接写在 html 里了。

2. GET 方式传递基本类型

最简单的一种常见,传递一个基本类型到后台。

2.1 PathVariable 注解

ParameterController:

@RestController
@RequestMapping("/parameter")
public class ParameterController {
    private Logger logger = LoggerFactory.getLogger(ParameterController.class);

    @GetMapping("/getString/{str}")
    public String getString(@PathVariable(value = "str") String str){
        logger.info("GET 传参,传递基本类型。str:{}",str);
        return "收到参数:" + str;
    }
}

ParameterPassing.html

<body>
    <h2>测试参数传递</h2>
    <button id = "bt1">get传递String</button>
    <input id="in1" type="text">
</body>
<script>
    $("#bt1").click(
        function () {
            $.ajax(
                {
                    url:"/learning/parameter/getString/"+$("#in1").val(),
                    method:"GET",
                    success:function (result) {
                        alert(result);
                    }
                }
            )
        }
    );
</script>

2.2 RequestParam 注解

ParameterController

    @GetMapping("/getName")
    public String getName(@RequestParam(value = "name") String name){
        logger.info("GET 传参,传递基本类型。str:{}",name);
        return "收到参数:" + name;
    }

ParameterPassing.html

    $("#bt2").click(
        function () {
            $.ajax(
                {
                    url: "/learning/parameter/getName",
                    method: "GET",
                    data: {
                        name: $("#in2").val()
                    },
                    success: function (result) {
                        alert(result);
                    }
                }
            );
        }
    );
    //拼接url方式
    $("#bt3").click(
        function () {
            $.ajax(
                {
                    url: "/learning/parameter/getName?name="+$("#in3").val(),
                    method: "GET",
                    success: function (result) {
                        alert(result);
                    }
                }
            );
        }
    );

注意:

PathVariable 注解的参数是直接拼接在url里的,不是放在data里的。

RequestParam 注解的参数可以放在data里,也可以拼接url,格式是 ?key=value

PS:前后端参数的key一定要一致不然会报一个”Required String parameter ‘nae’ is not present” 的错误

3. POST 方式传递基本类型

Post 方式传递基本类型与Get方式基本一样。

3.1 PathVariable 注解

ParameterController

    @PostMapping("/postString/{str}")
    public String postString(@PathVariable(value = "str") String str){
        logger.info("POST 传参,传递基本类型。str:{}",str);
        return "收到参数:" + str;
    }

ParameterPassing.html

    $("#bt4").click(
        function () {
            $.ajax(
                {
                    url:"/learning/parameter/postString/"+$("#in4").val(),
                    method:"POST",
                    success:function (result) {
                        alert(result);
                    }
                }
            )
        }
    );

3.2 RequestParam 注解

ParameterController

    @PostMapping("/postName")
    public String postName(@RequestParam(value = "name") String name){
        logger.info("POST 传参,传递基本类型。str:{}",name);
        return "收到参数:" + name;
    }

ParameterPassing.html

    $("#bt5").click(
        function () {
            $.ajax(
                {
                    url: "/learning/parameter/postName",
                    method: "POST",
                    data: {
                        name: $("#in5").val()
                    },
                    success: function (result) {
                        alert(result);
                    }
                }
            );
        }
    );
    //拼接url方式
    $("#bt6").click(
        function () {
            $.ajax(
                {
                    url: "/learning/parameter/postName?name="+$("#in6").val(),
                    method: "POST",
                    success: function (result) {
                        alert(result);
                    }
                }
            );
        }
    );

基本类型的传参方式这几种方式差不多就够用了。如果你使用的是RESTful的风格,建议使用 2.1 的格式。

4. POST 传递引用类型

PathVariable 注解不支持引用类型。

RequestParam 注解也不支持引用类型,有一种做法是将json串以String类型传递。用RequestParam 注解可以,不过需要对参数进行编码。

所以这里仅介绍下 RequestBody 注解。

ParameterController

    @PostMapping("/postAccount")
    public AccountInfo postAccount(@RequestBody AccountInfo accountInfo) {
        logger.info("GET 传参,传递基本类型。str:{}", accountInfo);
        return accountInfo;
    }

ParameterPassing.html

    $("#bt7").click(
        function () {
            var accountInfo = {
                accountId: 123,
                name: $("#in7").val(),
                pwd: "root",
                balance: 123
            };
            $.ajax(
                {
                    url: "/learning/parameter/postAccount",
                    method: "POST",
                    data: JSON.stringify(accountInfo),
                    contentType:"application/json",
                    success: function (result) {
                        alert(JSON.stringify(result));
                    }
                }
            );
        }
    );

5. 传递数组

5.1 传递基本类型的数组

ParameterController

    @PostMapping("/postNames")
    public List<String> postNames(@RequestBody String[] names) {
        logger.info("GET 传参,传递基本类型。str:{}", Arrays.asList(names).toString());
        return Arrays.asList(names);
    }

ParameterPassing.html

    $("#bt8").click(
        function () {
            var names = ["a","b","c",$("#in8").val()];
            $.ajax(
                {
                    url: "/learning/parameter/postNames",
                    method: "POST",
                    data: JSON.stringify(names),
                    contentType:"application/json",
                    success: function (result) {
                        alert(JSON.stringify(result));
                    }
                }
            );
        }
    );

5.2 传递复杂类型的集合(数组)

ParameterController

    @PostMapping("/postAccountList")
    public List<AccountInfo> postAccountList(@RequestBody List<AccountInfo> accounts) {
        logger.info("GET 传参,传递基本类型。str:{}", accounts.toString());
        return accounts;
    }

ParameterPassing.html

    $("#bt9").click(
        function () {
            var accounts = [];

            var accountInfo1 = {
                accountId: 123,
                name: $("#in9").val(),
                pwd: "root",
                balance: 123
            };
            accounts.push(accountInfo1);
            var accountInfo2 = {
                accountId: 123,
                name: $("#in9").val(),
                pwd: "root",
                balance: 123
            };
            accounts.push(accountInfo2);
            $.ajax(
                {
                    url: "/learning/parameter/postAccountList",
                    method: "POST",
                    data: JSON.stringify(accounts),
                    contentType:"application/json",
                    success: function (result) {
                        alert(JSON.stringify(result));
                    }
                }
            );
        }
    );

转载请注明出处
本文链接:http://zdran.com/20180725.html