Hashtable 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
此類別實作一個雜湊表,將鍵值映射為值。
[Android.Runtime.Register("java/util/Hashtable", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public class Hashtable : Java.Util.Dictionary, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Util.IMap
[<Android.Runtime.Register("java/util/Hashtable", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type Hashtable = class
inherit Dictionary
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICloneable
interface IMap
- 繼承
- 屬性
- 實作
備註
此類別實作一個雜湊表,將鍵值映射為值。 任何非null 物件都可以用作鍵或值。
要成功儲存和檢索雜湊表中的物件,作為鍵的物件必須實作該hashCode方法與方法。equals
一個 Hashtable 實例有兩個參數會影響其效能: 初始容量 與 負載因子。
容量是雜湊表中桶的數量,初始容量則是雜湊表建立時的容量。 請注意,雜湊表是 開放的:在「雜湊碰撞」的情況下,一個桶儲存多個條目,必須依序搜尋。
負載因子是衡量雜湊表容量自動增加前被允許填滿的程度。 初始容量與負載因數參數僅為實作的提示。 關於何時以及是否會呼叫重排方法的具體細節,則依實作而異。
一般來說,預設的負載因子(0.75)在時間與空間成本之間取得了不錯的平衡。 值越高,空間開銷越低,但查詢項目的時間成本增加(這反映在大多數 Hashtable 操作中,包括 get 和 put)。
初始容量控制了浪費空間與操作需求 rehash 之間的權衡,而操作本身耗時。 若初始容量超過rehash最大入口數除以負載因子,則不會Hashtable進行操作。 然而,初始容量設定過高可能會浪費空間。
若多個條目要被建立為 Hashtable,建立足夠大容量的條目,可能比讓它自動重排以擴充資料表更有效率地插入這些條目。
此範例建立一個數字雜湊表。 它使用數字名稱作為鍵:
{@code
Hashtable<String, Integer> numbers
= new Hashtable<String, Integer>();
numbers.put("one", 1);
numbers.put("two", 2);
numbers.put("three", 3);}
要取得一個數字,請使用以下代碼:
{@code
Integer n = numbers.get("two");
if (n != null) {
System.out.println("two = " + n);
}}
所有本類別「集合檢視方法」所回傳的集合中,方法回傳 iterator 的迭代器為 <em>fail-fast</em>:若雜湊表在迭代器建立後的任何時間以任何方式(除迭代器自身 remove 方法外)被結構修改,迭代器將拋出 ConcurrentModificationException。 因此,面對並行修改時,迭代器能迅速且乾淨地失敗,而非冒著未來某個未知時間出現任意且非確定性行為的風險。 Hashtable #keys keys 與 #elements elements 方法回傳的列舉為 <em>not</em> fail-fast;若在列舉建立後任何時間結構修改過,則列舉結果未定義。
請注意,迭代器的失效快速行為無法保證,因為一般而言,在存在非同步的並行修改時,無法做出任何硬性保證。 失效快速迭代器則是以盡力而為的方式投擲 ConcurrentModificationException 。 因此,撰寫依賴此例外來確保正確性的程式是錯誤的: 迭代器的快速失效行為應該只用來偵測錯誤。
自 Java 2 平台 v1.2 起,此類別被後改以實作介面Map,使其成為
Java 集合框架。 與新的集合實作不同, Hashtable 它是同步的。 若不需要執行緒安全實作,建議以 HashMapHashtable取代 。 若希望實現執行緒安全的高度並行實作,建議使用 java.util.concurrent.ConcurrentHashMapHashtable。
1.0 版本新增。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| Hashtable() |
建立一個新的空白雜湊表,預設初始容量為 11,負載因子為 0。 |
| Hashtable(IDictionary) |
建立一個與該映射相同的新雜湊表。 |
| Hashtable(Int32, Single) |
建立一個新的空雜湊表,包含指定的初始容量與負載因子。 |
| Hashtable(Int32) |
建構一個新的空白雜湊表,包含指定的初始容量與預設負載因子(0. |
| Hashtable(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsEmpty |
測試這個雜湊表是否將任何鍵對應到值。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
方法
| 名稱 | Description |
|---|---|
| Clear() |
清除此雜湊表,使其不包含鍵。 |
| Clone() |
建立這個雜湊表的淺層副本。 |
| Compute(Object, IBiFunction) |
嘗試計算指定鍵及其當前映射值的映射(若無當前映射則為空值)。 |
| ComputeIfAbsent(Object, IFunction) |
若指定鍵尚未與某值相關聯(或映射為空值),則嘗試使用該映射函數計算該值,並輸入該映射,除非為空值。 |
| ComputeIfPresent(Object, IBiFunction) |
若指定鍵值存在且非空值,則嘗試在該鍵及其當前映射值下計算新的映射。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
將此對等節點的建置委派給執行時的值管理器。 (繼承來源 JavaObject) |
| Contains(Object) |
測試某些鍵是否映射到此雜湊表中指定的值。 |
| ContainsKey(Object) |
測試指定的物件是否是此雜湊表中的金鑰。 |
| ContainsValue(Object) |
若此雜湊表將一個或多個鍵對應到該值,則回傳為真。 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
請求值管理器處置此對等節點,除非其映射保留該受管理實例。 (繼承來源 JavaObject) |
| Elements() |
回傳此雜湊表中數值的枚舉。 |
| EntrySet() |
回傳 |
| Equals(Object) |
測試另一個受管理節點是否參考相同的 Java 物件。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| ForEach(IBiConsumer) |
呼叫本表中每個鍵值項目的指定操作。 |
| Get(Object) |
回傳指定金鑰所映射的值,或 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetOrDefault(Object, Object) |
當沒有映射時,會查找一個金鑰並使用指定的預設值。 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。 (繼承來源 Object) |
| Keys() |
回傳此雜湊表中金鑰的枚舉。 |
| KeySet() |
回傳 |
| Merge(Object, Object, IBiFunction) |
如果指定的鍵尚未與某值相關聯或與空值相關聯,則會將其與給定的非空值關聯。 |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Put(Object, Object) |
將指定 |
| PutAll(IDictionary) |
將指定映射中的所有映射複製到此雜湊表。 |
| PutIfAbsent(Object, Object) |
只有當資料表中沒有該鍵的條目時,才會加入指定的映射。 |
| Rehash() |
增加雜湊表容量並內部重組,以更有效率地容納與存取其條目。 |
| Remove(Object, Object) |
從雜湊表中移除金鑰(及其對應值)。 |
| Remove(Object) |
從雜湊表中移除金鑰(及其對應值)。 |
| Replace(Object, Object, Object) |
只有當金鑰存在且其值等於預期值時,才會改變映射。 |
| Replace(Object, Object) |
只有當該鍵已經存在於此表時,才會改變該鍵的值。 |
| ReplaceAll(IBiFunction) |
更新每個項目的值,並更新指定函數的結果。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在控制區塊中儲存參考值,但不建立 JNI 參考副本。 (繼承來源 JavaObject) |
| Size() |
回傳此雜湊表中的金鑰數量。 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Values() |
回傳 |
| 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) |
試著強制 |