Apache CXF 3.1.18 Release Notes

1. Overview

The 3.1.x versions of Apache CXF is a significant new version of CXF 
that provides several new features and enhancements.  

New features include: 

* New Metrics feature for collecting metrics about a CXF services.  
* New Throttling feature for easily throttling CXF services.  
* New Logging feature for more advanced logging than the logging 
  available in cxf-core
* New Metadata service for SAML SSO to allow you to publish SAML SSO 
  metadata for your service provider.
* Enhancements to the code generator to be more "Java7" friendly
* Update to OpenSAML 3.0
* Support for Karaf 4, Jetty 9

Important notes:
CXF 3.1.x no longer supports Java 6.   You must upgrade to Java 7 or later.

Users are encourage to review the migration guide at:
http://cxf.apache.org/docs/31-migration-guide.html
for further information and requirements for upgrading from earlier
versions of CXF.

3.1.18 fixes over 11 JIRA issues reported by users and the community.


2. Installation Prerequisites 

Before installing Apache CXF, make sure the following products,
with the specified versions, are installed on your system:

    * Java 7 Development Kit
    * Apache Maven 3.x to build the samples


3.  Integrating CXF Into Your Application

If you use Maven to build your application, you need merely add
appropriate dependencies. See the pom.xml files in the samples.

If you don't use Maven, you'll need to add one or more jars to your
classpath. The file lib/WHICH_JARS should help you decide which 
jars you need.

4. Building the Samples

Building the samples included in the binary distribution is easy. Change to
the samples directory and follow the build instructions in the README.txt file 
included with each sample.

5. Reporting Problems

If you have any problems or want to send feedback of any kind, please e-mail the
CXF dev list, dev@cxf.apache.org.  You can also file issues in JIRA at:

http://issues.apache.org/jira/browse/CXF

6. Migration notes:

See the migration guide at:
http://cxf.apache.org/docs/31-migration-guide.html
for caveats when upgrading from CXF 2.7.x and 3.0.x
to 3.1.



7. Specific issues, features, and improvements fixed in this version

** Bug
* [CXF-7768] - ensure we close all temp queue/topic before we close a JMS connection
* [CXF-7824] - CacheMap may have spurious null keys
* [CXF-7832] - WrappedMessageContext containsKey not consistent with get/put
* [CXF-7847] - DOMUtils init failed with IBM JDK
* [CXF-7858] - Base64 empty string encoding issue
* [CXF-7869] - Infinite loop in rest client
* [CXF-7870] - JAXRSUtils referenced in AbstractBraveClientProvider
* [CXF-7947] - NullPointerException in Utils.java file

** Improvement
* [CXF-7796] - Support setting outbound network interface for UDP transport
* [CXF-7827] - shouldn't log JMS password from JMS address when using JMS transport
* [CXF-7855] - Update the Brave/OpenTracing/HTrace documentation to include more code snippets







