Repository: camel Updated Branches: refs/heads/master 9f104f90b -> 432d41d33
Added ref language to Gitbook Project: http://git-wip-us.apache.org/repos/asf/camel/repo Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/f70ae047 Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/f70ae047 Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/f70ae047 Branch: refs/heads/master Commit: f70ae047d6c0b21598d83932e81d3b9902889855 Parents: 9f104f9 Author: Andrea Cosentino <anco...@gmail.com> Authored: Thu Aug 25 11:58:03 2016 +0200 Committer: Andrea Cosentino <anco...@gmail.com> Committed: Thu Aug 25 11:58:03 2016 +0200 ---------------------------------------------------------------------- camel-core/src/main/docs/ref-language.adoc | 68 +++++++++++++++++++++++++ 1 file changed, 68 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/camel/blob/f70ae047/camel-core/src/main/docs/ref-language.adoc ---------------------------------------------------------------------- diff --git a/camel-core/src/main/docs/ref-language.adoc b/camel-core/src/main/docs/ref-language.adoc new file mode 100644 index 0000000..c28403d --- /dev/null +++ b/camel-core/src/main/docs/ref-language.adoc @@ -0,0 +1,68 @@ +[[RefLanguage-RefExpressionLanguage]] +Ref Expression Language +~~~~~~~~~~~~~~~~~~~~~~~ + +*Available as of Camel 2.8* + +The Ref Expression Language is really just a way to lookup a custom +link:expression.html[Expression] from the link:registry.html[Registry]. + + + This is particular useable in XML DSLs. + +[[RefLanguage-Options]] +Ref Language options +^^^^^^^^^^^^^^^^^^^^ + +// language options: START +The Ref language supports 1 options which are listed below. + + + +{% raw %} +[width="100%",cols="2,1m,1m,6",options="header"] +|======================================================================= +| Name | Default | Java Type | Description +| trim | true | Boolean | Whether to trim the value to remove leading and trailing whitespaces and line breaks +|======================================================================= +{% endraw %} +// language options: END + +[[RefLanguage-Exampleusage]] +Example usage +^^^^^^^^^^^^^ + +The link:splitter.html[Splitter] in XML DSL can utilize a custom +expression using `<ref>` like: + +[source,xml] +------------------------------------------------------------------ +<bean id="myExpression" class="com.mycompany.MyCustomExpression"/> + +... + +<route> + <from uri="seda:a"/> + <split> + <ref>myExpression</ref> + <to uri="mock:b"/> + </split> +</route> +------------------------------------------------------------------ + +in this case, the link:message.html[Message] coming from the seda:a +link:endpoint.html[Endpoint] will be splitted using a custom +link:expression.html[Expression] which has the id `myExpression` in the +link:registry.html[Registry]. + +And the same example using Java DSL: + +[source,java] +-------------------------------------------------------- +from("seda:a").split().ref("myExpression").to("seda:b"); +-------------------------------------------------------- + +[[RefLanguage-Dependencies]] +Dependencies +^^^^^^^^^^^^ + +The Constant language is part of *camel-core*.