This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git


The following commit(s) were added to refs/heads/main by this push:
     new 98017d22482a CAMEL-27238: camel-netty-http - deprecate the shared HTTP 
server (nettySharedHttpServer) (#30406)
98017d22482a is described below

commit 98017d22482a2600dfb3dbe6442fb33713cd08a3
Author: Claus Ibsen <[email protected]>
AuthorDate: Thu Nov 19 13:46:56 2026 +0100

    CAMEL-27238: camel-netty-http - deprecate the shared HTTP server 
(nettySharedHttpServer) (#30406)
    
    Co-Authored-By: Claude Opus 5.5 <[email protected]>
    Signed-off-by: Claus Ibsen <[email protected]>
---
 .../apache/camel/catalog/components/netty-http.json    |  2 +-
 .../camel/catalog/docs/netty-http-component.adoc       | 18 ++++++++++++++++++
 .../apache/camel/component/netty/http/netty-http.json  |  2 +-
 .../src/main/docs/netty-http-component.adoc            | 18 ++++++++++++++++++
 .../netty/http/DefaultNettySharedHttpServer.java       |  5 +++++
 .../netty/http/HttpServerBootstrapFactory.java         |  8 ++++++++
 .../netty/http/HttpServerSharedInitializerFactory.java |  7 ++++++-
 .../camel/component/netty/http/NettyHttpEndpoint.java  | 15 ++++++++++++++-
 .../component/netty/http/NettySharedHttpServer.java    |  5 +++++
 .../NettySharedHttpServerBootstrapConfiguration.java   |  8 ++++++++
 .../ROOT/pages/camel-4x-upgrade-guide-4_24.adoc        | 10 ++++++++++
 .../endpoint/dsl/NettyHttpEndpointBuilderFactory.java  | 18 ++++++++++++++----
 12 files changed, 108 insertions(+), 8 deletions(-)

diff --git 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/netty-http.json
 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/netty-http.json
index cdc1ac3050f4..b040794638b7 100644
--- 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/netty-http.json
+++ 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/netty-http.json
@@ -169,7 +169,7 @@
     "maxHeaderSize": { "index": 28, "kind": "parameter", "displayName": "Max 
Header Size", "group": "consumer (advanced)", "label": "consumer,advanced", 
"required": false, "type": "integer", "javaType": "int", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": 8192, 
"configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfiguration", 
"configurationField": "configuration", "description": "The maximum length of 
all headers. If the sum of the length o [...]
     "maxInitialLineLength": { "index": 29, "kind": "parameter", "displayName": 
"Max Initial Line Length", "group": "consumer (advanced)", "label": 
"consumer,advanced", "required": false, "type": "integer", "javaType": "int", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 4096, 
"configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfiguration", 
"configurationField": "configuration", "description": "The maximum length of 
the initial line (e.g. G [...]
     "nettyServerBootstrapFactory": { "index": 30, "kind": "parameter", 
"displayName": "Netty Server Bootstrap Factory", "group": "consumer 
(advanced)", "label": "consumer,advanced", "required": false, "type": "object", 
"javaType": "org.apache.camel.component.netty.NettyServerBootstrapFactory", 
"deprecated": false, "autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfiguration", 
"configurationField": "configuration", "description": [...]
-    "nettySharedHttpServer": { "index": 31, "kind": "parameter", 
"displayName": "Netty Shared Http Server", "group": "consumer (advanced)", 
"label": "consumer,advanced", "required": false, "type": "object", "javaType": 
"org.apache.camel.component.netty.http.NettySharedHttpServer", "deprecated": 
false, "autowired": false, "secret": false, "description": "To use a shared 
Netty HTTP server. See Netty HTTP Server Example for more details." },
+    "nettySharedHttpServer": { "index": 31, "kind": "parameter", 
"displayName": "Netty Shared Http Server", "group": "consumer (advanced)", 
"label": "consumer,advanced", "required": false, "type": "object", "javaType": 
"org.apache.camel.component.netty.http.NettySharedHttpServer", "deprecated": 
true, "deprecationNote": "The shared Netty HTTP server was added for 
OSGi\/Karaf, so that several applications in one JVM could use the same port. 
Use a netty-http consumer per port, where several [...]
     "serverClosedChannelExceptionCaughtLogLevel": { "index": 32, "kind": 
"parameter", "displayName": "Server Closed Channel Exception Caught Log Level", 
"group": "consumer (advanced)", "label": "consumer,advanced", "required": 
false, "type": "enum", "javaType": "org.apache.camel.LoggingLevel", "enum": [ 
"TRACE", "DEBUG", "INFO", "WARN", "ERROR", "OFF" ], "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": "DEBUG", 
"configurationClass": "org.apache.camel.component.ne [...]
     "serverExceptionCaughtLogLevel": { "index": 33, "kind": "parameter", 
"displayName": "Server Exception Caught Log Level", "group": "consumer 
(advanced)", "label": "consumer,advanced", "required": false, "type": "enum", 
"javaType": "org.apache.camel.LoggingLevel", "enum": [ "TRACE", "DEBUG", 
"INFO", "WARN", "ERROR", "OFF" ], "deprecated": false, "autowired": false, 
"secret": false, "defaultValue": "WARN", "configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfigurati [...]
     "serverInitializerFactory": { "index": 34, "kind": "parameter", 
"displayName": "Server Initializer Factory", "group": "consumer (advanced)", 
"label": "consumer,advanced", "required": false, "type": "object", "javaType": 
"org.apache.camel.component.netty.ServerInitializerFactory", "deprecated": 
false, "autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfiguration", 
"configurationField": "configuration", "description": "To use a [...]
diff --git 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/netty-http-component.adoc
 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/netty-http-component.adoc
index abfeb44607c1..3e0cedfb7afc 100644
--- 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/netty-http-component.adoc
+++ 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/netty-http-component.adoc
@@ -691,6 +691,24 @@ YAML::
 ----
 ====
 
+=== Using a shared Netty HTTP server (deprecated)
+
+[WARNING]
+====
+The shared Netty HTTP server is deprecated, and will be removed in a future 
release. This covers the
+`nettySharedHttpServer` option and the `NettySharedHttpServer`, 
`DefaultNettySharedHttpServer`,
+`NettySharedHttpServerBootstrapConfiguration` and 
`HttpServerSharedInitializerFactory` classes.
+
+It was added for OSGi/Karaf, so that several applications (bundles) in one JVM 
could use the same port.
+Camel Main, Spring Boot and Quarkus applications run one application per JVM: 
use a `netty-http` consumer
+per port, where several routes can use the same port (see 
<<_using_multiple_routes_with_same_port,Using multiple routes with same port>>),
+or the xref:platform-http-component.adoc[Platform HTTP] component, which uses 
the HTTP server of the runtime.
+====
+
+A `DefaultNettySharedHttpServer` is a Netty HTTP server that is configured 
with a
+`NettySharedHttpServerBootstrapConfiguration` and started on its own. The 
consumers that refer to it with the
+`nettySharedHttpServer` option use its port and its pipeline, instead of the 
server that the component creates.
+
 === Implementing a reverse proxy
 
 Netty HTTP component can act as a reverse proxy, in that case
diff --git 
a/components/camel-netty-http/src/generated/resources/META-INF/org/apache/camel/component/netty/http/netty-http.json
 
b/components/camel-netty-http/src/generated/resources/META-INF/org/apache/camel/component/netty/http/netty-http.json
index cdc1ac3050f4..b040794638b7 100644
--- 
a/components/camel-netty-http/src/generated/resources/META-INF/org/apache/camel/component/netty/http/netty-http.json
+++ 
b/components/camel-netty-http/src/generated/resources/META-INF/org/apache/camel/component/netty/http/netty-http.json
@@ -169,7 +169,7 @@
     "maxHeaderSize": { "index": 28, "kind": "parameter", "displayName": "Max 
Header Size", "group": "consumer (advanced)", "label": "consumer,advanced", 
"required": false, "type": "integer", "javaType": "int", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": 8192, 
"configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfiguration", 
"configurationField": "configuration", "description": "The maximum length of 
all headers. If the sum of the length o [...]
     "maxInitialLineLength": { "index": 29, "kind": "parameter", "displayName": 
"Max Initial Line Length", "group": "consumer (advanced)", "label": 
"consumer,advanced", "required": false, "type": "integer", "javaType": "int", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 4096, 
"configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfiguration", 
"configurationField": "configuration", "description": "The maximum length of 
the initial line (e.g. G [...]
     "nettyServerBootstrapFactory": { "index": 30, "kind": "parameter", 
"displayName": "Netty Server Bootstrap Factory", "group": "consumer 
(advanced)", "label": "consumer,advanced", "required": false, "type": "object", 
"javaType": "org.apache.camel.component.netty.NettyServerBootstrapFactory", 
"deprecated": false, "autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfiguration", 
"configurationField": "configuration", "description": [...]
-    "nettySharedHttpServer": { "index": 31, "kind": "parameter", 
"displayName": "Netty Shared Http Server", "group": "consumer (advanced)", 
"label": "consumer,advanced", "required": false, "type": "object", "javaType": 
"org.apache.camel.component.netty.http.NettySharedHttpServer", "deprecated": 
false, "autowired": false, "secret": false, "description": "To use a shared 
Netty HTTP server. See Netty HTTP Server Example for more details." },
+    "nettySharedHttpServer": { "index": 31, "kind": "parameter", 
"displayName": "Netty Shared Http Server", "group": "consumer (advanced)", 
"label": "consumer,advanced", "required": false, "type": "object", "javaType": 
"org.apache.camel.component.netty.http.NettySharedHttpServer", "deprecated": 
true, "deprecationNote": "The shared Netty HTTP server was added for 
OSGi\/Karaf, so that several applications in one JVM could use the same port. 
Use a netty-http consumer per port, where several [...]
     "serverClosedChannelExceptionCaughtLogLevel": { "index": 32, "kind": 
"parameter", "displayName": "Server Closed Channel Exception Caught Log Level", 
"group": "consumer (advanced)", "label": "consumer,advanced", "required": 
false, "type": "enum", "javaType": "org.apache.camel.LoggingLevel", "enum": [ 
"TRACE", "DEBUG", "INFO", "WARN", "ERROR", "OFF" ], "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": "DEBUG", 
"configurationClass": "org.apache.camel.component.ne [...]
     "serverExceptionCaughtLogLevel": { "index": 33, "kind": "parameter", 
"displayName": "Server Exception Caught Log Level", "group": "consumer 
(advanced)", "label": "consumer,advanced", "required": false, "type": "enum", 
"javaType": "org.apache.camel.LoggingLevel", "enum": [ "TRACE", "DEBUG", 
"INFO", "WARN", "ERROR", "OFF" ], "deprecated": false, "autowired": false, 
"secret": false, "defaultValue": "WARN", "configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfigurati [...]
     "serverInitializerFactory": { "index": 34, "kind": "parameter", 
"displayName": "Server Initializer Factory", "group": "consumer (advanced)", 
"label": "consumer,advanced", "required": false, "type": "object", "javaType": 
"org.apache.camel.component.netty.ServerInitializerFactory", "deprecated": 
false, "autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.netty.http.NettyHttpConfiguration", 
"configurationField": "configuration", "description": "To use a [...]
diff --git 
a/components/camel-netty-http/src/main/docs/netty-http-component.adoc 
b/components/camel-netty-http/src/main/docs/netty-http-component.adoc
index abfeb44607c1..3e0cedfb7afc 100644
--- a/components/camel-netty-http/src/main/docs/netty-http-component.adoc
+++ b/components/camel-netty-http/src/main/docs/netty-http-component.adoc
@@ -691,6 +691,24 @@ YAML::
 ----
 ====
 
+=== Using a shared Netty HTTP server (deprecated)
+
+[WARNING]
+====
+The shared Netty HTTP server is deprecated, and will be removed in a future 
release. This covers the
+`nettySharedHttpServer` option and the `NettySharedHttpServer`, 
`DefaultNettySharedHttpServer`,
+`NettySharedHttpServerBootstrapConfiguration` and 
`HttpServerSharedInitializerFactory` classes.
+
+It was added for OSGi/Karaf, so that several applications (bundles) in one JVM 
could use the same port.
+Camel Main, Spring Boot and Quarkus applications run one application per JVM: 
use a `netty-http` consumer
+per port, where several routes can use the same port (see 
<<_using_multiple_routes_with_same_port,Using multiple routes with same port>>),
+or the xref:platform-http-component.adoc[Platform HTTP] component, which uses 
the HTTP server of the runtime.
+====
+
+A `DefaultNettySharedHttpServer` is a Netty HTTP server that is configured 
with a
+`NettySharedHttpServerBootstrapConfiguration` and started on its own. The 
consumers that refer to it with the
+`nettySharedHttpServer` option use its port and its pipeline, instead of the 
server that the component creates.
+
 === Implementing a reverse proxy
 
 Netty HTTP component can act as a reverse proxy, in that case
diff --git 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/DefaultNettySharedHttpServer.java
 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/DefaultNettySharedHttpServer.java
index 70345ab77a2a..647fa8efb37d 100644
--- 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/DefaultNettySharedHttpServer.java
+++ 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/DefaultNettySharedHttpServer.java
@@ -33,7 +33,12 @@ import org.slf4j.LoggerFactory;
 
 /**
  * A default {@link NettySharedHttpServer} to make sharing Netty server in 
Camel applications easier.
+ *
+ * @deprecated the shared Netty HTTP server was added for OSGi/Karaf, so that 
several applications in one JVM could use
+ *             the same port. Use a netty-http consumer per port, where 
several routes can use the same port, or the
+ *             platform-http component.
  */
+@Deprecated
 public class DefaultNettySharedHttpServer extends ServiceSupport implements 
NettySharedHttpServer {
 
     // TODO: option to enlist in JMX
diff --git 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/HttpServerBootstrapFactory.java
 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/HttpServerBootstrapFactory.java
index 9fed54e09b1f..1d6b5ee3b2f7 100644
--- 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/HttpServerBootstrapFactory.java
+++ 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/HttpServerBootstrapFactory.java
@@ -37,6 +37,14 @@ public class HttpServerBootstrapFactory extends 
SingleTCPNettyServerBootstrapFac
         this(channelFactory, true);
     }
 
+    /**
+     * Creates a bootstrap factory, which only checks that the bootstrap 
configuration of the consumers are compatible
+     * when {@code compatibleCheck} is {@code true}. Only the shared Netty 
HTTP server turns the check off.
+     *
+     * @deprecated used only by the shared Netty HTTP server, which is 
deprecated. Use
+     *             {@link 
#HttpServerBootstrapFactory(HttpServerConsumerChannelFactory)}.
+     */
+    @Deprecated
     public HttpServerBootstrapFactory(HttpServerConsumerChannelFactory 
channelFactory, boolean compatibleCheck) {
         this.channelFactory = channelFactory;
         this.compatibleCheck = compatibleCheck;
diff --git 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/HttpServerSharedInitializerFactory.java
 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/HttpServerSharedInitializerFactory.java
index ce3a28a90e7a..417ffdbcc03b 100644
--- 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/HttpServerSharedInitializerFactory.java
+++ 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/HttpServerSharedInitializerFactory.java
@@ -39,8 +39,13 @@ import org.slf4j.LoggerFactory;
 /**
  * A shared {@link HttpServerInitializerFactory} for a shared Netty HTTP 
server.
  *
- * @see NettySharedHttpServer
+ * @see        NettySharedHttpServer
+ *
+ * @deprecated the shared Netty HTTP server was added for OSGi/Karaf, so that 
several applications in one JVM could use
+ *             the same port. Use a netty-http consumer per port, where 
several routes can use the same port, or the
+ *             platform-http component.
  */
+@Deprecated
 public class HttpServerSharedInitializerFactory extends 
HttpServerInitializerFactory {
 
     private static final Logger LOG = 
LoggerFactory.getLogger(HttpServerSharedInitializerFactory.class);
diff --git 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettyHttpEndpoint.java
 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettyHttpEndpoint.java
index 5956ac77dfe9..5567739129f1 100644
--- 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettyHttpEndpoint.java
+++ 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettyHttpEndpoint.java
@@ -109,6 +109,10 @@ public class NettyHttpEndpoint extends NettyEndpoint 
implements HeaderFilterStra
     @UriParam(label = "consumer,advanced")
     private String httpMethodRestrict;
     @UriParam(label = "consumer,advanced")
+    @Metadata(deprecationNote = "The shared Netty HTTP server was added for 
OSGi/Karaf, so that several applications"
+                                + " in one JVM could use the same port. Use a 
netty-http consumer per port, where several routes"
+                                + " can use the same port, or the 
platform-http component.")
+    @Deprecated
     private NettySharedHttpServer nettySharedHttpServer;
     @UriParam(label = "consumer,advanced", javaType = 
"org.apache.camel.component.netty.NettyServerBootstrapConfiguration")
     private NettyServerBootstrapConfiguration bootstrapConfiguration;
@@ -257,13 +261,22 @@ public class NettyHttpEndpoint extends NettyEndpoint 
implements HeaderFilterStra
         this.httpMethodRestrict = httpMethodRestrict;
     }
 
+    /**
+     * @deprecated the shared Netty HTTP server was added for OSGi/Karaf. Use 
one netty-http consumer per port, or the
+     *             platform-http component.
+     */
+    @Deprecated
     public NettySharedHttpServer getNettySharedHttpServer() {
         return nettySharedHttpServer;
     }
 
     /**
-     * To use a shared Netty HTTP server. See Netty HTTP Server Example for 
more details.
+     * To use a shared Netty HTTP server, so that several applications in one 
JVM can use the same port.
+     *
+     * @deprecated the shared Netty HTTP server was added for OSGi/Karaf. Use 
one netty-http consumer per port, or the
+     *             platform-http component.
      */
+    @Deprecated
     public void setNettySharedHttpServer(NettySharedHttpServer 
nettySharedHttpServer) {
         this.nettySharedHttpServer = nettySharedHttpServer;
     }
diff --git 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettySharedHttpServer.java
 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettySharedHttpServer.java
index c675b622e857..b4d40c070553 100644
--- 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettySharedHttpServer.java
+++ 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettySharedHttpServer.java
@@ -28,7 +28,12 @@ import 
org.apache.camel.component.netty.NettyServerBootstrapFactory;
  * To use this, just define a {@link NettyServerBootstrapConfiguration} 
configuration, and set this using
  * {@link 
#setNettyServerBootstrapConfiguration(NettySharedHttpServerBootstrapConfiguration)}.
 Then call the
  * {@link #start()} to initialize this shared server.
+ *
+ * @deprecated the shared Netty HTTP server was added for OSGi/Karaf, so that 
several applications in one JVM could use
+ *             the same port. Use a netty-http consumer per port, where 
several routes can use the same port, or the
+ *             platform-http component.
  */
+@Deprecated
 public interface NettySharedHttpServer extends Service {
 
     /**
diff --git 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettySharedHttpServerBootstrapConfiguration.java
 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettySharedHttpServerBootstrapConfiguration.java
index c7f8a1223310..ce3d8bbf4297 100644
--- 
a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettySharedHttpServerBootstrapConfiguration.java
+++ 
b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettySharedHttpServerBootstrapConfiguration.java
@@ -18,6 +18,14 @@ package org.apache.camel.component.netty.http;
 
 import org.apache.camel.component.netty.NettyServerBootstrapConfiguration;
 
+/**
+ * The bootstrap configuration of a {@link NettySharedHttpServer}.
+ *
+ * @deprecated the shared Netty HTTP server was added for OSGi/Karaf, so that 
several applications in one JVM could use
+ *             the same port. Use a netty-http consumer per port, where 
several routes can use the same port, or the
+ *             platform-http component.
+ */
+@Deprecated
 public class NettySharedHttpServerBootstrapConfiguration extends 
NettyServerBootstrapConfiguration {
 
     private int chunkedMaxContentLength = 1024 * 1024;
diff --git 
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc 
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
index d16d07edec42..aeff077087f8 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
@@ -6533,6 +6533,16 @@ checked at all. A consumer with `needClientAuth=true` 
and the option set now acc
 instead of rejecting all of them. Consumers that share a server through 
`nettySharedHttpServer` never applied the
 option, and are unchanged. The option still verifies the host on a 
`netty-http` producer.
 
+=== camel-netty-http - the shared HTTP server is deprecated
+
+The shared HTTP server of `camel-netty-http` is deprecated: the 
`nettySharedHttpServer` endpoint option, and the
+`NettySharedHttpServer`, `DefaultNettySharedHttpServer`, 
`NettySharedHttpServerBootstrapConfiguration` and
+`HttpServerSharedInitializerFactory` classes. It works as before, and will be 
removed in a future release.
+
+It was added for OSGi/Karaf, so that several applications (bundles) in one JVM 
could use the same port. Camel Main,
+Spring Boot and Quarkus applications run one application per JVM: use a 
`netty-http` consumer per port, where several
+routes can use the same port, or the `platform-http` component.
+
 === camel-alibaba-eventbridge - endpoint is marked as required instead of 
region
 
 The `endpoint` option of `alibaba-eventbridge` is now marked as required, and 
the `region` option no longer is. The
diff --git 
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/NettyHttpEndpointBuilderFactory.java
 
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/NettyHttpEndpointBuilderFactory.java
index 9ce99cf7b590..f59fc080d291 100644
--- 
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/NettyHttpEndpointBuilderFactory.java
+++ 
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/NettyHttpEndpointBuilderFactory.java
@@ -1393,8 +1393,12 @@ public interface NettyHttpEndpointBuilderFactory {
             return this;
         }
         /**
-         * To use a shared Netty HTTP server. See Netty HTTP Server Example for
-         * more details.
+         * To use a shared Netty HTTP server, so that several applications in
+         * one JVM can use the same port. Deprecation note: The shared Netty
+         * HTTP server was added for OSGi/Karaf, so that several applications 
in
+         * one JVM could use the same port. Use a netty-http consumer per port,
+         * where several routes can use the same port, or the platform-http
+         * component.
          * 
          * The option is a:
          * 
<code>org.apache.camel.component.netty.http.NettySharedHttpServer</code> type.
@@ -1404,13 +1408,18 @@ public interface NettyHttpEndpointBuilderFactory {
          * @param nettySharedHttpServer the value to set
          * @return the dsl builder
          */
+        @Deprecated
         default AdvancedNettyHttpEndpointConsumerBuilder 
nettySharedHttpServer(org.apache.camel.component.netty.http.NettySharedHttpServer
 nettySharedHttpServer) {
             doSetProperty("nettySharedHttpServer", nettySharedHttpServer);
             return this;
         }
         /**
-         * To use a shared Netty HTTP server. See Netty HTTP Server Example for
-         * more details.
+         * To use a shared Netty HTTP server, so that several applications in
+         * one JVM can use the same port. Deprecation note: The shared Netty
+         * HTTP server was added for OSGi/Karaf, so that several applications 
in
+         * one JVM could use the same port. Use a netty-http consumer per port,
+         * where several routes can use the same port, or the platform-http
+         * component.
          * 
          * The option will be converted to a
          * 
<code>org.apache.camel.component.netty.http.NettySharedHttpServer</code> type.
@@ -1420,6 +1429,7 @@ public interface NettyHttpEndpointBuilderFactory {
          * @param nettySharedHttpServer the value to set
          * @return the dsl builder
          */
+        @Deprecated
         default AdvancedNettyHttpEndpointConsumerBuilder 
nettySharedHttpServer(String nettySharedHttpServer) {
             doSetProperty("nettySharedHttpServer", nettySharedHttpServer);
             return this;

Reply via email to