< prev index next >

src/java.base/share/classes/java/net/SecureCacheResponse.java

Print this page




  65      * part of defining the session in the original connection that
  66      * retrieved the network resource, from cache.  Note: This method
  67      * can be used only when using certificate-based cipher suites;
  68      * using it with non-certificate-based cipher suites, such as
  69      * Kerberos, will throw an SSLPeerUnverifiedException.
  70      *
  71      * @return an immutable List of Certificate representing the server's
  72      *         certificate chain.
  73      * @throws SSLPeerUnverifiedException if the peer is not verified.
  74      * @see #getPeerPrincipal()
  75      */
  76     public abstract List<Certificate> getServerCertificateChain()
  77         throws SSLPeerUnverifiedException;
  78 
  79     /**
  80      * Returns the server's principal which was established as part of
  81      * defining the session during the original connection that
  82      * retrieved the network resource.
  83      *
  84      * @return the server's principal. Returns an X500Principal of the
  85      * end-entity certiticate for X509-based cipher suites, and
  86      * KerberosPrincipal for Kerberos cipher suites.
  87      *
  88      * @throws SSLPeerUnverifiedException if the peer was not verified.
  89      *
  90      * @see #getServerCertificateChain()
  91      * @see #getLocalPrincipal()
  92      */
  93      public abstract Principal getPeerPrincipal()
  94              throws SSLPeerUnverifiedException;
  95 
  96     /**
  97       * Returns the principal that was sent to the server during
  98       * handshaking in the original connection that retrieved the
  99       * network resource.
 100       *
 101       * @return the principal sent to the server. Returns an X500Principal
 102       * of the end-entity certificate for X509-based cipher suites, and
 103       * KerberosPrincipal for Kerberos cipher suites. If no principal was
 104       * sent, then null is returned.
 105       *




  65      * part of defining the session in the original connection that
  66      * retrieved the network resource, from cache.  Note: This method
  67      * can be used only when using certificate-based cipher suites;
  68      * using it with non-certificate-based cipher suites, such as
  69      * Kerberos, will throw an SSLPeerUnverifiedException.
  70      *
  71      * @return an immutable List of Certificate representing the server's
  72      *         certificate chain.
  73      * @throws SSLPeerUnverifiedException if the peer is not verified.
  74      * @see #getPeerPrincipal()
  75      */
  76     public abstract List<Certificate> getServerCertificateChain()
  77         throws SSLPeerUnverifiedException;
  78 
  79     /**
  80      * Returns the server's principal which was established as part of
  81      * defining the session during the original connection that
  82      * retrieved the network resource.
  83      *
  84      * @return the server's principal. Returns an X500Principal of the
  85      * end-entity certificate for X509-based cipher suites, and
  86      * KerberosPrincipal for Kerberos cipher suites.
  87      *
  88      * @throws SSLPeerUnverifiedException if the peer was not verified.
  89      *
  90      * @see #getServerCertificateChain()
  91      * @see #getLocalPrincipal()
  92      */
  93      public abstract Principal getPeerPrincipal()
  94              throws SSLPeerUnverifiedException;
  95 
  96     /**
  97       * Returns the principal that was sent to the server during
  98       * handshaking in the original connection that retrieved the
  99       * network resource.
 100       *
 101       * @return the principal sent to the server. Returns an X500Principal
 102       * of the end-entity certificate for X509-based cipher suites, and
 103       * KerberosPrincipal for Kerberos cipher suites. If no principal was
 104       * sent, then null is returned.
 105       *


< prev index next >