WeakHashMap 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
介面以雜湊表實作Map,並有<弱>鍵/弱<鍵>。
[Android.Runtime.Register("java/util/WeakHashMap", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public class WeakHashMap : Java.Util.AbstractMap, IDisposable
[<Android.Runtime.Register("java/util/WeakHashMap", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type WeakHashMap = class
inherit AbstractMap
interface IMap
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 繼承
- 屬性
- 實作
備註
介面以雜湊表實作Map,並有<弱>鍵/弱<鍵>。 當 a WeakHashMap 中的條目不再被正常使用時,將自動移除。 更精確地說,某一金鑰的映射存在,並不會阻止該金鑰被垃圾回收器丟棄,也就是說,該金鑰會被最終化、最終定型,然後再被回收。 當一個鍵被丟棄時,其條目會有效地從映射中移除,因此此類別的行為與其他實作有所不同 Map 。
同時支援 null 值與 null 鍵。 此級車的性能特性與本HashMap級相似,且效率參數相同:<電磁>初始容量</電磁><及電磁>負載因子</電磁>。
與大多數集合類別相同,此類別並非同步。 可用此WeakHashMap方法構建同步裝置Collections#synchronizedMap Collections.synchronizedMap。
此類別主要用於使用其 equals 方法測試物件身份 == 的鍵物件,使用運算子。 一旦此類金鑰被丟棄,就無法再重建,因此不可能在某個時間點查詢該金鑰 WeakHashMap ,並驚訝其條目已被移除。 此類別對於方法 equals 不基於物件身份的金鑰物件(如 String 實例)運作良好。 然而,對於這些可重複的金鑰物件,自動移除 WeakHashMap 已丟棄金鑰的條目可能會造成混淆。
該 WeakHashMap 類別的行為部分依賴於垃圾回收器的動作,因此這個類別不具數常見(但非必需) Map 不變量。 由於垃圾回收器隨時可能丟棄金鑰,因此 a WeakHashMap 可能會表現得像是未知的執行緒在悄悄移除條目。 特別地,即使你在某WeakHashMap個實例上同步且不呼叫任何變異器方法,方法仍可能size隨時間回傳較小的值,isEmpty方法回傳falsetruecontainsKey,然後回傳true,之後false對給定鍵get回傳,方法回傳給定鍵值後回傳,null 對於put先前看似在映射中的鍵,方法回傳nullremove與回傳false方法,以及對鍵組、值集合和入口集合的連續檢查,得出的元素數量逐漸減少。
a WeakHashMap 中的每個關鍵物件會間接儲存為弱參考的指稱。 因此,只有在垃圾回收器清除地圖內外對該鑰匙的弱參考後,才能自動移除該鑰匙。
<強實>作注意:</strong> a中的 WeakHashMap 值物件由普通強參考所持有。 因此應謹慎確保值物件不會直接或間接強烈指向自己的鍵,因為這樣會防止鍵被丟棄。 請注意,值物件可以透過自身間接指向其鍵 WeakHashMap ;也就是說,值物件可以強指涉另一個鍵物件,而該物件的相關值物件又強指涉第一個值物件的鍵。 如果映射中的值不依賴映射本身有強參考,一種處理方法是先將值本身包裹在 WeakReferences 內再插入,例如: m.put(key, new WeakReference(value)),然後對每個 get展開。
所有本類別「集合檢視方法」所回傳的集合中,方法回傳 iterator 的迭代器是 失敗快速的:若在迭代器建立後的任何時間對映射進行結構性修改,除非透過迭代器自身 remove 的方法,迭代器會拋出一個 ConcurrentModificationException。 因此,面對並行修改時,迭代器能迅速且乾淨地失敗,而非冒著未來某個未知時間出現任意且非確定性行為的風險。
請注意,迭代器的失效快速行為無法保證,因為一般而言,在存在非同步的並行修改時,無法做出任何硬性保證。 失效快速迭代器則是以盡力而為的方式投擲 ConcurrentModificationException 。 因此,撰寫依賴此例外來確保正確性的程式是錯誤的: 迭代器的快速失效行為應該只用來偵測錯誤。
此類別是 Java 集合框架的成員。
在 1.2 版本中加入。
Java 文件 java.util.WeakHashMap。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| 名稱 | Description |
|---|---|
| WeakHashMap() |
建造一個新的空置 |
| WeakHashMap(IDictionary) |
構造 |
| WeakHashMap(Int32, Single) |
以給定初始容量和載重因子建造一個新的空機 |
| WeakHashMap(Int32) |
以給定初始容量及預設負載因子(0)建造一個新的空機 |
| WeakHashMap(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsEmpty |
若此映射不含鍵值映射,則回傳為真。 (繼承來源 AbstractMap) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
| ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
方法
| 名稱 | Description |
|---|---|
| Clear() |
移除此映射中的所有映射(可選操作)。 (繼承來源 AbstractMap) |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
將此對等節點的建置委派給執行時的值管理器。 (繼承來源 JavaObject) |
| ContainsKey(Object) |
若此映射包含指定鍵的映射,則回傳為真。 (繼承來源 AbstractMap) |
| ContainsValue(Object) |
若此映射將一個或多個鍵映射到指定值,則返回為真。 (繼承來源 AbstractMap) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
請求值管理器處置此對等節點,除非其映射保留該受管理實例。 (繼承來源 JavaObject) |
| EntrySet() |
回傳 |
| Equals(Object) |
測試另一個受管理節點是否參考相同的 Java 物件。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| ForEach(IBiConsumer) |
呼叫未清除弱鍵的映射項目指定操作。 |
| Get(Object) |
回傳指定鍵映射的值,若該映射中沒有鍵的映射,則回傳為空值。 (繼承來源 AbstractMap) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。 (繼承來源 Object) |
| KeySet() |
回傳此映射中所含鍵的集合視圖。 (繼承來源 AbstractMap) |
| NewWeakHashMap(Int32) |
建立一個新的空 WeakHashMap,適用於預期的映射數量。 |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Put(Object, Object) |
將指定值與此映射中的指定鍵鍵關聯(可選操作)。 (繼承來源 AbstractMap) |
| PutAll(IDictionary) |
將指定映射中的所有映射複製到該映射(可選操作)。 (繼承來源 AbstractMap) |
| Remove(Object) |
若該映射存在,則移除該映射(可選操作)。 (繼承來源 AbstractMap) |
| ReplaceAll(IBiFunction) |
更新未清除弱鍵的條目值。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在控制區塊中儲存參考值,但不建立 JNI 參考副本。 (繼承來源 JavaObject) |
| Size() |
回傳此映射中鍵值映射的數量。 (繼承來源 AbstractMap) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Values() |
回傳此映射中所含值的集合檢視。 (繼承來源 AbstractMap) |
| Wait() |
導致目前執行緒等待被喚醒,通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
將此實例從執行時的 Java 物件查詢中移除。 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |