0N/A/*
2362N/A * Copyright (c) 2003, 2004, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/Apackage java.net;
0N/A
0N/Aimport java.security.cert.Certificate;
0N/Aimport javax.net.ssl.SSLPeerUnverifiedException;
0N/Aimport java.security.Principal;
0N/Aimport java.util.List;
0N/A
0N/A/**
0N/A * Represents a cache response originally retrieved through secure
0N/A * means, such as TLS.
0N/A *
0N/A * @since 1.5
0N/A */
0N/Apublic abstract class SecureCacheResponse extends CacheResponse {
0N/A /**
0N/A * Returns the cipher suite in use on the original connection that
0N/A * retrieved the network resource.
0N/A *
0N/A * @return a string representing the cipher suite
0N/A */
0N/A public abstract String getCipherSuite();
0N/A
0N/A /**
0N/A * Returns the certificate chain that were sent to the server during
0N/A * handshaking of the original connection that retrieved the
0N/A * network resource. Note: This method is useful only
0N/A * when using certificate-based cipher suites.
0N/A *
0N/A * @return an immutable List of Certificate representing the
0N/A * certificate chain that was sent to the server. If no
0N/A * certificate chain was sent, null will be returned.
0N/A * @see #getLocalPrincipal()
0N/A */
0N/A public abstract List<Certificate> getLocalCertificateChain();
0N/A
0N/A /**
0N/A * Returns the server's certificate chain, which was established as
0N/A * part of defining the session in the original connection that
0N/A * retrieved the network resource, from cache. Note: This method
0N/A * can be used only when using certificate-based cipher suites;
0N/A * using it with non-certificate-based cipher suites, such as
0N/A * Kerberos, will throw an SSLPeerUnverifiedException.
0N/A *
0N/A * @return an immutable List of Certificate representing the server's
0N/A * certificate chain.
0N/A * @throws SSLPeerUnverifiedException if the peer is not verified.
0N/A * @see #getPeerPrincipal()
0N/A */
0N/A public abstract List<Certificate> getServerCertificateChain()
0N/A throws SSLPeerUnverifiedException;
0N/A
0N/A /**
0N/A * Returns the server's principal which was established as part of
0N/A * defining the session during the original connection that
0N/A * retrieved the network resource.
0N/A *
0N/A * @return the server's principal. Returns an X500Principal of the
0N/A * end-entity certiticate for X509-based cipher suites, and
0N/A * KerberosPrincipal for Kerberos cipher suites.
0N/A *
0N/A * @throws SSLPeerUnverifiedException if the peer was not verified.
0N/A *
0N/A * @see #getServerCertificateChain()
0N/A * @see #getLocalPrincipal()
0N/A */
0N/A public abstract Principal getPeerPrincipal()
0N/A throws SSLPeerUnverifiedException;
0N/A
0N/A /**
0N/A * Returns the principal that was sent to the server during
0N/A * handshaking in the original connection that retrieved the
0N/A * network resource.
0N/A *
0N/A * @return the principal sent to the server. Returns an X500Principal
0N/A * of the end-entity certificate for X509-based cipher suites, and
0N/A * KerberosPrincipal for Kerberos cipher suites. If no principal was
0N/A * sent, then null is returned.
0N/A *
0N/A * @see #getLocalCertificateChain()
0N/A * @see #getPeerPrincipal()
0N/A */
0N/A public abstract Principal getLocalPrincipal();
0N/A}