Skip to content

Add support for OpenAPI schema generation#231

Open
zZHorizonZz wants to merge 1 commit intoeclipse-vertx:mainfrom
zZHorizonZz:openapi-generator
Open

Add support for OpenAPI schema generation#231
zZHorizonZz wants to merge 1 commit intoeclipse-vertx:mainfrom
zZHorizonZz:openapi-generator

Conversation

@zZHorizonZz
Copy link
Member

Motivation:

Add OpenAPI schema generation for enhanced transcoding use, as at the moment users would need to create schema themselves or use not java friendly generator plugin.

Changes:

  • Added a schema-config option in GenerationOptions to specify the OpenAPI configuration file path.
  • Updated SchemaModelBuilder to merge generated schemas with user-provided configuration values.
  • Added SchemaConfigLoader for loading and parsing configuration files.
  • Enhanced SchemaGenerator to handle schema customization during the generation process.
  • Updated documentation with examples for using the schema-config option.
  • Added integration tests to verify the functionality of schema customization using configuration files.

@zZHorizonZz zZHorizonZz requested a review from vietj January 28, 2026 08:30
@zZHorizonZz zZHorizonZz changed the title Add support for OpenAPI configuration file and schema customization. Add support for OpenAPI schema generation Jan 29, 2026
@vietj vietj added this to the 5.1.0 milestone Jan 29, 2026
Motivation:

Enable enhanced flexibility in OpenAPI schema generation by allowing users to provide a custom YAML/JSON configuration file for overriding and merging API specification details like metadata, servers, security, and tags.

Changes:

- Added a `schema-config` option in `GenerationOptions` to specify the OpenAPI configuration file path.
- Updated `SchemaModelBuilder` to merge generated schemas with user-provided configuration values.
- Introduced `SchemaConfigLoader` for loading and parsing configuration files.
- Enhanced `SchemaGenerator` to handle schema customization during the generation process.
- Updated documentation with examples for using the `schema-config` option.
- Added integration tests to verify the functionality of schema customization using configuration files.
- Refactored relevant classes and methods to support the new feature.

Signed-off-by: Daniel Fiala <danfiala23@gmail.com>
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