Package 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 Details

    • SecureCacheResponse

      public SecureCacheResponse()
      Creates a new instance of this class.

  • Method Details

    • 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.