Added javadocs

Author: scottslewis

framework/bundles/org.eclipse.ecf/src/org/eclipse/ecf/core/security/SSLContextFactory.java

@@ -16,14 +16,29 @@
 import javax.net.ssl.SSLContext;
 
 /**
+ * This class exposes three legacy static methods from the {@link SSLContext} class as 
+ * methods on an implementing instance.  Implementing instances should be registered
+ * as OSGi services.
+ * 
  * @since 3.12
  */
 public interface SSLContextFactory {
 
+	/**
+	 * See javadocs for {@link <a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/javax/net/ssl/SSLContext.html#getDefault()">SSLContext.getDefault()</a>}<br>
+	 * NOTE: Rather than the using the {@link #SSLContext.setDefault SSLContext.setDefault(SSLContext)}
+	 * to set the default SSLContext as described in the SSLContext.getDefault() javadocs, the default for the implementer is set upon construction of the service instance.
+	 */
 	SSLContext getDefault() throws NoSuchAlgorithmException, NoSuchProviderException;
 
+	/**
+	 * See javadocs for {@link <a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/javax/net/ssl/SSLContext.html#getInstance(java.lang.String)">SSLContext.getInstance(String protocol)</a>}<br>
+	 */
 	SSLContext getInstance(String protocol) throws NoSuchAlgorithmException, NoSuchProviderException;
 
+	/**
+	 * See javadocs for {@link <a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/javax/net/ssl/SSLContext.html#getInstance(java.lang.String,java.security.Provider)">SSLContext.getInstance(String protocol, String provider)</a>}<br>
+	 */
 	SSLContext getInstance(String protocol, String providerName) throws NoSuchAlgorithmException, NoSuchProviderException;
 
 }