You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by bu...@apache.org on 2015/04/09 22:46:56 UTC
svn commit: r946940 - in /websites/production/cxf/content:
cache/docs.pageCache docs/31-migration-guide.html
Author: buildbot
Date: Thu Apr 9 20:46:56 2015
New Revision: 946940
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/31-migration-guide.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/31-migration-guide.html
==============================================================================
--- websites/production/cxf/content/docs/31-migration-guide.html (original)
+++ websites/production/cxf/content/docs/31-migration-guide.html Thu Apr 9 20:46:56 2015
@@ -28,6 +28,15 @@
<meta name="description" content="Apache CXF, Services Framework - 3.1 Migration Guide">
+<link type="text/css" rel="stylesheet" href="/resources/highlighter/styles/shCoreCXF.css">
+<link type="text/css" rel="stylesheet" href="/resources/highlighter/styles/shThemeCXF.css">
+
+<script src='/resources/highlighter/scripts/shCore.js'></script>
+<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
+<script>
+ SyntaxHighlighter.defaults['toolbar'] = false;
+ SyntaxHighlighter.all();
+</script>
<title>
@@ -107,7 +116,18 @@ Apache CXF -- 3.1 Migration Guide
<td height="100%">
<!-- Content -->
<div class="wiki-content">
-<div id="ConfluenceContent"><h3 id="id-3.1MigrationGuide-MajorNotes">Major Notes</h3><ul><li>CXF 3.1 no longer supports Java 6.   You must use Java 7 or Java 8.</li><li>The JAX-WS/Simple frontend ServerFactoryBean will automatically call reset at the end of the create() call.   This allows resources to be cleaned up and garbage collected sooner.  However, it also prevents multiple calls to create() from sharing the same ServerInfo/EndpointInfo/etc... objects like they would we 3.0.x.   That sharing has caused many problems in the past due to sharing of properties (like token caches) that are stored on those objects so the new behavior is more "correct", but it is different than previous versions so care must be taken while upgrading.</li><li>The Karaf features.xml file for CXF 3.1 no longer will install spring or spring-dm when installing the "cxf" feature.  If you require spring/spring-dm, you will need to install those features prior to installing the CXF
feature.</li><li>The STS (Security Token Service) now issues tokens using the RSA-SHA256 signature algorithm by default (previously RSA-SHA1), and the SHA-256 digest algorithm (previously SHA-1).</li></ul><p> </p><h3 id="id-3.1MigrationGuide-NewFeatures">New Features</h3><ul><li>The CXF JAX-WS code generator has a new option "seiSuper" that can be used to specify additional super interfaces for the SEI.  This makes the code nonportable to other JAX-WS containers.   The primary use would be to add AutoCloseable to the interface to allow use of the clients in Java7 try with resource blocks.</li><li>New Metrics feature for collecting metrics about a CXF services.   Codahale/DropWizard based collector included.</li><li>New Throttling feature for easily throttling CXF services.  Sample included that uses the Metrics component to help make the throttling decisions.</li><li>New Logging feature for more advanced logging than the logging available in cxf-core</li></u
l><p> </p><h3 id="id-3.1MigrationGuide-MajorDependencyChanges">Major Dependency Changes</h3><ul><li>The Jetty based HTTP transport has been updated to support Jetty 9 as well as Jetty 8.   However, support for Jetty 7 has been dropped.</li><li>Due to the Jetty upgrade, support for running Jetty based endpoints in Karaf 2.3.x has been dropped.</li><li>Support for using JAX-WS 2.1 based API jars has been removed.  Java 7 (now required) includes JAX-WS 2.2 so this should not be an issue.</li></ul></div>
+<div id="ConfluenceContent"><h3 id="id-3.1MigrationGuide-MajorNotes">Major Notes</h3><ul><li>CXF 3.1 no longer supports Java 6.   You must use Java 7 or Java 8.</li><li>The JAX-WS/Simple frontend ServerFactoryBean will automatically call reset at the end of the create() call.   This allows resources to be cleaned up and garbage collected sooner.  However, it also prevents multiple calls to create() from sharing the same ServerInfo/EndpointInfo/etc... objects like they would we 3.0.x.   That sharing has caused many problems in the past due to sharing of properties (like token caches) that are stored on those objects so the new behavior is more "correct", but it is different than previous versions so care must be taken while upgrading.</li><li>The Karaf features.xml file for CXF 3.1 no longer will install spring or spring-dm when installing the "cxf" feature.  If you require spring/spring-dm, you will need to install those features prior to installing the CXF
feature.</li><li>The STS (Security Token Service) now issues tokens using the RSA-SHA256 signature algorithm by default (previously RSA-SHA1), and the SHA-256 digest algorithm (previously SHA-1).</li></ul><p> </p><h3 id="id-3.1MigrationGuide-NewFeatures">New Features</h3><ul><li>The CXF JAX-WS code generator has a new option "seiSuper" that can be used to specify additional super interfaces for the SEI.  This makes the code nonportable to other JAX-WS containers.   The primary use would be to add AutoCloseable to the interface to allow use of the clients in Java7 try with resource blocks.</li><li>New Metrics feature for collecting metrics about a CXF services.   Codahale/DropWizard based collector included.</li><li>New Throttling feature for easily throttling CXF services.  Sample included that uses the Metrics component to help make the throttling decisions.</li><li>New Logging feature for more advanced logging than the logging available in cxf-core</li><li
><p>The "cxf" frontend to the JAX-WS code generator (-fe cxf) now generates code that is a bit more "Java7" friendly as the return type of the getPort(...) calls is a sub-interface of the SEI that also implements AutoCloseable, BindingProvider, and Client.   Code that used to look like:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[(AddNumbersPortType port = service.getAddNumbersPort();
+((BindingProvider)port).getRequestContext()
+ .put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, address);
+port.addNumbers3(-1, 2);
+((Closeable)port).close();]]></script>
+</div></div><p>can be replaced with:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[try (AddNumbersPortTypeProxy port = service.getAddNumbersPort()) {
+ port.getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, address);
+ port.addNumbers3(-1, 2);
+}]]></script>
+</div></div></li></ul><p> </p><h3 id="id-3.1MigrationGuide-MajorDependencyChanges">Major Dependency Changes</h3><ul><li>The Jetty based HTTP transport has been updated to support Jetty 9 as well as Jetty 8.   However, support for Jetty 7 has been dropped.</li><li>Due to the Jetty upgrade, support for running Jetty based endpoints in Karaf 2.3.x has been dropped.</li><li>Support for using JAX-WS 2.1 based API jars has been removed.  Java 7 (now required) includes JAX-WS 2.2 so this should not be an issue.</li></ul></div>
</div>
<!-- Content -->
</td>