[BUG][JAVA] Uses spring pageable without any config indicating to do so

[downloadpizza]

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 searched for related issues/PRs?
• What's the actual output vs expected output?

Description

Using any schema called Pageable will instead use springs pageable (in a spring project)

openapi-generator version

6.0.1

OpenAPI declaration file content or url

https://github.com/downloadpizza/spring-openapi-pageable-poc

Generation Details

refer to pom.xml in my project

Steps to reproduce

1. Clone my project
2. Run maven compile
3. Look in generated PagedObject class and check which Pageable is used.

Related issues/PRs

#8360

Suggest a fix

redo the entire Pageable and springfox thing. #8192 (comment) as this user has said (which I agree with) it is a dumb thing for a mature library. Its a random very intrusive change that benefits very few people.

[downloadpizza]

Bump, this is not a big issue but it is documented nowhere and randomly breaks stuff, not very funny.

[Mintas]

@downloadpizza it looks like you can try this workaround with little tweak in your schema (replaced ref with type for Pageable):
typeMappings = ['pageable': 'xyz.model.Pageable']

components:
  schemas:
    Pageable:
      type: object
      properties:
        definetly_not_pageable:
          type: string
    PagedObject:
      type: object
      properties:
        value:
          type: string
        pageable:
          type: pageable

btw, I see two possible fixes:
a) https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/SpringCodegen.java#L485 put importMapping for Pageable only if x-spring-paginated enabled

b) make all that importMapping thing customizable, using putIfAbsent(), then you could have used workaround by setting
importMappings = ['Pageable': 'xyz.model.Pageable']

[tofi86]

@Mintas regarding your suggested fix: the importMapping map you're referring to is just a map. It does not actually put the Pageable import in the list of imports to be used in the template. This is actually done behind a guard at https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/SpringCodegen.java#L1089

[tofi86]

@Mintas sorry, my fault. now I understand what you meant!

[downloadpizza]

@downloadpizza it looks like you can try this workaround with little tweak in your schema (replaced ref with type for Pageable): typeMappings = ['pageable': 'xyz.model.Pageable']

While I am not working on the project where this was an issue anymore. Your solution helped me on something completely unrelated. Thanks!