0

Drop-wizard と統合された swagger-jersey2-jaxrs 1.5.1-M2 があります。リソースとモデルに含めた 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"

parameters:は、swagger から生成された yaml に含まれていることに注意してください。これをswaggerエディター2.0に貼り付けると、「配列が短すぎます（0）、最小1」というエラーがスローされます。

パラメータを生成しない方法はありますか: URLにパラメータが必要ない場合、yamlで? パラメーターの注釈を含めなかったので、生成された yaml に表示されます。

4

1 に答える 1

0

Swagger 定義の JSON スキーマに、空のパラメーターを許可しないバグがありました。これは修正されており、swagger-editor でもすぐに利用できるようになります。

https://github.com/swagger-api/swagger-editor/issues/395に従って、いつ更新されるかを確認してください。

出力が間違っていないため、生成プロセスでこの問題を「解決」しようとしても意味がありません。

于 2015-04-10T03:34:13.123 に答える