Quarkus资源POST请求如何传递多参数 解决单body参数报错

抛出java.io.IOException can only have a single body parameter是JAX-RS（Quarkus REST能力的底层规范）的硬性约束：单个HTTP请求方法仅允许声明1个请求体（Body）参数。
你的代码中input1、input2、input3三个参数都没有添加任何参数来源注解，框架会默认将无注解的参数判定为请求体参数，同时存在多个请求体参数时就会直接抛出该错误。

根据业务传参场景选择对应实现即可：

方案1：封装统一请求体DTO（适配JSON/XML请求，最符合REST规范） #

你的接口本身支持接收JSON、XML格式请求，最推荐的做法是把多个业务入参封装为一个普通的Java实体类（DTO），框架会自动将请求体的JSON/XML内容反序列化为该实体对象，实现多参数传递。
第一步先定义请求DTO：

public class GenerateRequest {
    private String input1;
    private String input2;
    private String input3;

    // 必须提供无参构造，供Quarkus做反序列化
    public GenerateRequest() {}

    // 补全所有字段的getter、setter
    public String getInput1() { return input1; }
    public void setInput1(String input1) { this.input1 = input1; }
    public String getInput2() { return input2; }
    public void setInput2(String input2) { this.input2 = input2; }
    public String getInput3() { return input3; }
    public void setInput3(String input3) { this.input3 = input3; }
}

第二步修改接口方法：

@Path("/api")
public class ExampleResource {

    @Path("/example")
    @POST
    @Consumes({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
    @Produces(MediaType.APPLICATION_JSON)
    public String generate(@HeaderParam("Content-Type") String contentType, GenerateRequest request){
        String input1 = request.getInput1();
        String input2 = request.getInput2();
        String input3 = request.getInput3();

        System.out.println("Content-Type : " + contentType);
        System.out.println("Parameter 1 : " + input1);
        System.out.println("Parameter 2 : " + input2);
        System.out.println("Parameter 3 : " + input3);

        final MyClass myObj = new MyClass();
        return contentType.equals("application/xml") ? myObj.xmlMethod(input1, input2, input3) : myObj.jsonMethod(input1, input2, input3);
    }
}

请求时直接将三个参数放在请求体中传递即可，JSON格式请求示例：

{
  "input1": "参数1值",
  "input2": "参数2值",
  "input3": "参数3值"
}

方案2：给非请求体参数明确标注来源注解 #

如果不需要通过请求体传参，要把参数放在URL路径、查询参数、请求头等位置，需要给每个参数添加对应的来源注解。注意该方式依然最多只能保留1个无注解的请求体参数。
示例代码：

@Path("/api")
public class ExampleResource {

    // 示例：input1取路径参数，input2取URL查询参数，input3取请求头参数
    @Path("/example/{input1}")
    @POST
    @Consumes({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
    @Produces(MediaType.APPLICATION_JSON)
    public String generate(
            @HeaderParam("Content-Type") String contentType,
            @PathParam("input1") String input1,
            @QueryParam("input2") String input2,
            @HeaderParam("input3") String input3
    ){
        System.out.println("Content-Type : " + contentType);
        System.out.println("Parameter 1 : " + input1);
        System.out.println("Parameter 2 : " + input2);
        System.out.println("Parameter 3 : " + input3);

        final MyClass myObj = new MyClass();
        return contentType.equals("application/xml") ? myObj.xmlMethod(input1, input2, input3) : myObj.jsonMethod(input1, input2, input3);
    }
}

常用参数来源注解说明：

• @PathParam：匹配URL路径中的占位符参数
• @QueryParam：匹配URL中?后拼接的查询参数
• @HeaderParam：匹配请求头中的参数
• @CookieParam：匹配Cookie中的参数
• @FormParam：匹配表单提交的参数（使用时需要将@Consumes修改为MediaType.APPLICATION_FORM_URLENCODED）

方案3：使用@BeanParam聚合多来源参数 #

如果参数分散在路径、查询参数、请求头等多个位置，又不想写过长的方法参数列表，可以用@BeanParam将所有参数聚合到一个Bean中注入。
示例代码：

// 定义参数聚合Bean
public class GenerateParamBean {
    @HeaderParam("Content-Type")
    private String contentType;
    @QueryParam("input1")
    private String input1;
    @QueryParam("input2")
    private String input2;
    @QueryParam("input3")
    private String input3;

    // 补全无参构造、所有字段的getter和setter
    public String getContentType() { return contentType; }
    public void setContentType(String contentType) { this.contentType = contentType; }
    public String getInput1() { return input1; }
    public void setInput1(String input1) { this.input1 = input1; }
    public String getInput2() { return input2; }
    public void setInput2(String input2) { this.input2 = input2; }
    public String getInput3() { return input3; }
    public void setInput3(String input3) { this.input3 = input3; }
}

// 接口方法写法
@Path("/api")
public class ExampleResource {
    @Path("/example")
    @POST
    @Produces(MediaType.APPLICATION_JSON)
    public String generate(@BeanParam GenerateParamBean params) {
        String contentType = params.getContentType();
        String input1 = params.getInput1();
        String input2 = params.getInput2();
        String input3 = params.getInput3();
        final MyClass myObj = new MyClass();
        return contentType.equals("application/xml") ? myObj.xmlMethod(input1, input2, input3) : myObj.jsonMethod(input1, input2, input3);
    }
}

注意：无论使用哪种实现方式，一个接口方法最多只能存在1个无来源注解的参数（即被框架解析为请求体的参数），否则都会触发单请求体参数的报错。

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