Update SmallRye OpenAPI and MicroProfile OpenAPI to 4.0

[MikeEdgar]

• Bumps MicroProfile OpenAPI to 4.0.2 (breaking API changes)
• Bumps SmallRye OpenAPI to 4.0.0
• Replace uses of SmallRye OpenAPI's internal model types with OASFactory
• Move calculation of operation method reference into OpenAPI processor and combine two Operation filters into single filter to make a single pass over the OpenAPI model.

[MikeEdgar]

@zakkak, you should see further reduction in the native image size with this update.

[zakkak]

For reference, this PR is related to #43616 and #41037.

@zakkak, you should see further reduction in the native image size with this update.

The mentioned reduction in the native image size refers to #41037 (comment) and how #43616 reverted some of that effect.

[MikeEdgar]

I'm looking into the integration test failure.

[MikeEdgar]

@phillip-kruger please take a look when you can, thanks.

[phillip-kruger]

Nice ! Thanks @MikeEdgar !

[zakkak]

@zakkak, you should see further reduction in the native image size with this update.

Indeed, I see:

	Before	After	Diff (%)
Reachable classes	13680	13421	1.9
Reachable methods	70690	69608	1.5
Size (MB)	63.6	63.1	0.7

[michalvavrik]

Hello, this PR has in description breaking changes but there is no label and there isn't a migration guide note. For example, JSON path to one of my example in schema was components.schemas.LocalDateTime.example and now it is components.schemas.LocalDateTime.examples[0]. This may impact generated clients, ETLs etc. and users need to know about breaking changes. @MikeEdgar can you document this, please? If you cannot add migration guides, I am sure @gsmet or @phillip-kruger can help.

[MikeEdgar]

@MikeEdgar can you document this, please?

@michalvavrik can you point me to the repository where that should be done?

[michalvavrik]

@MikeEdgar can you document this, please?

@michalvavrik can you point me to the repository where that should be done?

It's this one. I myself have no rights so better talk to @gsmet about the process.

[michalvavrik]

I'll add a breaking label though. Hope that's fine.

[zakkak]

@michalvavrik can you point me to the repository where that should be done?

@MikeEdgar the migration guide is here https://github.com/quarkusio/quarkus/wiki/Migration-Guide-3.17 , I don't know if you have edit rights through.

[gsmet]

You can post something here and I'll add it.

[MikeEdgar]

@gsmet , @michalvavrik , here is some content for the 3.17 Migration guide.

MicroProfile OpenAPI 4.0

MicroProfile OpenAPI and the SmallRye OpenAPI implementation have both be updated to version 4. This version brings support for OpenAPI specification version 3.1. By default, the OpenAPI documentation generated will use version 3.1.0, however users can continue to generate 3.0.x output by using property mp.openapi.extensions.smallrye.openapi with (for example) the value 3.0.3.

The Schema interface contains breaking changes, specifically:

• type property type changed from SchemaType to List<SchemaType>
• exclusiveMinimum and exclusiveMaximum property types changed from Boolean to BigDecimal
• nullable property removed (replaced by the addition of NULL to SchemaType)
• property example is deprecated in favor of using the new examples property, which may hold one or more example objects

Additionally, the default value of @RequestBody.required has changed to true to reflect that this is the much more common case where a RESTful resource method accepts a request body.

There are numerous other new properties for annotations and models, reflecting the changes between OpenAPI 3.0.x and 3.1.0. The release notes for the latest MicroProfile OpenAPI 4 release are available for review.

[michalvavrik]

thank you @MikeEdgar

[MikeEdgar]

@gsmet just bumping this thread to make sure you got my comment with the 3.17 migration notes for OpenAPI.