Support for using oneOf in response body

[harshmeet001]

Q&A (please complete the following information)

• OS: macOS Big Sur, 11.4

• Browser: chrome

• Version: 103.0.5060.53

• Swagger-UI version: 3.0.0

• Swagger/OpenAPI version: 3.0.3

Content & configuration

Unable to generate response object using oneOf keyword

Swagger/OpenAPI definition:

openapi: 3.0.3
info:
  title: AnimalKingdom
  description: AnimalKingdom
  version: 1.0.0
servers:
  - url: 'http://pets-api.animalkingdom-devjungle.com'
paths:
  /v1/search/pets:
    get:
      responses:
        '200':
                  description: OK
                  content:
                    application/json:
                      schema:
                        oneOf:
                          - $ref: '#/components/schemas/Cat'
                          - $ref: '#/components/schemas/Dog'
                          - $ref: '#/components/schemas/Hamster'
      summary: 'An API which returns different types of pets'
components:
  schemas:
    Cat:
      type: object
      properties:
        hunts:
          type: boolean
        age:
          type: integer
    Dog:
      type: object
      properties:
        hunts:
          type: boolean
        age:
          type: integer
        breed:
          type: string
          enum: [ Dingo, Husky, Retriever, Shepherd ]
    Hamster:
        type: object
        properties:
          hunts:
            type: boolean
          age:
            type: integer
          food:
            type: boolean

Swagger-UI configuration options:

SwaggerUI({
  // your config options here
})

?yourQueryStringConfig

Screenshots

How can we help?

The OpenAPI Generator does not generate the interface correctly when using oneOf.
The ApiResponse is OneOfCatDogHamster.class as seen in the screen shot which is not a generated class.
I want to use the oneOf operator to validate that the api responds with one of cat, dog or hamster class.
Is this even possible to do, if so what am i doing wrong and what is the suggested way to use oneOf keyword in respone