CookieManager 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
CookieManager 提供了具體的實作, CookieHandler將 Cookie 的儲存與接受與拒絕 Cookie 的政策分開。
[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
- 繼承
- 屬性
備註
CookieManager 提供了具體的實作, CookieHandler將 Cookie 的儲存與接受與拒絕 Cookie 的政策分開。 CookieManager 初始化時會以管理儲存的 a CookieStore 和 CookiePolicy 一個物件,負責對 Cookie 的接受或拒絕做出政策決策。
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 呼叫,以判斷是否應接受某個 Cookie 並放入 Cookie 儲存。 使用者可以使用三種預先定義的 CookiePolicy 之一,分別是 ACCEPT_ALL、ACCEPT_NONE 和 ACCEPT_ORIGINAL_SERVER,或者使用者可以自行定義 CookiePolicy 實作並告訴 CookieManager 使用。 </li><li> CookieStore 是儲存任何已接受 HTTP Cookie 的地方。 若建立時未指定,CookieManager 實例將使用內部記憶體實作。 或者使用者可以實作一個,然後告訴 CookieManager 使用它。 </li><> 目前,CookieManager 僅使用 CookieStore.add(URI, HttpCookie) 和 CookieStore.get(URI)。 其他則是為了完整性,且可能需要更先進的 CookieStore 實作,例如 NetscapeCookieStore。 </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>讓 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 文件 java.net.CookieManager。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| 名稱 | Description |
|---|---|
| CookieManager() |
建立一個新的 Cookie 管理器。 |
| CookieManager(ICookieStore, ICookiePolicy) |
建立一個新的 Cookie 管理器,並指定 Cookie 商店和 Cookie 政策。 |
| CookieManager(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
傳回這個 |
| CookieStore |
要取得目前的 Cookie 商店。 |
| Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
| ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並傳回這個 對象的複本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
將此對等節點的建置委派給執行時的值管理器。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
請求值管理器處置此對等節點,除非其映射保留該受管理實例。 (繼承來源 JavaObject) |
| Equals(Object) |
測試另一個受管理節點是否參考相同的 Java 物件。 (繼承來源 JavaObject) |
| Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
| Get(URI, IDictionary<String,IList<String>>) |
從請求標頭中指定 URI 的 cookie 快取取得所有適用的 Cookie。 |
| GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾收集決定不再參考物件時,垃圾收集行程在 物件上呼叫。 (繼承來源 Object) |
| Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
| NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
| Put(URI, IDictionary<String,IList<String>>) |
Set 所有適用的 Cookie,例如回應標頭欄位 Set-Cookie2,這些欄位存在於 Cookie 快取的回應標頭中。 |
| SetCookiePolicy(ICookiePolicy) |
設定這個 Cookie 管理員的 Cookie 政策。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在控制區塊中儲存參考值,但不建立 JNI 參考副本。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。 (繼承來源 Object) |
| Wait(Int64, Int32) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
| Wait(Int64) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |