--- old/src/java.base/share/classes/javax/net/ssl/SSLContextSpi.java Fri May 29 00:47:23 2015
+++ new/src/java.base/share/classes/javax/net/ssl/SSLContextSpi.java Fri May 29 00:47:23 2015
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -29,7 +29,7 @@
/**
* This class defines the Service Provider Interface (SPI)
- * for the SSLContext
class.
+ * for the {@code SSLContext} class.
*
*
All the abstract methods in this class must be implemented by each
* cryptographic service provider who wishes to supply the implementation
@@ -52,12 +52,14 @@
SecureRandom sr) throws KeyManagementException;
/**
- * Returns a SocketFactory
object for this
+ * Returns a {@code SocketFactory} object for this
* context.
*
- * @return the SocketFactory
object
+ * @return the {@code SocketFactory} object
+ * @throws UnsupportedOperationException if the underlying provider
+ * does not implement the operation.
* @throws IllegalStateException if the SSLContextImpl requires
- * initialization and the engineInit()
+ * initialization and the {@code engineInit()}
* has not been called
* @see javax.net.ssl.SSLContext#getSocketFactory()
*/
@@ -64,12 +66,14 @@
protected abstract SSLSocketFactory engineGetSocketFactory();
/**
- * Returns a ServerSocketFactory
object for
+ * Returns a {@code ServerSocketFactory} object for
* this context.
*
- * @return the ServerSocketFactory
object
+ * @return the {@code ServerSocketFactory} object
+ * @throws UnsupportedOperationException if the underlying provider
+ * does not implement the operation.
* @throws IllegalStateException if the SSLContextImpl requires
- * initialization and the engineInit()
+ * initialization and the {@code engineInit()}
* has not been called
* @see javax.net.ssl.SSLContext#getServerSocketFactory()
*/
@@ -76,7 +80,7 @@
protected abstract SSLServerSocketFactory engineGetServerSocketFactory();
/**
- * Creates a new SSLEngine
using this context.
+ * Creates a new {@code SSLEngine} using this context.
*
* Applications using this factory method are providing no hints
* for an internal session reuse strategy. If hints are desired,
@@ -86,9 +90,9 @@
* Some cipher suites (such as Kerberos) require remote hostname
* information, in which case this factory method should not be used.
*
- * @return the SSLEngine
Object
+ * @return the {@code SSLEngine} Object
* @throws IllegalStateException if the SSLContextImpl requires
- * initialization and the engineInit()
+ * initialization and the {@code engineInit()}
* has not been called
*
* @see SSLContext#createSSLEngine()
@@ -98,7 +102,7 @@
protected abstract SSLEngine engineCreateSSLEngine();
/**
- * Creates a SSLEngine
using this context.
+ * Creates a {@code SSLEngine} using this context.
*
* Applications using this factory method are providing hints
* for an internal session reuse strategy.
@@ -108,9 +112,9 @@
*
* @param host the non-authoritative name of the host
* @param port the non-authoritative port
- * @return the SSLEngine
Object
+ * @return the {@code SSLEngine} Object
* @throws IllegalStateException if the SSLContextImpl requires
- * initialization and the engineInit()
+ * initialization and the {@code engineInit()}
* has not been called
*
* @see SSLContext#createSSLEngine(String, int)
@@ -120,19 +124,19 @@
protected abstract SSLEngine engineCreateSSLEngine(String host, int port);
/**
- * Returns a server SSLSessionContext
object for
+ * Returns a server {@code SSLSessionContext} object for
* this context.
*
- * @return the SSLSessionContext
object
+ * @return the {@code SSLSessionContext} object
* @see javax.net.ssl.SSLContext#getServerSessionContext()
*/
protected abstract SSLSessionContext engineGetServerSessionContext();
/**
- * Returns a client SSLSessionContext
object for
+ * Returns a client {@code SSLSessionContext} object for
* this context.
*
- * @return the SSLSessionContext
object
+ * @return the {@code SSLSessionContext} object
* @see javax.net.ssl.SSLContext#getClientSessionContext()
*/
protected abstract SSLSessionContext engineGetClientSessionContext();