Package java.net

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