src/java.base/share/classes/javax/net/ssl/SSLSessionContext.java
changeset 57485 af4b0fc25bc4
parent 52764 8a85d21d9616
equal deleted inserted replaced
57484:e8b8460b191c 57485:af4b0fc25bc4
     1 /*
     1 /*
     2  * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 1997, 2019, 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
    33  * A <code>SSLSessionContext</code> represents a set of
    33  * A <code>SSLSessionContext</code> represents a set of
    34  * <code>SSLSession</code>s associated with a single entity. For example,
    34  * <code>SSLSession</code>s associated with a single entity. For example,
    35  * it could be associated with a server or client who participates in many
    35  * it could be associated with a server or client who participates in many
    36  * sessions concurrently.
    36  * sessions concurrently.
    37  * <p>
    37  * <p>
    38  * Not all environments will contain session contexts.
    38  * Not all environments will contain session contexts.  For example, stateless
       
    39  * session resumption.
       
    40  * <p>
       
    41  * Session contexts may not contain all sessions. For example, stateless
       
    42  * sessions are not stored in the session context.
    39  * <p>
    43  * <p>
    40  * There are <code>SSLSessionContext</code> parameters that affect how
    44  * There are <code>SSLSessionContext</code> parameters that affect how
    41  * sessions are stored:
    45  * sessions are stored:
    42  * <UL>
    46  * <UL>
    43  *      <LI>Sessions can be set to expire after a specified
    47  *      <LI>Sessions can be set to expire after a specified
    66      * @throws NullPointerException if <code>sessionId</code> is null.
    70      * @throws NullPointerException if <code>sessionId</code> is null.
    67      */
    71      */
    68     public SSLSession getSession(byte[] sessionId);
    72     public SSLSession getSession(byte[] sessionId);
    69 
    73 
    70     /**
    74     /**
    71      * Returns an Enumeration of all session id's grouped under this
    75      * Returns an Enumeration of all known session id's grouped under this
    72      * <code>SSLSessionContext</code>.
    76      * <code>SSLSessionContext</code>.
       
    77      * <p>Session contexts may not contain all sessions. For example,
       
    78      * stateless sessions are not stored in the session context.
       
    79      * <p>
    73      *
    80      *
    74      * @return an enumeration of all the Session id's
    81      * @return an enumeration of all the Session id's
    75      */
    82      */
    76     public Enumeration<byte[]> getIds();
    83     public Enumeration<byte[]> getIds();
    77 
    84