Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id BA703200CE0 for ; Fri, 25 Aug 2017 10:22:13 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id B8FC016BD4F; Fri, 25 Aug 2017 08:22:13 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 0E03316B8F3 for ; Fri, 25 Aug 2017 10:22:11 +0200 (CEST) Received: (qmail 14219 invoked by uid 500); 25 Aug 2017 08:22:10 -0000 Mailing-List: contact commits-help@camel.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@camel.apache.org Delivered-To: mailing list commits@camel.apache.org Received: (qmail 14210 invoked by uid 99); 25 Aug 2017 08:22:10 -0000 Received: from Unknown (HELO svn01-us-west.apache.org) (209.188.14.144) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 25 Aug 2017 08:22:10 +0000 Received: from svn01-us-west.apache.org (localhost [127.0.0.1]) by svn01-us-west.apache.org (ASF Mail Server at svn01-us-west.apache.org) with ESMTP id 8B1E43A03A1 for ; Fri, 25 Aug 2017 08:22:07 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r1017260 [4/40] - in /websites/production/camel/content: ./ cache/ Date: Fri, 25 Aug 2017 08:22:03 -0000 To: commits@camel.apache.org From: buildbot@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20170825082207.8B1E43A03A1@svn01-us-west.apache.org> archived-at: Fri, 25 Aug 2017 08:22:13 -0000 Modified: websites/production/camel/content/beanshell.html ============================================================================== --- websites/production/camel/content/beanshell.html (original) +++ websites/production/camel/content/beanshell.html Fri Aug 25 08:22:01 2017 @@ -41,7 +41,6 @@ - -

Using Properties Function

Available from Camel 2.9

If you need to use the Properties component from a script to lookup property placeholders, then its a bit cumbersome to do so. For example, to set a header name myHeader with a value from a property placeholder, whose key is taken from a header named foo.

- -

From Camel 2.9: you can now use the properties function and the same example is simpler:

- -

Loading Script From External Resource

Available from Camel 2.11

You can externalize the script and have Camel load it from a resource such as classpath:, file:, or http:. This is done using the following syntax: resource:scheme:location e.g. to refer to a file on the classpath you can do:

- -

How to Get the Result from Multiple Statements Script

Available from Camel 2.14

The script engine's eval method returns a null when it runs a multi-statement script. However, Camel can look up the value of a script's result by using the key result from the value set. When writing a multi-statement script set the value of the result variable as the script return value.

- -

 

Dependencies

To use scripting languages in your camel routes you need to add the a dependency on camel-script which integrates the JSR-223 scripting engine.

If you use maven you could just add the following to your pom.xml, substituting the version number for the latest & greatest release (see the download page for the latest versions).

- -
+
Modified: websites/production/camel/content/blueprint-testing.html ============================================================================== --- websites/production/camel/content/blueprint-testing.html (original) +++ websites/production/camel/content/blueprint-testing.html Fri Aug 25 08:22:01 2017 @@ -36,17 +36,6 @@ - - - - - - - - Apache Camel: Blueprint Testing @@ -86,141 +75,48 @@ <tbody> <tr> <td valign="top" width="100%"> -<div class="wiki-content maincontent"><h2 id="BlueprintTesting-BlueprintTesting">Blueprint Testing</h2><p><strong>Available as of Camel 2.10</strong></p><div class="confluence-information-macro confluence-information-macro-information"><span class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p><strong>camel-test-blueprint</strong> does only support testing <em>one</em> CamelContext. So if you have two or more CamelContexts in your blueprint XML files, then only the CamelContext first found is used during testing.</p></div></div><p><a shape="rect" href="testing.html">Testing</a><span style="line-height: 1.4285715;"> is a crucial part of any development or integration work. Camel supports the definition of </span><a shape="rect" href="using-osgi-blueprint-with-camel.html">Blueprint routes</a><span style="line-height: 1.4285715;">, but given that Blueprint is an OSGi specific technology, writing uni t tests is quite difficult. This library leverages </span><a shape="rect" class="external-link" href="http://code.google.com/p/pojosr/" rel="nofollow" style="line-height: 1.4285715;">PojoSR</a><span style="line-height: 1.4285715;"> (now Felix Connect) which provides a service registry without using a fully compliant OSGi container. This allows defining real unit tests (as opposed to integration tests using </span><a shape="rect" class="external-link" href="http://team.ops4j.org/wiki/display/paxexam/Pax+Exam" rel="nofollow" style="line-height: 1.4285715;">Pax Exam</a><span style="line-height: 1.4285715;">. Please make sure all test jars in your classpath are OSGi bundles.</span></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[ -// tag::example[] -// to use camel-test-blueprint, then extend the CamelBlueprintTestSupport class, -// and add your unit tests methods as shown below. -public class DebugBlueprintTest extends CamelBlueprintTestSupport { - - private boolean debugBeforeMethodCalled; - private boolean debugAfterMethodCalled; - - // override this method, and return the location of our Blueprint XML file to be used for testing - @Override - protected String getBlueprintDescriptor() { - return "org/apache/camel/test/blueprint/camelContext.xml"; - } - - // here we have regular JUnit @Test method - @Test - public void testRoute() throws Exception { - - // set mock expectations - getMockEndpoint("mock:a").expectedMessageCount(1); - - // send a message - template.sendBody("direct:start", "World"); - - // assert mocks - assertMockEndpointsSatisfied(); - - // assert on the debugBefore/debugAfter methods below being called as we've enabled the debugger - assertTrue(debugBeforeMethodCalled); - assertTrue(debugAfterMethodCalled); - } - - @Override - public boolean isUseDebugger() { - // must enable debugger - return true; - } - - @Override - protected void debugBefore(Exchange exchange, org.apache.camel.Processor processor, ProcessorDefinition<?> definition, String id, String label) { - log.info("Before " + definition + " with body " + exchange.getIn().getBody()); - debugBeforeMethodCalled = true; - } - - @Override - protected void debugAfter(Exchange exchange, org.apache.camel.Processor processor, ProcessorDefinition<?> definition, String id, String label, long timeTaken) { - log.info("After " + definition + " with body " + exchange.getIn().getBody()); - debugAfterMethodCalled = true; - } -} -// end::example[] -]]></script> -</div></div>Also notice the use of <strong><code>getBlueprintDescriptor</code></strong> to specify the location of the OSGi Blueprint XML file.<br clear="none"> If you have multiple OSGi Blueprint XML files, then you can specify them with a comma-separated list in the <strong><code>getBlueprintDescriptor</code></strong> method.<p>Here's the <a shape="rect" class="external-link" href="http://svn.apache.org/viewvc/camel/trunk/components/camel-test-blueprint/src/test/resources/org/apache/camel/test/blueprint/camelContext.xml?view=markup">Blueprint XML file</a>:</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[ -<!-- tag::example[] --> -<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation=" - http://www.osgi.org/xmlns/blueprint/v1.0.0 https://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd"> - - <camelContext xmlns="http://camel.apache.org/schema/blueprint"> - - <route> - <from uri="direct:start"/> - <transform> - <simple>Hello ${body}</simple> - </transform> - <to uri="mock:a"/> - </route> - - </camelContext> - -</blueprint> -<!-- end::example[] --> -]]></script> -</div></div>In order to define blueprint tests, add the following dependency to your pom:<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> +<div class="wiki-content maincontent"><h2 id="BlueprintTesting-BlueprintTesting">Blueprint Testing</h2><p><strong>Available as of Camel 2.10</strong></p><rich-text-body><p><strong>camel-test-blueprint</strong> does only support testing <em>one</em> CamelContext. So if you have two or more CamelContexts in your blueprint XML files, then only the CamelContext first found is used during testing.</p></rich-text-body><p><a shape="rect" href="testing.html">Testing</a><span style="line-height: 1.4285715;"> is a crucial part of any development or integration work. Camel supports the definition of </span><a shape="rect" href="using-osgi-blueprint-with-camel.html">Blueprint routes</a><span style="line-height: 1.4285715;">, but given that Blueprint is an OSGi specific technology, writing unit tests is quite difficult. This library leverages </span><a shape="rect" class="external-link" href="http://code.google.com/p/pojosr/" rel="nofollow" style="line-height: 1.4285715;">PojoSR</a><span style=" line-height: 1.4285715;"> (now Felix Connect) which provides a service registry without using a fully compliant OSGi container. This allows defining real unit tests (as opposed to integration tests using </span><a shape="rect" class="external-link" href="http://team.ops4j.org/wiki/display/paxexam/Pax+Exam" rel="nofollow" style="line-height: 1.4285715;">Pax Exam</a><span style="line-height: 1.4285715;">. Please make sure all test jars in your classpath are OSGi bundles.</span><plain-text-body>{snippet:lang=java|id=example|url=camel/trunk/components/camel-test-blueprint/src/test/java/org/apache/camel/test/blueprint/DebugBlueprintTest.java}</plain-text-body>Also notice the use of <strong><code>getBlueprintDescriptor</code></strong> to specify the location of the OSGi Blueprint XML file.<br clear="none"> If you have multiple OSGi Blueprint XML files, then you can specify them with a comma-separated list in the <strong><code>getBlueprintDescriptor</code></strong> method.</p><p>Here' s the <a shape="rect" class="external-link" href="http://svn.apache.org/viewvc/camel/trunk/components/camel-test-blueprint/src/test/resources/org/apache/camel/test/blueprint/camelContext.xml?view=markup">Blueprint XML file</a>:<plain-text-body>{snippet:lang=xml|id=example|url=camel/trunk/components/camel-test-blueprint/src/test/resources/org/apache/camel/test/blueprint/camelContext.xml}</plain-text-body>In order to define blueprint tests, add the following dependency to your pom:</p><parameter ac:name="">xml</parameter><plain-text-body><dependency> <groupId>org.apache.camel</groupId> <artifactId>camel-test-blueprint</artifactId> <version>2.10</version> <scope>test</scope> </dependency> -]]></script> -</div></div><h3 id="BlueprintTesting-Classpathscanning">Classpath scanning</h3><p>By default PojoSR test container scans the test classpath for all the OSGi bundles available there. All the bundles with Blueprint descriptor files will be automatically started by the test container. If you would like to prevent particular bundles from being started by the test container, override the <code><strong>getBundleFilter</strong></code> method, just as demonstrated in the snippet 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[@Override +</plain-text-body><h3 id="BlueprintTesting-Classpathscanning">Classpath scanning</h3><p>By default PojoSR test container scans the test classpath for all the OSGi bundles available there. All the bundles with Blueprint descriptor files will be automatically started by the test container. If you would like to prevent particular bundles from being started by the test container, override the <code><strong>getBundleFilter</strong></code> method, just as demonstrated in the snippet below. </p><parameter ac:name="language">java</parameter><plain-text-body>@Override protected String getBundleFilter() { - // I don't want test container to scan and load Logback bundle during the test - return "(!(Bundle-SymbolicName=ch.qos.logback.core))"; + // I don't want test container to scan and load Logback bundle during the test + return "(!(Bundle-SymbolicName=ch.qos.logback.core))"; } -]]></script> -</div></div><p class="caseCommentStyle privateComment"><br clear="none">Keep in mind that not specifying the Blueprint descriptor in the getBlueprintDescriptor method will not prevent the test container from loading a given descriptor. The <code>getBundleFilter</code> method is the proper way of filtering out bundles you don't want to start during the test.</p><h3 id="BlueprintTesting-SettingtimeoutwhengettingCamelContext">Setting timeout when getting CamelContext</h3><p><strong>Available as of Camel 2.13.0/2.12.1/2.11.2</strong></p><p><code>CamelBlueprintTestSupport</code> waits 30 seconds for Camel Context to be ready by default, now you can override this value in two ways:</p><ul><li>Globally, by setting <code>org.apache.camel.test.blueprint.camelContextCreationTimeout</code> system property.</li><li>Locally for each test, by overriding <em>getCamelContextCreationTimeout</em> method.</li></ul><h3 id="BlueprintTesting-Addingservicesonstartup">Adding services on startup</h3><p><str ong>Available as of Camel 2.11.2/2.12.0</strong></p><p>When using <code>camel-test-blueprint</code> you may do unit tests which requires using shared services which are not available during unit testing, but only in the real OSGi container, for example a shared <code>DataSource</code>.</p><p>To make it easier to register services on startup, such as a standalone <code>DataSource</code> or any other service, you can override the method <code>addServicesOnStartup</code> when your unit test class extends <code>CamelBlueprintTestSupport</code>.</p><p>In the example below we register a service <code>org.apache.camel.test.blueprint.MyService</code> using the name <code>myService</code> having a property <code>beer=Carlsberg</code>, as 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[ @Override +</plain-text-body><p class="caseCommentStyle privateComment"><br clear="none">Keep in mind that not specifying the Blueprint descriptor in the getBlueprintDescriptor method will not prevent the test container from loading a given descriptor. The <code>getBundleFilter</code> method is the proper way of filtering out bundles you don't want to start during the test.</p><h3 id="BlueprintTesting-SettingtimeoutwhengettingCamelContext">Setting timeout when getting CamelContext</h3><p><strong>Available as of Camel 2.13.0/2.12.1/2.11.2</strong></p><p><code>CamelBlueprintTestSupport</code> waits 30 seconds for Camel Context to be ready by default, now you can override this value in two ways:</p><ul><li>Globally, by setting <code>org.apache.camel.test.blueprint.camelContextCreationTimeout</code> system property.</li><li>Locally for each test, by overriding <em>getCamelContextCreationTimeout</em> method.</li></ul><h3 id="BlueprintTesting-Addingservicesonstartup">Adding services on startup</h3>< p><strong>Available as of Camel 2.11.2/2.12.0</strong></p><p>When using <code>camel-test-blueprint</code> you may do unit tests which requires using shared services which are not available during unit testing, but only in the real OSGi container, for example a shared <code>DataSource</code>.</p><p>To make it easier to register services on startup, such as a standalone <code>DataSource</code> or any other service, you can override the method <code>addServicesOnStartup</code> when your unit test class extends <code>CamelBlueprintTestSupport</code>.</p><p>In the example below we register a service <code>org.apache.camel.test.blueprint.MyService</code> using the name <code>myService</code> having a property <code>beer=Carlsberg</code>, as shown below:</p><plain-text-body> @Override protected void addServicesOnStartup(Map<String, KeyValueHolder<Object, Dictionary>> services) { - services.put("myService", asService(myService, "beer", "Carlsberg")); + services.put("myService", asService(myService, "beer", "Carlsberg")); } -]]></script> -</div></div><p>The asService is a builder method that makes it easy to register a service with a single property. If you need more properties you can use the <code>asService</code> method that takes a <code>Dictionary</code> as argument. And if you do not need any properties, then just pass in <code>null</code>, eg:</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[services.put("myService", asService(myService, null)); -]]></script> -</div></div><p>This allows us to use the service by calling a method on it from a Camel <a shape="rect" href="bean.html">Bean</a> component in a route as shown:</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[ <route> - <from uri="direct:start"/> - <to uri="bean:myService"/> - <to uri="mock:result"/> +</plain-text-body><p>The asService is a builder method that makes it easy to register a service with a single property. If you need more properties you can use the <code>asService</code> method that takes a <code>Dictionary</code> as argument. And if you do not need any properties, then just pass in <code>null</code>, eg:</p><plain-text-body>services.put("myService", asService(myService, null)); +</plain-text-body><p>This allows us to use the service by calling a method on it from a Camel <a shape="rect" href="bean.html">Bean</a> component in a route as shown:</p><parameter ac:name="">xml</parameter><plain-text-body> <route> + <from uri="direct:start"/> + <to uri="bean:myService"/> + <to uri="mock:result"/> </route> -]]></script> -</div></div><p>Notice the bean endpoint uses the service name <code>myService</code> which was the name we registered the service as. You can also use the fully qualified class name instead, which is more common with OSGi.</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[ @Override +</plain-text-body><p>Notice the bean endpoint uses the service name <code>myService</code> which was the name we registered the service as. You can also use the fully qualified class name instead, which is more common with OSGi.</p><plain-text-body> @Override protected void addServicesOnStartup(Map<String, KeyValueHolder<Object, Dictionary>> services) { - services.put(MyService.class.getName(), asService(myService, "beer", "Carlsberg")); + services.put(MyService.class.getName(), asService(myService, "beer", "Carlsberg")); } -]]></script> -</div></div><p>And in the route we use the FQN name:</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[ <route> - <from uri="direct:start"/> - <to uri="bean:org.apache.camel.test.blueprint.MyService"/> - <to uri="mock:result"/> +</plain-text-body><p>And in the route we use the FQN name:</p><parameter ac:name="">xml</parameter><plain-text-body> <route> + <from uri="direct:start"/> + <to uri="bean:org.apache.camel.test.blueprint.MyService"/> + <to uri="mock:result"/> </route> -]]></script> -</div></div><p> </p><p><span>From </span><strong>Camel 2.16.0</strong><span>, an additional </span><span><code>addServicesOnStartup</code> method is available to be overridden making it ideal for when needing to specify multiple services with the same interface.</span><span> </span></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[ @Override +</plain-text-body><p> </p><p><span>From </span><strong>Camel 2.16.0</strong><span>, an additional </span><span><code>addServicesOnStartup</code> method is available to be overridden making it ideal for when needing to specify multiple services with the same interface.</span><span> </span></p><parameter ac:name="language">java</parameter><plain-text-body> @Override protected void addServicesOnStartup(List<KeyValueHolder<String, KeyValueHolder<Object, Dictionary>>> services) { Dictionary<String, String> dict1 = new Hashtable<String, String>(); - dict1.put("osgi.jndi.service.name", "jdbc/db1"); -   + dict1.put("osgi.jndi.service.name", "jdbc/db1"); +   Dictionary<String, String> dict2 = new Hashtable<String, String>(); - dict2.put("osgi.jndi.service.name", "jdbc/db2"); -   + dict2.put("osgi.jndi.service.name", "jdbc/db2"); +   services.add(asKeyValueService(javax.sql.DataSource.class.getName(), mockService1, dict1)); services.add(asKeyValueService(javax.sql.DataSource.class.getName(), mockService2, dict2)); } -]]></script> -</div></div><p><span>The <code>asKeyValueService</code> builder method can be used to construct the necessary parameters to create the service. The method takes in the name of the registered service, the object, and and a <code><span>Dictionary</span></code> as arguments.</span></p></div> +</plain-text-body><p><span>The <code>asKeyValueService</code> builder method can be used to construct the necessary parameters to create the service. The method takes in the name of the registered service, the object, and and a <code><span>Dictionary</span></code> as arguments.</span></p></div> </td> <td valign="top"> <div class="navigation">