Java REST Client的swagger-codegen头参数

Question

我使用swagger-codegen为我的一个REST API生成Java REST客户端。 REST API采用可选的头参数。 客户端中生成的方法有一个额外的参数，用于获取标头。 我想在方法签名中没有header参数的情况下生成方法。 我已经阅读了文档，但找不到任何参考。

例如，对于带有选项X-CUSTOM-HEADER参数的GET所有API，swagger-codegen生成如下方法：

public List<SomeType> findAllUsingGET1(String optionalHeader)

我希望它在哪里：

public List<SomeType> findAllUsingGET1()

寻找变通方法的指针，而不是自定义客户端代码生成。

编辑1：添加JSON规范

  "get": {
    "summary": "findAll",
    "operationId": "findAllUsingGET1",
    "consumes": [
      "application/json"
    ],
    "produces": [
      "application/json"
    ],
    "parameters": [
      {
        "name": "X-CUSTOM-HEADER",
        "in": "header",
        "description": "Custom Header",
        "required": false,
        "type": "string"
      }
    ],
    "responses": {
      "200": {
        "description": "OK",
        "schema": {
          "type": "string"
        }
      },
      "401": {
        "description": "Unauthorized"
      },
      "403": {
        "description": "Forbidden"
      },
      "404": {
        "description": "Not Found"
      }
    }
  }

Answer 1

如果要从Java API客户端中的方法签名中删除参数（可选），唯一的方法是从Swagger / OpenAPI规范中删除该参数。

要添加默认标题，您可以使用addDefaultHeader的方法ApiClient ： https://github.com/swagger-api/swagger-codegen/blob/master/samples/client/petstore/java/okhttp-gson/src/main/爪哇/ IO /昂首阔步/客户/ ApiClient.java＃L528

更新：类似于表单，查询参数的标头参数作为方法参数生成。 从开发人员的角度来看，它只是另一个参数（并且他们不需要知道参数是标头，表单还是查询参数）