JavaTM 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)

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。