Skip to content

Conversation

@jayblanc
Copy link
Contributor

@jayblanc jayblanc commented Sep 18, 2025

With Karaf 4.4.8 upgrade, Apache CXF provides a new cxf-rt-rs-service-description-openapi-v3 which can replace the previously used jaxrs-analyzer-maven-plugin for Swagger/OpenAPI documentation.

This PR includes:

  • Replacement of Swagger documentation generation with CXF's OpenAPI integration
  • Override of swagger-initializer.js to ensure Unomi's API documentation loads correctly (fixes issue with default petshop sample)
  • Upgrade of Apache CXF to 3.6.8 for compatibility between Swagger Core (2.2.34) and Jackson (2.18.2)
  • Addition of docker-compose-cluster.yml for cluster testing
  • Addition of BUILD file at package root for easy build identification in Docker images

Also fixes:

  • Swagger UI no longer supports query params
  • Swagger Core/Jackson incompatibility (related issue)

@jayblanc jayblanc changed the title [UNOMI-899} Replace jaxrs-analyzer-maven-plugin with an alternative for Swagger documentation generation [UNOMI-899] Replace jaxrs-analyzer-maven-plugin with an alternative for Swagger documentation generation Sep 18, 2025
@jsinovassin jsinovassin merged commit 8cff171 into apache:master Sep 23, 2025
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants