[notablogger]

Summary

With pageable = true, the generated findAll(Pageable pageable) was documented in /v3/api-docs as a single required query parameter pageable of type object, instead of the optional page / size / sort parameters the endpoint actually takes. The endpoint itself always worked; only the API docs (Swagger UI, generated clients) were wrong.

Type

• 🐛 Bug fix
• ✨ New feature / annotation attribute
• ♻️ Refactor (no behaviour change)
• 🧪 Tests only
• 📝 Documentation only
• 🔧 Build / CI change

Related issue

None

What was changed

• RestControllerGenerator: the Pageable parameter gets springdoc's @ParameterObject when org.springdoc.core.annotations.ParameterObject is on the processing classpath. Without springdoc nothing changes (no springdoc annotation is generated).
• RestControllerGeneratorTest: new test for both cases (springdoc present → @ParameterObject Pageable pageable; absent → no annotation).

No breaking change — can ship as a 3.0.x patch. (#6 uses the same mechanism for its filter parameter; it will be reconciled when either merges.)

How to test

1. Entity with @ExposeEntity(path = "products", pageable = true) in an app with springdoc.
2. GET /v3/api-docs → /api/products GET lists page, size, sort as optional query params.

Verified end-to-end with this branch published to mavenLocal and a Spring Boot 4.0.8 + springdoc 3.0.3 app:

	Before	After
Parameters	pageable — required, $ref: Pageable (object)	page (integer, default 0), size (integer, default 20), sort (array of string) — all optional
GET ?page=0&size=1&sort=name,desc	200	200

Generated output (if applicable)

Generated source diff

// before
public ResponseEntity<Page<ProductDto>> findAll(Pageable pageable)
// after (springdoc on the classpath)
public ResponseEntity<Page<ProductDto>> findAll(@ParameterObject Pageable pageable)

Checklist

• All existing tests pass (./gradlew :processor:test) — 59/59; ./gradlew build clean
• New tests added / updated to cover the change
• No MapStruct warnings in the sample project — not run
• README.md updated if a public API / annotation attribute changed — n/a
• docs/tech/ updated if architecture or generated artifacts changed — n/a
• Commit messages follow type(scope): description format

---

Generated by Claude Code