[CXF-6913] [doc] Setting SSLSocketFactory on TLSClientParameters switches from async to sync HTTP

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.1.6
• Component/s: Documentation
• Labels: documentation
• Estimated Complexity: Unknown
• Assignee: Freeman Yue Fang
• Reporter: Torsten Mielke
• Created: 24/May/16 10:02
• Updated: 25/May/16 14:29
• Resolved: 25/May/16 09:02

Description

The fix for CXF-5071 introduced a check in AsyncHTTPConduit.setupConnection()

        if (uri.getScheme().equals("https") 
            && clientParameters != null
            && clientParameters.getSSLSocketFactory() != null) {
            //if they configured in an SSLSocketFactory, we cannot do anything
            //with it as the NIO based transport cannot use socket created from
            //the SSLSocketFactory.
            o = false;
        }

that makes CXF switch from an asynchronous to a synchronous HTTP transport if the TLSClientParameters used sets an SSLSocketFactory.

This behaviour is undocumented and has caused confusion among customers. Can we get this please documented on page
http://cxf.apache.org/docs/asynchronous-client-http-transport.html

Thanks,
Torsten