blob: 9460ff6c528f6c867d6b3822906155f21af9e487 [file] [log] [blame]
== Camel Netty HTTP Server Example
=== Introduction
This example shows how to use a shared Netty HTTP Server in an OSGi
environment.
There is 4 modules in this example:
* `+shared-netty-http-server+` - The Shared Netty HTTP server that the
other Camel applications uses
* `+myapp-one+` - A Camel application that reuses the shared Netty HTTP
server
* `+myapp-two+` - A Camel application that reuses the shared Netty HTTP
server
=== Build
You will need to compile this example first:
[source,sh]
----
$ mvn install
----
=== Run
This example runs in Apache Karaf / ServiceMix. To install Apache Camel
in Karaf you type in the shell:
[source,sh]
----
karaf@root()> repo-add camel ${version}
karaf@root()> feature:install camel
----
Then you need to install the following features in Karaf/ServiceMix:
[source,sh]
----
karaf@root()> feature:install camel-netty-http
----
Then you can install the shared Netty HTTP server which by default runs
on port `+8888+`. The port number can be changed by editing the
following source file:
`+shared-netty-http-server/src/main/resources/OSGI-INF/blueprint/http-server.xml+`
In the Apache Karaf / ServiceMix shell type:
[source,sh]
----
karaf@root()> install -s mvn:org.apache.camel.example/camel-example-netty-http-shared/${version}
----
Then you can install the Camel applications:
[source,sh]
----
karaf@root()> install -s mvn:org.apache.camel.example/camel-example-netty-myapp-one/${version}
karaf@root()> install -s mvn:org.apache.camel.example/camel-example-netty-myapp-two/${version}
----
From a web browser you can then try the example by accessing the
following URLs:
http://localhost:8888/one
http://localhost:8888/two
Camel commands can be used to gain some insights on the CDI Camel
context, e.g.:
* The `+camel:context-list+` displays the CDI Camel contexts:
+
....
karaf@root()> camel:context-list
Context Status Total # Failed # Inflight # Uptime
------- ------ ------- -------- ---------- ------
camel-1 Started 1 0 0 1 minute
camel-2 Started 1 0 0 1 minute
....
Or by tailing the log with:
[source,sh]
----
karaf@root()> log:tail
----
The following messages should be displayed:
....
2017-05-10 21:36:55,582 | INFO | nt Dispatcher: 1 | BlueprintCamelContext | 52 - org.apache.camel.camel-blueprint - 2.17.0 | Attempting to start Camel Context camel-2
2017-05-10 21:36:55,582 | INFO | nt Dispatcher: 1 | BlueprintCamelContext | 52 - org.apache.camel.camel-blueprint - 2.17.0 | Apache Camel 2.17.0 (CamelContext: camel-2) is starting
2017-05-10 21:36:55,583 | INFO | nt Dispatcher: 1 | ManagedManagementStrategy | 54 - org.apache.camel.camel-core - 2.17.0 | JMX is enabled
2017-05-10 21:36:55,624 | INFO | nt Dispatcher: 1 | DefaultRuntimeEndpointRegistry | 54 - org.apache.camel.camel-core - 2.17.0 | Runtime endpoint registry is in extended mode gathering usage statistics of all incoming and outgoing endpoints (cache limit: 1000)
2017-05-10 21:36:55,638 | INFO | nt Dispatcher: 1 | BlueprintCamelContext | 52 - org.apache.camel.camel-blueprint - 2.17.0 | StreamCaching is not in use. If using streams then its recommended to enable stream caching. See more details at http://camel.apache.org/stream-caching.html
2017-05-10 21:36:55,639 | INFO | nt Dispatcher: 1 | NettyHttpEndpoint | 60 - org.apache.camel.camel-netty-http - 2.17.0 | NettyHttpConsumer: Consumer[http://localhost/two] is using NettySharedHttpServer on port: 8888
2017-05-10 21:36:55,646 | INFO | nt Dispatcher: 1 | NettyConsumer | 59 - org.apache.camel.camel-netty - 2.17.0 | Netty consumer bound to: localhost:8888
2017-05-10 21:36:55,646 | INFO | nt Dispatcher: 1 | BlueprintCamelContext | 52 - org.apache.camel.camel-blueprint - 2.17.0 | Route: http-route-two started and consuming from: http://localhost/two
2017-05-10 21:36:55,647 | INFO | nt Dispatcher: 1 | BlueprintCamelContext | 52 - org.apache.camel.camel-blueprint - 2.17.0 | Total 1 routes, of which 1 are started.
2017-05-10 21:36:55,647 | INFO | nt Dispatcher: 1 | BlueprintCamelContext | 52 - org.apache.camel.camel-blueprint - 2.17.0 | Apache Camel 2.17.0 (CamelContext: camel-2) started in 0.065 seconds
....
Hit ctrl+c to exit the log command.
=== Help and contributions
If you hit any problem using Camel or have some feedback, then please
https://camel.apache.org/support.html[let us know].
We also love contributors, so
https://camel.apache.org/contributing.html[get involved] :-)
The Camel riders!