Создание кода сервера для этого минимального Пример с использованием spring
или jaxrs-spec
создает 2 класса моделей: Pet.java
и InlineResposne200.java
. За исключением имени класса, они идентичны.
Контроллер, который отвечает на /pets
, возвращает List<InlineResponse200>
вместо List<Pet>
, а класс Pet
фактически нигде не используется, хотя в определении yaml используется $ref: "#/definitions/Pet"
. Почему это происходит?
---
swagger: "2.0"
info:
version: "1.0.0"
title: "Swagger Petstore"
description: "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification"
termsOfService: "http://swagger.io/terms/"
contact:
name: "Swagger API Team"
license:
name: "MIT"
host: "petstore.swagger.io"
basePath: "/api"
schemes:
- "http"
consumes:
- "application/json"
produces:
- "application/json"
paths:
/pets:
get:
description: "Returns all pets from the system that the user has access to"
produces:
- "application/json"
responses:
"200":
description: "A list of pets."
schema:
type: "array"
items:
$ref: "#/definitions/Pet"
definitions:
Pet:
type: "object"
required:
- "id"
- "name"
properties:
id:
type: "integer"
format: "int64"
name:
type: "string"
tag:
type: "string"