Swagger Spring Boot Code Gen - API docs don't reflect the actual YAML for Array return type

From @techlogix on September 22, 2016 13:51

Swagger File

 # paste your swagger document here
   responses:
        "200":
          description: successful operation
          schema:
            type: array
            items:
              $ref: "#/definitions/PaygoVendor"

/api-docs

responses: {
200: {
description: "successful operation",
schema: {
$ref: "#/definitions/PaygoVendor"
}

• Version: swagger.editor.io
• Browser/OS: all

Issue
There is a DIFFERENCE in the generated API spec from the Spring Boot generated source from the YAML spec for ARRAY return type.
Easy to replicate - basically

1. define an API with in YAML a 200 schema type:array and items with a $ref.
   schema:
   type: array
   items:
   $ref: "#/definitions/PaygoVendor"
2. Generate Spring Boot Server Stub.
3. Compile and run with maven.
4. view /api-docs and the response type schema rendered is NOT an array anymore!
   schema: {
   $ref: "#/definitions/PaygoVendor"
   }

Copied from original issue: swagger-api/swagger-editor#1068

Start with the provided Swagger YAML response schema and reproduce the issue by generating a Spring Boot server stub, compiling it with Maven, and viewing /api-docs. Compare the generated API documentation with the array schema and its $ref item; done means the rendered response remains an array.