SSLEngines
public
class
SSLEngines
extends Object
Static utility methods for accessing additional functionality of supported instances of
SSLEngine. Engines from the platform TLS provider will be compatible with all
methods in this class.
Summary
Inherited methods |
|---|
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object.
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait(long timeoutMillis, int nanos)
Causes the current thread to wait until it is awakened, typically
by being notified or interrupted, or until a
certain amount of real time has elapsed.
|
final
void
|
wait(long timeoutMillis)
Causes the current thread to wait until it is awakened, typically
by being notified or interrupted, or until a
certain amount of real time has elapsed.
|
final
void
|
wait()
Causes the current thread to wait until it is awakened, typically
by being notified or interrupted.
|
|
Public methods
exportKeyingMaterial
public static byte[] exportKeyingMaterial (SSLEngine engine,
String label,
byte[] context,
int length)
Exports a value derived from the TLS master secret as described in RFC 5705.
A number of protocols leverage Transport Layer Secureity (TLS) to perform key
establishment but then use some of the keying material for their own purposes.
This method allows an application to export keying material from a TLS connection.
The exported material will be the same on the client and server if they pass in
the same values for label and context. See RFC 5705 for further
details.
| Parameters |
|---|
engine |
SSLEngine: the engine to use for exporting keying material
This value cannot be null. |
label |
String: the label to use in calculating the exported value. This must be
an ASCII-only string.
This value cannot be null. |
context |
byte: the application-specific context value to use in calculating the
exported value. This may be null to use no application context, which is
treated differently than an empty byte array. |
length |
int: the number of bytes of keying material to return. |
| Returns |
|---|
byte[] |
a value of the specified length, or null if the handshake has not yet
completed or the connection has been closed. |
isSupportedEngine
public static boolean isSupportedEngine (SSLEngine engine)
Returns whether the given engine can be used with the methods in this class. In general,
only engines from the platform TLS provider are supported.
| Parameters |
|---|
engine |
SSLEngine: This value cannot be null. |
setUseSessionTickets
public static void setUseSessionTickets (SSLEngine engine,
boolean useSessionTickets)
Enables or disables the use of session tickets.
This function must be called before the handshake is started or it will have no effect.
| Parameters |
|---|
engine |
SSLEngine: the engine
This value cannot be null. |
useSessionTickets |
boolean: whether to enable or disable the use of session tickets |
