[OpenApi] The api code is not generated without description

[alfredo9f]

What happens

If you have an input parameter (like testId) without description the generator creates an empty file for the api:
Example:

openapi: 3.0.3
info:
  title: test
  version: 11.0.0
servers:
- url: https://to_be_defined
paths:
  '/test/{testId}':
    get:
      tags:
      - Test
      summary: test
      description: test
      operationId: Retrieve
      parameters:
      - $ref: '#/components/parameters/testId'
      responses:
        '200':
          $ref: '#/components/responses/TestResponse'
components:
  parameters:
    testId:
      name: testId
      in: path
      required: true
      style: simple
      schema:
        type: string
  schemas:
    TestResponse:
      type: string
  responses:
    TestResponse:
      description: CustomerPositionStateResponse
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TestResponse'

Error:

Tested in 4.8.5 version

What is expected

The api code should be generated in the api file.

[joseegman]

Hi @alfredo9f — this issue was reported against 4.8.5. On current main the API file is generated correctly with the @PathVariable parameter even when the $ref parameter has no description; it was fixed by later refactors.

Added a regression test (testNoDescriptionRefParameterGeneration, in PR #411) that reproduces the exact spec from this issue and asserts the API is generated.