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.4 Migration Guide
Date Tue, 15 Feb 2011 20:28:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2036/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.4+Migration+Guide">2.4
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" >* WSS4J has been updated from 1.5.x
to 1.6. <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">*
Neethi has been upgraded from 2.0.x to 3.0.    Much of the utilities and functionality in
the CXF policy engine has now been backported into Neethi directly and CXF now leverages more
of the capabilities of Neethi without duplicating functionality.    If you write custom policies
for CXF, some changes will be required.  These include: <br>    *  --- more to come
---- <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">*
Neethi has been upgraded from 2.0.x to 3.0.    Due to deficiencies and restrictions in the
Neethi 2.0.x API&#39;s, CXF has maintained a semi-fork of various parts of Neethi in the
org.apache.cxf packages.   With CXF 2.4.x and Neethi 3.0, the deficiencies in Neethi have
been addressed and the forked changes have been pushed down into Neethi and CXF can better
leverage enhancements and new functionality in Neethi directly without duplicating functionality.
   If you write custom policies for CXF, some changes will be required.  These include: <br>**
The CXF AssertionBuilder interface has been removed.   We now use the Neethi AssertionBuilders
and Assertions directly. <br>** The &quot;getPolicy()&quot; method of PolicyAssertion
has been removed.  Policies that can contain nested policies should implement the Neethi PolicyContainingAssertion
interface directly. <br>** Neethi has been updated to be able to process WS-Policy 1.5
policies.  Thus, the Assertion interface now has a isIgnorable() method that must be implemented.
<br>** With the removal of the CXF AssertionBuilder and the implementation if the intersection
algorithm in Neethi, the &quot;buildCompatible&quot; method that was on the CXF AssertionBuilder
is no longer needed.   If a policy needs a custom intersect algorith, they can now implement
the Neethi IntersectableAssertion interface. <br></td></tr>
            <tr><td class="diff-unchanged" > <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <h3><a name="2.4MigrationGuide-NewFeatures"></a>New Features</h3>


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

<ul>
	<li>GZIP related interceptors/features have been moved out  of the http module so they
are usable with other transports such as JMS.  As such, their package has changed from org.apache.cxf.transport.http.gzip
to org.apache.cxf.transport.common.gzip</li>
</ul>


<ul>
	<li>XmlSchema has been updated from 1.4.x to 2.0.   As such, any use of XmlSchema classes
may have changed.  In particular, XmlSchema 2.0 uses Java 5 collections which changes how
it's used.   Also, many static utility methods that existed in org.apache.cxf.common.xmlschema.XmlSchemaUtils
have now been merged directly into the XmlSchema API's and are no longer needed or available.</li>
</ul>


<ul>
	<li>WSS4J has been updated from 1.5.x to 1.6.</li>
</ul>


<ul>
	<li>Neethi has been upgraded from 2.0.x to 3.0.    Due to deficiencies and restrictions
in the Neethi 2.0.x API's, CXF has maintained a semi-fork of various parts of Neethi in the
org.apache.cxf packages.   With CXF 2.4.x and Neethi 3.0, the deficiencies in Neethi have
been addressed and the forked changes have been pushed down into Neethi and CXF can better
leverage enhancements and new functionality in Neethi directly without duplicating functionality.
   If you write custom policies for CXF, some changes will be required.  These include:
	<ul>
		<li>The CXF AssertionBuilder interface has been removed.   We now use the Neethi AssertionBuilders
and Assertions directly.</li>
		<li>The "getPolicy()" method of PolicyAssertion has been removed.  Policies that can
contain nested policies should implement the Neethi PolicyContainingAssertion interface directly.</li>
		<li>Neethi has been updated to be able to process WS-Policy 1.5 policies.  Thus, the
Assertion interface now has a isIgnorable() method that must be implemented.</li>
		<li>With the removal of the CXF AssertionBuilder and the implementation if the intersection
algorithm in Neethi, the "buildCompatible" method that was on the CXF AssertionBuilder is
no longer needed.   If a policy needs a custom intersect algorith, they can now implement
the Neethi IntersectableAssertion interface.</li>
	</ul>
	</li>
</ul>






<h3><a name="2.4MigrationGuide-RuntimeChanges"></a>Runtime Changes</h3>



    </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.4+Migration+Guide">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=24190088&revisedVersion=3&originalVersion=2">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/CXF20DOC/2.4+Migration+Guide?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message