博客

1. 前言

接口参数应该怎么传递是每个项目应该面对的问题，这跟编程语言无关，今天来总结一波常用的接口参数传递方式。

2. GET 请求

GET 请求一般用来向服务器请求获取数据。总体来说目前有两种传参风格类型。

多参数拼接

这是我们最常见的传递方式，它一般传参方式如下：

GET /api/v1/user?name=felord.cn&age=18 HTTP/1.1
Host: localhost:8080

规则为：参数和 URI 之间用问号

?

隔开, 参数键值用等号

=

连接,然后参数之间用连接符

&

拼接起来，如样例中的

name=felord.cn&age=18

。在 Spring MVC 中这种参数可以被对象接收：

@GetMapping("/user")
public Rest> urlEncode(User params) {
     
    // params.name = felord.cn
    // params.age = 18
    return RestBody.okData(params);
}

通过

HttpServletRequest#getParameter(String key)

也获取上述方式携带的参数，但是一般这种方式建议在 Servlet Filter 过滤器使用，而不建议在接口中使用。Spring MVC 拦截器获取参数的底层也是该方式实现的。但是我也发现很多人在接口中使用此不合理的方式。

另外 URL 的长度是有限制的，如果 GET 请求包含了过于复杂的参数组合，说明业务设计是有问题的。