javax.net.ssl
介面 SSLSessionContext

public interface SSLSessionContext

SSLSessionContext 表示與單個實體關聯的 SSLSession。例如，它可以與同時參與多個Session的伺服器或客戶端相關聯。

不是所有的環境都包含Session上下文。

下面是影響Session的存儲方式的 SSLSessionContext 參數：

• 可以將Session設置為經過指定的時間限制後終止。
• 可以限制可以存儲在上下文中的Session數。

可以根據Session的 id 獲取Session，SSLSessionContext 中的所有Session id 可以被列入表中。

從以下版本開始：

1.4

另請參見：

SSLSession

方法摘要

Enumeration	getIds() 返回在此 SSLSessionContext 下分組的所有Session id 的 Enumeration。
SSLSession	getSession(byte[] sessionId) 返回綁定到指定Session id 的 SSLSession。
int	getSessionCacheSize() 返回用來存儲在此 SSLSessionContext 下分組的 SSLSession 物件的快取記憶體大小。
int	getSessionTimeout() 返回在此 SSLSessionContext 下分組的 SSLSession 物件的逾時值限制。
void	setSessionCacheSize(int size) 設置用來存儲在此 SSLSessionContext 下分組的 SSLSession 物件的快取記憶體大小。
void	setSessionTimeout(int seconds) 設置在此 SSLSessionContext 下分組的 SSLSession 物件的逾時值限制。

方法詳細資訊

getSession

SSLSession getSession(byte[] sessionId)

返回綁定到指定Session id 的 SSLSession。

參數：

sessionId - Session 標識符

返回：

SSLSession；如果指定的Session id 沒有指向有效的 SLSession，則返回 null。

拋出：

NullPointerException - 如果 sessionId 為 null。

getIds

Enumeration getIds()

返回在此 SSLSessionContext 下分組的所有Session id 的 Enumeration。

返回：

所有 Session id 列舉。

setSessionTimeout

void setSessionTimeout(int seconds)
                       throws IllegalArgumentException

設置在此 SSLSessionContext 下分組的 SSLSession 物件的逾時值限制。

如果把逾時值限制設置為't' 秒，則在Session創建 't' 秒後超過逾時值限制。當已經超過Session的逾時值限制時，SSLSession 物件將變成無效的並且後來的連接不能恢復和重新加入此Session。當此 SSLSessionContext 的逾時值改變時，將立即檢查Session是否超過逾時值。

參數：

seconds - 以秒為單位的新的Session逾時值；零表示沒有限制。

拋出：

IllegalArgumentException - 如果指定的逾時值 < 0。

另請參見：

getSessionTimeout()

getSessionTimeout

int getSessionTimeout()

返回在此 SSLSessionContext 下分組的 SSLSession 物件的逾時值限制。

如果把逾時值限制設置為't' 秒，則在Session創建 't' 秒後超過逾時值限制。當已經超過Session的逾時值限制時，SSLSession 物件將變成無效的並且後來的連接不能恢復和重新加入此Session。當此 SSLSessionContext 的逾時值改變時，將立即檢查Session是否超過逾時值。

返回：

以秒為單位的Session逾時值；零表示沒有限制。

另請參見：

setSessionTimeout(int)

setSessionCacheSize

void setSessionCacheSize(int size)
                         throws IllegalArgumentException

設置用來存儲在此 SSLSessionContext 下分組的 SSLSession 物件的快取記憶體大小。

參數：

size - 新的Session快取記憶體大小限制；零表示沒有限制。

拋出：

IllegalArgumentException - 如果指定的大小 < 0。

另請參見：

getSessionCacheSize()

getSessionCacheSize

int getSessionCacheSize()

返回用來存儲在此 SSLSessionContext 下分組的 SSLSession 物件的快取記憶體大小。

返回：

Session快取記憶體大小；零表示沒有大小限制。

另請參見：

setSessionCacheSize(int)