Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
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.

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 ()

Added in API level 1

Creates a new instance of this class.

Public Methods

public abstract String getCipherSuite ()

Added in 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 ()

Added in 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 ()

Added in 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 ()

Added in 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 ()

Added in 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.