使用openapi生成器maven插件处理两种不同的响应媒体类型

Question

我正在用OpenAPI生成器maven插件（版本为5.4.0）生成OpenAPI合同的源代码。

我正在使用java生成器和webclient库。

我有一个endpoint响应Application/octt-stream或Application/json：

    "responses": {
      "200": {
        "content": {
          "application/octet-stream": {
            "schema": {
              "type": "string",
              "format": "byte"
            }
          },
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/TheResponseObject"
            }
          }
        }
      },

问题是插件只是考虑第一个媒体类型（按声明顺序）来生成相应的java返回类型。

在上面的例子中，我必须处理字节[]。

如果我首先反转媒体类型（application/json），我必须处理响应对象。

有没有办法处理这两个问题，并根据响应头获得良好的格式？




Answer 1

问题是：您希望从openapi生成器maven插件中得到什么结果？

其主要思想是使用以下方法生成API：

ResponseEntity<TheResponseObject> get(...) 

现在，您的模式定义endpoint可以同时返回Application/json和byte[]，因此，从java的角度来看，API如下所示：

ResponseEntity<TheResponseObject> get(...);

ResponseEntity<byte[]> get(...);

这是不可能的，因为两种方法具有相同的签名。通常，可以通过将您自己的版本放在资源目录中并在插件配置中指定模板目录来覆盖小胡子模板（例如spring模板），但您可以获得的最佳结果如下：

ResponseEntity<java.lang.Object> get(...);

你真的需要吗？