This is an automated email from the ASF dual-hosted git repository.
Croway pushed a commit to branch camel-4.22.x
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/camel-4.22.x by this push:
new 7e7d440ba135 (chore) Deprecate Tika configuration options (#25874)
7e7d440ba135 is described below
commit 7e7d440ba135fd4cffabafeef5316232a2db789d
Author: Federico Mariani <[email protected]>
AuthorDate: Fri Aug 28 16:40:45 2026 +0200
(chore) Deprecate Tika configuration options (#25874)
* (chore) Deprecate Tika configuration options
* chore: Regenerate Tika endpoint DSL
* chore: Match generated endpoint DSL formatting
---
.../org/apache/camel/catalog/components/tika.json | 4 ++--
.../META-INF/org/apache/camel/component/tika/tika.json | 4 ++--
.../apache/camel/component/tika/TikaConfiguration.java | 18 ++++++++++++++++++
.../ROOT/pages/camel-4x-upgrade-guide-4_22.adoc | 8 ++++++++
.../endpoint/dsl/TikaEndpointBuilderFactory.java | 3 +++
5 files changed, 33 insertions(+), 4 deletions(-)
diff --git
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/tika.json
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/tika.json
index 2dd6f4529918..998e04c99162 100644
---
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/tika.json
+++
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/tika.json
@@ -32,7 +32,7 @@
"tikaParseOutputEncoding": { "index": 1, "kind": "parameter",
"displayName": "Tika Parse Output Encoding", "group": "producer", "label": "",
"required": false, "type": "string", "javaType": "java.lang.String",
"deprecated": false, "autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Parse Output Encoding" },
"tikaParseOutputFormat": { "index": 2, "kind": "parameter", "displayName":
"Tika Parse Output Format", "group": "producer", "label": "", "required":
false, "type": "enum", "javaType":
"org.apache.camel.component.tika.TikaParseOutputFormat", "enum": [ "xml",
"html", "text" ], "deprecated": false, "autowired": false, "secret": false,
"defaultValue": "xml", "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description" [...]
"lazyStartProducer": { "index": 3, "kind": "parameter", "displayName":
"Lazy Start Producer", "group": "producer (advanced)", "label":
"producer,advanced", "required": false, "type": "boolean", "javaType":
"boolean", "deprecated": false, "autowired": false, "secret": false,
"defaultValue": false, "description": "Whether the producer should be started
lazy (on the first message). By starting lazy you can use this to allow
CamelContext and routes to startup in situations where a produc [...]
- "tikaConfig": { "index": 4, "kind": "parameter", "displayName": "Tika
Config", "group": "advanced", "label": "advanced", "required": false, "type":
"object", "javaType": "org.apache.tika.config.TikaConfig", "deprecated": false,
"autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Config" },
- "tikaConfigUri": { "index": 5, "kind": "parameter", "displayName": "Tika
Config Uri", "group": "advanced", "label": "advanced", "required": false,
"type": "string", "javaType": "java.lang.String", "deprecated": false,
"autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Config Url" }
+ "tikaConfig": { "index": 4, "kind": "parameter", "displayName": "Tika
Config", "group": "advanced", "label": "advanced", "required": false, "type":
"object", "javaType": "org.apache.tika.config.TikaConfig", "deprecated": true,
"autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Config" },
+ "tikaConfigUri": { "index": 5, "kind": "parameter", "displayName": "Tika
Config Uri", "group": "advanced", "label": "advanced", "required": false,
"type": "string", "javaType": "java.lang.String", "deprecated": true,
"autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Config Url" }
}
}
diff --git
a/components/camel-tika/src/generated/resources/META-INF/org/apache/camel/component/tika/tika.json
b/components/camel-tika/src/generated/resources/META-INF/org/apache/camel/component/tika/tika.json
index 2dd6f4529918..998e04c99162 100644
---
a/components/camel-tika/src/generated/resources/META-INF/org/apache/camel/component/tika/tika.json
+++
b/components/camel-tika/src/generated/resources/META-INF/org/apache/camel/component/tika/tika.json
@@ -32,7 +32,7 @@
"tikaParseOutputEncoding": { "index": 1, "kind": "parameter",
"displayName": "Tika Parse Output Encoding", "group": "producer", "label": "",
"required": false, "type": "string", "javaType": "java.lang.String",
"deprecated": false, "autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Parse Output Encoding" },
"tikaParseOutputFormat": { "index": 2, "kind": "parameter", "displayName":
"Tika Parse Output Format", "group": "producer", "label": "", "required":
false, "type": "enum", "javaType":
"org.apache.camel.component.tika.TikaParseOutputFormat", "enum": [ "xml",
"html", "text" ], "deprecated": false, "autowired": false, "secret": false,
"defaultValue": "xml", "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description" [...]
"lazyStartProducer": { "index": 3, "kind": "parameter", "displayName":
"Lazy Start Producer", "group": "producer (advanced)", "label":
"producer,advanced", "required": false, "type": "boolean", "javaType":
"boolean", "deprecated": false, "autowired": false, "secret": false,
"defaultValue": false, "description": "Whether the producer should be started
lazy (on the first message). By starting lazy you can use this to allow
CamelContext and routes to startup in situations where a produc [...]
- "tikaConfig": { "index": 4, "kind": "parameter", "displayName": "Tika
Config", "group": "advanced", "label": "advanced", "required": false, "type":
"object", "javaType": "org.apache.tika.config.TikaConfig", "deprecated": false,
"autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Config" },
- "tikaConfigUri": { "index": 5, "kind": "parameter", "displayName": "Tika
Config Uri", "group": "advanced", "label": "advanced", "required": false,
"type": "string", "javaType": "java.lang.String", "deprecated": false,
"autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Config Url" }
+ "tikaConfig": { "index": 4, "kind": "parameter", "displayName": "Tika
Config", "group": "advanced", "label": "advanced", "required": false, "type":
"object", "javaType": "org.apache.tika.config.TikaConfig", "deprecated": true,
"autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Config" },
+ "tikaConfigUri": { "index": 5, "kind": "parameter", "displayName": "Tika
Config Uri", "group": "advanced", "label": "advanced", "required": false,
"type": "string", "javaType": "java.lang.String", "deprecated": true,
"autowired": false, "secret": false, "configurationClass":
"org.apache.camel.component.tika.TikaConfiguration", "configurationField":
"tikaConfiguration", "description": "Tika Config Url" }
}
}
diff --git
a/components/camel-tika/src/main/java/org/apache/camel/component/tika/TikaConfiguration.java
b/components/camel-tika/src/main/java/org/apache/camel/component/tika/TikaConfiguration.java
index 93de5fc3a6f9..b9e0990e5876 100644
---
a/components/camel-tika/src/main/java/org/apache/camel/component/tika/TikaConfiguration.java
+++
b/components/camel-tika/src/main/java/org/apache/camel/component/tika/TikaConfiguration.java
@@ -36,8 +36,10 @@ public class TikaConfiguration {
@UriParam(description = "Tika Parse Output Encoding")
private String tikaParseOutputEncoding = Charset.defaultCharset().name();
@UriParam(label = "advanced", description = "Tika Config")
+ @Deprecated(since = "4.22.1", forRemoval = true)
private TikaConfig tikaConfig = TikaConfig.getDefaultConfig();
@UriParam(label = "advanced", description = "Tika Config Url")
+ @Deprecated(since = "4.22.1", forRemoval = true)
private String tikaConfigUri;
public TikaOperation getOperation() {
@@ -85,24 +87,40 @@ public class TikaConfiguration {
this.tikaParseOutputEncoding = tikaParseOutputEncoding;
}
+ /**
+ * @deprecated Tika 4 removes {@link TikaConfig}; use the replacement Tika
4 configuration options in Camel 4.23.
+ */
+ @Deprecated(since = "4.22.1", forRemoval = true)
public TikaConfig getTikaConfig() {
return tikaConfig;
}
/**
* To use a custom Tika config.
+ *
+ * @deprecated Tika 4 removes {@link TikaConfig}; use the replacement Tika
4 configuration options in Camel 4.23.
*/
+ @Deprecated(since = "4.22.1", forRemoval = true)
+ @Metadata(deprecationNote = "Tika 4 removes TikaConfig; use the
replacement Tika 4 configuration options in Camel 4.23")
public void setTikaConfig(TikaConfig tikaConfig) {
this.tikaConfig = tikaConfig;
}
+ /**
+ * @deprecated Tika 4 removes XML configuration; use the JSON
configuration option provided in Camel 4.23.
+ */
+ @Deprecated(since = "4.22.1", forRemoval = true)
public String getTikaConfigUri() {
return tikaConfigUri;
}
/**
* Tika Config Uri: The URI of tika-config.xml file to use.
+ *
+ * @deprecated Tika 4 removes XML configuration; use the JSON
configuration option provided in Camel 4.23.
*/
+ @Deprecated(since = "4.22.1", forRemoval = true)
+ @Metadata(deprecationNote = "Tika 4 removes XML configuration; use the
JSON configuration option provided in Camel 4.23")
public void setTikaConfigUri(String tikaConfigUri) {
this.tikaConfigUri = tikaConfigUri;
try {
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
index 144cac121b77..e6bb96e52b7b 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
@@ -35,6 +35,14 @@ previously behaved differently from node mode for an
otherwise identical endpoin
== Upgrading Camel 4.21 to 4.22
+=== camel-tika
+
+The `tikaConfig` and `tikaConfigUri` component options are deprecated for
removal in Camel 4.23.
+Apache Tika 4 removes the `TikaConfig` class and XML configuration support;
Camel 4.23 will provide
+replacement options based on Tika's `TikaLoader` and JSON configuration. See
the
+https://tika.apache.org/docs/4.0.x/migration-to-4x/migrating-to-4x.html[Tika 4
migration guide] for
+migration details.
+
=== camel-reactive-executor-tomcat
The `camel-reactive-executor-tomcat` component has been deprecated. Its
cross-thread `ThreadLocal`
diff --git
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/TikaEndpointBuilderFactory.java
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/TikaEndpointBuilderFactory.java
index b1de6a481da4..bfc6b0f271d0 100644
---
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/TikaEndpointBuilderFactory.java
+++
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/TikaEndpointBuilderFactory.java
@@ -166,6 +166,7 @@ public interface TikaEndpointBuilderFactory {
* @param tikaConfig the value to set
* @return the dsl builder
*/
+ @Deprecated
default AdvancedTikaEndpointBuilder
tikaConfig(org.apache.tika.config.TikaConfig tikaConfig) {
doSetProperty("tikaConfig", tikaConfig);
return this;
@@ -181,6 +182,7 @@ public interface TikaEndpointBuilderFactory {
* @param tikaConfig the value to set
* @return the dsl builder
*/
+ @Deprecated
default AdvancedTikaEndpointBuilder tikaConfig(String tikaConfig) {
doSetProperty("tikaConfig", tikaConfig);
return this;
@@ -195,6 +197,7 @@ public interface TikaEndpointBuilderFactory {
* @param tikaConfigUri the value to set
* @return the dsl builder
*/
+ @Deprecated
default AdvancedTikaEndpointBuilder tikaConfigUri(String
tikaConfigUri) {
doSetProperty("tikaConfigUri", tikaConfigUri);
return this;