SSLSessionContext (Java 2 Platform SE 5.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Standard Ed. 5.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

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

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)

概要