This is an automated email from the ASF dual-hosted git repository. jamesnetherton pushed a commit to branch 3.40.x in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git
commit c5dde283406c3482e548e9340c1e86371e2e340d Author: James Netherton <[email protected]> AuthorDate: Fri Oct 23 08:01:29 2026 +0100 Deprecate core build items and configuration removed in 4.0.0 Deprecate CamelBootstrapCompletedBuildItem, CamelRuntimeBuildItem, RegistryRoutesLoader, RegistryRoutesLoaders and quarkus.camel.source-location-enabled for removal in 4.0.0, and add a 3.40.1 migration guide describing the deprecations. Co-Authored-By: Claude Opus 5.5 <[email protected]> --- .../modules/ROOT/pages/migration-guide/3.40.1.adoc | 31 ++++++++++++++++++++++ docs/modules/ROOT/pages/migration-guide/index.adoc | 1 + .../ROOT/pages/reference/extensions/core.adoc | 12 ++++----- .../spi/CamelBootstrapCompletedBuildItem.java | 5 ++++ .../core/deployment/spi/CamelRuntimeBuildItem.java | 8 ++++++ .../org/apache/camel/quarkus/core/CamelConfig.java | 3 +++ .../camel/quarkus/core/RegistryRoutesLoader.java | 4 +++ .../camel/quarkus/core/RegistryRoutesLoaders.java | 4 +++ 8 files changed, 62 insertions(+), 6 deletions(-) diff --git a/docs/modules/ROOT/pages/migration-guide/3.40.1.adoc b/docs/modules/ROOT/pages/migration-guide/3.40.1.adoc new file mode 100644 index 0000000000..ccdba03514 --- /dev/null +++ b/docs/modules/ROOT/pages/migration-guide/3.40.1.adoc @@ -0,0 +1,31 @@ += Camel Quarkus 3.40.1 Migration Guide + +The following guide outlines how to adapt your code to changes that were made in Camel Quarkus 3.40.1. + +== `quarkus.camel.source-location-enabled` deprecated + +`quarkus.camel.source-location-enabled` duplicates the standard Apache Camel `camel.main.sourceLocationEnabled` option. It is deprecated and will be removed in Camel Quarkus 4.0.0. Use the Apache Camel property instead. + +[source,properties] +---- +camel.main.sourceLocationEnabled = true +---- + +== Core extension build items deprecated + +These changes affect only custom Quarkus extensions that consume build items from `camel-quarkus-core-deployment`. Applications are unaffected. + +The following build items are deprecated and will be removed in Camel Quarkus 4.0.0. + +[cols="1,2"] +|=== +|Build item |Replacement + +|`CamelBootstrapCompletedBuildItem` +|None. To act after Camel has started, observe the `org.apache.camel.quarkus.main.events.AfterStart` CDI event. + +|`CamelRuntimeBuildItem` +|To access the runtime, inject the `org.apache.camel.quarkus.core.CamelRuntime` bean. To run a `RUNTIME_INIT` task before Camel starts, produce a `CamelRuntimeTaskBuildItem`. +|=== + +The runtime classes `org.apache.camel.quarkus.core.RegistryRoutesLoader` and `org.apache.camel.quarkus.core.RegistryRoutesLoaders` are also deprecated and will be removed in Camel Quarkus 4.0.0. diff --git a/docs/modules/ROOT/pages/migration-guide/index.adoc b/docs/modules/ROOT/pages/migration-guide/index.adoc index 150b2340bc..4d0291e8d6 100644 --- a/docs/modules/ROOT/pages/migration-guide/index.adoc +++ b/docs/modules/ROOT/pages/migration-guide/index.adoc @@ -4,6 +4,7 @@ We do frequent releases, a release almost every month, and even though we strive Listed here are guides on how to migrate between major versions and anything of significance to watch for when upgrading from minor versions. +* xref:migration-guide/3.40.1.adoc[Camel Quarkus 3.40.0 to Camel Quarkus 3.40.1 migration guide] * xref:migration-guide/3.40.0.adoc[Camel Quarkus 3.39.x to Camel Quarkus 3.40.0 migration guide] * xref:migration-guide/3.39.0.adoc[Camel Quarkus 3.38.x to Camel Quarkus 3.39.0 migration guide] * xref:migration-guide/3.38.0.adoc[Camel Quarkus 3.36.x to Camel Quarkus 3.38.0 migration guide] diff --git a/docs/modules/ROOT/pages/reference/extensions/core.adoc b/docs/modules/ROOT/pages/reference/extensions/core.adoc index 37d54bcc76..2309b54534 100644 --- a/docs/modules/ROOT/pages/reference/extensions/core.adoc +++ b/docs/modules/ROOT/pages/reference/extensions/core.adoc @@ -357,12 +357,6 @@ application. | `boolean` | `true` -a|icon:lock[title=Fixed at build time] [[quarkus-camel-source-location-enabled]]`link:#quarkus-camel-source-location-enabled[quarkus.camel.source-location-enabled]` - -Build time configuration options for enable/disable camel source location. -| `boolean` -| `false` - a|icon:lock[title=Fixed at build time] [[quarkus-camel-dev-ui-update-interval]]`link:#quarkus-camel-dev-ui-update-interval[quarkus.camel.dev-ui.update-interval]` The interval at which data is updated in Camel Quarkus Dev UI pages. @@ -401,6 +395,12 @@ What to do if it is not possible to extract CSimple expressions from a route def | `fail`, `warn`, `ignore` | `warn` +a|icon:lock[title=Fixed at build time] [[quarkus-camel-source-location-enabled]]`link:#quarkus-camel-source-location-enabled[quarkus.camel.source-location-enabled]` + +Build time configuration options for enable/disable camel source location. +| `boolean` +| `false` + a|icon:lock[title=Fixed at build time] [[quarkus-camel-trace-enabled]]`link:#quarkus-camel-trace-enabled[quarkus.camel.trace.enabled]` Enables tracer in your Camel application. diff --git a/extensions-core/core/deployment/src/main/java/org/apache/camel/quarkus/core/deployment/spi/CamelBootstrapCompletedBuildItem.java b/extensions-core/core/deployment/src/main/java/org/apache/camel/quarkus/core/deployment/spi/CamelBootstrapCompletedBuildItem.java index d576507099..9794529755 100644 --- a/extensions-core/core/deployment/src/main/java/org/apache/camel/quarkus/core/deployment/spi/CamelBootstrapCompletedBuildItem.java +++ b/extensions-core/core/deployment/src/main/java/org/apache/camel/quarkus/core/deployment/spi/CamelBootstrapCompletedBuildItem.java @@ -21,6 +21,11 @@ import io.quarkus.builder.item.EmptyBuildItem; /** * A build item that does not carry any data but it is used to signal that all the bootstrap steps have been * completed. + * + * @deprecated nothing consumes this build item. To act after Camel has started, observe the + * {@code org.apache.camel.quarkus.main.events.AfterStart} CDI event. Deprecated in 3.40.1, will be removed + * in 4.0.0. */ +@Deprecated(since = "3.40.1", forRemoval = true) public final class CamelBootstrapCompletedBuildItem extends EmptyBuildItem { } diff --git a/extensions-core/core/deployment/src/main/java/org/apache/camel/quarkus/core/deployment/spi/CamelRuntimeBuildItem.java b/extensions-core/core/deployment/src/main/java/org/apache/camel/quarkus/core/deployment/spi/CamelRuntimeBuildItem.java index 7b9d72e15f..1ef77b4450 100644 --- a/extensions-core/core/deployment/src/main/java/org/apache/camel/quarkus/core/deployment/spi/CamelRuntimeBuildItem.java +++ b/extensions-core/core/deployment/src/main/java/org/apache/camel/quarkus/core/deployment/spi/CamelRuntimeBuildItem.java @@ -20,6 +20,14 @@ import io.quarkus.builder.item.SimpleBuildItem; import io.quarkus.runtime.RuntimeValue; import org.apache.camel.quarkus.core.CamelRuntime; +/** + * Holds the {@link CamelRuntime} {@link RuntimeValue}. + * + * @deprecated to access the runtime, inject the {@link CamelRuntime} bean. To run a + * {@link io.quarkus.deployment.annotations.ExecutionTime#RUNTIME_INIT} task before Camel starts, produce a + * {@link CamelRuntimeTaskBuildItem}. Deprecated in 3.40.1, will be removed in 4.0.0. + */ +@Deprecated(since = "3.40.1", forRemoval = true) public final class CamelRuntimeBuildItem extends SimpleBuildItem { private final RuntimeValue<CamelRuntime> runtime; private final boolean autoStartup; diff --git a/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/CamelConfig.java b/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/CamelConfig.java index f4055c19c1..70ff480492 100644 --- a/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/CamelConfig.java +++ b/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/CamelConfig.java @@ -87,8 +87,11 @@ public interface CamelConfig { /** * Build time configuration options for enable/disable camel source location. * + * @deprecated use the standard Apache Camel {@code camel.main.sourceLocationEnabled} configuration property + * instead. Deprecated in 3.40.1, will be removed in 4.0.0. * @asciidoclet */ + @Deprecated(since = "3.40.1", forRemoval = true) @WithDefault("false") boolean sourceLocationEnabled(); diff --git a/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/RegistryRoutesLoader.java b/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/RegistryRoutesLoader.java index 58f45dc5c4..82029c5e65 100644 --- a/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/RegistryRoutesLoader.java +++ b/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/RegistryRoutesLoader.java @@ -21,6 +21,10 @@ import java.util.List; import org.apache.camel.CamelContext; import org.apache.camel.RoutesBuilder; +/** + * @deprecated internal API that will be removed in 4.0.0 without replacement. Deprecated in 3.40.1. + */ +@Deprecated(since = "3.40.1", forRemoval = true) public interface RegistryRoutesLoader { List<RoutesBuilder> collectRoutesFromRegistry(CamelContext camelContext, String excludePattern, String includePattern); } diff --git a/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/RegistryRoutesLoaders.java b/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/RegistryRoutesLoaders.java index f211459b9e..1e8a43f09c 100644 --- a/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/RegistryRoutesLoaders.java +++ b/extensions-core/core/runtime/src/main/java/org/apache/camel/quarkus/core/RegistryRoutesLoaders.java @@ -33,6 +33,10 @@ import org.apache.camel.util.ObjectHelper; import org.slf4j.Logger; import org.slf4j.LoggerFactory; +/** + * @deprecated internal API that will be removed in 4.0.0 without replacement. Deprecated in 3.40.1. + */ +@Deprecated(since = "3.40.1", forRemoval = true) public final class RegistryRoutesLoaders { private RegistryRoutesLoaders() { }
