Added Message bus docs to Gitbook
Project: http://git-wip-us.apache.org/repos/asf/camel/repo Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/5be0992c Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/5be0992c Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/5be0992c Branch: refs/heads/master Commit: 5be0992cde0bb2aca6a67aff1791b016ab5eeee8 Parents: 808248e Author: Andrea Cosentino <anco...@gmail.com> Authored: Wed Oct 26 13:36:34 2016 +0200 Committer: Andrea Cosentino <anco...@gmail.com> Committed: Wed Oct 26 13:36:34 2016 +0200 ---------------------------------------------------------------------- camel-core/src/main/docs/message-bus.adoc | 64 ++++++++++++++++++++++++++ docs/user-manual/en/SUMMARY.md | 1 + 2 files changed, 65 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/camel/blob/5be0992c/camel-core/src/main/docs/message-bus.adoc ---------------------------------------------------------------------- diff --git a/camel-core/src/main/docs/message-bus.adoc b/camel-core/src/main/docs/message-bus.adoc new file mode 100644 index 0000000..8ad4ea8 --- /dev/null +++ b/camel-core/src/main/docs/message-bus.adoc @@ -0,0 +1,64 @@ +[[MessageBus-MessageBus]] +Message Bus +^^^^^^^^^^^ + +Camel supports the +http://www.enterpriseintegrationpatterns.com/PointToPointChannel.html[Message +Bus] from the link:enterprise-integration-patterns.html[EIP patterns]. +You could view Camel as a Message Bus itself as it allows producers and +consumers to be decoupled. + +image:http://www.enterpriseintegrationpatterns.com/img/MessageBusSolution.gif[image] + +Folks often assume that a Message Bus is a JMS though so you may wish to +refer to the link:jms.html[JMS] component for traditional MOM support. + + Also worthy of note is the link:xmpp.html[XMPP] component for +supporting messaging over XMPP (Jabber) + +Of course there are also ESB products such as +http://servicemix.apache.org/home.html[Apache ServiceMix] which serve as +full fledged message busses. + + You can interact with http://servicemix.apache.org/home.html[Apache +ServiceMix] from Camel in many ways, but in particular you can use the +link:nmr.html[NMR] or link:jbi.html[JBI] component to access the +ServiceMix message bus directly. + + + +[[MessageBus-Example]] +Example ++++++++ + +The following demonstrates how the Camel message bus can be used to +communicate with consumers and producers + +*Using the link:fluent-builders.html[Fluent Builders]* + +[source,java] +----------------------------------------------- +from("direct:start") + .pollEnrich("file:inbox?fileName=data.txt") + .to("jms:queue:foo"); +----------------------------------------------- + +**Using the link:spring-xml-extensions.html[Spring XML Extensions]** + +[source,xml] +---------------------------------------------------- +<route> + <from uri="direct:start"/> + <pollEnrich uri="file:inbox?fileName=data.txt"/> + <to uri="jms:queue:foo"/> +</route> +---------------------------------------------------- + +[[MessageBus-UsingThisPattern]] +Using This Pattern +++++++++++++++++++ + +If you would like to use this EIP Pattern then please read the +link:getting-started.html[Getting Started], you may also find the +link:architecture.html[Architecture] useful particularly the description +of link:endpoint.html[Endpoint] and link:uris.html[URIs]. Then you could +try out some of the link:examples.html[Examples] first before trying +this pattern out. http://git-wip-us.apache.org/repos/asf/camel/blob/5be0992c/docs/user-manual/en/SUMMARY.md ---------------------------------------------------------------------- diff --git a/docs/user-manual/en/SUMMARY.md b/docs/user-manual/en/SUMMARY.md index 126dc0e..2233ac5 100644 --- a/docs/user-manual/en/SUMMARY.md +++ b/docs/user-manual/en/SUMMARY.md @@ -86,6 +86,7 @@ * [Publish Subscribe Channel](publish-subscribe-channel.adoc) * [Dead Letter Channel](dead-letter-channel.adoc) * [Guaranteed Delivery](guaranteed-delivery.adoc) + * [Message Bus](message-bus.adoc) * Message Construction * [Correlation Identifier](correlation-identifier.adoc) * [Event Message](event-message.adoc)
