You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by da...@apache.org on 2016/08/16 11:11:38 UTC

[2/2] camel git commit: CAMEL-9541: Generate readme for dataformat/language

CAMEL-9541: Generate readme for dataformat/language


Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/9ecd5635
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/9ecd5635
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/9ecd5635

Branch: refs/heads/master
Commit: 9ecd5635d10aac3e50652cc14693bc3cf4fe46f9
Parents: 536ec53
Author: Claus Ibsen <da...@apache.org>
Authored: Tue Aug 16 13:11:28 2016 +0200
Committer: Claus Ibsen <da...@apache.org>
Committed: Tue Aug 16 13:11:28 2016 +0200

----------------------------------------------------------------------
 components/camel-gson/src/main/docs/gson.adoc   |  36 --
 .../src/main/docs/json-gson-dataformat.adoc     |  71 ++++
 .../camel-jackson/src/main/docs/jackson.adoc    |  36 --
 .../src/main/docs/json-jackson-dataformat.adoc  |  72 ++++
 .../src/main/docs/jackson-xml.adoc              | 352 -----------------
 .../src/main/docs/jacksonxml-dataformat.adoc    | 385 +++++++++++++++++++
 .../camel-johnzon/src/main/docs/johnzon.adoc    |  36 --
 .../src/main/docs/json-johnzon-dataformat.adoc  |  72 ++++
 components/camel-josql/src/main/docs/josql.adoc |  82 ----
 .../camel-josql/src/main/docs/sql-language.adoc |  92 +++++
 .../camel-juel/src/main/docs/el-language.adoc   | 115 ++++++
 components/camel-juel/src/main/docs/juel.adoc   |  93 -----
 .../main/docs/yaml-snakeyaml-dataformat.adoc    | 148 +++++++
 .../camel-snakeyaml/src/main/docs/yaml.adoc     | 119 ------
 components/camel-soap/src/main/docs/soap.adoc   | 289 --------------
 .../src/main/docs/soapjaxb-dataformat.adoc      | 315 +++++++++++++++
 .../main/docs/string-template-component.adoc    | 145 +++++++
 .../src/main/docs/string-template.adoc          | 126 ------
 .../stringtemplate/StringTemplateEndpoint.java  |   2 +-
 .../camel-tagsoup/src/main/docs/tagsoup.adoc    |  69 ----
 .../src/main/docs/tidyMarkup-dataformat.adoc    |  90 +++++
 21 files changed, 1506 insertions(+), 1239 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-gson/src/main/docs/gson.adoc
----------------------------------------------------------------------
diff --git a/components/camel-gson/src/main/docs/gson.adoc b/components/camel-gson/src/main/docs/gson.adoc
deleted file mode 100644
index 80db796..0000000
--- a/components/camel-gson/src/main/docs/gson.adoc
+++ /dev/null
@@ -1,36 +0,0 @@
-[[Gson-Gson]]
-Gson
-~~~~
-
-*Available as of Camel 2.18*
-
-Gson is a link:data-format.html[Data Format] which uses the
-https://github.com/google/gson[Gson Library]
-
-[source,java]
--------------------------------
-from("activemq:My.Queue").
-  marshal().json(JsonLibrary.Gson).
-  to("mqseries:Another.Queue");
--------------------------------
-
-[[Gson-Dependencies]]
-Dependencies
-^^^^^^^^^^^^
-
-To use Gson in your camel routes you need to add the dependency
-on *camel-gson* which implements this data format.
-
-If you use maven you could just add the following to your pom.xml,
-substituting the version number for the latest & greatest release (see
-link:download.html[the download page for the latest versions]).
-
-[source,xml]
-----------------------------------------------------------
-<dependency>
-  <groupId>org.apache.camel</groupId>
-  <artifactId>camel-gson</artifactId>
-  <version>x.x.x</version>
-  <!-- use the same version as your Camel core version -->
-</dependency>
-----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-gson/src/main/docs/json-gson-dataformat.adoc
----------------------------------------------------------------------
diff --git a/components/camel-gson/src/main/docs/json-gson-dataformat.adoc b/components/camel-gson/src/main/docs/json-gson-dataformat.adoc
new file mode 100644
index 0000000..8331364
--- /dev/null
+++ b/components/camel-gson/src/main/docs/json-gson-dataformat.adoc
@@ -0,0 +1,71 @@
+[[Gson-Gson]]
+Gson
+~~~~
+
+*Available as of Camel 2.18*
+
+Gson is a link:data-format.html[Data Format] which uses the
+https://github.com/google/gson[Gson Library]
+
+[source,java]
+-------------------------------
+from("activemq:My.Queue").
+  marshal().json(JsonLibrary.Gson).
+  to("mqseries:Another.Queue");
+-------------------------------
+
+[[Gson-Options]]
+Gson Options
+^^^^^^^^^^^^
+
+
+// dataformat options: START
+The JSon GSon dataformat supports 15 options which are listed below.
+
+
+
+{% raw %}
+[width="100%",cols="2s,1m,1m,6",options="header"]
+|=======================================================================
+| Name | Default | Java Type | Description
+| objectMapper |  | String | Lookup and use the existing ObjectMapper with the given id when using Jackson.
+| prettyPrint | false | Boolean | To enable pretty printing output nicely formatted. Is by default false.
+| library | Gson | JsonLibrary | Which json library to use.
+| unmarshalTypeName |  | String | Class name of the java type to use when unarmshalling
+| jsonView |  | Class<?> | When marshalling a POJO to JSON you might want to exclude certain fields from the JSON output. With Jackson you can use JSON views to accomplish this. This option is to refer to the class which has JsonView annotations
+| include |  | String | If you want to marshal a pojo to JSON and the pojo has some fields with null values. And you want to skip these null values you can set this option to NOT_NULL
+| allowJmsType | false | Boolean | Used for JMS users to allow the JMSType header from the JMS spec to specify a FQN classname to use to unmarshal to.
+| collectionTypeName |  | String | Refers to a custom collection type to lookup in the registry to use. This option should rarely be used but allows to use different collection types than java.util.Collection based as default.
+| useList | false | Boolean | To unarmshal to a List of Map or a List of Pojo.
+| enableJaxbAnnotationModule | false | Boolean | Whether to enable the JAXB annotations module when using jackson. When enabled then JAXB annotations can be used by Jackson.
+| moduleClassNames |  | String | To use custom Jackson modules com.fasterxml.jackson.databind.Module specified as a String with FQN class names. Multiple classes can be separated by comma.
+| moduleRefs |  | String | To use custom Jackson modules referred from the Camel registry. Multiple modules can be separated by comma.
+| enableFeatures |  | String | Set of features to enable on the Jackson com.fasterxml.jackson.databind.ObjectMapper. The features should be a name that matches a enum from com.fasterxml.jackson.databind.SerializationFeature com.fasterxml.jackson.databind.DeserializationFeature or com.fasterxml.jackson.databind.MapperFeature Multiple features can be separated by comma
+| disableFeatures |  | String | Set of features to disable on the Jackson com.fasterxml.jackson.databind.ObjectMapper. The features should be a name that matches a enum from com.fasterxml.jackson.databind.SerializationFeature com.fasterxml.jackson.databind.DeserializationFeature or com.fasterxml.jackson.databind.MapperFeature Multiple features can be separated by comma
+| permissions |  | String | Adds permissions that controls which Java packages and classes XStream is allowed to use during unmarshal from xml/json to Java beans. A permission must be configured either here or globally using a JVM system property. The permission can be specified in a syntax where a plus sign is allow and minus sign is deny. Wildcards is supported by using . as prefix. For example to allow com.foo and all subpackages then specfy com.foo.. Multiple permissions can be configured separated by comma such as com.foo.-com.foo.bar.MySecretBean. The following default permission is always included: -java.lang.java.util. unless its overridden by specifying a JVM system property with they key org.apache.camel.xstream.permissions.
+|=======================================================================
+{% endraw %}
+// dataformat options: END
+
+
+
+[[Gson-Dependencies]]
+Dependencies
+^^^^^^^^^^^^
+
+To use Gson in your camel routes you need to add the dependency
+on *camel-gson* which implements this data format.
+
+If you use maven you could just add the following to your pom.xml,
+substituting the version number for the latest & greatest release (see
+link:download.html[the download page for the latest versions]).
+
+[source,xml]
+----------------------------------------------------------
+<dependency>
+  <groupId>org.apache.camel</groupId>
+  <artifactId>camel-gson</artifactId>
+  <version>x.x.x</version>
+  <!-- use the same version as your Camel core version -->
+</dependency>
+----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-jackson/src/main/docs/jackson.adoc
----------------------------------------------------------------------
diff --git a/components/camel-jackson/src/main/docs/jackson.adoc b/components/camel-jackson/src/main/docs/jackson.adoc
deleted file mode 100644
index 273623f..0000000
--- a/components/camel-jackson/src/main/docs/jackson.adoc
+++ /dev/null
@@ -1,36 +0,0 @@
-[[Jackson-Jackson]]
-Jackson
-~~~~~~~
-
-*Available as of Camel 2.18*
-
-Jackson is a link:data-format.html[Data Format] which uses the
-https://github.com/FasterXML/jackson-core[Jackson Library]
-
-[source,java]
--------------------------------
-from("activemq:My.Queue").
-  marshal().json(JsonLibrary.Jackson).
-  to("mqseries:Another.Queue");
--------------------------------
-
-[[Jackson-Dependencies]]
-Dependencies
-^^^^^^^^^^^^
-
-To use Jackson in your camel routes you need to add the dependency
-on *camel-jackson* which implements this data format.
-
-If you use maven you could just add the following to your pom.xml,
-substituting the version number for the latest & greatest release (see
-link:download.html[the download page for the latest versions]).
-
-[source,xml]
-----------------------------------------------------------
-<dependency>
-  <groupId>org.apache.camel</groupId>
-  <artifactId>camel-jackson</artifactId>
-  <version>x.x.x</version>
-  <!-- use the same version as your Camel core version -->
-</dependency>
-----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-jackson/src/main/docs/json-jackson-dataformat.adoc
----------------------------------------------------------------------
diff --git a/components/camel-jackson/src/main/docs/json-jackson-dataformat.adoc b/components/camel-jackson/src/main/docs/json-jackson-dataformat.adoc
new file mode 100644
index 0000000..d6fe055
--- /dev/null
+++ b/components/camel-jackson/src/main/docs/json-jackson-dataformat.adoc
@@ -0,0 +1,72 @@
+[[Jackson-Jackson]]
+Jackson
+~~~~~~~
+
+*Available as of Camel 2.18*
+
+Jackson is a link:data-format.html[Data Format] which uses the
+https://github.com/FasterXML/jackson-core[Jackson Library]
+
+[source,java]
+-------------------------------
+from("activemq:My.Queue").
+  marshal().json(JsonLibrary.Jackson).
+  to("mqseries:Another.Queue");
+-------------------------------
+
+[[Jackson-Options]]
+Jackson Options
+^^^^^^^^^^^^^^^
+
+
+
+// dataformat options: START
+The JSon Jackson dataformat supports 15 options which are listed below.
+
+
+
+{% raw %}
+[width="100%",cols="2s,1m,1m,6",options="header"]
+|=======================================================================
+| Name | Default | Java Type | Description
+| objectMapper |  | String | Lookup and use the existing ObjectMapper with the given id when using Jackson.
+| prettyPrint | false | Boolean | To enable pretty printing output nicely formatted. Is by default false.
+| library | Jackson | JsonLibrary | Which json library to use.
+| unmarshalTypeName |  | String | Class name of the java type to use when unarmshalling
+| jsonView |  | Class<?> | When marshalling a POJO to JSON you might want to exclude certain fields from the JSON output. With Jackson you can use JSON views to accomplish this. This option is to refer to the class which has JsonView annotations
+| include |  | String | If you want to marshal a pojo to JSON and the pojo has some fields with null values. And you want to skip these null values you can set this option to NOT_NULL
+| allowJmsType | false | Boolean | Used for JMS users to allow the JMSType header from the JMS spec to specify a FQN classname to use to unmarshal to.
+| collectionTypeName |  | String | Refers to a custom collection type to lookup in the registry to use. This option should rarely be used but allows to use different collection types than java.util.Collection based as default.
+| useList | false | Boolean | To unarmshal to a List of Map or a List of Pojo.
+| enableJaxbAnnotationModule | false | Boolean | Whether to enable the JAXB annotations module when using jackson. When enabled then JAXB annotations can be used by Jackson.
+| moduleClassNames |  | String | To use custom Jackson modules com.fasterxml.jackson.databind.Module specified as a String with FQN class names. Multiple classes can be separated by comma.
+| moduleRefs |  | String | To use custom Jackson modules referred from the Camel registry. Multiple modules can be separated by comma.
+| enableFeatures |  | String | Set of features to enable on the Jackson com.fasterxml.jackson.databind.ObjectMapper. The features should be a name that matches a enum from com.fasterxml.jackson.databind.SerializationFeature com.fasterxml.jackson.databind.DeserializationFeature or com.fasterxml.jackson.databind.MapperFeature Multiple features can be separated by comma
+| disableFeatures |  | String | Set of features to disable on the Jackson com.fasterxml.jackson.databind.ObjectMapper. The features should be a name that matches a enum from com.fasterxml.jackson.databind.SerializationFeature com.fasterxml.jackson.databind.DeserializationFeature or com.fasterxml.jackson.databind.MapperFeature Multiple features can be separated by comma
+| permissions |  | String | Adds permissions that controls which Java packages and classes XStream is allowed to use during unmarshal from xml/json to Java beans. A permission must be configured either here or globally using a JVM system property. The permission can be specified in a syntax where a plus sign is allow and minus sign is deny. Wildcards is supported by using . as prefix. For example to allow com.foo and all subpackages then specfy com.foo.. Multiple permissions can be configured separated by comma such as com.foo.-com.foo.bar.MySecretBean. The following default permission is always included: -java.lang.java.util. unless its overridden by specifying a JVM system property with they key org.apache.camel.xstream.permissions.
+|=======================================================================
+{% endraw %}
+// dataformat options: END
+
+
+
+[[Jackson-Dependencies]]
+Dependencies
+^^^^^^^^^^^^
+
+To use Jackson in your camel routes you need to add the dependency
+on *camel-jackson* which implements this data format.
+
+If you use maven you could just add the following to your pom.xml,
+substituting the version number for the latest & greatest release (see
+link:download.html[the download page for the latest versions]).
+
+[source,xml]
+----------------------------------------------------------
+<dependency>
+  <groupId>org.apache.camel</groupId>
+  <artifactId>camel-jackson</artifactId>
+  <version>x.x.x</version>
+  <!-- use the same version as your Camel core version -->
+</dependency>
+----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-jacksonxml/src/main/docs/jackson-xml.adoc
----------------------------------------------------------------------
diff --git a/components/camel-jacksonxml/src/main/docs/jackson-xml.adoc b/components/camel-jacksonxml/src/main/docs/jackson-xml.adoc
deleted file mode 100644
index e2d05be..0000000
--- a/components/camel-jacksonxml/src/main/docs/jackson-xml.adoc
+++ /dev/null
@@ -1,352 +0,0 @@
-[[JacksonXML-JacksonXML]]
-Jackson XML
-~~~~~~~~~~~
-
-*Available as of Camel 2.16*
-
-Jackson XML is a link:data-format.html[Data Format] which uses the
-http://wiki.fasterxml.com/JacksonHome/[Jackson library]�with the
-https://github.com/FasterXML/jackson-dataformat-xml[XMLMapper extension]
-to unmarshal an XML payload into Java objects or to marshal Java objects
-into an XML payload.
-
-INFO:If you are familiar with Jackson, this XML data format behaves in the
-same way as its JSON counterpart, and thus can be used with classes
-annotated for JSON serialization/deserialization.
-
-This extension also mimics
-https://github.com/FasterXML/jackson-dataformat-xml/blob/master/README.md[JAXB's
-"Code first" approach].
-
-This data format relies on
-http://wiki.fasterxml.com/WoodstoxHome[Woodstox] (especially for
-features like pretty printing), a fast and efficient XML processor.
-
-[source,java]
--------------------------------
-from("activemq:My.Queue").
-  unmarshal().jacksonxml().
-  to("mqseries:Another.Queue");
--------------------------------
-
-[[JacksonXML-UsingJacksonXMLinSpringDSL]]
-Using Jackson XML in Spring DSL
-+++++++++++++++++++++++++++++++
-
-When using�link:data-format.html[Data Format]�in Spring DSL you need to
-declare the data formats first. This is done in the�*DataFormats*�XML
-tag.
-
-[source,xml]
------------------------------------------------------------------------------------------------------------------------------
-        <dataFormats>
-            <!-- here we define a Xml data format with the id jack and that it should use the TestPojo as the class type when
-                 doing unmarshal. The unmarshalTypeName is optional, if not provided Camel will use a Map as the type -->
-            <jacksonxml id="jack" unmarshalTypeName="org.apache.camel.component.jacksonxml.TestPojo"/>
-        </dataFormats>
------------------------------------------------------------------------------------------------------------------------------
-
-And then you can refer to this id in the route:
-
-[source,xml]
--------------------------------------
-       <route>
-            <from uri="direct:back"/>
-            <unmarshal ref="jack"/>
-            <to uri="mock:reverse"/>
-        </route>
--------------------------------------
-
-[[JacksonXML-ExcludingPOJOfieldsfrommarshalling]]
-Excluding POJO fields from marshalling
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-When marshalling a POJO to XML you might want to exclude certain fields
-from the XML output. With Jackson you can
-use�http://wiki.fasterxml.com/JacksonJsonViews[JSON views]�to accomplish
-this. First create one or more marker classes.
-
-Use the marker classes with the�`@JsonView`�annotation to
-include/exclude certain fields. The annotation also works on getters.
-
-Finally use the Camel�`JacksonXMLDataFormat`�to marshall the above POJO
-to XML.
-
-Note that the weight field is missing in the resulting XML:
-
-[source,java]
-----------------------------
-<pojo age="30" weight="70"/>
-----------------------------
-
-[[JacksonXML-Include/ExcludefieldsusingthejsonViewattributewithJacksonXMLDataFormat]]
-Include/Exclude fields using the�`jsonView`�attribute with�`JacksonXML`DataFormat
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-As an example of using this attribute you can instead of:
-
-[source,java]
----------------------------------------------------------------------------------------------------
-JacksonXMLDataFormat ageViewFormat = new JacksonXMLDataFormat(TestPojoView.class, Views.Age.class);
-from("direct:inPojoAgeView").
-  marshal(ageViewFormat);
----------------------------------------------------------------------------------------------------
-
-Directly specify your�http://wiki.fasterxml.com/JacksonJsonViews[JSON
-view]�inside the Java DSL as:
-
-[source,java]
-------------------------------------------------------------
-from("direct:inPojoAgeView").
-  marshal().jacksonxml(TestPojoView.class, Views.Age.class);
-------------------------------------------------------------
-
-And the same in XML DSL:
-
-[source,xml]
----------------------------------------------------------------------------------------------------------------------------------------------------
-<from uri="direct:inPojoAgeView"/>
-  <marshal>
-    <jacksonxml unmarshalTypeName="org.apache.camel.component.jacksonxml.TestPojoView" jsonView="org.apache.camel.component.jacksonxml.Views$Age"/>
-  </marshal>
----------------------------------------------------------------------------------------------------------------------------------------------------
-
-[[JacksonXML-Settingserializationincludeoption]]
-Setting serialization include option
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-If you want to marshal a pojo to XML, and the pojo has some fields with
-null values. And you want to skip these null values, then you need to
-set either an annotation on the pojo,�
-
-[source,java]
-------------------------------
-@JsonInclude(Include.NON_NULL)
-public class MyPojo {
-   ...
-}
-------------------------------
-
-But this requires you to include that annotation in your pojo source
-code. You can also configure the Camel JacksonXMLDataFormat to set the
-include option, as shown below:
-
-[source,java]
----------------------------------------------------------
-JacksonXMLDataFormat format = new JacksonXMLDataFormat();
-format.setInclude("NON_NULL");
----------------------------------------------------------
-
-Or from XML DSL you configure this as
-
-[source,java]
-------------------------------------------------------
-    <dataFormats>
-      <jacksonxml id="jacksonxml" include="NOT_NULL"/>
-    </dataFormats>
-------------------------------------------------------
-
-[[JacksonXML-UnmarshallingfromXMLtoPOJOwithdynamicclassname]]
-Unmarshalling from XML to POJO with dynamic class name
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-If you use jackson to unmarshal XML to POJO, then you can now specify a
-header in the message that indicate which class name to unmarshal to. +
-The header has key�`CamelJacksonUnmarshalType`�if that header is present
-in the message, then Jackson will use that as FQN for the POJO class to
-unmarshal the XML payload as.
-
-�For JMS end users there is the JMSType header from the JMS spec that
-indicates that also. To enable support for JMSType you would need to
-turn that on, on the jackson data format as shown:
-
-[source,java]
----------------------------------------------------
-JacksonDataFormat format = new JacksonDataFormat();
-format.setAllowJmsType(true);
----------------------------------------------------
-
-Or from XML DSL you configure this as
-
-[source,java]
--------------------------------------------------------
-    <dataFormats>
-      <jacksonxml id="jacksonxml" allowJmsType="true"/>
-    </dataFormats>
--------------------------------------------------------
-
-[[JacksonXML-UnmarshallingfromXMLtoListMaporListPojo]]
-Unmarshalling from XML�to List<Map> or List<pojo>
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-If you are using Jackson to unmarshal XML to a list of map/pojo, you can
-now specify this by setting�`useList="true"`�or use
-the�`org.apache.camel.component.jacksonxml.ListJacksonXMLDataFormat`.
-For example with Java you can do as shown below:
-
-[source,java]
--------------------------------------------------------------
-JacksonXMLDataFormat format = new ListJacksonXMLDataFormat();
-// or
-JacksonXMLDataFormat format = new JacksonXMLDataFormat();
-format.useList();
-// and you can specify the pojo class type also
-format.setUnmarshalType(MyPojo.class);
--------------------------------------------------------------
-
-And if you use XML DSL then you configure to use list
-using�`useList`�attribute as shown below:
-
-[source,java]
---------------------------------------------
-    <dataFormats>
-      <jacksonxml id="jack" useList="true"/>
-    </dataFormats>
---------------------------------------------
-
-And you can specify the pojo type also
-
-[source,java]
--------------------------------------------------------------------------------
-    <dataFormats>
-      <jacksonxml id="jack" useList="true" unmarshalTypeName="com.foo.MyPojo"/>
-    </dataFormats>
--------------------------------------------------------------------------------
-
-[[JacksonXML-UsingcustomJacksonmodules]]
-Using custom Jackson modules
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-You can use custom Jackson modules by specifying the class names of
-those using the moduleClassNames option as shown below.
-
-[source,java]
------------------------------------------------------------------------------------------------------------------------------------------
-    <dataFormats>
-      <jacksonxml id="jack" useList="true" unmarshalTypeName="com.foo.MyPojo" moduleClassNames="com.foo.MyModule,com.foo.MyOtherModule"/>
-    </dataFormats>
------------------------------------------------------------------------------------------------------------------------------------------
-
-When using�moduleClassNames then the custom jackson modules are not
-configured, by created using default constructor and used as-is. If a
-custom module needs any custom configuration, then an instance of the
-module can be created and configured, and then use modulesRefs to refer
-to the module as shown below:
-
-[source,java]
-------------------------------------------------------------------------------------------------------------------
-    <bean id="myJacksonModule" class="com.foo.MyModule">
-      ... // configure the module as you want
-    </bean>
-�
-    <dataFormats>
-      <jacksonxml id="jacksonxml" useList="true" unmarshalTypeName="com.foo.MyPojo" moduleRefs="myJacksonModule"/>
-    </dataFormats>
-------------------------------------------------------------------------------------------------------------------
-
-�Multiple modules can be specified separated by comma, such as
-moduleRefs="myJacksonModule,myOtherModule"
-
-[[JacksonXML-EnablingordisablefeaturesusingJackson]]
-Enabling or disable features using Jackson
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Jackson has a number of features you can enable or disable, which its
-ObjectMapper uses. For example to disable failing on unknown properties
-when marshalling, you can configure this using the disableFeatures:
-
-[source,java]
--------------------------------------------------------------------------------------------------------------------
- <dataFormats>
-      <jacksonxml id="jacksonxml" unmarshalTypeName="com.foo.MyPojo" disableFeatures="FAIL_ON_UNKNOWN_PROPERTIES"/>
- </dataFormats>
--------------------------------------------------------------------------------------------------------------------
-
-You can disable multiple features by separating the values using comma.
-The values for the features must be the name of the enums from Jackson
-from the following enum classes
-
-* com.fasterxml.jackson.databind.SerializationFeature
-* com.fasterxml.jackson.databind.DeserializationFeature
-* com.fasterxml.jackson.databind.MapperFeature
-
-To enable a feature use the enableFeatures options instead.
-
-From Java code you can use the type safe methods from camel-jackson
-module:
-
-[source,java]
-----------------------------------------------------------------------
-JacksonDataFormat df = new JacksonDataFormat(MyPojo.class);
-df.disableFeature(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
-df.disableFeature(DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES);
-----------------------------------------------------------------------
-
-[[JacksonXML-ConvertingMapstoPOJOusingJackson]]
-Converting Maps to POJO using Jackson
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Jackson�`ObjectMapper`�can be used to convert maps to POJO objects.
-Jackson component comes with the data converter that can be used to
-convert�`java.util.Map`�instance to non-String, non-primitive and
-non-Number objects.
-
-[source,java]
-----------------------------------------------------------------
-Map<String, Object> invoiceData = new HashMap<String, Object>();
-invoiceData.put("netValue", 500);
-producerTemplate.sendBody("direct:mapToInvoice", invoiceData);
-...
-// Later in the processor
-Invoice invoice = exchange.getIn().getBody(Invoice.class);
-----------------------------------------------------------------
-
-If there is a single�`ObjectMapper`�instance available in the Camel
-registry, it will used by the converter to perform the conversion.
-Otherwise the default mapper will be used. �
-
-[[JacksonXML-FormattedXMLmarshallingpretty-printing]]
-Formatted XML marshalling (pretty-printing)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Using the�`prettyPrint`�option�one can output a well formatted XML�while
-marshalling:
-
-[source,java]
-------------------------------------------------
- <dataFormats>
-      <jacksonxml id="jack" prettyPrint="true"/>
- </dataFormats>
-------------------------------------------------
-
-And in Java DSL:
-
-[source,java]
----------------------------------------------------
-from("direct:inPretty").marshal().jacksonxml(true);
----------------------------------------------------
-
-Please note that there are 5 different overloaded�`jacksonxml()`�DSL
-methods which support the�`prettyPrint`�option in combination with other
-settings for�`unmarshalType`,�`jsonView`�etc.�
-
-[[JacksonXML-Dependencies]]
-Dependencies
-^^^^^^^^^^^^
-
-To use Jackson XML in your camel routes you need to add the dependency
-on *camel-jacksonxml* which implements this data format.
-
-If you use maven you could just add the following to your pom.xml,
-substituting the version number for the latest & greatest release (see
-link:download.html[the download page for the latest versions]).
-
-[source,xml]
-----------------------------------------------------------
-<dependency>
-  <groupId>org.apache.camel</groupId>
-  <artifactId>camel-jacksonxml</artifactId>
-  <version>x.x.x</version>
-  <!-- use the same version as your Camel core version -->
-</dependency>
-----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-jacksonxml/src/main/docs/jacksonxml-dataformat.adoc
----------------------------------------------------------------------
diff --git a/components/camel-jacksonxml/src/main/docs/jacksonxml-dataformat.adoc b/components/camel-jacksonxml/src/main/docs/jacksonxml-dataformat.adoc
new file mode 100644
index 0000000..f631701
--- /dev/null
+++ b/components/camel-jacksonxml/src/main/docs/jacksonxml-dataformat.adoc
@@ -0,0 +1,385 @@
+[[JacksonXML-JacksonXML]]
+Jackson XML
+~~~~~~~~~~~
+
+*Available as of Camel 2.16*
+
+Jackson XML is a link:data-format.html[Data Format] which uses the
+http://wiki.fasterxml.com/JacksonHome/[Jackson library]�with the
+https://github.com/FasterXML/jackson-dataformat-xml[XMLMapper extension]
+to unmarshal an XML payload into Java objects or to marshal Java objects
+into an XML payload.
+
+INFO:If you are familiar with Jackson, this XML data format behaves in the
+same way as its JSON counterpart, and thus can be used with classes
+annotated for JSON serialization/deserialization.
+
+This extension also mimics
+https://github.com/FasterXML/jackson-dataformat-xml/blob/master/README.md[JAXB's
+"Code first" approach].
+
+This data format relies on
+http://wiki.fasterxml.com/WoodstoxHome[Woodstox] (especially for
+features like pretty printing), a fast and efficient XML processor.
+
+[source,java]
+-------------------------------
+from("activemq:My.Queue").
+  unmarshal().jacksonxml().
+  to("mqseries:Another.Queue");
+-------------------------------
+
+[[JacksonXML-Options]]
+JacksonXML Options
+^^^^^^^^^^^^^^^^^^
+
+
+
+// dataformat options: START
+The JacksonXML dataformat supports 13 options which are listed below.
+
+
+
+{% raw %}
+[width="100%",cols="2s,1m,1m,6",options="header"]
+|=======================================================================
+| Name | Default | Java Type | Description
+| xmlMapper |  | String | Lookup and use the existing XmlMapper with the given id.
+| prettyPrint | false | Boolean | To enable pretty printing output nicely formatted. Is by default false.
+| unmarshalTypeName |  | String | Class name of the java type to use when unarmshalling
+| jsonView |  | Class<?> | When marshalling a POJO to JSON you might want to exclude certain fields from the JSON output. With Jackson you can use JSON views to accomplish this. This option is to refer to the class which has JsonView annotations
+| include |  | String | If you want to marshal a pojo to JSON and the pojo has some fields with null values. And you want to skip these null values you can set this option to NOT_NULL
+| allowJmsType | false | Boolean | Used for JMS users to allow the JMSType header from the JMS spec to specify a FQN classname to use to unmarshal to.
+| collectionTypeName |  | String | Refers to a custom collection type to lookup in the registry to use. This option should rarely be used but allows to use different collection types than java.util.Collection based as default.
+| useList | false | Boolean | To unarmshal to a List of Map or a List of Pojo.
+| enableJaxbAnnotationModule | false | Boolean | Whether to enable the JAXB annotations module when using jackson. When enabled then JAXB annotations can be used by Jackson.
+| moduleClassNames |  | String | To use custom Jackson modules com.fasterxml.jackson.databind.Module specified as a String with FQN class names. Multiple classes can be separated by comma.
+| moduleRefs |  | String | To use custom Jackson modules referred from the Camel registry. Multiple modules can be separated by comma.
+| enableFeatures |  | String | Set of features to enable on the Jackson com.fasterxml.jackson.databind.ObjectMapper. The features should be a name that matches a enum from com.fasterxml.jackson.databind.SerializationFeature com.fasterxml.jackson.databind.DeserializationFeature or com.fasterxml.jackson.databind.MapperFeature Multiple features can be separated by comma
+| disableFeatures |  | String | Set of features to disable on the Jackson com.fasterxml.jackson.databind.ObjectMapper. The features should be a name that matches a enum from com.fasterxml.jackson.databind.SerializationFeature com.fasterxml.jackson.databind.DeserializationFeature or com.fasterxml.jackson.databind.MapperFeature Multiple features can be separated by comma
+|=======================================================================
+{% endraw %}
+// dataformat options: END
+
+
+[[JacksonXML-UsingJacksonXMLinSpringDSL]]
+Using Jackson XML in Spring DSL
++++++++++++++++++++++++++++++++
+
+When using�link:data-format.html[Data Format]�in Spring DSL you need to
+declare the data formats first. This is done in the�*DataFormats*�XML
+tag.
+
+[source,xml]
+-----------------------------------------------------------------------------------------------------------------------------
+        <dataFormats>
+            <!-- here we define a Xml data format with the id jack and that it should use the TestPojo as the class type when
+                 doing unmarshal. The unmarshalTypeName is optional, if not provided Camel will use a Map as the type -->
+            <jacksonxml id="jack" unmarshalTypeName="org.apache.camel.component.jacksonxml.TestPojo"/>
+        </dataFormats>
+-----------------------------------------------------------------------------------------------------------------------------
+
+And then you can refer to this id in the route:
+
+[source,xml]
+-------------------------------------
+       <route>
+            <from uri="direct:back"/>
+            <unmarshal ref="jack"/>
+            <to uri="mock:reverse"/>
+        </route>
+-------------------------------------
+
+[[JacksonXML-ExcludingPOJOfieldsfrommarshalling]]
+Excluding POJO fields from marshalling
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When marshalling a POJO to XML you might want to exclude certain fields
+from the XML output. With Jackson you can
+use�http://wiki.fasterxml.com/JacksonJsonViews[JSON views]�to accomplish
+this. First create one or more marker classes.
+
+Use the marker classes with the�`@JsonView`�annotation to
+include/exclude certain fields. The annotation also works on getters.
+
+Finally use the Camel�`JacksonXMLDataFormat`�to marshall the above POJO
+to XML.
+
+Note that the weight field is missing in the resulting XML:
+
+[source,java]
+----------------------------
+<pojo age="30" weight="70"/>
+----------------------------
+
+[[JacksonXML-Include/ExcludefieldsusingthejsonViewattributewithJacksonXMLDataFormat]]
+Include/Exclude fields using the�`jsonView`�attribute with�`JacksonXML`DataFormat
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+As an example of using this attribute you can instead of:
+
+[source,java]
+---------------------------------------------------------------------------------------------------
+JacksonXMLDataFormat ageViewFormat = new JacksonXMLDataFormat(TestPojoView.class, Views.Age.class);
+from("direct:inPojoAgeView").
+  marshal(ageViewFormat);
+---------------------------------------------------------------------------------------------------
+
+Directly specify your�http://wiki.fasterxml.com/JacksonJsonViews[JSON
+view]�inside the Java DSL as:
+
+[source,java]
+------------------------------------------------------------
+from("direct:inPojoAgeView").
+  marshal().jacksonxml(TestPojoView.class, Views.Age.class);
+------------------------------------------------------------
+
+And the same in XML DSL:
+
+[source,xml]
+---------------------------------------------------------------------------------------------------------------------------------------------------
+<from uri="direct:inPojoAgeView"/>
+  <marshal>
+    <jacksonxml unmarshalTypeName="org.apache.camel.component.jacksonxml.TestPojoView" jsonView="org.apache.camel.component.jacksonxml.Views$Age"/>
+  </marshal>
+---------------------------------------------------------------------------------------------------------------------------------------------------
+
+[[JacksonXML-Settingserializationincludeoption]]
+Setting serialization include option
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you want to marshal a pojo to XML, and the pojo has some fields with
+null values. And you want to skip these null values, then you need to
+set either an annotation on the pojo,�
+
+[source,java]
+------------------------------
+@JsonInclude(Include.NON_NULL)
+public class MyPojo {
+   ...
+}
+------------------------------
+
+But this requires you to include that annotation in your pojo source
+code. You can also configure the Camel JacksonXMLDataFormat to set the
+include option, as shown below:
+
+[source,java]
+---------------------------------------------------------
+JacksonXMLDataFormat format = new JacksonXMLDataFormat();
+format.setInclude("NON_NULL");
+---------------------------------------------------------
+
+Or from XML DSL you configure this as
+
+[source,java]
+------------------------------------------------------
+    <dataFormats>
+      <jacksonxml id="jacksonxml" include="NOT_NULL"/>
+    </dataFormats>
+------------------------------------------------------
+
+[[JacksonXML-UnmarshallingfromXMLtoPOJOwithdynamicclassname]]
+Unmarshalling from XML to POJO with dynamic class name
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you use jackson to unmarshal XML to POJO, then you can now specify a
+header in the message that indicate which class name to unmarshal to. +
+The header has key�`CamelJacksonUnmarshalType`�if that header is present
+in the message, then Jackson will use that as FQN for the POJO class to
+unmarshal the XML payload as.
+
+�For JMS end users there is the JMSType header from the JMS spec that
+indicates that also. To enable support for JMSType you would need to
+turn that on, on the jackson data format as shown:
+
+[source,java]
+---------------------------------------------------
+JacksonDataFormat format = new JacksonDataFormat();
+format.setAllowJmsType(true);
+---------------------------------------------------
+
+Or from XML DSL you configure this as
+
+[source,java]
+-------------------------------------------------------
+    <dataFormats>
+      <jacksonxml id="jacksonxml" allowJmsType="true"/>
+    </dataFormats>
+-------------------------------------------------------
+
+[[JacksonXML-UnmarshallingfromXMLtoListMaporListPojo]]
+Unmarshalling from XML�to List<Map> or List<pojo>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you are using Jackson to unmarshal XML to a list of map/pojo, you can
+now specify this by setting�`useList="true"`�or use
+the�`org.apache.camel.component.jacksonxml.ListJacksonXMLDataFormat`.
+For example with Java you can do as shown below:
+
+[source,java]
+-------------------------------------------------------------
+JacksonXMLDataFormat format = new ListJacksonXMLDataFormat();
+// or
+JacksonXMLDataFormat format = new JacksonXMLDataFormat();
+format.useList();
+// and you can specify the pojo class type also
+format.setUnmarshalType(MyPojo.class);
+-------------------------------------------------------------
+
+And if you use XML DSL then you configure to use list
+using�`useList`�attribute as shown below:
+
+[source,java]
+--------------------------------------------
+    <dataFormats>
+      <jacksonxml id="jack" useList="true"/>
+    </dataFormats>
+--------------------------------------------
+
+And you can specify the pojo type also
+
+[source,java]
+-------------------------------------------------------------------------------
+    <dataFormats>
+      <jacksonxml id="jack" useList="true" unmarshalTypeName="com.foo.MyPojo"/>
+    </dataFormats>
+-------------------------------------------------------------------------------
+
+[[JacksonXML-UsingcustomJacksonmodules]]
+Using custom Jackson modules
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can use custom Jackson modules by specifying the class names of
+those using the moduleClassNames option as shown below.
+
+[source,java]
+-----------------------------------------------------------------------------------------------------------------------------------------
+    <dataFormats>
+      <jacksonxml id="jack" useList="true" unmarshalTypeName="com.foo.MyPojo" moduleClassNames="com.foo.MyModule,com.foo.MyOtherModule"/>
+    </dataFormats>
+-----------------------------------------------------------------------------------------------------------------------------------------
+
+When using�moduleClassNames then the custom jackson modules are not
+configured, by created using default constructor and used as-is. If a
+custom module needs any custom configuration, then an instance of the
+module can be created and configured, and then use modulesRefs to refer
+to the module as shown below:
+
+[source,java]
+------------------------------------------------------------------------------------------------------------------
+    <bean id="myJacksonModule" class="com.foo.MyModule">
+      ... // configure the module as you want
+    </bean>
+�
+    <dataFormats>
+      <jacksonxml id="jacksonxml" useList="true" unmarshalTypeName="com.foo.MyPojo" moduleRefs="myJacksonModule"/>
+    </dataFormats>
+------------------------------------------------------------------------------------------------------------------
+
+�Multiple modules can be specified separated by comma, such as
+moduleRefs="myJacksonModule,myOtherModule"
+
+[[JacksonXML-EnablingordisablefeaturesusingJackson]]
+Enabling or disable features using Jackson
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Jackson has a number of features you can enable or disable, which its
+ObjectMapper uses. For example to disable failing on unknown properties
+when marshalling, you can configure this using the disableFeatures:
+
+[source,java]
+-------------------------------------------------------------------------------------------------------------------
+ <dataFormats>
+      <jacksonxml id="jacksonxml" unmarshalTypeName="com.foo.MyPojo" disableFeatures="FAIL_ON_UNKNOWN_PROPERTIES"/>
+ </dataFormats>
+-------------------------------------------------------------------------------------------------------------------
+
+You can disable multiple features by separating the values using comma.
+The values for the features must be the name of the enums from Jackson
+from the following enum classes
+
+* com.fasterxml.jackson.databind.SerializationFeature
+* com.fasterxml.jackson.databind.DeserializationFeature
+* com.fasterxml.jackson.databind.MapperFeature
+
+To enable a feature use the enableFeatures options instead.
+
+From Java code you can use the type safe methods from camel-jackson
+module:
+
+[source,java]
+----------------------------------------------------------------------
+JacksonDataFormat df = new JacksonDataFormat(MyPojo.class);
+df.disableFeature(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
+df.disableFeature(DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES);
+----------------------------------------------------------------------
+
+[[JacksonXML-ConvertingMapstoPOJOusingJackson]]
+Converting Maps to POJO using Jackson
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Jackson�`ObjectMapper`�can be used to convert maps to POJO objects.
+Jackson component comes with the data converter that can be used to
+convert�`java.util.Map`�instance to non-String, non-primitive and
+non-Number objects.
+
+[source,java]
+----------------------------------------------------------------
+Map<String, Object> invoiceData = new HashMap<String, Object>();
+invoiceData.put("netValue", 500);
+producerTemplate.sendBody("direct:mapToInvoice", invoiceData);
+...
+// Later in the processor
+Invoice invoice = exchange.getIn().getBody(Invoice.class);
+----------------------------------------------------------------
+
+If there is a single�`ObjectMapper`�instance available in the Camel
+registry, it will used by the converter to perform the conversion.
+Otherwise the default mapper will be used. �
+
+[[JacksonXML-FormattedXMLmarshallingpretty-printing]]
+Formatted XML marshalling (pretty-printing)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Using the�`prettyPrint`�option�one can output a well formatted XML�while
+marshalling:
+
+[source,java]
+------------------------------------------------
+ <dataFormats>
+      <jacksonxml id="jack" prettyPrint="true"/>
+ </dataFormats>
+------------------------------------------------
+
+And in Java DSL:
+
+[source,java]
+---------------------------------------------------
+from("direct:inPretty").marshal().jacksonxml(true);
+---------------------------------------------------
+
+Please note that there are 5 different overloaded�`jacksonxml()`�DSL
+methods which support the�`prettyPrint`�option in combination with other
+settings for�`unmarshalType`,�`jsonView`�etc.�
+
+[[JacksonXML-Dependencies]]
+Dependencies
+^^^^^^^^^^^^
+
+To use Jackson XML in your camel routes you need to add the dependency
+on *camel-jacksonxml* which implements this data format.
+
+If you use maven you could just add the following to your pom.xml,
+substituting the version number for the latest & greatest release (see
+link:download.html[the download page for the latest versions]).
+
+[source,xml]
+----------------------------------------------------------
+<dependency>
+  <groupId>org.apache.camel</groupId>
+  <artifactId>camel-jacksonxml</artifactId>
+  <version>x.x.x</version>
+  <!-- use the same version as your Camel core version -->
+</dependency>
+----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-johnzon/src/main/docs/johnzon.adoc
----------------------------------------------------------------------
diff --git a/components/camel-johnzon/src/main/docs/johnzon.adoc b/components/camel-johnzon/src/main/docs/johnzon.adoc
deleted file mode 100644
index 53c77cc..0000000
--- a/components/camel-johnzon/src/main/docs/johnzon.adoc
+++ /dev/null
@@ -1,36 +0,0 @@
-[[Johnzon-Johnzon]]
-Johnzon
-~~~~~~~
-
-*Available as of Camel 2.18*
-
-Johnzon is a link:data-format.html[Data Format] which uses the
-http://johnzon.apache.org/[Johnzon Library]
-
-[source,java]
--------------------------------
-from("activemq:My.Queue").
-  marshal().json(JsonLibrary.Johnzon).
-  to("mqseries:Another.Queue");
--------------------------------
-
-[[Johnzon-Dependencies]]
-Dependencies
-^^^^^^^^^^^^
-
-To use Johnzon in your camel routes you need to add the dependency
-on *camel-johnzon* which implements this data format.
-
-If you use maven you could just add the following to your pom.xml,
-substituting the version number for the latest & greatest release (see
-link:download.html[the download page for the latest versions]).
-
-[source,xml]
-----------------------------------------------------------
-<dependency>
-  <groupId>org.apache.camel</groupId>
-  <artifactId>camel-johnzon</artifactId>
-  <version>x.x.x</version>
-  <!-- use the same version as your Camel core version -->
-</dependency>
-----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-johnzon/src/main/docs/json-johnzon-dataformat.adoc
----------------------------------------------------------------------
diff --git a/components/camel-johnzon/src/main/docs/json-johnzon-dataformat.adoc b/components/camel-johnzon/src/main/docs/json-johnzon-dataformat.adoc
new file mode 100644
index 0000000..043c721
--- /dev/null
+++ b/components/camel-johnzon/src/main/docs/json-johnzon-dataformat.adoc
@@ -0,0 +1,72 @@
+[[Johnzon-Johnzon]]
+Johnzon
+~~~~~~~
+
+*Available as of Camel 2.18*
+
+Johnzon is a link:data-format.html[Data Format] which uses the
+http://johnzon.apache.org/[Johnzon Library]
+
+[source,java]
+-------------------------------
+from("activemq:My.Queue").
+  marshal().json(JsonLibrary.Johnzon).
+  to("mqseries:Another.Queue");
+-------------------------------
+
+[[Johnzon-Options]]
+Johnzon Options
+^^^^^^^^^^^^^^^
+
+
+
+// dataformat options: START
+The JSon Johnzon dataformat supports 15 options which are listed below.
+
+
+
+{% raw %}
+[width="100%",cols="2s,1m,1m,6",options="header"]
+|=======================================================================
+| Name | Default | Java Type | Description
+| objectMapper |  | String | Lookup and use the existing ObjectMapper with the given id when using Jackson.
+| prettyPrint | false | Boolean | To enable pretty printing output nicely formatted. Is by default false.
+| library | Johnzon | JsonLibrary | Which json library to use.
+| unmarshalTypeName |  | String | Class name of the java type to use when unarmshalling
+| jsonView |  | Class<?> | When marshalling a POJO to JSON you might want to exclude certain fields from the JSON output. With Jackson you can use JSON views to accomplish this. This option is to refer to the class which has JsonView annotations
+| include |  | String | If you want to marshal a pojo to JSON and the pojo has some fields with null values. And you want to skip these null values you can set this option to NOT_NULL
+| allowJmsType | false | Boolean | Used for JMS users to allow the JMSType header from the JMS spec to specify a FQN classname to use to unmarshal to.
+| collectionTypeName |  | String | Refers to a custom collection type to lookup in the registry to use. This option should rarely be used but allows to use different collection types than java.util.Collection based as default.
+| useList | false | Boolean | To unarmshal to a List of Map or a List of Pojo.
+| enableJaxbAnnotationModule | false | Boolean | Whether to enable the JAXB annotations module when using jackson. When enabled then JAXB annotations can be used by Jackson.
+| moduleClassNames |  | String | To use custom Jackson modules com.fasterxml.jackson.databind.Module specified as a String with FQN class names. Multiple classes can be separated by comma.
+| moduleRefs |  | String | To use custom Jackson modules referred from the Camel registry. Multiple modules can be separated by comma.
+| enableFeatures |  | String | Set of features to enable on the Jackson com.fasterxml.jackson.databind.ObjectMapper. The features should be a name that matches a enum from com.fasterxml.jackson.databind.SerializationFeature com.fasterxml.jackson.databind.DeserializationFeature or com.fasterxml.jackson.databind.MapperFeature Multiple features can be separated by comma
+| disableFeatures |  | String | Set of features to disable on the Jackson com.fasterxml.jackson.databind.ObjectMapper. The features should be a name that matches a enum from com.fasterxml.jackson.databind.SerializationFeature com.fasterxml.jackson.databind.DeserializationFeature or com.fasterxml.jackson.databind.MapperFeature Multiple features can be separated by comma
+| permissions |  | String | Adds permissions that controls which Java packages and classes XStream is allowed to use during unmarshal from xml/json to Java beans. A permission must be configured either here or globally using a JVM system property. The permission can be specified in a syntax where a plus sign is allow and minus sign is deny. Wildcards is supported by using . as prefix. For example to allow com.foo and all subpackages then specfy com.foo.. Multiple permissions can be configured separated by comma such as com.foo.-com.foo.bar.MySecretBean. The following default permission is always included: -java.lang.java.util. unless its overridden by specifying a JVM system property with they key org.apache.camel.xstream.permissions.
+|=======================================================================
+{% endraw %}
+// dataformat options: END
+
+
+
+[[Johnzon-Dependencies]]
+Dependencies
+^^^^^^^^^^^^
+
+To use Johnzon in your camel routes you need to add the dependency
+on *camel-johnzon* which implements this data format.
+
+If you use maven you could just add the following to your pom.xml,
+substituting the version number for the latest & greatest release (see
+link:download.html[the download page for the latest versions]).
+
+[source,xml]
+----------------------------------------------------------
+<dependency>
+  <groupId>org.apache.camel</groupId>
+  <artifactId>camel-johnzon</artifactId>
+  <version>x.x.x</version>
+  <!-- use the same version as your Camel core version -->
+</dependency>
+----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-josql/src/main/docs/josql.adoc
----------------------------------------------------------------------
diff --git a/components/camel-josql/src/main/docs/josql.adoc b/components/camel-josql/src/main/docs/josql.adoc
deleted file mode 100644
index d0d1043..0000000
--- a/components/camel-josql/src/main/docs/josql.adoc
+++ /dev/null
@@ -1,82 +0,0 @@
-[[SQL-SQLLanguage]]
-SQL Language
-~~~~~~~~~~~~
-
-The SQL support is added by http://josql.sourceforge.net/[JoSQL] and is
-primarily used for performing SQL queries on in-memory objects. If you
-prefer to perform actual database queries then check out the
-link:jpa.html[JPA] component.
-
-*Looking for the SQL component*
-
-Camel has both a link:sql.html[SQL] language and a
-link:sql-component.html[SQL Component]. This page is about the SQL
-language. Click on link:sql-component.html[SQL Component] if you are
-looking for the component instead.
-
-To use SQL in your camel routes you need to add the a dependency on
-*camel-josql* which implements the SQL language.
-
-If you use maven you could just add the following to your pom.xml,
-substituting the version number for the latest & greatest release (see
-link:download.html[the download page for the latest versions]).
-
-[source,xml]
-----------------------------------------------------------
-<dependency>
-  <groupId>org.apache.camel</groupId>
-  <artifactId>camel-josql</artifactId>
-  <version>x.x.x</version>
-  <!-- use the same version as your Camel core version -->
-</dependency>
-----------------------------------------------------------
-
-Camel supports http://en.wikipedia.org/wiki/SQL[SQL] to allow an
-link:expression.html[Expression] or link:predicate.html[Predicate] to be
-used in the link:dsl.html[DSL] or link:xml-configuration.html[Xml
-Configuration]. For example you could use SQL to create an
-link:predicate.html[Predicate] in a link:message-filter.html[Message
-Filter] or as an link:expression.html[Expression] for a
-link:recipient-list.html[Recipient List].
-
-[source,java]
------------------------------------------------------------------------
-from("queue:foo").setBody().sql("select * from MyType").to("queue:bar")
------------------------------------------------------------------------
-
-And the spring DSL:
-
-[source,xml]
---------------------------------------
-   <from uri="queue:foo"/>
-   <setBody>
-       <sql>select * from MyType</sql>
-   </setBody>
-   <to uri="queue:bar"/>
---------------------------------------
-
-[[SQL-Options]]
-Options
-^^^^^^^
-
-// component options: START
-// component options: END
-
-// endpoint options: START
-// endpoint options: END
-
-[[SQL-Loadingscriptfromexternalresource]]
-Loading script from external resource
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-*Available as of 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"`,
-eg to refer to a file on the classpath you can do:
-
-[source,java]
-----------------------------------------------------------
-.setHeader("myHeader").sql("resource:classpath:mysql.sql")
-----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-josql/src/main/docs/sql-language.adoc
----------------------------------------------------------------------
diff --git a/components/camel-josql/src/main/docs/sql-language.adoc b/components/camel-josql/src/main/docs/sql-language.adoc
new file mode 100644
index 0000000..5447b77
--- /dev/null
+++ b/components/camel-josql/src/main/docs/sql-language.adoc
@@ -0,0 +1,92 @@
+[[SQL-SQLLanguage]]
+SQL Language
+~~~~~~~~~~~~
+
+The SQL support is added by http://josql.sourceforge.net/[JoSQL] and is
+primarily used for performing SQL queries on in-memory objects. If you
+prefer to perform actual database queries then check out the
+link:jpa.html[JPA] component.
+
+*Looking for the SQL component*
+
+Camel has both a link:sql.html[SQL] language and a
+link:sql-component.html[SQL Component]. This page is about the SQL
+language. Click on link:sql-component.html[SQL Component] if you are
+looking for the component instead.
+
+To use SQL in your camel routes you need to add the a dependency on
+*camel-josql* which implements the SQL language.
+
+If you use maven you could just add the following to your pom.xml,
+substituting the version number for the latest & greatest release (see
+link:download.html[the download page for the latest versions]).
+
+[source,xml]
+----------------------------------------------------------
+<dependency>
+  <groupId>org.apache.camel</groupId>
+  <artifactId>camel-josql</artifactId>
+  <version>x.x.x</version>
+  <!-- use the same version as your Camel core version -->
+</dependency>
+----------------------------------------------------------
+
+Camel supports http://en.wikipedia.org/wiki/SQL[SQL] to allow an
+link:expression.html[Expression] or link:predicate.html[Predicate] to be
+used in the link:dsl.html[DSL] or link:xml-configuration.html[Xml
+Configuration]. For example you could use SQL to create an
+link:predicate.html[Predicate] in a link:message-filter.html[Message
+Filter] or as an link:expression.html[Expression] for a
+link:recipient-list.html[Recipient List].
+
+[source,java]
+-----------------------------------------------------------------------
+from("queue:foo").setBody().sql("select * from MyType").to("queue:bar")
+-----------------------------------------------------------------------
+
+And the spring DSL:
+
+[source,xml]
+--------------------------------------
+   <from uri="queue:foo"/>
+   <setBody>
+       <sql>select * from MyType</sql>
+   </setBody>
+   <to uri="queue:bar"/>
+--------------------------------------
+
+[[SQL-Options]]
+Options
+^^^^^^^
+
+
+// language options: START
+The SQL language supports 1 options which are listed below.
+
+
+
+{% raw %}
+[width="100%",cols="2s,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
+
+
+[[SQL-Loadingscriptfromexternalresource]]
+Loading script from external resource
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+*Available as of 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"`,
+eg to refer to a file on the classpath you can do:
+
+[source,java]
+----------------------------------------------------------
+.setHeader("myHeader").sql("resource:classpath:mysql.sql")
+----------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-juel/src/main/docs/el-language.adoc
----------------------------------------------------------------------
diff --git a/components/camel-juel/src/main/docs/el-language.adoc b/components/camel-juel/src/main/docs/el-language.adoc
new file mode 100644
index 0000000..86625fe
--- /dev/null
+++ b/components/camel-juel/src/main/docs/el-language.adoc
@@ -0,0 +1,115 @@
+[[EL-EL]]
+EL
+~~
+
+Camel supports the unified JSP and JSF Expression Language via the
+http://juel.sourceforge.net/[JUEL] to allow an
+link:expression.html[Expression] or link:predicate.html[Predicate] to be
+used in the link:dsl.html[DSL] or link:xml-configuration.html[Xml
+Configuration].
+
+For example you could use EL inside a link:message-filter.html[Message
+Filter] in XML
+
+[source,xml]
+---------------------------------------
+<route>
+  <from uri="seda:foo"/>
+  <filter>
+    <el>${in.headers.foo == 'bar'}</el>
+    <to uri="seda:bar"/>
+  </filter>
+</route>
+---------------------------------------
+
+You could also use slightly different syntax, e.g. if the header name is
+not a valid identifier:
+
+[source,xml]
+------------------------------------------------
+<route>
+  <from uri="seda:foo"/>
+  <filter>
+    <el>${in.headers['My Header'] == 'bar'}</el>
+    <to uri="seda:bar"/>
+  </filter>
+</route>
+------------------------------------------------
+
+You could use EL to create an link:predicate.html[Predicate] in a
+link:message-filter.html[Message Filter] or as an
+link:expression.html[Expression] for a
+link:recipient-list.html[Recipient List]
+
+[[EL-Options]]
+EL Options
+^^^^^^^^^^
+
+
+
+// language options: START
+The EL language supports 1 options which are listed below.
+
+
+
+{% raw %}
+[width="100%",cols="2s,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
+
+
+
+[[EL-Variables]]
+Variables
+^^^^^^^^^
+
+[width="100%",cols="10%,10%,80%",options="header",]
+|=======================================================================
+|Variable |Type |Description
+
+|exchange |Exchange |the Exchange object
+
+|in |Message |the exchange.in message
+
+|out |Message |the exchange.out message
+|=======================================================================
+
+[[EL-Samples]]
+Samples
+^^^^^^^
+
+You can use EL dot notation to invoke operations. If you for instance
+have a body that contains a POJO that has a `getFamiliyName` method then
+you can construct the syntax as follows:
+
+[source,java]
+-----------------------
+"${in.body.familyName}"
+-----------------------
+
+[[EL-Dependencies]]
+Dependencies
+^^^^^^^^^^^^
+
+To use EL in your camel routes you need to add the a dependency on
+*camel-juel* which implements the EL language.
+
+If you use maven you could just add the following to your pom.xml,
+substituting the version number for the latest & greatest release (see
+link:download.html[the download page for the latest versions]).
+
+[source,java]
+-------------------------------------
+<dependency>
+  <groupId>org.apache.camel</groupId>
+  <artifactId>camel-juel</artifactId>
+  <version>x.x.x</version>
+</dependency>
+-------------------------------------
+
+Otherwise you'll also need to include
+http://repo2.maven.org/maven2/de/odysseus/juel/juel/2.1.3/juel-2.1.3.jar[JUEL].

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-juel/src/main/docs/juel.adoc
----------------------------------------------------------------------
diff --git a/components/camel-juel/src/main/docs/juel.adoc b/components/camel-juel/src/main/docs/juel.adoc
deleted file mode 100644
index e79b29f..0000000
--- a/components/camel-juel/src/main/docs/juel.adoc
+++ /dev/null
@@ -1,93 +0,0 @@
-[[EL-EL]]
-EL
-~~
-
-Camel supports the unified JSP and JSF Expression Language via the
-http://juel.sourceforge.net/[JUEL] to allow an
-link:expression.html[Expression] or link:predicate.html[Predicate] to be
-used in the link:dsl.html[DSL] or link:xml-configuration.html[Xml
-Configuration].
-
-For example you could use EL inside a link:message-filter.html[Message
-Filter] in XML
-
-[source,xml]
----------------------------------------
-<route>
-  <from uri="seda:foo"/>
-  <filter>
-    <el>${in.headers.foo == 'bar'}</el>
-    <to uri="seda:bar"/>
-  </filter>
-</route>
----------------------------------------
-
-You could also use slightly different syntax, e.g. if the header name is
-not a valid identifier:
-
-[source,xml]
-------------------------------------------------
-<route>
-  <from uri="seda:foo"/>
-  <filter>
-    <el>${in.headers['My Header'] == 'bar'}</el>
-    <to uri="seda:bar"/>
-  </filter>
-</route>
-------------------------------------------------
-
-You could use EL to create an link:predicate.html[Predicate] in a
-link:message-filter.html[Message Filter] or as an
-link:expression.html[Expression] for a
-link:recipient-list.html[Recipient List]
-
-[[EL-Variables]]
-Variables
-^^^^^^^^^
-
-[width="100%",cols="10%,10%,80%",options="header",]
-|=======================================================================
-|Variable |Type |Description
-
-|exchange |Exchange |the Exchange object
-
-|in |Message |the exchange.in message
-
-|out |Message |the exchange.out message
-|=======================================================================
-
-[[EL-Samples]]
-Samples
-^^^^^^^
-
-You can use EL dot notation to invoke operations. If you for instance
-have a body that contains a POJO that has a `getFamiliyName` method then
-you can construct the syntax as follows:
-
-[source,java]
------------------------
-"${in.body.familyName}"
------------------------
-
-[[EL-Dependencies]]
-Dependencies
-^^^^^^^^^^^^
-
-To use EL in your camel routes you need to add the a dependency on
-*camel-juel* which implements the EL language.
-
-If you use maven you could just add the following to your pom.xml,
-substituting the version number for the latest & greatest release (see
-link:download.html[the download page for the latest versions]).
-
-[source,java]
--------------------------------------
-<dependency>
-  <groupId>org.apache.camel</groupId>
-  <artifactId>camel-juel</artifactId>
-  <version>x.x.x</version>
-</dependency>
--------------------------------------
-
-Otherwise you'll also need to include
-http://repo2.maven.org/maven2/de/odysseus/juel/juel/2.1.3/juel-2.1.3.jar[JUEL].

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-snakeyaml/src/main/docs/yaml-snakeyaml-dataformat.adoc
----------------------------------------------------------------------
diff --git a/components/camel-snakeyaml/src/main/docs/yaml-snakeyaml-dataformat.adoc b/components/camel-snakeyaml/src/main/docs/yaml-snakeyaml-dataformat.adoc
new file mode 100644
index 0000000..9cba881
--- /dev/null
+++ b/components/camel-snakeyaml/src/main/docs/yaml-snakeyaml-dataformat.adoc
@@ -0,0 +1,148 @@
+[[YAMLDataFormat-YAML]]
+YAML
+~~~~
+
+YAML is a�link:data-format.html[Data Format]�to marshal and unmarshal
+Java objects to and from�http://www.yaml.org/[YAML].
+
+For YAML to object marshalling, Camel provides integration with three
+popular YAML libraries:
+
+* The�http://www.snakeyaml.org/[SnakeYAML] library
+
+Every library requires adding the special camel component (see
+"Dependency..." paragraphs further down). By default Camel uses the
+SnakeYAML library.
+
+[[YAMLDataFormat-UsingYAMLdataformatwiththeSnakeYAMLlibrary]]
+Using YAML data format with the SnakeYAML library
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+[source,java]
+------------------------------------------------------------
+// lets turn Object messages into yaml then send to MQSeries
+from("activemq:My.Queue")
+  .marshal().yaml()
+  .to("mqseries:Another.Queue");
+------------------------------------------------------------
+
+[source,java]
+------------------------------------------------------------
+// lets turn Object messages into yaml then send to MQSeries
+from("activemq:My.Queue")
+  .marshal().yaml(YAMLLibrary.SnakeYAML)
+  .to("mqseries:Another.Queue");
+------------------------------------------------------------
+
+[[YAML-Options]]
+YAML Options
+^^^^^^^^^^^^
+
+
+
+// dataformat options: START
+The YAML SnakeYAML dataformat supports 8 options which are listed below.
+
+
+
+{% raw %}
+[width="100%",cols="2s,1m,1m,6",options="header"]
+|=======================================================================
+| Name | Default | Java Type | Description
+| library | SnakeYAML | YAMLLibrary | Which yaml library to use such. Is by default SnakeYAML
+| unmarshalTypeName |  | String | Class name of the java type to use when unarmshalling
+| constructor |  | String | BaseConstructor to construct incoming documents.
+| representer |  | String | Representer to emit outgoing objects.
+| dumperOptions |  | String | DumperOptions to configure outgoing objects.
+| resolver |  | String | Resolver to detect implicit type
+| useApplicationContextClassLoader | true | Boolean | Use ApplicationContextClassLoader as custom ClassLoader
+| prettyFlow | false | Boolean | Force the emitter to produce a pretty YAML document when using the flow style.
+|=======================================================================
+{% endraw %}
+// dataformat options: END
+
+
+
+[[YAMLDataFormat-UsingYAMLinSpringDSL]]
+Using YAML in Spring DSL
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+When using�link:data-format.html[Data Format]�in Spring DSL you need to
+declare the data formats first. This is done in the�*DataFormats*�XML
+tag.
+
+[source,xml]
+----------------------------------------------------------------------------------------------------------------------------------
+        <dataFormats>
+            <!-- here we define a YAML data format with the id snak and that it should use the TestPojo as the class type when
+                 doing unmarshal. The unmarshalTypeName is optional, if not provided Camel will use a Object.class as the type -->
+            <yaml id="snake" library="SnakeYAML" unmarshalTypeName="org.apache.camel.component.yaml.model.TestPojo"/>
+        </dataFormats>
+----------------------------------------------------------------------------------------------------------------------------------
+
+And then you can refer to this id in the route:
+
+[source,xml]
+-------------------------------------
+       <route>
+            <from uri="direct:back"/>
+            <unmarshal ref="snake"/>
+            <to uri="mock:reverse"/>
+        </route>
+-------------------------------------
+
+�
+
+[[YAMLDataFormat-OptionsforSnakeYAMLDataFormat]]
+Options for SnakeYAML Data Format
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+[width="100%",cols="<25%,<25%,<25%,<25%",options="header",]
+|=======================================================================
+|Name |Type |Default |Description
+|unmarshalType |`Class` |`Object.class` |Class of the object to be created
+
+|classLoader |ClassLoader |null |The classloader to use to
+instantiate objects
+
+|constructor |String |null |A reference to an 
+org.yaml.snakeyaml.constructor.BaseConstructor instance in the registry
+
+|representer |String |null |A reference to an 
+org.yaml.snakeyaml.representer.Representer instance in the registry
+
+|dumperOptions |String |null |A reference to an 
+org.yaml.snakeyaml.DumperOptions instance in the registry
+
+|resolver |String |null |A reference to an 
+org.yaml.snakeyaml.resolver.Resolver instance in the registry
+
+|useApplicationContextClassLoader |�Boolean |true� |To use CamelContext's ApplicationContextClassLoader if no custom class loader is set and
+ApplicationContextClassLoader is provided
+
+|prettyFlow |�Boolean |false� |Force the emitter to produce a pretty YAML document when using the flow style
+|=======================================================================
+
+[[YAMLDataFormat-DependenciesforSnakeYAML]]
+Dependencies for SnakeYAML
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To use YAML in your camel routes you need to add the a dependency
+on�*camel-snakeyaml*�which implements this data format.
+
+If you use maven you could just add the following to your pom.xml,
+substituting the version number for the latest & greatest release
+(see�link:download.html[the download page for the latest versions]).
+
+[source,xml]
+------------------------------------------
+<dependency>
+  <groupId>org.apache.camel</groupId>
+  <artifactId>camel-snakeyaml</artifactId>
+  <version>${camel-version}</version>
+</dependency>
+------------------------------------------
+
+�
+
+�

http://git-wip-us.apache.org/repos/asf/camel/blob/9ecd5635/components/camel-snakeyaml/src/main/docs/yaml.adoc
----------------------------------------------------------------------
diff --git a/components/camel-snakeyaml/src/main/docs/yaml.adoc b/components/camel-snakeyaml/src/main/docs/yaml.adoc
deleted file mode 100644
index cfea419..0000000
--- a/components/camel-snakeyaml/src/main/docs/yaml.adoc
+++ /dev/null
@@ -1,119 +0,0 @@
-[[YAMLDataFormat-YAML]]
-YAML
-~~~~
-
-YAML is a�link:data-format.html[Data Format]�to marshal and unmarshal
-Java objects to and from�http://www.yaml.org/[YAML].
-
-For YAML to object marshalling, Camel provides integration with three
-popular YAML libraries:
-
-* The�http://www.snakeyaml.org/[SnakeYAML] library
-
-Every library requires adding the special camel component (see
-"Dependency..." paragraphs further down). By default Camel uses the
-SnakeYAML library.
-
-[[YAMLDataFormat-UsingYAMLdataformatwiththeSnakeYAMLlibrary]]
-Using YAML data format with the SnakeYAML library
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-[source,java]
-------------------------------------------------------------
-// lets turn Object messages into yaml then send to MQSeries
-from("activemq:My.Queue")
-  .marshal().yaml()
-  .to("mqseries:Another.Queue");
-------------------------------------------------------------
-
-[source,java]
-------------------------------------------------------------
-// lets turn Object messages into yaml then send to MQSeries
-from("activemq:My.Queue")
-  .marshal().yaml(YAMLLibrary.SnakeYAML)
-  .to("mqseries:Another.Queue");
-------------------------------------------------------------
-
-[[YAMLDataFormat-UsingYAMLinSpringDSL]]
-Using YAML in Spring DSL
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-When using�link:data-format.html[Data Format]�in Spring DSL you need to
-declare the data formats first. This is done in the�*DataFormats*�XML
-tag.
-
-[source,xml]
-----------------------------------------------------------------------------------------------------------------------------------
-        <dataFormats>
-            <!-- here we define a YAML data format with the id snak and that it should use the TestPojo as the class type when
-                 doing unmarshal. The unmarshalTypeName is optional, if not provided Camel will use a Object.class as the type -->
-            <yaml id="snake" library="SnakeYAML" unmarshalTypeName="org.apache.camel.component.yaml.model.TestPojo"/>
-        </dataFormats>
-----------------------------------------------------------------------------------------------------------------------------------
-
-And then you can refer to this id in the route:
-
-[source,xml]
--------------------------------------
-       <route>
-            <from uri="direct:back"/>
-            <unmarshal ref="snake"/>
-            <to uri="mock:reverse"/>
-        </route>
--------------------------------------
-
-�
-
-[[YAMLDataFormat-OptionsforSnakeYAMLDataFormat]]
-Options for SnakeYAML Data Format
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-[width="100%",cols="<25%,<25%,<25%,<25%",options="header",]
-|=======================================================================
-|Name |Type |Default |Description
-|unmarshalType |`Class` |`Object.class` |Class of the object to be created
-
-|classLoader |ClassLoader |null |The classloader to use to
-instantiate objects
-
-|constructor |String |null |A reference to an 
-org.yaml.snakeyaml.constructor.BaseConstructor instance in the registry
-
-|representer |String |null |A reference to an 
-org.yaml.snakeyaml.representer.Representer instance in the registry
-
-|dumperOptions |String |null |A reference to an 
-org.yaml.snakeyaml.DumperOptions instance in the registry
-
-|resolver |String |null |A reference to an 
-org.yaml.snakeyaml.resolver.Resolver instance in the registry
-
-|useApplicationContextClassLoader |�Boolean |true� |To use CamelContext's ApplicationContextClassLoader if no custom class loader is set and
-ApplicationContextClassLoader is provided
-
-|prettyFlow |�Boolean |false� |Force the emitter to produce a pretty YAML document when using the flow style
-|=======================================================================
-
-[[YAMLDataFormat-DependenciesforSnakeYAML]]
-Dependencies for SnakeYAML
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-To use YAML in your camel routes you need to add the a dependency
-on�*camel-snakeyaml*�which implements this data format.
-
-If you use maven you could just add the following to your pom.xml,
-substituting the version number for the latest & greatest release
-(see�link:download.html[the download page for the latest versions]).
-
-[source,xml]
-------------------------------------------
-<dependency>
-  <groupId>org.apache.camel</groupId>
-  <artifactId>camel-snakeyaml</artifactId>
-  <version>${camel-version}</version>
-</dependency>
-------------------------------------------
-
-�
-
-�