Skip to content

Migration Guide 3.4

Clement Escoffier edited this page Sep 13, 2024 · 12 revisions

Vert.x HTTP

Configuration

The Vert.x HTTP configuration was migrated to the new ConfigMapping infrastructure. The main visible change is that the configuration classes are now interfaces.

If you were consuming them in an extension to get the configuration property values (for instance by injecting io.quarkus.vertx.http.runtime.HttpConfiguration), you will have to adjust your code accordingly to use the interface methods (instead of the class fields). Adding () at the end of each consumed field should be all that’s needed in most cases.

Flyway

The Flyway extension has seen significant changes in 3.3 and some of these changes introduced some regressions in corner cases, typically when you had several datasources, one of which is not supported by Flyway.

It is now possible to entirely disable the automatic setup of the Flyway extension by setting quarkus.flyway.enabled=false.

You can also make Flyway inactive for a specific datasource by setting quarkus.flyway.active=false for the default datasource or quarkus.flyway."datasource name".active=false for a named datasource.

Elasticsearch

Dev Services

The Elasticsearch Dev Services now default to starting Elasticsearch 8.9, instead of 8.8 previously.

Also, Elasticsearch Dev Services will now automatically start OpenSearch instead of Elasticsearch when they detect that a Quarkus extension expects OpenSearch. Currently only the Hibernate Search extension takes advantage of this feature.

To force the use of a specific distribution (Elasticsearch vs. OpenSearch) or version, configure the container image explicitly.

SmallRye GraphQL

Directives

Previously, annotation-based GraphQL directives got applied on any element of the GraphQL schema, regardless of whether that directive was actually declared to be applicable to that element type. This has now been fixed and the directive annotation’s on parameter is used for determining allowed placement for directives. This change might potentially break some applications that were written incorrectly but were working by accident, so if you use annotation-based GraphQL directives, we recommend verifying that their usages correspond to the directive’s declaration.

Component testing

Programmatic registration

The QuarkusComponentTestExtension is now immutable. As a result, if you register the QuarkusComponentTestExtension programmatically then the static field is initialized with with the QuarkusComponentTestExtension(Class…​) simplified constructor or with the convenient QuarkusComponentTestExtension.builder().

Lifecycle

The test instance lifecycle determines the test phase in which the CDI container is started/stopped. If the test instance lifecycle is Lifecycle#PER_METHOD (default) then the container is started during the before each test phase and stopped during the after each test phase. However, if the test instance lifecycle is Lifecycle#PER_CLASS then the container is started during the before all test phase and stopped during the after all test phase. In previous versions, the container was always started during the before all test phase and stopped during the after all test phase.

Current version

Migration Guide 3.17

Next version in main

Migration Guide 3.18

Clone this wiki locally