[BUG][Java] Schema name collision with template imports

[gtsystem]

Bug Report Checklist

• Have you provided a full/minimal spec to reproduce the issue?
• Have you validated the input using an OpenAPI validator (example)?
• Have you tested with the latest master to confirm the issue still exists?
• Have you searched for related issues/PRs?
• What's the actual output vs expected output?
• [Optional] Sponsorship to speed up the bug fix or feature request (example)

Description

If a schema is named "Schema", the import of such class will be import io.swagger.v3.oas.annotations.media.Schema;.
This will also trigger an error because this module is not defined in the pom file by default.

openapi-generator version

7.7.0 and latest (7.8.0-SNAPSHOT)

OpenAPI declaration file content or url

openapi: 3.0.3
info:
  title: Example API
  description: Example API
  contact: {}
  version: 2.0.0

paths: {}

components:
  schemas:
    Response:
      properties:
        schema:
          $ref: '#/components/schemas/Schema'
    
    Schema:
      properties:
        test:
          type: string

Generation Details

Steps to reproduce

1. Create the file openapi-example-schema.yml with the content above in the current directory
2. run docker run -v pwd:/temp -it openapitools/openapi-generator-cli:latest generate -g java -i /temp/openapi-example-schema.yml -o /temp/build/
3. check the content of the file build/src/main/java/org/openapitools/client/model/Response.java

Current behavior:

• It contains import io.swagger.v3.oas.annotations.media.Schema;

Expected behavior:

• it contains import org.openapitools.client.model.Schema;

Tested the same behavior with other imported classes like HashMap

Related issues/PRs

The error I get, is the same reported in #16932, but root cause could be different

Suggest a fix

Schema is one of the optional imports of the Java code generator: AbstractJavaCodegen.java#L578 and I believe the system automatically use the existing import for it.

In theory this could be solved by adding Schema in the list of reserved words. Doing so will result in a class named SchemaModel. However this will also change the property name called schema to _schema which in reality is not necessary. I'm not sure why all reserved words are compared in a case insensitive way..

I also tried to use reservedWordsMappings, but it seems it's only considered for pre-existing reserved words

[gtsystem]

Fix in #19178 works for the case annotationLibrary is not set to swagger2