You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by bu...@apache.org on 2012/09/08 00:36:15 UTC
svn commit: r831334 [3/14] - in /websites/production/camel/content: ./ cache/
Modified: websites/production/camel/content/book-dataformat-appendix.html
==============================================================================
--- websites/production/camel/content/book-dataformat-appendix.html (original)
+++ websites/production/camel/content/book-dataformat-appendix.html Fri Sep 7 22:36:12 2012
@@ -282,7 +282,7 @@ from(<span class="code-quote">"activemq:
</pre>
</div></div>
-<p>This example shows how to configure the data type just once and reuse it on multiple routes. For Camel versions below 1.5.0 you have to set the <jaxb> element directly in <camelContext>.</p>
+<p>This example shows how to configure the data type just once and reuse it on multiple routes.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag"><camelContext id=<span class="code-quote">"camel"</span> xmlns=<span class="code-quote">"http://camel.apache.org/schema/spring"</span>></span>
@@ -355,12 +355,12 @@ JaxbDataFromat supports to ignore the <a
<h3><a shape="rect" name="BookDataFormatAppendix-WorkingwiththeObjectFactory"></a>Working with the ObjectFactory</h3>
-<p>If you use XJC to create the java class from the schema, you will get an ObjectFactory for you JAXB context. Since the ObjectFactory uses <a shape="rect" class="external-link" href="http://java.sun.com/javase/6/docs/api/javax/xml/bind/JAXBElement.html" rel="nofollow">JAXBElement</a> to hold the reference of the schema and element instance value, from Camel 1.5.1 jaxbDataformat will ignore the JAXBElement by default and you will get the element instance value instead of the JAXBElement object form the unmarshaled message body. <br clear="none">
+<p>If you use XJC to create the java class from the schema, you will get an ObjectFactory for you JAXB context. Since the ObjectFactory uses <a shape="rect" class="external-link" href="http://java.sun.com/javase/6/docs/api/javax/xml/bind/JAXBElement.html" rel="nofollow">JAXBElement</a> to hold the reference of the schema and element instance value, jaxbDataformat will ignore the JAXBElement by default and you will get the element instance value instead of the JAXBElement object form the unmarshaled message body. <br clear="none">
If you want to get the JAXBElement object form the unmarshaled message body, you need to set the JaxbDataFormat object's ignoreJAXBElement property to be false.</p>
<h3><a shape="rect" name="BookDataFormatAppendix-Settingencoding"></a>Setting encoding</h3>
-<p>In Camel 1.6.1 and newer you can set the <b>encoding</b> option to use when marshalling. Its the <tt>Marshaller.JAXB_ENCODING</tt> encoding property on the JAXB Marshaller.<br clear="none">
+<p>You can set the <b>encoding</b> option to use when marshalling. Its the <tt>Marshaller.JAXB_ENCODING</tt> encoding property on the JAXB Marshaller.<br clear="none">
You can setup which encoding to use when you declare the JAXB data format. You can also provide the encoding in the <a shape="rect" href="exchange.html" title="Exchange">Exchange</a> property <tt>Exchange.CHARSET_NAME</tt>. This property will overrule the encoding set on the JAXB data format.</p>
<p>In this Spring DSL we have defined to use <tt>iso-8859-1</tt> as the encoding:</p>
@@ -389,7 +389,7 @@ You can setup which encoding to use when
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-jaxb</artifactId>
- <version>1.6.0</version>
+ <version>x.x.x</version>
</dependency>
</pre>
</div></div>
@@ -445,7 +445,7 @@ from(<span class="code-quote">"activemq:
4. Use the platform default XMLInputFactory,XMLOutputFactory instance.</p>
<h3><a shape="rect" name="BookDataFormatAppendix-HowtosettheXMLencodinginXstreamDataFormat%3F"></a>How to set the XML encoding in Xstream DataFormat?</h3>
-<p>From Camel 1.6.3 or Camel 2.2.0, you can set the encoding of XML in Xstream DataFormat by setting the Exchange's property with the key <tt>Exchange.CHARSET_NAME</tt>, or setting the encoding property on Xstream from DSL or Spring config.</p>
+<p>From Camel 2.2.0, you can set the encoding of XML in Xstream DataFormat by setting the Exchange's property with the key <tt>Exchange.CHARSET_NAME</tt>, or setting the encoding property on Xstream from DSL or Spring config.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
from(<span class="code-quote">"activemq:My.Queue"</span>).
@@ -490,7 +490,7 @@ from(<span class="code-quote">"activemq:
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-xstream</artifactId>
- <version>1.5.0</version>
+ <version>x.x.x</version>
</dependency>
</pre>
</div></div>
@@ -502,7 +502,7 @@ from(<span class="code-quote">"activemq:
<h3><a shape="rect" name="BookDataFormatAppendix-Options"></a>Options</h3>
<div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Option </th><th colspan="1" rowspan="1" class="confluenceTh"> Type </th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> config </td><td colspan="1" rowspan="1" class="confluenceTd"> CSVConfig </td><td colspan="1" rowspan="1" class="confluenceTd"> Can be used to set a custom CSVConfig object. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> strategy </td><td colspan="1" rowspan="1" class="confluenceTd"> CSVStrategy </td><td colspan="1" rowspan="1" class="confluenceTd"> Camel uses by default <tt>CSVStrategy.DEFAULT_STRATEGY</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> autogenColumns </td><td colspan="1" rowspan="1" class="confluenceTd"> boolean </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 1.6.1/2.0:</b> Is default true. By default, columns are autogene
rated in the resulting CSV. Subsequent messages use the previously created columns with new fields being added at the end of the line. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> delimiter </td><td colspan="1" rowspan="1" class="confluenceTd"> String </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Is default <tt>,</tt>. Can be used to configure the delimiter, if it's not the comma. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> skipFirstLine </td><td colspan="1" rowspan="1" class="confluenceTd"> boolean </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10:</b> Is default false. While unmarshalling can be used to skip the first line of a CSV input which contains the CSV headers. </td></tr></tbody></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Option </th><th colspan="1" rowspan="1" class="confluenceTh"> Type </th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> config </td><td colspan="1" rowspan="1" class="confluenceTd"> CSVConfig </td><td colspan="1" rowspan="1" class="confluenceTd"> Can be used to set a custom CSVConfig object. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> strategy </td><td colspan="1" rowspan="1" class="confluenceTd"> CSVStrategy </td><td colspan="1" rowspan="1" class="confluenceTd"> Camel uses by default <tt>CSVStrategy.DEFAULT_STRATEGY</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> autogenColumns </td><td colspan="1" rowspan="1" class="confluenceTd"> boolean </td><td colspan="1" rowspan="1" class="confluenceTd"> Is default true. By default, columns are autogenerated in the resulting C
SV. Subsequent messages use the previously created columns with new fields being added at the end of the line. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> delimiter </td><td colspan="1" rowspan="1" class="confluenceTd"> String </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.4:</b> Is default <tt>,</tt>. Can be used to configure the delimiter, if it's not the comma. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> skipFirstLine </td><td colspan="1" rowspan="1" class="confluenceTd"> boolean </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.10:</b> Is default false. While unmarshalling can be used to skip the first line of a CSV input which contains the CSV headers. </td></tr></tbody></table>
</div>
@@ -751,7 +751,7 @@ from(<span class="code-quote">"direct:st
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-csv</artifactId>
- <version>2.0.0</version>
+ <version>x.x.x</version>
</dependency>
</pre>
</div></div>
@@ -876,7 +876,7 @@ from(<span class="code-quote">"seda:peop
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-flatpack</artifactId>
- <version>1.5.0</version>
+ <version>x.x.x</version>
</dependency>
</pre>
</div></div>
@@ -1149,14 +1149,12 @@ from(<span class="code-quote">"file:<spa
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-tagsoup</artifactId>
- <version>1.6.0</version>
+ <version>x.x.x</version>
</dependency>
</pre>
</div></div>
<h2><a shape="rect" name="BookDataFormatAppendix-Bindy"></a>Bindy</h2>
-<p><b>Available as of Camel 2.0</b></p>
-
<p>The idea that the developers has followed to design this component was to allow the parsing/binding of non structured data (or to be more precise non-XML data)<br clear="none">
to Java Bean using annotations. Using Bindy, you can bind data like :</p>
<ul class="alternate" type="square"><li>CSV record,</li><li>Fixedlength record,</li><li>FIX messages,</li><li>or any other non-structured data</li></ul>
@@ -2414,7 +2412,6 @@ from(<span class="code-quote">"direct:ha
</pre>
</div></div>
<h2><a shape="rect" name="BookDataFormatAppendix-XMLSecurityDataFormat"></a>XMLSecurity Data Format</h2>
-<p><b>Available as of Camel 2.0</b></p>
<p>The XMLSecurity DataFormat facilitates encryption and decryption of XML payloads at the Document, Element and Element Content levels (including simultaneous multi-node encryption/decryption using XPATH).</p>
@@ -3303,7 +3300,7 @@ from(<span class="code-quote">"direct:ke
<h3><a shape="rect" name="BookDataFormatAppendix-PGPDataFormatOptions"></a>PGPDataFormat Options</h3>
<div class="confluenceTableSmall"><div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Name </th><th colspan="1" rowspan="1" class="confluenceTh"> Type </th><th colspan="1" rowspan="1" class="confluenceTh"> Default </th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>keyUserid</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>String</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The userid of the key in the pgp keyring </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>password</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>String</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Password used when opening the private key (not used for encryption) </td></tr><tr><td colspan="1" rowspan
="1" class="confluenceTd"> <tt>keyFileName</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>String</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Filename of the keyring, must be accessible as classpathresource </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>armored</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>boolean</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> This option will cause pgp to base64 encode the encrypted text, making it available for copy/paste, etc. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>integrity</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>boolean</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> add a integrity che
ck/sign into the encryption file </td></tr></tbody></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Name </th><th colspan="1" rowspan="1" class="confluenceTh"> Type </th><th colspan="1" rowspan="1" class="confluenceTh"> Default </th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>keyUserid</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>String</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The userid of the key in the pgp keyring </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>password</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>String</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Password used when opening the private key (not used for encryption) </td></tr><tr><td colspan="1" rowspan
="1" class="confluenceTd"> <tt>keyFileName</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>String</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Filename of the keyring, must be accessible as a classpath resource (but you can specify a location in the file system by using the "file:" prefix) </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>armored</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>boolean</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> This option will cause pgp to base64 encode the encrypted text, making it available for copy/paste, etc. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>integrity</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>boolean</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>t
rue</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> add a integrity check/sign into the encryption file </td></tr></tbody></table>
</div>
</div>