Как работать с OpenAPI 3 (swagger) с помощью плагина Maven - PullRequest
Новая
       71

Как работать с OpenAPI 3 (swagger) с помощью плагина Maven

0 голосов
/ 19 ноября 2018

Я написал API, совместимый с Openapi 3 (https://swagger.io/docs/specification/basic-structure/)), и теперь я попытался и не смог создать объекты Java Spring, как я делал это ранее с определением сваггера и связанным с ним плагином maven.

Пока у меня есть базовое определение API, и в моем pom.xml файле я добавил 

<dependency>
<groupId>org.openapitools</groupId>
<art ifactId>openapi-generator-cli</artifactId>
<version>3.3.3</version>
</dependency>

при выполнении mvn install я получил эту ошибку:

com.fasterxml.jackson.core.JsonParseException: Unrecognized token 'openapi': was expecting ('true', 'false' or 'null') at [Source: definition\DEFINITION.yml; line: 1, column: 9]

вот мои первые строки моего файла Definition.yml:

openapi: 3.0.0 info: title: Demo API description: This is a basic REST API implementing the [Open API Specification](https://en.wikipedia.org/wiki/OpenAPI_Specification). version: 0.0.1

Может кто-нибудь помочь, пожалуйста?

1 Ответ

0 голосов
/ 20 ноября 2018

В настоящее время я работаю над openapi-generator-maven-plugin для генерации классов Java из схемы JAP OpenAPI.

Ошибки выглядят как проблема синтаксиса.Поэтому сначала убедитесь, что ваша схема синтаксически правильна и выглядит следующим образом: 

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo API",
    "description": "This is a basic REST API implementing the [Open API Specification](https://en.wikipedia.org/wiki/OpenAPI_Specification).",
    "version": "0.0.1"
  },
  # Schema definition goes here
}
...