Add support for $ref to all types that allow reference objects

[dalewking]

Currently reference objects (i.e. $ref) are only supported for schema. It needs to be supported for all types that support reference objects. For the types that swagger-brake cares about that means:

• ApiResponse
• Parameter
• RequestBody

Here is a file that causes an NPE due to ref for the request body:

openapi: 3.0.0
info:
  title: EXAMPLE
  version: '1'
paths:
  /actuator/info:
    get:
      tags:
        - operation-handler
      summary: handle
      operationId: handleUsingGET_1
      responses:
        '200':
          description: OK
          responseSchema:
            type: object
          content:
            application/json:
              schema:
                type: object
            application/vnd.spring-boot.actuator.v2+json:
              schema:
                type: object
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
      requestBody:
        $ref: '#/components/requestBodies/handleUsingGETBody'
components:
  requestBodies:
    handleUsingGETBody:
      content:
        application/json:
          schema:
            type: object
            additionalProperties:
              type: string
      description: body

[dalewking]

Looks like Path Item needs to add support for it as well, but the spec is kind of unclear. It says you can do it, but there is no support for it in components. Perhaps that is only for referencing another file.

[dalewking]

Actually, the easiest fix is probably change the parsing to set resolve fully:

        ParseOptions options = new ParseOptions();
        options.setResolveFully(true);
        OpenAPI loadedApi = new OpenAPIV3Parser().read(path, null, options);

[galovics]

Fixed. Thanks for the hint @dalewking. Full resolution is set now. :-)

[dalewking]

Now that my issues are fixed, just need a new release, soon

[galovics]

Most probably I'll do one on the next week. :-)