Explore generics possibilities

[kbuntrock]

Explore new openapi 3.1 generic possibilities

See

• https://json-schema.org/blog/posts/dynamicref-and-generics
• https://learn.openapis.org/referencing/dynamic.html
• Recommend describing templates/generic types using $dynamicRef OAI/OpenAPI-Specification#3601
• https://github.com/OAI/OpenAPI-Specification/pull/3714/files

And example (https://editor-next.swagger.io):

openapi: 3.1.0
info:
  title: Swagger Petstore - OpenAPI 3.0
  version: 1.0.11
servers:
  - url: https://petstore3.swagger.io/api/v3
tags:
  - name: user
    description: Operations about user
paths:
  /user:
    post:
      tags:
        - user
      summary: Create user
      description: This can only be done by the logged in user.
      operationId: createUser
      requestBody:
        description: Created user object
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/User'
      responses:
        default:
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/objWithTypedArray'
  /user/createWithList:
    post:
      tags:
        - user
      summary: Creates list of users with given input array
      description: Creates list of users with given input array
      operationId: createUsersWithListInput
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/User'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageUser'  
        default:
          description: successful operation
components:
  schemas:
    User:
      $id: User.Id
      type: object
      properties:
        id:
          type: integer
          format: int64
        username:
          type: string
        firstName:
          type: string
        lastName:
          type: string
    Page:
      $id: PageId
      type: object
      properties:
        content:
          type: array
          items: 
            $dynamicRef: "#page.content"
          $defs:
          allowAll:
            $dynamicAnchor: page.content
        first:
          type: boolean
        last:
          type: boolean
        totalElements:
          type: number
        totalPages:
          type: number
    PageUser:
      $id: page.user
      $ref: PageId
      $defs:
        pageOfUser:
          $dynamicAnchor: page.content
          type: object
          $ref: User.Id
    genericArrayComponent:
      $id: fully_generic_array
      type: array
      items:
        $dynamicRef: "#generic-array"
      $defs:
        allowAll:
          $dynamicAnchor: generic-array
    numberArray:
      $id: array_of_numbers
      $ref: fully_generic_array
      $defs:
        numbersOnly:
          $dynamicAnchor: generic-array
          type: number
    stringArray:
      $id: array_of_strings
      $ref: fully_generic_array
      $defs:
        stringsOnly:
          $dynamicAnchor: generic-array
          type: string
    objWithTypedArray:
      $id: obj_with_typed_array
      type: object
      required: 
      - dataType 
      - data
      properties:
        dataType:
          enum:
          - string
          - number
      oneOf:
      - properties:
          dataType:
            const: string
          data:
            $ref: array_of_strings
      - properties:
          dataType:
            const: number
          data:
            $ref: array_of_numbers