svn commit: r1644064 - /httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContextBuilder.java

[se...@apache.org]

Author: sebb
Date: Tue Dec  9 14:37:14 2014
New Revision: 1644064

URL: http://svn.apache.org/r1644064
Log:
HTTPCLIENT-1587 Document default Oracle JSSE restriction: SSLContext#init only uses first instance of managers

Modified:
    httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContextBuilder.java

Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContextBuilder.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContextBuilder.java?rev=1644064&r1=1644063&r2=1644064&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContextBuilder.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContextBuilder.java Tue Dec  9 14:37:14 2014
@@ -61,7 +61,13 @@ import org.apache.http.util.Args;
 
 /**
  * Builder for {@link javax.net.ssl.SSLContext} instances.
- *
+ * <p>
+ * Please note: the default Oracle JSSE implementation of {@link SSLContext#init(KeyManager[], TrustManager[], SecureRandom)}
+ * accepts multiple key and trust managers, however only only first matching type is ever used.
+ * See for example:
+ * <a href="http://docs.oracle.com/javase/7/docs/api/javax/net/ssl/SSLContext.html#init%28javax.net.ssl.KeyManager[],%20javax.net.ssl.TrustManager[],%20java.security.SecureRandom%29">
+ * SSLContext.html#init
+ * </a>
  * @since 4.4
  */
 @NotThreadSafe