cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache CXF Documentation > 2.7 Migration Guide
Date Fri, 09 Nov 2012 17:30:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2042/9/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/2.7+Migration+Guide">2.7
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 (1)</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" >** Support for new filters, interceptors,
dynamic features, exception classes, and more, please see [JAX-RS Basics] for more information.
<br> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
Major Dependency Changes <br>* The Jetty based HTTP transport has been updated from
Jetty 7.6 to Jetty 8.1.  This brings in all the new functionality of the Servlet API 3.0 specification.
 The transport can still work with the older 7.6 and 7.5 versions of Jetty, but you will need
to exclude the 8.1 versions and explicitly depend on the appropriate Jetty dependencies and
servlet-api jar. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>h3. API Changes <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <h3><a name="2.7MigrationGuide-MajorNotes"></a>Major Notes</h3>
<ul>
	<li>CXF 2.7.x no longer supports Java 5.   In order to upgrade to 2.7.0, you must be
using Java 6 (or newer).  Many of the dependencies that CXF uses have moved to Java 6 and
in order to get fixes and updates, we have moved to Java 6 as well.</li>
</ul>


<h3><a name="2.7MigrationGuide-NewFeatures"></a>New Features</h3>

<ul>
	<li>New <a href="/confluence/display/CXF20DOC/UDP+Transport" title="UDP Transport">UDP
Transport</a>.</li>
	<li>New optional <a href="/confluence/display/CXF20DOC/Asynchronous+Client+HTTP+Transport"
title="Asynchronous Client HTTP Transport">HTTP transport</a> based on <a href="http://hc.apache.org/httpcomponents-asyncclient-dev/index.html"
class="external-link" rel="nofollow">Apache HTTP Components HttpAsyncClient</a>.</li>
	<li>Support for the <a href="/confluence/display/CXF20DOC/SOAP+over+UDP" title="SOAP
over UDP">SOAP over UDP</a>.</li>
	<li>Ability to only apply schema validation to incoming or outgoing messages by setting
the "schema-validation-enabled" property to "IN", "OUT", "BOTH", or "NONE".   @SchemaValidationEnabled
annotation updated to have a type=IN|OUT|BOTH|NONE parameter.</li>
	<li>Support for <a href="/confluence/display/CXF20DOC/WS-Discovery" title="WS-Discovery">WS&#45;Discovery</a>.
	<ul>
		<li>Services can send Hello/Bye when started/stopped as well as respond to Probe requests</li>
		<li>API for sending probes and resolving to EndpointReferences</li>
	</ul>
	</li>
	<li>Initial support for parts of the <a href="http://jcp.org/en/jsr/detail?id=339"
class="external-link" rel="nofollow">JAX-RS 2.0 (JSR-339)</a> specification
	<ul>
		<li>Additional methods on WebClient to provide <a href="/confluence/display/CXF20DOC/JAX-RS+Client+API#JAX-RSClientAPI-asynchronousinvocations">asynchronous
invocations</a></li>
		<li>Support for new filters, interceptors, dynamic features, exception classes, and
more, please see <a href="/confluence/display/CXF20DOC/JAX-RS+Basics" title="JAX-RS Basics">JAX&#45;RS
Basics</a> for more information.</li>
	</ul>
	</li>
</ul>


<h3><a name="2.7MigrationGuide-MajorDependencyChanges"></a>Major Dependency
Changes</h3>
<ul>
	<li>The Jetty based HTTP transport has been updated from Jetty 7.6 to Jetty 8.1.  This
brings in all the new functionality of the Servlet API 3.0 specification.  The transport can
still work with the older 7.6 and 7.5 versions of Jetty, but you will need to exclude the
8.1 versions and explicitly depend on the appropriate Jetty dependencies and servlet-api jar.</li>
</ul>


<h3><a name="2.7MigrationGuide-APIChanges"></a>API Changes</h3>

<ul>
	<li>The HTTPConduit class has been made abstract with the HttpURLConnection related
code moving to an URLConnectionHTTPConduit.   Several method calls of the HTTPConduit that
used to take HttpURLConnection objects have been eliminated.  Also, most methods taking a
URL object now take a URI object instead.   The HTTPConduit.WrappedOutputStream class is also
now abstract.   If you have custom subclasses of HTTPConduit, changing them to subclass URLConnectionHTTPConduit
will likely work.</li>
</ul>


<ul>
	<li>The WS-Addressing related VersionTransformer and MAPCodec classes have been changed
to not encode the WS-Addressing headers to  DOM elements and instead just use the Header list
on the SoapMessage directly.  This did change the parameters on the encode methods to take
the JAXBContext instead of the Marshaller.  Any custom VersionTransformers will need to be
updated.  (very rare)</li>
</ul>


<ul>
	<li>All methods that took or returned org.apache.cxf.feature.AbstractFeatures have
been changed to just use org.apache.cxf.feature.Feature.</li>
</ul>


<ul>
	<li>JAX-RS: 3 classes have been removed from the org.apache.cxf.jaxrs.client package:
ResponseReader, ServerWebApplicationException, ClientWebApplicationException. The first class
in the list is not needed with JAX-RS 2.0 Response class, the latter two are replaced by javax.ws.rs.WebApplicationException
and javax.ws.rs.client.ClientException</li>
</ul>


<ul>
	<li>The STS Claims object now uses a List&lt;String&gt; for the values instead
of a single String value.</li>
</ul>


<h3><a name="2.7MigrationGuide-DeprecatedAPI"></a>Deprecated API</h3>

<ul>
	<li>The following CXF JAX-RS specific extensions have been deprecated and will be eventually
removed
	<ul>
		<li>org.apache.cxf.jaxrs.ext.ParamHandler (use javax.ws.rs.ext.ParamConverterProvider
and javax.ws.rs.ext.ParamConverter instead).</li>
		<li>org.apache.cxf.jaxrs.ext.RequestHandler and org.apache.cxf.jaxrs.ext.ResponseHandler
(use javax.ws.rs.container.ContainerRequestFilter and  javax.ws.rs.container.ContainerResponseFilter
instead).</li>
	</ul>
	</li>
</ul>


<p>Note that no @Deprecated annotation has been attached to the deprecated classes in
order to minimize the 'noise' in the runtime code while these classes are still maintained.</p>
    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/CXF20DOC/2.7+Migration+Guide">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=29688919&revisedVersion=24&originalVersion=23">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/CXF20DOC/2.7+Migration+Guide?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message