JAX-RS中GET方法未标注参数的含义及默认处理逻辑咨询

首先明确JAX-RS的核心规则：当接口方法参数没有标注@QueryParam、@PathParam这类绑定注解时，默认行为是按参数名称匹配请求的查询参数——这是规范定义的 fallback 逻辑，和显式写@QueryParam("参数名")的效果一致。

针对你给出的这段代码：

@GET
@Produces(MediaType.APPLICATION_JSON)
public Map<String, Object> getProduct(
    String domain,
    @QueryParam("code") String code,
    @QueryParam("region") String region
) {

这里的domain参数，会自动尝试从请求URL的查询参数里取domain对应的值。比如请求/products?domain=xxx&code=123，domain参数就会被赋值为xxx。

需要注意一个前提：JAX-RS实现需要能获取到方法参数的原始名称。如果是Java 8及以上版本，编译时加上-parameters选项就能保留参数名；如果没开这个选项，部分早期框架版本可能无法识别参数名，导致domain值为null，甚至抛出绑定异常。

另外你提到POST方法的情况：POST里无注解的非基本类型参数默认绑定请求体，这是因为POST请求通常携带请求体，但GET请求按HTTP标准不应该携带请求体，所以JAX-RS规范明确区分了两者的处理逻辑——GET方法的无注解参数绝不会绑定到请求体，只会走查询参数匹配的 fallback 逻辑。

内容的提问来源于stack exchange，提问作者dimnnv