证实一个大摇大摆的人

Question

我正在尝试验证swagger文件（实际上是我的gradle构建的一部分）。我曾经尝试过使用swagger解析器，但尽管它可以工作，如果swagger根本不进行解析，就会出现错误，但它似乎无法以这种方式捕获问题http://editor.swagger.io/#/做（这就是我要找的。）

当然，这是一个很常见的问题，一定有办法做到这一点？

我所尝试的：

build.gradle：

     compile("io.swagger:swagger-parser:1.0.31")

有一些明显问题的简单招摇：

swagger: '2.0'
info:
  description: 'This is a sample server Petstore server.'  
  version: 1.0.0
  title: Swagger Petstore
  termsOfService: http://swagger.io/terms/
  contact:
    email: [e-mail]
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
host: petstore.swagger.io
basePath: /v2
paths:
  /pet:
    post:
      tags:
      - pet
      summary: Add a new pet to the store
      description: ''
      operationId: addPet
      parameters:
      - in: body
        name: body
        description: Pet object that needs to be added to the store
        required: true
        schema:
          type: '#/definitions/Pet'
      responses:
        '405':
          description: Invalid input
      security:
      - petstore_auth:
        - write:pets
        - read:pets
definitions:
  Category:
    type: petObject
    properties:
      id:
        type: integer
        format: int64
      name:
        type: string
    xml:
      name: Category
  Pet:
    type: object
    required:
    - name
    - photoUrls
    properties:
      id:
        type: integer
        format: int64
      category:
        $ref: '#/definitions/Category'
      name:
        type: string
        example: doggie
    xml:
      name: Pet

和一个简单的类来测试它(目的是最终将它移植到gradle):

class SwaggerTest {

public static void main(String[] args) {
  SwaggerTest st = new SwaggerTest();
  st.validate();
}

private void validate() {
    try {

      String content = new String(Files.readAllBytes(Paths.get("petstore.yml")));
      SwaggerParser swaggerParser = new SwaggerParser();
      SwaggerDeserializationResult result = swaggerParser.readWithInfo(content);
      swaggerParser.parse(content);

        Swagger swagger = result.getSwagger();
        if (swagger == null) {
            System.out.println("Unable to validate swagger");
        }else {
          System.out.println("Read the swagger");
        }
        List<String> messageList = result.getMessages();
        for(String message: messageList) {
            System.out.println(message);                
        }


    } catch(Exception e) {
        System.out.println("Error!! "+ e.getMessage());
    }
}
}

上面的swagger有多个问题，正如您在http://editor.swagger.io/中看到的那样，swagger-parser没有告诉我这些问题。

Answer 1

我用你的文件运行Swagger 2.0，没有任何额外的依赖关系。它可以毫无错误地工作，这是实现：

Swagger20Parser swaggerParser = new Swagger20Parser();