Author: buildbot
Date: Thu Jul 18 14:48:00 2013
New Revision: 869978
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/jax-rs-data-bindings.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/jax-rs-data-bindings.html
==============================================================================
--- websites/production/cxf/content/docs/jax-rs-data-bindings.html (original)
+++ websites/production/cxf/content/docs/jax-rs-data-bindings.html Thu Jul 18
14:48:00 2013
@@ -130,7 +130,7 @@ Apache CXF -- JAX-RS Data Bindings
<div id="ConfluenceContent"><p><span style="font-size:2em;font-weight:bold">
JAX-RS : Data Bindings </span></p>
<div>
-<ul><li><a shape="rect" href="#JAX-RSDataBindings-JAXBsupport">JAXB
support</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-ConfiguringJAXBprovider">Configuring JAXB
provider</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-JAXBandMoxy">JAXB and Moxy</a></li></ul><li><a
shape="rect" href="#JAX-RSDataBindings-JSONsupport">JSON
support</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-Jettison">Jettison</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-ConfiguringJSONprovider">Configuring JSON
provider</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-DealingwithJSONarrayserializationissues">Dealing with
JSON array serialization issues</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-BadgerFishconvention">BadgerFish
convention</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-WrappingandUnwrappingJSONsequences">Wrapping and
Unwrapping JSON sequences</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-TypeConverters">TypeConverters</a></li>
</ul><li><a shape="rect"
href="#JAX-RSDataBindings-Jackson">Jackson</a></li></ul><li><a shape="rect"
href="#JAX-RSDataBindings-CommonJAXBandJSONconfiguration">Common JAXB and JSON
configuration</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-SingleJAXBContextandextrauserclasses">Single
JAXBContext and extra user classes</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-AutomaticJAXBElementconversionduringserialization">Automatic
JAXBElement conversion during serialization</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-HandlingJAXBbeanswithoutXmlRootElementannotations">Handling
JAXB beans without XmlRootElement annotations</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-Handlingexplicitcollections">Handling explicit
collections</a></li></ul><li><a shape="rect"
href="#JAX-RSDataBindings-CustomizingJAXBXMLandJSONinputandoutput">Customizing
JAXB XML and JSON input and output</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-ControllingLargeJAXBXMLandJSONin
putpayloads">Controlling Large JAXB XML and JSON input payloads</a></li><li><a
shape="rect" href="#JAX-RSDataBindings-JSONWithPadding%28JSONP%29">JSON With
Padding (JSONP)</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-Formpayloads">Form payloads</a></li><li><a
shape="rect" href="#JAX-RSDataBindings-Atom">Atom</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-AegisDataBinding">Aegis Data Binding</a></li><li><a
shape="rect" href="#JAX-RSDataBindings-XMLBeans">XMLBeans</a></li><li><a
shape="rect" href="#JAX-RSDataBindings-CXFDataBindingsasJAXRSproviders">CXF
DataBindings as JAX-RS providers</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-JAXRSDataBinding">JAXRS DataBinding</a></li><li><a
shape="rect" href="#JAX-RSDataBindings-Schemavalidation">Schema
validation</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-Supportforcatalogs">Support for
catalogs</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-Outputvalidation">Output
validation</a></li></ul><li><a s
hape="rect" href="#JAX-RSDataBindings-FastInfoset">Fast
Infoset</a></li></ul></div>
+<ul><li><a shape="rect" href="#JAX-RSDataBindings-JAXBsupport">JAXB
support</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-ConfiguringJAXBprovider">Configuring JAXB
provider</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-JAXBandMoxy">JAXB and Moxy</a></li></ul><li><a
shape="rect" href="#JAX-RSDataBindings-JSONsupport">JSON
support</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-Jettison">Jettison</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-ConfiguringJSONprovider">Configuring JSON
provider</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-DealingwithJettisonarrayserializationissues">Dealing
with Jettison array serialization issues</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-BadgerFishconvention">BadgerFish
convention</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-WrappingandUnwrappingJSONsequences">Wrapping and
Unwrapping JSON sequences</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-TypeConverters">TypeConverters<
/a></li></ul><li><a shape="rect"
href="#JAX-RSDataBindings-Jackson">Jackson</a></li></ul><li><a shape="rect"
href="#JAX-RSDataBindings-CommonJAXBandJSONconfiguration">Common JAXB and JSON
configuration</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-SingleJAXBContextandextrauserclasses">Single
JAXBContext and extra user classes</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-AutomaticJAXBElementconversionduringserialization">Automatic
JAXBElement conversion during serialization</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-HandlingJAXBbeanswithoutXmlRootElementannotations">Handling
JAXB beans without XmlRootElement annotations</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-Handlingexplicitcollections">Handling explicit
collections</a></li></ul><li><a shape="rect"
href="#JAX-RSDataBindings-CustomizingJAXBXMLandJSONinputandoutput">Customizing
JAXB XML and JSON input and output</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-ControllingLargeJAXBXMLa
ndJSONinputpayloads">Controlling Large JAXB XML and JSON input
payloads</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-JSONWithPadding%28JSONP%29">JSON With Padding
(JSONP)</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-Formpayloads">Form payloads</a></li><li><a
shape="rect" href="#JAX-RSDataBindings-Atom">Atom</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-AegisDataBinding">Aegis Data Binding</a></li><li><a
shape="rect" href="#JAX-RSDataBindings-XMLBeans">XMLBeans</a></li><li><a
shape="rect" href="#JAX-RSDataBindings-CXFDataBindingsasJAXRSproviders">CXF
DataBindings as JAX-RS providers</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-JAXRSDataBinding">JAXRS DataBinding</a></li><li><a
shape="rect" href="#JAX-RSDataBindings-Schemavalidation">Schema
validation</a></li><ul><li><a shape="rect"
href="#JAX-RSDataBindings-Supportforcatalogs">Support for
catalogs</a></li><li><a shape="rect"
href="#JAX-RSDataBindings-Outputvalidation">Output validation</a></li></ul>
<li><a shape="rect" href="#JAX-RSDataBindings-FastInfoset">Fast
Infoset</a></li></ul></div>
<h1><a shape="rect" name="JAX-RSDataBindings-JAXBsupport"></a>JAXB support</h1>
@@ -326,9 +326,9 @@ public class CustomerService {
<p>Schema validation can be enabled and custom @Consume and @Produce media
types can be injected, see <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/systests/jaxrs/src/test/resources/jaxrs/WEB-INF/beans.xml";>this
example</a> and "Customizing media types for message body providers" and
"Schema Validation" sections for more information. </p>
-<h3><a shape="rect"
name="JAX-RSDataBindings-DealingwithJSONarrayserializationissues"></a>Dealing
with JSON array serialization issues </h3>
+<h3><a shape="rect"
name="JAX-RSDataBindings-DealingwithJettisonarrayserializationissues"></a>Dealing
with Jettison array serialization issues </h3>
-<p>There is a well known problem in the JSON community which shows itself in
the wrong serialization of List objects containing a single value only. To work
around this issue, one needs to enable a 'serializeAsArray' feature on a
JSONProvider, with the additional option of specifying the individual fields
which needs to be processed accordingly using an 'arrayKeys' property. Please
see <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/systests/jaxrs/src/test/resources/jaxrs/WEB-INF/beans.xml";>this
example</a> for more information. </p>
+<p>By default, Jettison wrongly serializes List objects containing a single
value only. To work around this issue, one needs to enable a 'serializeAsArray'
feature on a JSONProvider, with the additional option of specifying the
individual fields which needs to be processed accordingly using an 'arrayKeys'
property. Please see <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/systests/jaxrs/src/test/resources/jaxrs/WEB-INF/beans.xml";>this
example</a> for more information. </p>
<p>Note that 'serializeAsArray' and 'arrayKeys' can be combined to produce so
called natural convention sequences. For example, given the following two class
definitions :</p>
@@ -377,6 +377,12 @@ public static class Comment {
<p>You may also request that JSONProvider ignores all the namespaces during
the serialization process by setting an "ignoreNamespaces" boolean property
with a 'true' value. </p>
+<p>Starting from CXF 2.7.6 (and Jettison 1.3.4): </p>
+<ul class="alternate" type="square"><li>'writeNullAsString' property can be
used to affect the way Jettison writes out null values, if this property is set
to 'false' then Jettison will write null values without wrapping them in double
quotes.</li><li>new 'dropElementsInXmlStream' can be set to false and be used
with outDropElements property to affect the serialization directly at the
Jettison level</li></ul>
+
+
+
+
<h3><a shape="rect"
name="JAX-RSDataBindings-BadgerFishconvention"></a>BadgerFish convention</h3>
<p>Starting from CXF 2.2.5 it is possible to configure JSONProvider to support
a BadgerFish convention. By default a "mapped" convention is supported, set a
JSONProvider "convention" property with the value "badgerfish" if you'd like to
work with the BadgerFish convention. </p>
