cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r869978 - in /websites/production/cxf/content: cache/docs.pageCache docs/jax-rs-data-bindings.html
Date Thu, 18 Jul 2013 14:48:00 GMT
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>



Mime
View raw message