javax.net.ssl
インタフェース SSLSessionContext

public interface SSLSessionContext

SSLSessionContext は、特定のエンティティーと関連付けられた一連の SSLSession を表します。たとえば、並行して複数のセッションに参加しているサーバーまたはクライアントを、特定のエンティティーに関連付けることができます。

セッションコンテキストは、一部の環境では使用できません。

SSLSessionContext パラメータを使用すれば、セッションの格納方法を制御できます。

• 指定された制限時間が経過すると、セッションを無効にすることができる
• コンテキストに格納できるセッションの数を制限できる

セッションは、セッション IDに基づいて取り出すことができます。SSLSessionContext 内のセッション ID は一覧表示できます。

導入されたバージョン:

1.4

関連項目:

SSLSession

メソッドの概要

Enumeration	getIds() この SSLSessionContext にグループ化されているすべてのセッション ID の列挙を返します。
SSLSession	getSession(byte[] sessionId) 特定のセッション 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)

特定のセッション ID にバインドされている SSLSession を返します。

パラメータ:

sessionId - セッション識別子

戻り値:

SSLSession。指定されたセッション ID が有効な SSLSession を指していない場合は null

例外:

NullPointerException - sessionId が null の場合。

getIds

Enumeration getIds()

この SSLSessionContext にグループ化されているすべてのセッション ID の列挙を返します。

戻り値:

すべてのセッション ID の列挙

setSessionTimeout

void setSessionTimeout(int seconds)
                       throws IllegalArgumentException

この SSLSessionContext にグループ化されている SSLSession オブジェクトのタイムアウト制限を設定します。

タイムアウト制限が t 秒に設定されている場合、作成時刻から t 秒経過したセッションはタイムアウト制限を超えます。セッションがタイムアウト制限を超えると、SSLSession オブジェクトは無効になり、後続の接続ではそのセッションを再開または参加できません。SSLSessionContext のタイムアウト制限を変更すると、タイムアウトを超えたセッションの確認がただちに行われます。

パラメータ:

seconds - 新しいタイムアウト制限 (秒単位)。ゼロは制限なし

例外:

IllegalArgumentException - 指定されたタイムアウト制限が 0 より小さい場合。

関連項目:

getSessionTimeout()

getSessionTimeout

int getSessionTimeout()

この SSLSessionContext にグループ化されている SSLSession オブジェクトのタイムアウト制限を返します。

タイムアウト制限が t 秒に設定されている場合、作成時刻から t 秒経過したセッションはタイムアウト制限を超えます。セッションがタイムアウト制限を超えると、SSLSession オブジェクトは無効になり、後続の接続ではそのセッションを再開または参加できません。SSLSessionContext のタイムアウト制限を変更すると、タイムアウト制限を超えたセッションの確認がただちに行われます。

戻り値:

タイムアウト制限 (秒単位)。ゼロは制限なし

関連項目:

setSessionTimeout(int)

setSessionCacheSize

void setSessionCacheSize(int size)
                         throws IllegalArgumentException

この SSLSessionContext にグループ化されている SSLSession オブジェクトの格納に使用されるキャッシュのサイズを設定します。

パラメータ:

size - セッションキャッシュの新しいサイズ制限。ゼロは制限なし

例外:

IllegalArgumentException - 指定されたサイズが 0 より小さい場合。

関連項目:

getSessionCacheSize()

getSessionCacheSize

int getSessionCacheSize()

この SSLSessionContext にグループ化されている SSLSession オブジェクトの格納に使用されるキャッシュのサイズを返します。

戻り値:

セッションキャッシュのサイズ。ゼロは制限なし。

関連項目:

setSessionCacheSize(int)