CAMEL-10843 - very initial, checking it in considering better than nothing
Project: http://git-wip-us.apache.org/repos/asf/camel/repo Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/7042d7ae Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/7042d7ae Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/7042d7ae Branch: refs/heads/master Commit: 7042d7ae8a77e0fcd19405f4e99c125e58a5f1a3 Parents: 94fa14a Author: onders86 <ondersezgin+git...@gmail.com> Authored: Wed Apr 12 22:21:59 2017 +0300 Committer: Andrea Cosentino <anco...@gmail.com> Committed: Thu Apr 13 08:39:29 2017 +0200 ---------------------------------------------------------------------- .../src/main/docs/ribbon-component.adoc | 47 ++++++++++++++++++++ 1 file changed, 47 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/camel/blob/7042d7ae/components/camel-ribbon/src/main/docs/ribbon-component.adoc ---------------------------------------------------------------------- diff --git a/components/camel-ribbon/src/main/docs/ribbon-component.adoc b/components/camel-ribbon/src/main/docs/ribbon-component.adoc new file mode 100644 index 0000000..9a189f4 --- /dev/null +++ b/components/camel-ribbon/src/main/docs/ribbon-component.adoc @@ -0,0 +1,47 @@ +## Ribbon Component + +*Available as of Camel version 2.18* + +The ribbon component provides use of Netflix Ribbon for client side load balancing. + +Maven users will need to add the following dependency to their `pom.xml` +for this component: + +[source,xml] +------------------------------------------------------------ +<dependency> + <groupId>org.apache.camel</groupId> + <artifactId>camel-ribbon</artifactId> + <version>x.x.x</version> + <!-- use the same version as your Camel core version --> +</dependency> +------------------------------------------------------------ + +This component helps applying load balancing feature at the client side +when using ServiceCall EIP. + +As you can see [ServiceCall EIP](http://camel.apache.org/servicecall-eip.html), ribbon +makes use of http component for calling the remote service. The details of different protocols +are outlined in the EIP page. + +[source,java] +--------------------------------------- +StaticServiceDiscovery servers = new StaticServiceDiscovery(); +servers.addServer("localhost", 9090); +servers.addServer("localhost", 9091); + +RibbonConfiguration configuration = new RibbonConfiguration(); +RibbonLoadBalancer loadBalancer = new RibbonLoadBalancer(configuration); + +from("direct:start") + .serviceCall() + .name("myService") + .loadBalancer(loadBalancer) + .serviceDiscovery(servers) + .end() + .to("mock:result"); +--------------------------------------- + +### See Also + +* link:http://camel.apache.org/servicecall-eip.html[ServiceCall EIP] \ No newline at end of file
