CookieManager クラス

定義

[Android.Runtime.Register("java/net/CookieManager", DoNotGenerateAcw=true)]
public class CookieManager : Java.Net.CookieHandler

[<Android.Runtime.Register("java/net/CookieManager", DoNotGenerateAcw=true)>]
type CookieManager = class
    inherit CookieHandler

継承

Object

JavaObject

Object

CookieHandler

CookieManager

属性

RegisterAttribute

注釈

CookieManager は、cookie の保存と Cookie の受け入れと拒否に関するポリシーを分離する、 CookieHandlerの具体的な実装を提供します。 CookieManager は、ストレージを管理する CookieStore と、Cookie の受け入れ/拒否に関するポリシー決定を行う CookiePolicy オブジェクトで初期化されます。

java.net パッケージでの HTTP Cookie の管理は次のようになります。 <blockquote>

{@code
                             use
            CookieHandler <------- HttpURLConnection
                  ^
                  | impl
                  |         use
            CookieManager -------> CookiePolicy
                        |   use
                        |--------> HttpCookie
                        |              ^
                        |              | use
                        |   use        |
                        |--------> CookieStore
                                       ^
                                       | impl
                                       |
                             Internal in-memory implementation
            }

<ul><li> CookieHandler は Cookie 管理の中核をなしています。 ユーザーは CookieHandler.setDefault を呼び出して、使用する具体的な CookieHanlder 実装を設定できます。 </li><li> CookiePolicy.shouldAccept が CookieManager.put によって呼び出され、1 つの Cookie を受け入れて Cookie ストアに格納する必要があるかどうかを確認します。 ユーザーは、定義済みの 3 つの CookiePolicy (ACCEPT_ALL、ACCEPT_NONE、ACCEPT_ORIGINAL_SERVER) のいずれかを使用できます。また、ユーザーは独自の CookiePolicy 実装を定義し、CookieManager にその実装を使用するように指示できます。 </li><li> CookieStore は、受け入れられた HTTP Cookie が格納される場所です。 作成時に指定しない場合、CookieManager インスタンスは内部メモリ内実装を使用します。 または、ユーザーが実装し、それを使用するように CookieManager に指示できます。 </li><li> 現在、CookieManager で使用されるのは CookieStore.add(URI、HttpCookie) と CookieStore.get(URI) のみです。 その他は完全性を目的としており、NetscapeCookieStore など、より高度な CookieStore 実装で必要になる場合があります。 </li></ul></blockquote>

ユーザーが独自の HTTP Cookie 管理動作をフックできるさまざまな方法があります。 例: <blockquote><ul><li> CookieHandler.setDefault を使用して、新しい CookieHandler 実装 <li> CookieManager を既定の CookieHandler 実装に設定しますが、ユーザー自身の CookieStore と CookiePolicy を実装し、既定の CookieManager に使用するように指示します。 <blockquote>

// this should be done at the beginning of an HTTP session
                  CookieHandler.setDefault(new CookieManager(new MyCookieStore(), new MyCookiePolicy()));

</blockquote><li>Let CookieManager は既定の CookieHandler 実装ですが、カスタマイズされた CookiePolicyを使用します: <blockquote>

// this should be done at the beginning of an HTTP session
                  CookieHandler.setDefault(new CookieManager());
                  // this can be done at any point of an HTTP session
                  ((CookieManager)CookieHandler.getDefault()).setCookiePolicy(new MyCookiePolicy());

</blockquote></ul></blockquote>

実装は RFC 2965、セクション 3.3 に準拠しています。

1.6 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。