public abstract class

SecureCacheResponse

extends CacheResponse
java.lang.Object
   ↳ java.net.CacheResponse
     ↳ java.net.SecureCacheResponse

Class Overview

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

Summary

Public Constructors
SecureCacheResponse()
Creates a new instance of this class.
Public Methods
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.
[Expand]
Inherited Methods
From class java.net.CacheResponse
From class java.lang.Object

Public Constructors

public SecureCacheResponse ()

Since: API Level 1

Creates a new instance of this class.

Public Methods

public abstract String getCipherSuite ()

Since: API Level 1

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

Returns
  • the cipher suite string.

public abstract List<Certificate> getLocalCertificateChain ()

Since: API Level 1

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.

public abstract Principal getLocalPrincipal ()

Since: API Level 1

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.

public abstract Principal getPeerPrincipal ()

Since: API Level 1

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.

public abstract List<Certificate> getServerCertificateChain ()

Since: API Level 1

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.