cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache CXF > 2.3 Migration Guide
Date Wed, 14 Oct 2009 13:41:00 GMT
<html>
<head>
    <base href="http://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1519/1/11/_/styles/combined.css?spaceKey=CXF&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background-color: white" bgcolor="white">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
     <h2><a href="http://cwiki.apache.org/confluence/display/CXF/2.3+Migration+Guide">2.3
Migration Guide</a></h2>
     <h4>Page <b>edited</b> by             <a href="http://cwiki.apache.org/confluence/display/~dkulp">Daniel
Kulp</a>
    </h4>
     
          <br/>
     <div class="notificationGreySide">
         <h2><a name="2.3MigrationGuide-Newfeatures"></a>New features</h2>
<ul>
	<li>New annotations of java first use cases
	<ul>
		<li>@WSDLDocumentation annotation to add documentation nodes to generated wsdl</li>
		<li>@SchemaValidation annotation to turn on schema validation</li>
		<li>@DataBinding to set the databinding used (if other than JAXB)</li>
		<li>@GZIP to turn on GZIP compression</li>
		<li>@FastInfoset to turn on FastInfoset support</li>
		<li>@Logging to turn on and control various Logging functionality</li>
	</ul>
	</li>
	<li>SOAP/JMS spec implementation</li>
	<li>SDO databinding</li>
</ul>



<h2><a name="2.3MigrationGuide-APIchanges"></a>API changes</h2>


<h2><a name="2.3MigrationGuide-Runtimechanges"></a>Runtime changes</h2>
<ul>
	<li>In 2.2.x and earlier, mustUnderstand=true headers were sent into the endpoint (in
the List&lt;Header&gt;) and only checked after the endpoint is done processing.  If
the endpoint doesn't process them, only afterword is the mustUnderstand fault raised.   With
2.3.x, mustUnderstand=true headers are checked prior to dispatch.   If an endpoint requires
mustUnderstand headers to be passed in, it must be configured so the runtime knows to allow
them through.  To do so, add a endpoint property named "endpoint-processes-headers" that is
either a string of the qname of the header to pass in or a collection of string of qnames
of headers to pass in.   (We'll be adding an annotation or other means to configure this shortly)</li>
</ul>


<ul>
	<li>SOAP/JMS - CXF now support the <a href="http://www.w3.org/TR/2009/CR-soapjms-20090604/"
rel="nofollow">w3c SOAP/JMS spec</a>.  Existing SOAP/JMS stuff should continue working,
but users are encouraged to start using the standard configurations.</li>
</ul>


<ul>
	<li>Provider&lt;Source&gt; and Dispatch&lt;Source&gt; - when specifying
a generic "Source" type, CXF now provides a streaming SAXSource object.   Previously, CXF
would load the whole message into a DOM and provide a DOMSource.  Applications that expect
a DOMSource will need to be updated to accept the SAXSource or provide configuration to force
to DOMSource.   There is now a configuration property for the Endpoint of "source-preferred-format"
which can be set to:
	<ul>
		<li>"dom" -&gt; DOMSource</li>
		<li>"sax" -&gt; SAXSource  (cxf StaxSource)</li>
		<li>"stream" -&gt; StreamSource</li>
		<li>"cxf.stax" -&gt;  StaxSource</li>
		<li>"stax" -&gt; javax.xml.transform.stax.StAXSource if avail, StaxSource otherwise</li>
	</ul>
	</li>
</ul>


<ul>
	<li>Aegis
	<ul>
		<li>The set of root classes is now of type Set&lt;java.lang.reflect.Type&gt;
to permit generics.</li>
		<li>The class Type is renamed to AegisType to reduce confusion and conflict with java.lang.reflect.Type.</li>
	</ul>
	</li>
</ul>



<h2><a name="2.3MigrationGuide-Configchanges"></a>Config changes</h2>
     </div>
     <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;">
            <a href="http://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
       </div>

       <a href="http://cwiki.apache.org/confluence/display/CXF/2.3+Migration+Guide">View
Online</a>
       |
       <a href="http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=2329656&revisedVersion=7&originalVersion=6">View
Change</a>
              |
       <a href="http://cwiki.apache.org/confluence/display/CXF/2.3+Migration+Guide?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message