Apache CXF 3.4.4 Release Notes

1. Overview

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

New features include: 
* New cxf-bom artifactId for importing all the CXF artifacts
* New support for Microprofile OpenAPI (as alternative to Swagger Core 2.0)
* New samples to show WS-Transaction usage, OpenAPI v3.0 with Microprofile
* Ability in Logging feature to mask sensitive information
* New support for SSEs in Microprofile Rest Client
* OAuth 2.0 Authorization Server Metadata / OpenID Provider Metadata

Important notes:
* Many dependencies have been upgraded to newer versions.  Check
  the migration guide.


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

3.4.4 fixes over 26 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 8 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/34-migration-guide.html
for caveats when upgrading.

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

** Sub-task
    * [CXF-8404] - Fix org.apache.cxf.transport.jms.util.MessageListenerTest.testNoTransaction
    * [CXF-8428] - Fix org.apache.cxf.jaxrs.sse.client.SseEventSourceImplTest.testReconnectAndTwoEventsReceived
    * [CXF-8461] - jaxrs.ee.rs.beanparam.form.plain formFieldParamEntityWithEncodedTest
    * [CXF-8462] - jaxrs.ee.rs.beanparam.form.plain formParamEntityWithEncodedTest
    * [CXF-8504] - jaxrs.jaxrs21.ee.sse.sseeventsource defaultWaiting1s
    * [CXF-8506] - jaxrs.jaxrs21.ee.sse.sseeventsource reconnectByEventMethodTest
    * [CXF-8508] - jaxrs.jaxrs21.ee.sse.sseeventsource userReconnectByEventMethodTest
    * [CXF-8509] - jaxrs.jaxrs21.ee.sse.sseeventsource wait2Seconds
    * [CXF-8516] - jaxrs.spec.provider.jaxbcontext readWriteProviderTest
    * [CXF-8518] - jaxrs.spec.provider.standardnotnull clientJaxbProviderTest
    * [CXF-8529] - Fix org.apache.cxf.systest.jms.tx.JMSTransactionTest.testTransactionOneWay

** Bug
    * [CXF-7921] - JAXRS CDI extension ignores interfaces annotations
    * [CXF-8344] - org.apache.cxf.jaxrs.utils.AnnotationUtils#getNameBindings does not use ClassUnwrapper
    * [CXF-8387] - Allow special characters to be used for a queryParam name.
    * [CXF-8435] - JsonMapObjectReaderWriter doesn't escape double quotes
    * [CXF-8442] - java.io.IOException: closed when compiled and run with Java 16
    * [CXF-8454] - DOS vulnerability in bearer token parsing
    * [CXF-8456] - wadl2java plugin generates classes names with invalid identifiers
    * [CXF-8533] - ensure an endpoint destination which is still in use won't be shutdown inproperly
    * [CXF-8535] - Query missing from signature request-target
    * [CXF-8536] - Incorrect log message "Could not create a NamespaceMapper compatible with Marshaller class com.sun.xml.bind.v2.runtime.MarshallerImpl"
    * [CXF-8540] - FAULT_OUT logged by CORS preflight requests
    * [CXF-8546] - introduce a property so that we can configure writeOptionalTypeParameters

** New Feature
    * [CXF-8532] - @Priority support for ParamConverterProvider

** Improvement
    * [CXF-8450] - Make JAXBDatabinding extendable
    * [CXF-8537] - Replace String.replaceAll with substring for better throughput performance

