jdk/src/java.base/share/classes/javax/net/ssl/SSLSession.java
changeset 43195 e7f80841643d
parent 39828 968eec6ee74e
child 43541 9aeb1de77a63
equal deleted inserted replaced
43183:b50e0f90d284 43195:e7f80841643d
     1 /*
     1 /*
     2  * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 1997, 2016, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
   217      * of defining the session.
   217      * of defining the session.
   218      * <P>
   218      * <P>
   219      * Note: This method can be used only when using certificate-based
   219      * Note: This method can be used only when using certificate-based
   220      * cipher suites; using it with non-certificate-based cipher suites,
   220      * cipher suites; using it with non-certificate-based cipher suites,
   221      * such as Kerberos, will throw an SSLPeerUnverifiedException.
   221      * such as Kerberos, will throw an SSLPeerUnverifiedException.
       
   222      * <P>
       
   223      * Note: The returned value may not be a valid certificate chain
       
   224      * and should not be relied on for trust decisions.
   222      *
   225      *
   223      * @return an ordered array of peer certificates,
   226      * @return an ordered array of peer certificates,
   224      *          with the peer's own certificate first followed by any
   227      *          with the peer's own certificate first followed by any
   225      *          certificate authorities.
   228      *          certificate authorities.
   226      * @exception SSLPeerUnverifiedException if the peer's identity has not
   229      * @exception SSLPeerUnverifiedException if the peer's identity has not
   257      * of defining the session.
   260      * of defining the session.
   258      * <P>
   261      * <P>
   259      * Note: This method can be used only when using certificate-based
   262      * Note: This method can be used only when using certificate-based
   260      * cipher suites; using it with non-certificate-based cipher suites,
   263      * cipher suites; using it with non-certificate-based cipher suites,
   261      * such as Kerberos, will throw an SSLPeerUnverifiedException.
   264      * such as Kerberos, will throw an SSLPeerUnverifiedException.
       
   265      * <P>
       
   266      * Note: The returned value may not be a valid certificate chain
       
   267      * and should not be relied on for trust decisions.
   262      *
   268      *
   263      * <p><em>Note: this method exists for compatibility with previous
   269      * <p><em>Note: this method exists for compatibility with previous
   264      * releases. New applications should use
   270      * releases. New applications should use
   265      * {@link #getPeerCertificates} instead.</em></p>
   271      * {@link #getPeerCertificates} instead.</em></p>
   266      *
   272      *