java.net

Class SecureCacheResponse

java.lang.Object

java.net.CacheResponse

java.net.SecureCacheResponse

public abstract class SecureCacheResponse
extends CacheResponse

A secure cache response represents data which is originally retrieved over a secure connection. Such a connection can be secured by using a cryptographic protocol like TLS or SSL.

See Also:

ResponseCache

Constructor Summary

Constructors

Constructor and Description
SecureCacheResponse() Creates a new instance of this class.

Method Summary

Modifier and Type	Method and Description
abstract String	getCipherSuite() Gets the cipher suite string on the connection which is originally used to retrieve the network resource.
abstract List<Certificate>	getLocalCertificateChain() Gets the local certificate chain.
abstract Principal	getLocalPrincipal() Gets the local principle that the original connection sent to the server.
abstract Principal	getPeerPrincipal() Gets the server's principle.
abstract List<Certificate>	getServerCertificateChain() Gets the cached server's certificate chain.

Methods inherited from class java.net.CacheResponse

getBody, getHeaders

Methods inherited from class java.lang.Object

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

Constructor Detail

SecureCacheResponse

public SecureCacheResponse()

Creates a new instance of this class.

Method Detail

getCipherSuite

public abstract String getCipherSuite()

Gets the cipher suite string on the connection which is originally used to retrieve the network resource.

Returns:

the cipher suite string.

getLocalCertificateChain

public abstract List<Certificate> getLocalCertificateChain()

Gets the local certificate chain. When the original connection retrieved the resource data, this certificate chain was sent to the server during handshaking process. This method only takes effect when certificate-based cipher suite is enabled.

Returns:

the certificate chain that was sent to the server. If no certificate chain was sent, the method returns null.

getServerCertificateChain

public abstract List<Certificate> getServerCertificateChain()
                                                     throws SSLPeerUnverifiedException

Gets the cached server's certificate chain. As part of defining the session, the certificate chain was established when the original connection retrieved network resource. This method can only be invoked when certificated-based cipher suite is enabled. Otherwise, it throws an SSLPeerUnverifiedException.

Returns:

the server's certificate chain.

Throws:

SSLPeerUnverifiedException - if the peer is unverified.

getPeerPrincipal

public abstract Principal getPeerPrincipal()
                                    throws SSLPeerUnverifiedException

Gets the server's principle. When the original connection retrieved network resource, the principle was established when defining the session.

Returns:

a principal object representing the server's principal.

Throws:

SSLPeerUnverifiedException - if the peer is unverified.

getLocalPrincipal

public abstract Principal getLocalPrincipal()

Gets the local principle that the original connection sent to the server. When the original connection fetched the network resource, the principle was sent to the server during handshaking process.

Returns:

the local principal object being sent to the server. Returns an X500Principal object for X509-based cipher suites. If no principal was sent, it returns null.