It is not possible to create Schema with array of referenced items

Versions: 1.0.1, 1.1.2, 2.0-MR1 I’m using the following annotation for schema: @Schema(required = true, description = "Some description...", type = SchemaType.ARRAY, ref = "name1") What I’m getting is:

variableName:
          $ref: '#/components/schemas/name1'

What I expect to get:

variableName:
          type: array
          description: Some description...
          items:
                    $ref: '#/components/schemas/name1'

It looks like ref is overriding all of data in @Schema object. I have tried a lot of modifications for mentioned annotation, but only pseudo-success is when I have add an ‘implementation’ element pointing to class- but that’s not satisfying solution. I’m sorry for not pasting original content, but it’s protected by contract.

[EricWittmann]

Yes that is the contract for the ref property. That property is mutually exclusive with all other properties on @Schema.

[MikeEdgar]

@KrystianRos, @0xqab - I would suggest you try either

(1) implementing an OASModelReader and having it produce the correct array Schema in components which can then be referenced by name using ref in @Schema annotations throughout your code or (2) Specify the same schema in components in a static YAML or JSON file which can also be referenced with ref.

@0xqab mentioned the use of Payara, which implementation are you using @KrystianRos ? I expect the type = ARRAY with implementation = MyClass.class to work with runtimes using SmallRye.