JavaTM 2 Platform
Standard Ed. 5.0

java.net
クラス CookieHandler

java.lang.Object
  上位を拡張 java.net.CookieHandler

public abstract class CookieHandler
extends Object

CookieHandler オブジェクトは、HTTP 状態管理ポリシー実装を HTTP プロトコルハンドラに渡すコールバック機構を提供します。HTTP 状態管理機構は、HTTP 要求/応答を使ってステートフルセッションを作成する方法を指定します。

リンクローカルのアドレスやサイトローカルのアドレスは非グローバルです。このため、複数のホストが同じ宛先アドレスを共有し、その結果、これらのホストに同じ送信元システム上の複数のインタフェースを介して到達できる可能性があります。この場合、送信元システムは同じスコープの複数のゾーンに接続されていることになります。どれが目的のゾーンであるか明確にするため、IPv6 アドレスにゾーン識別子 (scope_id) を追加できます。 HTTP 状態管理の詳細については、「RFC 2965: HTTP State Management Mechanism」を参照してください。

導入されたバージョン:
1.5

コンストラクタの概要
CookieHandler()
           
 
メソッドの概要
abstract  Map<String,List<String>> get(URI uri, Map<String,List<String>> requestHeaders)
          要求ヘッダ内に指定された uri のクッキーキャッシュから、適用可能なすべてのクッキーを取得します。
static CookieHandler getDefault()
          システム全体のクッキーハンドラを取得します。
abstract  void put(URI uri, Map<String,List<String>> responseHeaders)
          適用可能なすべてのクッキー (たとえば応答ヘッダ内のフィールド Set-Cookie2) を、クッキーキャッシュ内に設定します。
static void setDefault(CookieHandler cHandler)
          システム全体のクッキーハンドラを設定 (または設定解除) します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

CookieHandler

public CookieHandler()
メソッドの詳細

getDefault

public static CookieHandler getDefault()
システム全体のクッキーハンドラを取得します。

戻り値:
システム全体のクッキーハンドラ。現在システム全体のクッキーハンドラが設定されていない場合は null
例外:
SecurityException - セキュリティマネージャがインストールされており、NetPermission("getCookieHandler") を拒否した場合
関連項目:
setDefault(CookieHandler)

setDefault

public static void setDefault(CookieHandler cHandler)
システム全体のクッキーハンドラを設定 (または設定解除) します。注: 非標準 HTTP プロトコルハンドラは、この設定を無視する場合があります。

パラメータ:
cHandler - HTTP クッキーハンドラ。設定解除の場合は null
例外:
SecurityException - セキュリティマネージャがインストールされており、NetPermission("setCookieHandler") を拒否した場合
関連項目:
getDefault()

get

public abstract Map<String,List<String>> get(URI uri,
                                             Map<String,List<String>> requestHeaders)
                                      throws IOException
要求ヘッダ内に指定された uri のクッキーキャッシュから、適用可能なすべてのクッキーを取得します。 HTTP プロトコルの実装者は、クッキーの選択に関連したすべての要求ヘッダを追加したあと、要求を送信する前に、このメソッドを呼び出す必要があります。

パラメータ:
uri - 要求としてクッキーを送信する宛先 URI
requestHeaders - 要求ヘッダフィールド名と、現在の要求ヘッダを表すフィールド値のリストを対応付ける Map
戻り値:
状態管理ヘッダと状態情報を含むクッキーのリストのマップ。不変で、フィールド名 Cookie または Cookie2 を持つ
例外:
IOException - 入出力エラー * が発生した場合
IllegalArgumentException - どちらかの引数が null の場合
関連項目:
put(URI, Map)

put

public abstract void put(URI uri,
                         Map<String,List<String>> responseHeaders)
                  throws IOException
適用可能なすべてのクッキー (たとえば応答ヘッダ内のフィールド Set-Cookie2) を、クッキーキャッシュ内に設定します。

パラメータ:
uri - クッキーのソースになる URI
responseHeaders - フィールド名と、返される応答ヘッダフィールドを表すフィールド値のリストを対応付ける不変のマップ
例外:
IOException - 入出力エラーが発生した場合
IllegalArgumentException - どちらかの引数が null の場合
関連項目:
get(URI, Map)

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 も参照してください。