cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Daniel Kulp (Confluence)" <conflue...@apache.org>
Subject [CONF] Apache CXF Documentation > 3.0 Migration Guide
Date Tue, 19 Nov 2013 17:38:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/en/2176/1/1/_/styles/combined.css?spaceKey=CXF20DOC&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/CXF20DOC/3.0+Migration+Guide">3.0
Migration Guide</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~dkulp">Daniel
Kulp</a>
    </h4>
        <br/>
                         <h4>Changes (2)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >* &quot;jaxb-validation-event-handler&quot;s
now apply for both Reading and Writing. (previously only applied to Reading).  There are separate
jaxb-(reader|writer)-validation-event-handler properties if you need it set for only one direction.
<br> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h4.
WS-Security <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h4.
WS-ReliableMessaging <br> <br> <br></td></tr>
            <tr><td class="diff-unchanged" >h4. CXF Module/Jar Changes <br>
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <h2><a name="3.0MigrationGuide-3.0MigrationGuide"></a>3.0 Migration
Guide</h2>


<h4><a name="3.0MigrationGuide-JAXRS"></a>JAX-RS</h4>

<ul>
	<li>JAX-RS 2.0 has been completely implemented.</li>
</ul>


<ul>
	<li>JAX-RS WADL auto-generation code has been moved to a new cxf-rt-rs-service-description
module.</li>
</ul>


<ul>
	<li>JAX-RS 2.0 Client API and CXF specific WebClient and Proxy client code is now available
in a new cxf-rt-rs-client module. Important: the namespace for jaxrs:client elements has changed
from "http://cxf.apache.org/jaxrs" to "http://cxf.apache.org/jaxrs-client"</li>
</ul>


<ul>
	<li>Bean Validation 1.1 is supported for all CXF frontends</li>
</ul>


<h4><a name="3.0MigrationGuide-JAXWS%2FSoap"></a>JAX-WS/Soap</h4>

<ul>
	<li>Add new code generator frontend to add CXF specific constructors and methods. 
(pass "-fe cxf" to wsdl2java)</li>
</ul>


<ul>
	<li>Make AbstractFeature subclass WebServiceFeature and update the JAX-WS frontend
to look for them.</li>
</ul>


<ul>
	<li>"jaxb-validation-event-handler"s now apply for both Reading and Writing. (previously
only applied to Reading).  There are separate jaxb-(reader|writer)-validation-event-handler
properties if you need it set for only one direction.</li>
</ul>


<h4><a name="3.0MigrationGuide-WSSecurity"></a>WS-Security</h4>

<h4><a name="3.0MigrationGuide-WSReliableMessaging"></a>WS-ReliableMessaging</h4>


<h4><a name="3.0MigrationGuide-CXFModule%2FJarChanges"></a>CXF Module/Jar
Changes</h4>

<ul>
	<li>Combined api/core into just a cxf-core.  All "wsdl" related stuff has been moved
to a new cxf-wsdl bundle to remove the wsdl4j requirement for JAX-RS applications.</li>
</ul>


<ul>
	<li>Dropped support for Karaf 2.2.x.  Karaf 2.3.x is now required.</li>
</ul>


<ul>
	<li>The direct dependency on a javax.mail implementation has been removed and the CXF
maven poms will not pull one in transitively anymore. For MOST users, this is not a problem.
 However, if your application uses MTOM or Soap w/Attachments or similar that requires some
of the DataContentHandlers that are part of the mail implementations, you may need to re-add
this to your classpath.</li>
</ul>


<ul>
	<li>DynamicClientFactory was moved from the JAXB databinding to the Simple frontend.
 However, users are strongly encouraged to use the JaxWsDynamicClientFactory subclass.</li>
</ul>



<h4><a name="3.0MigrationGuide-Removed%2FChangedAPI%27s"></a>Removed/Changed
API's</h4>

<ul>
	<li>CXFBusImpl has been removed.   The only subclass was the ExtensionMangerBus (SpringBus
and Blueprint/osgi stuff subclassed that) so the functionality was pushed up into ExtensionMangerBus.
 Some of the "common" methods were put directly on the Bus interface to make using the Bus
cleaner (no casts to the impl).</li>
</ul>


<ul>
	<li>The unused "run()" method on Bus was removed.</li>
</ul>


<ul>
	<li>Merge BaseDataReader/DataReader and the same for the writer getting rid of the
"Base" versions that are unreferenced.</li>
</ul>


<ul>
	<li>The 2 unused params on Destination.getBackChannel were removed.  They were unused
and normally passed in as null.</li>
</ul>


<ul>
	<li>Remove QueryHandlers -&gt; these were originally used for the ?wsdl processing
(and is still used for ?js).  However, that stuff is better done directly on the interceptor
chains as interceptors to allow user supplied interceptors to also handle them.   I'd like
to just remove these.  (obviously update the ?js stuff)  Would simplify the CXFServlet a bit.</li>
</ul>


<ul>
	<li>Removed all the /META-INF/cxf/cxf-extension-XYZ.xml files.  They have been deprecated
an not needed for a long time.</li>
</ul>


<ul>
	<li>Updated ConduitInitiator and DestinationFactory to pass Bus as parameter to the
various methods.</li>
</ul>


<ul>
	<li>Removed support for the old bus-extensions.xml file (in favor of the current and
much faster bus-extensions.txt)</li>
</ul>


<ul>
	<li>Move ALL XML parsing and writing to StaxUtils and DOM based utilities to DOMUtils.
 The XMLUtils class that used SAX based parsing and Transformer based writing has been eliminated.
  This simplifies the code as well as increases security as we can provide better limits and
have more control with the StAX based IO.</li>
</ul>


<ul>
	<li>AddressingProperties has been turned from an interface to a concrete class that
can be created directly with "new".  AddressingPropertiesImpl has been removed.</li>
</ul>


<ul>
	<li>Many of our interfaces/classes that held onto constants were either removed or
moved.  In particular XmlSchemaConstants was removed (use the Constants from the XmlSchema
library directly), WSDLConstants was moved from api to rt-wsdl, SOAPConstants was removed
(most are available in WSDLConstants).  Goal is to reduce some memory usage and help startup
time and reduce a lot of duplication.</li>
</ul>


<ul>
	<li>AlternativeSelector and the PolicyEngine and other PolicyRelated classes have been
updated to pass the current Message in (when appropriate) to allow using message contextual
information to select the alternative.  HOWEVER, keep in mind that the selected alternative
is likely cached and thus if contextual information changes, the alternatively may not be
recalculated.</li>
</ul>


<ul>
	<li>FailoverTargetSelector will not activate the fail-over in cases when HTTP client
errors are returned, only HTTP 404 and 503 statuses will be recognized. Set FailoverTargetSelector
supportNotAvailableErrorsOnly property to false if the support for all HTTP errors is required.</li>
</ul>


<ul>
	<li>ServletController will not override the endpoint addresses by default as it has
side-effects when a given endpoint is accessed via multiple paths. Set CXFServlet "disable-address-updates"
parameter to 'false' if required.</li>
</ul>


    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;" class="grey">
                        <a href="https://cwiki.apache.org/confluence/users/removespacenotification.action?spaceKey=CXF20DOC">Stop
watching space</a>
            <span style="padding: 0px 5px;">|</span>
                <a href="https://cwiki.apache.org/confluence/users/editmyemailsettings.action">Change
email notification preferences</a>
</div>
        <a href="https://cwiki.apache.org/confluence/display/CXF20DOC/3.0+Migration+Guide">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=25203937&revisedVersion=24&originalVersion=23">View
Changes</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message