Handle complex typed parameters

[pouyanh]

Currently getting parameter type is just based on type key and library is not aware of schema field. In fact it cannot do validation checks for complex-typed parameters.

For example:

  parameters:
    - name: entities
      in: body
      required: true
      schema:
        type: array
        items:
          $ref: "#/definitions/entity"

[olaferlandsen]

@pouyanh Can you include full definition of entity, please ;)

[pouyanh]

In swagger.yml below:

swagger: '2.0'
info:
  title: entities management
  version: 2.0.0
schemes:
  - http
consumes:
  - application/entities.management.api.v1+json
  - application/json
  - text/plain
produces:
  - application/entities.management.api.v1+json
  - application/json
paths:
  /entities:
    post:
      tags:
        - entities
      operationId: createEntities
      summary: Create new entities
      parameters:
        - name: entities
          in: body
          required: true
          schema:
            type: array
            items:
              $ref: "#/definitions/entity"
      responses:
        201:
          description: Created all
          schema:
            type: object
            properties:
              entities:
                type: array
                items:
                  $ref: "#/definitions/entity"
        207:
          description: Created some
          schema:
            type: object
            properties:
              entities:
                type: array
                items:
                  $ref: "#/definitions/entity"
              errors:
                type: array
                items:
                  $ref: "#/definitions/error"
        default:
          description: error
          schema:
            $ref: "#/definitions/error"
definitions:
  entity:
    type: object
    required:
      - entityId
      - name
    properties:
      entityId:
        type: integer
        format: int32
        readOnly: true
        description: Internal identifier of an entity
      name:
        type: string
        description: Name of an entity

  error:
    type: object
    required:
       - message
    properties:
      code:
        type: integer
        format: int64
      message:
        type: string
      fields:
        type: array
        items:
          type: string

/entities POST request requires this json in body:

[
  {
    "entityId": 1,
    "name": "1st Entity name"
  },
  {
    "entityId": 2,
    "name": "2nd Entity name"
  },
  {
    "entityId": 3,
    "name": "3rd Entity name"
  }
]

Although its parameter is defined as entities, but this key should not be included in body.
Currently library creates the request as below:

{
  "entities": [
    {
      "entityId": 1,
      "name": "first name",
    },
    {
      "entityId": 2,
      "name": "second name",
    }
  ]
}