Modified: websites/production/camel/content/book-in-one-page.html ============================================================================== --- websites/production/camel/content/book-in-one-page.html (original) +++ websites/production/camel/content/book-in-one-page.html Wed Aug 24 16:20:01 2016 @@ -3619,11 +3619,11 @@ The tutorial has been designed in two pa While not actual tutorials you might find working through the source of the various <a shape="rect" href="examples.html">Examples</a> useful.</li></ul> <h2 id="BookInOnePage-TutorialonSpringRemotingwithJMS">Tutorial on Spring Remoting with JMS</h2><p> </p><div class="confluence-information-macro confluence-information-macro-information"><p class="title">Thanks</p><span class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>This tutorial was kindly donated to Apache Camel by Martin Gilday.</p></div></div><h2 id="BookInOnePage-Preface">Preface</h2><p>This tutorial aims to guide the reader through the stages of creating a project which uses Camel to facilitate the routing of messages from a JMS queue to a <a shape="rect" class="external-link" href="http://www.springramework.org"; rel="nofollow">Spring</a> service. The route works in a synchronous fashion returning a response to the client.</p><p><style type="text/css">/*<![CDATA[*/ -div.rbtoc1471911469962 {padding: 0px;} -div.rbtoc1471911469962 ul {list-style: disc;margin-left: 0px;} -div.rbtoc1471911469962 li {margin-left: 0px;padding-left: 0px;} +div.rbtoc1472055492903 {padding: 0px;} +div.rbtoc1472055492903 ul {list-style: disc;margin-left: 0px;} +div.rbtoc1472055492903 li {margin-left: 0px;padding-left: 0px;} -/*]]>*/</style></p><div class="toc-macro rbtoc1471911469962"> +/*]]>*/</style></p><div class="toc-macro rbtoc1472055492903"> <ul class="toc-indentation"><li><a shape="rect" href="#BookInOnePage-TutorialonSpringRemotingwithJMS">Tutorial on Spring Remoting with JMS</a></li><li><a shape="rect" href="#BookInOnePage-Preface">Preface</a></li><li><a shape="rect" href="#BookInOnePage-Prerequisites">Prerequisites</a></li><li><a shape="rect" href="#BookInOnePage-Distribution">Distribution</a></li><li><a shape="rect" href="#BookInOnePage-About">About</a></li><li><a shape="rect" href="#BookInOnePage-CreatetheCamelProject">Create the Camel Project</a> <ul class="toc-indentation"><li><a shape="rect" href="#BookInOnePage-UpdatethePOMwithDependencies">Update the POM with Dependencies</a></li></ul> </li><li><a shape="rect" href="#BookInOnePage-WritingtheServer">Writing the Server</a> @@ -5738,11 +5738,11 @@ So we completed the last piece in the pi <p>This example has been removed from <strong>Camel 2.9</strong> onwards. Apache Axis 1.4 is a very old and unsupported framework. We encourage users to use <a shape="rect" href="cxf.html">CXF</a> instead of Axis.</p></div></div> <style type="text/css">/*<![CDATA[*/ -div.rbtoc1471911470227 {padding: 0px;} -div.rbtoc1471911470227 ul {list-style: disc;margin-left: 0px;} -div.rbtoc1471911470227 li {margin-left: 0px;padding-left: 0px;} +div.rbtoc1472055493263 {padding: 0px;} +div.rbtoc1472055493263 ul {list-style: disc;margin-left: 0px;} +div.rbtoc1472055493263 li {margin-left: 0px;padding-left: 0px;} -/*]]>*/</style><div class="toc-macro rbtoc1471911470227"> +/*]]>*/</style><div class="toc-macro rbtoc1472055493263"> <ul class="toc-indentation"><li><a shape="rect" href="#BookInOnePage-TutorialusingAxis1.4withApacheCamel">Tutorial using Axis 1.4 with Apache Camel</a> <ul class="toc-indentation"><li><a shape="rect" href="#BookInOnePage-Prerequisites">Prerequisites</a></li><li><a shape="rect" href="#BookInOnePage-Distribution">Distribution</a></li><li><a shape="rect" href="#BookInOnePage-Introduction">Introduction</a></li><li><a shape="rect" href="#BookInOnePage-SettinguptheprojecttorunAxis">Setting up the project to run Axis</a> <ul class="toc-indentation"><li><a shape="rect" href="#BookInOnePage-Maven2">Maven 2</a></li><li><a shape="rect" href="#BookInOnePage-wsdl">wsdl</a></li><li><a shape="rect" href="#BookInOnePage-ConfiguringAxis">Configuring Axis</a></li><li><a shape="rect" href="#BookInOnePage-RunningtheExample">Running the Example</a></li></ul> @@ -16335,7 +16335,7 @@ droppable = false} </dependency> ]]></script> </div></div><p></p><h3 id="BookInOnePage-SeeAlso.20">See Also</h3> -<ul><li><a shape="rect" href="configuring-camel.html">Configuring Camel</a></li><li><a shape="rect" href="component.html">Component</a></li><li><a shape="rect" href="endpoint.html">Endpoint</a></li><li><a shape="rect" href="getting-started.html">Getting Started</a></li></ul> <div class="error"><span class="error">Unable to render {include}</span> The included page could not be found.</div> <h2 id="BookInOnePage-AMQP">AMQP</h2><p>The <strong style="line-height: 1.42857;">amqp:</strong> component supports the <a shape="rect" class="external-link" href="http://www.amqp.org/"; style="line-height: 1.42857;" rel="nofollow">AMQP 1.0 protocol</a> using the JMS Client API of the <a shape="rect" class="external-link" href="https://github.com/apache/qpid-jms/"; rel="nofollow">Qpid</a> project. In case you want to use AMQP 0.9 (in particular RabbitMQ) you might also be interested in the <a shape="rect" href="rabbitmq.html">Camel RabbitMQ</a> component. Please keep in mind that prior to the Camel 2.17.0 AMQP component supported AMQP 0.9 and above, however since Camel 2.17.0 it supports only AMQP 1.0.</p><p>Maven users will need to add the following dependency to their <code>pom.xml</code> for this component:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<ul><li><a shape="rect" href="configuring-camel.html">Configuring Camel</a></li><li><a shape="rect" href="component.html">Component</a></li><li><a shape="rect" href="endpoint.html">Endpoint</a></li><li><a shape="rect" href="getting-started.html">Getting Started</a></li></ul> <div class="error"><span class="error">Unable to render {include}</span> The included page could not be found.</div> <h2 id="BookInOnePage-AMQP">AMQP</h2><p>The <strong style="line-height: 1.42857;">amqp:</strong> component supports the <a shape="rect" class="external-link" href="http://www.amqp.org/"; style="line-height: 1.42857;" rel="nofollow">AMQP 1.0 protocol</a> using the JMS Client API of the <a shape="rect" class="external-link" href="https://github.com/apache/qpid-jms/"; rel="nofollow">Qpid</a> project. In case you want to use <strong>AMQP 0.9</strong> (in particular RabbitMQ) you might also be interested in the <a shape="rect" href="rabbitmq.html">Camel RabbitMQ</a> component. Please keep in mind that pr ior to the <strong>Camel 2.17.0</strong> AMQP component supported <strong>AMQP 0.9</strong> and above, however since <strong>Camel 2.17.0</strong> it supports only <strong>AMQP 1.0</strong>.</p><p>Maven users will need to add the following dependency to their <strong><code>pom.xml</code></strong> for this component:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="brush: xml; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[<dependency> <groupId>org.apache.camel</groupId> <artifactId>camel-amqp</artifactId> @@ -16345,21 +16345,21 @@ droppable = false} </div></div><h3 id="BookInOnePage-URIformat.2">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[amqp:[queue:|topic:]destinationName[?options] ]]></script> -</div></div><h3 id="BookInOnePage-AMQPOptions">AMQP Options</h3><p>You can specify all of the various configuration options of the <a shape="rect" href="jms.html">JMS</a> component after the destination name.</p><h3 id="BookInOnePage-Usage.1">Usage</h3><p>As AMQP component is inherited from JMS component, the usage of the former is almost identical to the latter:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Using AMQP component</b></div><div class="codeContent panelContent pdl"> +</div></div><h3 id="BookInOnePage-AMQPOptions">AMQP Options</h3><p>You can specify all of the various configuration options of the <a shape="rect" href="jms.html">JMS</a> component after the destination name.</p><h3 id="BookInOnePage-Usage.1">Usage</h3><p>As AMQP component inherits from the JMS component. The usage of the former is almost identical to the latter:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Using AMQP component</b></div><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[// Consuming from AMQP queue -from("amqp:queue:incoming"). - to(...); +from("amqp:queue:incoming") + .to(...); Â // Sending message to the AMQP topic -from(...). - to("amqp:topic:notify");]]></script> -</div></div><h3 id="BookInOnePage-ConfiguringAMQPcomponent"><span style="line-height: 1.5;">Configuring AMQP component</span></h3><p>Starting from the Camel 2.16.1 you can also use the <code>AMQPComponent#amqp10Component(String connectionURI)</code> factory method to return the AMQP 1.0 component with the pre-configured topic prefix: </p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Creating AMQP 1.0 component</b></div><div class="codeContent panelContent pdl"> +from(...) + .to("amqp:topic:notify");]]></script> +</div></div><h3 id="BookInOnePage-ConfiguringAMQPcomponent"><span style="line-height: 1.5;">Configuring AMQP component</span></h3><p>Starting from the <strong>Camel 2.16.1</strong> you can also use the <strong><code>AMQPComponent#amqp10Component(String connectionURI)</code></strong> factory method to return the <strong>AMQP 1.0</strong> component with the pre-configured topic prefix: </p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Creating AMQP 1.0 component</b></div><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[ AMQPComponent amqp = AMQPComponent.amqp10Component("amqp://guest:guest@localhost:5672");]]></script> -</div></div><p>Keep in mind that starting from the Camel 2.17 the <code>AMQPComponent#amqp10Component(String connectionURI)</code> factory method has been deprecated on the behalf of the <code><span>AMQPComponent#amqpComponent(String connectionURI)</span></code>: </p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Creating AMQP 1.0 component</b></div><div class="codeContent panelContent pdl"> +</div></div><p>Keep in mind that starting from the <strong>Camel 2.17</strong> the <strong><code>AMQPComponent#amqp10Component(String connectionURI)</code></strong> factory method has been deprecated on the behalf of the <strong><code>AMQPComponent#amqpComponent(String connectionURI)</code></strong>: </p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Creating AMQP 1.0 component</b></div><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[AMQPComponent amqp = AMQPComponent.amqpComponent("amqp://localhost:5672"); Â AMQPComponent authorizedAmqp = AMQPComponent.amqpComponent("amqp://localhost:5672", "user", "password");]]></script> -</div></div><p>Starting from Camel 2.17, in order to automatically configure the AMQP component, you can also add an instance of <code>org.apache.camel.component.amqp.AMQPConnectionDetails</code> to the registry. For example for Spring Boot you just have to define bean:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>AMQP connection details auto-configuration</b></div><div class="codeContent panelContent pdl"> +</div></div><p>Starting from <strong>Camel 2.17</strong>, in order to automatically configure the AMQP component, you can also add an instance of <strong><code>org.apache.camel.component.amqp.AMQPConnectionDetails</code></strong> to the registry. For example for Spring Boot you just have to define bean:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>AMQP connection details auto-configuration</b></div><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[@Bean AMQPConnectionDetails amqpConnection() { return new AMQPConnectionDetails("amqp://lcoalhost:5672"); @@ -16369,7 +16369,7 @@ AMQPConnectionDetails amqpConnection() { AMQPConnectionDetails securedAmqpConnection() { return new AMQPConnectionDetails("amqp://lcoalhost:5672", "username", "password"); }]]></script> -</div></div><p> </p><p>You can also rely on the <a shape="rect" href="properties.html">Camel properties</a> to read the AMQP connection details. Factory method <code>AMQPConnectionDetails.discoverAMQP()</code> attempts to read Camel properties in a Kubernetes-like convention, just as demonstrated on the snippet below:</p><p> </p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>AMQP connection details auto-configuration</b></div><div class="codeContent panelContent pdl"> +</div></div><p> </p><p>You can also rely on the <a shape="rect" href="properties.html">Camel properties</a> to read the AMQP connection details. The factory method <strong><code>AMQPConnectionDetails.discoverAMQP()</code></strong> attempts to read Camel properties in a Kubernetes-like convention, just as demonstrated on the snippet below:</p><p> </p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>AMQP connection details auto-configuration</b></div><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[export AMQP_SERVICE_HOST = "mybroker.com" export AMQP_SERVICE_PORT = "6666" export AMQP_SERVICE_USERNAME = "username" @@ -16382,39 +16382,41 @@ AMQPConnectionDetails amqpConnection() { return AMQPConnectionDetails.discoverAMQP(); } ]]></script> -</div></div><h3 id="BookInOnePage-ConfiguringConnectionFactory">Configuring Connection Factory</h3><p>Like with any other JMS-based component, usually it's important to configure JMS connection factory. For example, you'd like to set your broker url or set proper connection credentials. Additionally, you would always want to set some kind of pooling (or caching) on the connection factory. An example of how to do both of these tasks is shown below.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> -<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[ <bean id="jmsConnectionFactory" class="org.apache.qpid.jms.JmsConnectionFactory"> - <property name="remoteURI" value="amqp://localhost:5672" /> - <property name="username" value="admin"/> - <property name="password" value="admin"/> - </bean> +</div></div><h3 id="BookInOnePage-ConfiguringConnectionFactory">Configuring Connection Factory</h3><p>Like with any other JMS-based component, usually it's important to configure JMS connection factory. For example, you'd like to set your broker URL or set proper connection credentials. Additionally, you would always want to set some kind of pooling (or caching) on the connection factory. An example of how to do both of these tasks is shown below.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="brush: xml; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[<bean id="jmsConnectionFactory" class="org.apache.qpid.jms.JmsConnectionFactory"> + <property name="remoteURI" value="amqp://localhost:5672" /> + <property name="username" value="admin"/> + <property name="password" value="admin"/> +</bean> - <bean id="jmsCachingConnectionFactory" class="org.springframework.jms.connection.CachingConnectionFactory"> - <property name="targetConnectionFactory" ref="jmsConnectionFactory" /> - </bean> +<bean id="jmsCachingConnectionFactory" class="org.springframework.jms.connection.CachingConnectionFactory"> + <property name="targetConnectionFactory" ref="jmsConnectionFactory" /> +</bean> - <bean id="jmsConfig" class="org.apache.camel.component.jms.JmsConfiguration" > - <property name="connectionFactory" ref="jmsCachingConnectionFactory" /> - <property name="cacheLevelName" value="CACHE_CONSUMER" /> - </bean> - - <bean id="amqp" class="org.apache.camel.component.amqp.AMQPComponent"> - <property name="configuration" ref="jmsConfig" /> - </bean> +<bean id="jmsConfig" class="org.apache.camel.component.jms.JmsConfiguration" > + <property name="connectionFactory" ref="jmsCachingConnectionFactory" /> + <property name="cacheLevelName" value="CACHE_CONSUMER" /> +</bean> + +<bean id="amqp" class="org.apache.camel.component.amqp.AMQPComponent"> + <property name="configuration" ref="jmsConfig" /> +</bean> - <camelContext xmlns="http://camel.apache.org/schema/blueprint" id="simple"> - <route> - <from uri="timer:simple?period=5000"/> - <setBody> - <simple>Hello World</simple> - </setBody> - <to uri="amqp:test"/> - </route> - </camelContext>]]></script> -</div></div><h3 id="BookInOnePage-UsinginsideKaraf">Using inside Karaf</h3><p>If you want to use <strong>amqp</strong> component inside the Karaf, there's already defined feature that will install all necessary bundles for you. All you need to do is</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> -<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[karaf@root()> repo-add camel +<camelContext xmlns="http://camel.apache.org/schema/blueprint" id="simple"> + <route> + <from uri="timer:simple?period=5000"/> + <setBody> + <simple>Hello World</simple> + </setBody> + <to uri="amqp:test"/> + </route> +</camelContext> + +]]></script> +</div></div><h3 id="BookInOnePage-UsingamqpinsideKaraf">Using amqp inside Karaf</h3><p>To use the <strong><code>amqp</code></strong> component inside Karaf use the predefined feature called <strong><code>camel-amqp</code></strong> to install the necessary bundles.</p><p>Example:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="brush: text; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[karaf@root()> repo-add camel karaf@root()> feature:install camel-amqp]]></script> -</div></div><p>and the environment would be set. Additionally you can add <strong>camel-blueprint</strong> or <strong>camel-spring</strong> features if you want to define your routes in those contexts.</p><p> </p><p></p><h3 id="BookInOnePage-SeeAlso.21">See Also</h3> +</div></div><p>and the environment would be set.</p><p>Use the <strong><code>camel-blueprint</code></strong> or <strong><code>camel-spring</code></strong> features to define routes in those contexts.</p><p> </p><p></p><h3 id="BookInOnePage-SeeAlso.21">See Also</h3> <ul><li><a shape="rect" href="configuring-camel.html">Configuring Camel</a></li><li><a shape="rect" href="component.html">Component</a></li><li><a shape="rect" href="endpoint.html">Endpoint</a></li><li><a shape="rect" href="getting-started.html">Getting Started</a></li></ul><p> </p> <h2 id="BookInOnePage-SQSComponent">SQS Component</h2><p><strong>Available as of Camel 2.6</strong></p><p>The sqs component supports sending and receiving messages to <a shape="rect" class="external-link" href="http://aws.amazon.com/sqs"; rel="nofollow">Amazon's SQS</a> service.</p><div class="confluence-information-macro confluence-information-macro-information"><p class="title">Prerequisites</p><span class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>You must have a valid Amazon Web Services developer account, and be signed up to use Amazon SQS. More information are available at <a shape="rect" class="external -link" href="http://aws.amazon.com/sqs"; rel="nofollow">Amazon SQS</a>.</p></div></div><h3 id="BookInOnePage-URIFormat">URI Format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[aws-sqs://queueName[?options] aws-sqs://queueNameOrArn[?options] (Camel 2.18 onwards) @@ -17167,11 +17169,11 @@ template.send("direct:alias-verify& ]]></script> </div></div><p></p><h3 id="BookInOnePage-SeeAlso.28">See Also</h3> <ul><li><a shape="rect" href="configuring-camel.html">Configuring Camel</a></li><li><a shape="rect" href="component.html">Component</a></li><li><a shape="rect" href="endpoint.html">Endpoint</a></li><li><a shape="rect" href="getting-started.html">Getting Started</a></li></ul><ul><li><a shape="rect" href="crypto.html">Crypto</a> Crypto is also available as a <a shape="rect" href="data-format.html">Data Format</a></li></ul> <h2 id="BookInOnePage-CXFComponent">CXF Component</h2><div class="confluence-information-macro confluence-information-macro-note"><span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>When using CXF as a consumer, the <a shape="rect" href="cxf-bean-component.html">CXF Bean Component</a> allows you to factor out how message payloads are received from their processing as a RESTful or SOAP web service. This has the potential of using a multitude of transports to consume web services. The bean component's configuration is also simpler and provides the fastest method to implement web services using Camel and CXF.</p></div></div><div class="confluence-information-macro confluence-information-macro-tip"><span class="aui-icon aui-icon-small aui-iconfont-approve confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>When using CXF in streaming modes (see DataFormat option), then also read about <a shape="rect" href="stream-caching.html">Stream caching</a>.</p></div></div><p>The <strong>cxf:</strong> component provides integration with <a shape="rect" href="http://cxf.apache.org";>Apache CXF</a> for connecting to JAX-WS services hosted in CXF.</p><p><style type="text/css">/*<![CDATA[*/ -div.rbtoc1471911472601 {padding: 0px;} -div.rbtoc1471911472601 ul {list-style: disc;margin-left: 0px;} -div.rbtoc1471911472601 li {margin-left: 0px;padding-left: 0px;} +div.rbtoc1472055525790 {padding: 0px;} +div.rbtoc1472055525790 ul {list-style: disc;margin-left: 0px;} +div.rbtoc1472055525790 li {margin-left: 0px;padding-left: 0px;} -/*]]>*/</style></p><div class="toc-macro rbtoc1471911472601"> +/*]]>*/</style></p><div class="toc-macro rbtoc1472055525790"> <ul class="toc-indentation"><li><a shape="rect" href="#BookInOnePage-CXFComponent">CXF Component</a> <ul class="toc-indentation"><li><a shape="rect" href="#BookInOnePage-URIformat">URI format</a></li><li><a shape="rect" href="#BookInOnePage-Options">Options</a> <ul class="toc-indentation"><li><a shape="rect" href="#BookInOnePage-Thedescriptionsofthedataformats">The descriptions of the dataformats</a>
Modified: websites/production/camel/content/cache/main.pageCache ============================================================================== Binary files - no diff available.
