Apache CXF 2.0.8 Release Notes

1. Overview

Apache CXF 2.0.8 delivers the latest set of patches for the 2.0.x series
fixing another 28 reported JIRA issues.


2. Installation Prerequisites 

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

    * Java 5 Development Kit   (Java 6 requires extra setup)
    * Apache ant 1.6

2.1 Java 5 Development Kit

You must install the J2SE Development Kit (JDK) 5.0, which can be downloaded
from:

    http://java.sun.com/j2se/1.5.0/download.jsp

After installing the JDK, set or modify the following environment variables:

    * JAVA_HOME -- set this environment variable
      to point at the root directory of the JDK 5.0 installation.

    * PATH -- make sure that your PATH includes: 
      %JAVA_HOME%\bin  (Windows) 
      $JAVA_HOME/bin   (UNIX)

If using a Java 6 kit, you may need to copy the jaxb-*, saaj-*, jaxws-* jars 
from the lib dir to your jre/lib/endorsed directory.


2.2 Apache Ant 1.6.5 (or newer, 1.7.0 should work as well)

To run samples included in the binary distribution of Apache CXF,
you must install the Apache Ant 1.6.5 build utility, which can be downloaded
from:

    http://ant.apache.org/bindownload.cgi

After installing Apache Ant, add the <AntInstallDir>/bin directory to your PATH.

For more details, see the Installation Guide.


2.3 Bouncy Castle/JCE requirement for WS-Security

To use the WS-Security features of CXF, you need to obtain a JCE crypto provider
that implements the algorithms that you plan to use. One option is to download 
the Bouncy Castle jar from:
http://bouncycastle.org/download/bcprov-jdk14-136.jar 
and add that to the lib directory or classpath.   


The latest version of the WSS4J library that is used to implement WS-Security 
requires the opensaml jar to be on the classpath.  This is different than previous
versions that only required it if doing SAML assertions.  When upgrading
to CXF 2.0.8, you will need to add the opensaml jar to your application.   

3. 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.

4. Errata

4.1 WS-Security
The WS-Security configuration mechanisms may change between this release and 
the next one as we add in support for WS-SecurityPolicy and WS-Trust.

5. Reporting Problems

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

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

6. Specific issues, features, and improvements fixed in this version:


** Bug
    * [CXF-1578] - Json marshall/unmarshall error
    * [CXF-1617] - Basic Authentication failure
    * [CXF-1620] - wsdl2java ignores jaxb2 xjc globalBindings with namespace xjc
    * [CXF-1658] - The jbi transport should honor the sendSync flag so that xa transactions are handled correctly in smx3
    * [CXF-1659] - Eclipse plugin has ${cxf.version} in directory name
    * [CXF-1660] - Nested namespace defined spring beans aren't properly unique
    * [CXF-1661] - style="rpc" in soapBinging configuration is not honored
    * [CXF-1663] - Attempting to use a Spring configured HTTPConduit causing compatability problems with Spring 2.5.4 testing framework
    * [CXF-1665] - org.apache.cxf.jaxws.interceptors.SwAOutInterceptor:197 | Unreachable Code
    * [CXF-1667] - WsdlLocation can't not be set from <simple:server> or <jaxws:server>
    * [CXF-1669] - MTOM does not work when add WSS4J interceptors(UsernameToken and Timestamp)
    * [CXF-1678] - wsdl2java does not generate impl stubs when only logical wsdl is present
    * [CXF-1681] - Base URL caching in ServletController avoids needed updateDests() call on republishing endpoints
    * [CXF-1682] - Generated Web service Client fails for http://demo.aws.air-worldwide.com/aws/passporttogo.asmx?wsdl
    * [CXF-1683] - ExtendedURIResolver returns relative paths after resolving a URI relative to another one.
    * [CXF-1687] - Lots of NPE when parsing documents at start time
    * [CXF-1689] - CXF assumes class.getPackage() is never null
    * [CXF-1696] - wsdl2java issues with implicit headers
    * [CXF-1697] - Problem with converting to Calendar
    * [CXF-1709] - "No service was found." after refresh of Spring's ApplicationContext 
    * [CXF-1711] - Server failed to start and receieved IllegalAnnotationExceptions 
    * [CXF-1712] - ObjectFactory cache doesn't take classloaders into accout

** Improvement
    * [CXF-1680] - Map ws-security principals into WebServiceContext.getUserPrincipal() call
    * [CXF-1684] - URIResolver cannot resolve relative paths with with zip: scheme
    * [CXF-1685] - Not possible to pass empty parameter to the maven-codegen-plugin
    * [CXF-1686] - maven-codegen-plugin: Add ability to specify a default set of options for all wsdls in a project.
    * [CXF-1692] - cfx-codegen-plugin: Should be possible to configure using named parameters.
    * [CXF-1705] - Servlet 2.3 compliance
