org.conscrypt

Class OpenSSLSessionImpl

java.lang.Object

org.conscrypt.AbstractOpenSSLSession

org.conscrypt.OpenSSLSessionImpl

All Implemented Interfaces:

SSLSession

public class OpenSSLSessionImpl
extends AbstractOpenSSLSession

Implementation of the class OpenSSLSessionImpl based on OpenSSL.

Field Summary

Fields

Modifier and Type	Field and Description
protected long	sslSessionNativePointer

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	OpenSSLSessionImpl(long sslSessionNativePointer, X509Certificate[] localCertificates, X509Certificate[] peerCertificates, byte[] peerCertificateOcspData, byte[] peerTlsSctData, String peerHost, int peerPort, org.conscrypt.AbstractSessionContext sessionContext) Class constructor creates an SSL session context given the appropriate SSL parameters.

Method Summary

Modifier and Type	Method and Description
protected void	finalize()
String	getCipherSuite() Returns a string identifier of the crypto tools used in the actual SSL session.
long	getCreationTime() Gets the creation time of the SSL session.
byte[]	getEncoded() Get the session object in DER format.
byte[]	getId() Gets the identifier of the actual SSL session
long	getLastAccessedTime() Returns the last time this concrete SSL session was accessed.
String	getPeerHost() The peer's host name used in this SSL session is returned.
int	getPeerPort() Returns the peer's port number for the actual SSL session.
String	getProtocol() Returns the standard version name of the SSL protocol used in all connections pertaining to this SSL session.
String	getRequestedServerName() Returns the name requested by the SNI extension.
List<byte[]>	getStatusResponses() Returns the OCSP stapled response.
byte[]	getTlsSctData() Returns the TLS Stapled Certificate Transparency data.
Object	getValue(String name) Returns the object which is bound to the the input parameter name.
String[]	getValueNames() Returns an array with the names (sort of links) of all the data objects of the application layer bound into the SSL session.
protected X509Certificate[]	getX509LocalCertificates()
protected X509Certificate[]	getX509PeerCertificates()
void	putValue(String name, Object value) A link (name) with the specified value object of the SSL session's application layer data is created or replaced.
void	removeValue(String name) Removes a link (name) with the specified value object of the SSL session's application layer data.
void	setLastAccessedTime(long accessTimeMillis) Sets the last accessed time for this session in milliseconds since Jan 1, 1970 00:00:00 UTC.

Methods inherited from class org.conscrypt.AbstractOpenSSLSession

getApplicationBufferSize, getLocalCertificates, getLocalPrincipal, getPacketBufferSize, getPeerCertificateChain, getPeerCertificates, getPeerPrincipal, getSessionContext, invalidate, isValid

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

sslSessionNativePointer

protected long sslSessionNativePointer

Constructor Detail

OpenSSLSessionImpl

protected OpenSSLSessionImpl(long sslSessionNativePointer,
                             X509Certificate[] localCertificates,
                             X509Certificate[] peerCertificates,
                             byte[] peerCertificateOcspData,
                             byte[] peerTlsSctData,
                             String peerHost,
                             int peerPort,
                             org.conscrypt.AbstractSessionContext sessionContext)

Class constructor creates an SSL session context given the appropriate SSL parameters.

Method Detail

getId

public byte[] getId()

Gets the identifier of the actual SSL session

Returns:

array of sessions' identifiers.

getEncoded

public byte[] getEncoded()

Get the session object in DER format. This allows saving the session data or sharing it with other processes.

getCreationTime

public long getCreationTime()

Gets the creation time of the SSL session.

Returns:

the session's creation time in milliseconds since the epoch

getLastAccessedTime

public long getLastAccessedTime()

Returns the last time this concrete SSL session was accessed. Accessing here is to mean that a new connection with the same SSL context data was established.

Returns:

the session's last access time in milliseconds since the epoch

setLastAccessedTime

public void setLastAccessedTime(long accessTimeMillis)

Description copied from class: AbstractOpenSSLSession

Sets the last accessed time for this session in milliseconds since Jan 1, 1970 00:00:00 UTC.

Specified by:

setLastAccessedTime in class AbstractOpenSSLSession

getX509LocalCertificates

protected X509Certificate[] getX509LocalCertificates()

Specified by:

getX509LocalCertificates in class AbstractOpenSSLSession

getX509PeerCertificates

protected X509Certificate[] getX509PeerCertificates()
                                             throws SSLPeerUnverifiedException

Specified by:

getX509PeerCertificates in class AbstractOpenSSLSession

Throws:

SSLPeerUnverifiedException

getPeerHost

public String getPeerHost()

The peer's host name used in this SSL session is returned. It is the host name of the client for the server; and that of the server for the client. It is not a reliable way to get a fully qualified host name: it is mainly used internally to implement links for a temporary cache of SSL sessions.

Returns:

the host name of the peer, or null if no information is available.

getPeerPort

public int getPeerPort()

Returns the peer's port number for the actual SSL session. It is the port number of the client for the server; and that of the server for the client. It is not a reliable way to get a peer's port number: it is mainly used internally to implement links for a temporary cache of SSL sessions.

Returns:

the peer's port number, or -1 if no one is available.

getCipherSuite

public String getCipherSuite()

Returns a string identifier of the crypto tools used in the actual SSL session. For example AES_256_WITH_MD5.

getProtocol

public String getProtocol()

Returns the standard version name of the SSL protocol used in all connections pertaining to this SSL session.

getValue

public Object getValue(String name)

Returns the object which is bound to the the input parameter name. This name is a sort of link to the data of the SSL session's application layer, if any exists.

Specified by:

getValue in interface SSLSession

Overrides:

getValue in class AbstractOpenSSLSession

Parameters:

name - the name of the binding to find.

Returns:

the value bound to that name, or null if the binding does not exist.

Throws:

IllegalArgumentException - if the argument is null.

getValueNames

public String[] getValueNames()

Returns an array with the names (sort of links) of all the data objects of the application layer bound into the SSL session.

Specified by:

getValueNames in interface SSLSession

Overrides:

getValueNames in class AbstractOpenSSLSession

Returns:

a non-null (possibly empty) array of names of the data objects bound to this SSL session.

putValue

public void putValue(String name,
                     Object value)

A link (name) with the specified value object of the SSL session's application layer data is created or replaced. If the new (or existing) value object implements the SSLSessionBindingListener interface, that object will be notified in due course.

Specified by:

putValue in interface SSLSession

Overrides:

putValue in class AbstractOpenSSLSession

Parameters:

name - the name of the link (no null are accepted!)

value - data object that shall be bound to name.

Throws:

IllegalArgumentException - if one or both argument(s) is null.

removeValue

public void removeValue(String name)

Removes a link (name) with the specified value object of the SSL session's application layer data.

If the value object implements the SSLSessionBindingListener interface, the object will receive a valueUnbound notification.

Specified by:

removeValue in interface SSLSession

Overrides:

removeValue in class AbstractOpenSSLSession

Parameters:

name - the name of the link (no null are accepted!)

Throws:

IllegalArgumentException - if the argument is null.

getRequestedServerName

public String getRequestedServerName()

Returns the name requested by the SNI extension.

Specified by:

getRequestedServerName in class AbstractOpenSSLSession

getStatusResponses

public List<byte[]> getStatusResponses()

Returns the OCSP stapled response.

Specified by:

getStatusResponses in class AbstractOpenSSLSession

getTlsSctData

public byte[] getTlsSctData()

Description copied from class: AbstractOpenSSLSession

Returns the TLS Stapled Certificate Transparency data.

Specified by:

getTlsSctData in class AbstractOpenSSLSession

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable