クラスCookieHandler

java.lang.Object
java.net.CookieHandler
直系の既知のサブクラス:
CookieManager
public abstract class CookieHandler extends Object
CookieHandlerオブジェクトは、HTTPプロトコル・ハンドラにHTTP状態管理ポリシー実装を組み込むためのコールバック・メカニズ を提供します。 HTTP状態管理メカニズ は、HTTPの要求と応答を使ってステートフル・セッションを作成する方法を指定します。

「HTTP URLストリー ・プロトコル・ハンドラ」が使用するシステ 全体のCookieHandlerは、CookieHandler.setDefault(CookieHandler)を実行することによって登録できます。 現在登録されているCookieHandlerを取得するには、CookieHandler.getDefault()を呼び出します。 HTTP状態管理の詳細は、「RFC 2965: HTTP状態管理メカニズ 」を参照してく さい

導入されたバージョン:
1.5
外部仕様

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    CookieHandler()
    サブクラスが呼び出すためのコンストラクタ。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    abstract Map<String, List<String>>
    get(URI uri, Map<String, List<String>> requestHeaders)
    要求ヘッダー内に指定されたURIのCookieキャッシュから適用可能なすべてのCookieを取得します。
    static CookieHandler
    getDefault()
    システ 全体のCookieハンドラを取得します。
    abstract void
    put(URI uri, Map<String, List<String>> responseHeaders)
    応答ヘッダー内に存在するSet-Cookie2という名前の応答ヘッダー・フィールドなど、適用可能なすべてのCookieをCookieキャッシュ内に設定します。
    static void
    setDefault(CookieHandler cHandler)
    システ 全体のCookieハンドラを設定(または設定解除)します。

    クラスjava.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • コンストラクタの詳細

    • CookieHandler

      public CookieHandler()
      サブクラスが呼び出すためのコンストラクタ。

  • メソッドの詳細

    • getDefault

      public static CookieHandler getDefault()
      システ 全体のCookieハンドラを取得します。
      戻り値:
      システ 全体のCookieハンドラ。nullが返された 合、それは、システ 全体のCookieハンドラが現在設定されていないことを意味する。
      関連 目:

    • setDefault

      public static void setDefault(CookieHandler cHandler)
      システ 全体のCookieハンドラを設定(または設定解除)します。 ノート: 標準でないHTTPプロトコル・ハンドラは、この設定を無視する可能性があります。
      パラメータ:
      cHandler - HTTP Cookieハンドラ。設定解除する 合はnull。
      関連 目:

    • get

      public abstract Map<String, List<String>> get(URI uri, Map<String, List<String>> requestHeaders) throws IOException
      要求ヘッダー内に指定されたURIのCookieキャッシュから適用可能なすべてのCookieを取得します。

      引数として渡されるURIは、Cookieの使用目的を指定します。 たとえば、スキー にはCookieがhttpまたはhttpsのどちらで送信されるのかや、Javascriptなどの別のコンテキストで使用されるのかを反 するべきです。 ホスト部分にはCookieの転送先またはJavascriptの 合はそれらのオリジンを反 するべきです。

      どれを返すかを決定する際に、URIおよびCookieの属性とセキュリティ設定を考慮することは、実装に任されています。

      HTTPプロトコルの実装者は、Cookieの選択に関係するすべての要求ヘッダーが追 されてから要求が送信されるまでの間に、必ずこのメソッドが呼び出されるようにしてく さい。

      パラメータ:
      uri - Cookieの使用目的を表すURI
      requestHeaders - リクエスト・ヘッダー・フィールド名から現在のリクエスト・ヘッダーを表すフィールド値のリストへのマップ
      戻り値:
      フィールド名「Cookie」または「Cookie2」を持つ状態管理ヘッダーから状態情 が 納されたCookieのリストへの不変のマップ
      スロー:
      IOException - 入出力エラーが発生した 合
      IllegalArgumentException - どちらかの引数がnullの 合
      関連 目:

    • put

      public abstract void put(URI uri, Map<String, List<String>> responseHeaders) throws IOException
      応答ヘッダー内に存在するSet-Cookie2という名前の応答ヘッダー・フィールドなど、適用可能なすべてのCookieをCookieキャッシュ内に設定します。
      パラメータ:
      uri - Cookieの生成元のURI
      responseHeaders - 返された応答ヘッダー・フィールドを表す、フィールド名からフィールド値のリストへの不変のマップ
      スロー:
      IOException - 入出力エラーが発生した 合
      IllegalArgumentException - どちらかの引数がnullの 合
      関連 目: