0

我有 swagger-jersey2-jaxrs 1.5.1-M2 与 Drop-wizard 集成。我使用包含在资源和模型中的 swagger 注释生成了以下 yaml：

    ---
swagger: "2.0"
info:
  version: "1.0.0"
  title: "test Application"
tags:
- name: "test"
paths:
  /v1/test/version:
    get:
      tags:
      - "v1test"
      summary: "version number of test"
      description: "Returns version number of test"
      operationId: "getVersionAndBuildInfo"
      produces:
      - "application/json"
      parameters: 
      responses:
        404:
          description: "build number not found."
        200:
          description: "successful operation"
          schema:
            type: "array"
            items:
              $ref: "#/definitions/testInformation"
definitions:
  testInformation:
    properties:
      build:
        type: "string"
        description: "test build number"
      version:
        type: "string"
        description: "test version number"
      buildTimestamp:
        type: "string"
        description: "test build timestamp"
    description: "model for test version information"

请注意，参数：包含在从 swagger 生成的 yaml 中。当我将其粘贴到 swagger 编辑器 2.0 中时，它会抛出一个错误，提示“数组太短 (0)，最小值为 1”。

有没有办法不生成参数：在 yaml 当 URL 不需要任何参数时？我没有包含任何参数注释，它仍然显示在生成的 yaml 中。

4

1 回答 1

0

我们在 Swagger 定义的 JSON Schema 中有一个错误，它不允许空参数。这已修复，并且很快将在 swagger-editor 中可用。

请关注https://github.com/swagger-api/swagger-editor/issues/395查看何时更新。

在生成过程中试图“解决”这个问题是没有意义的，因为输出没有错。

于 2015-04-10T03:34:13.123 回答