Language

WeakHashMap クラス

定義

Map インターフェイスのハッシュ テーブル ベースの実装(<em>weak キー</em>。

[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 インターフェイスのハッシュ テーブル ベースの実装(<em>weak キー</em>。 キーが通常使用されなくなった場合、 WeakHashMap のエントリは自動的に削除されます。 より正確には、特定のキーのマッピングが存在する場合、ガベージ コレクターによってキーが破棄されるのを防ぐ、つまり、ファイナライズ可能にし、最終処理し、再利用することはできません。 キーが破棄されると、そのエントリは実質的にマップから削除されるため、このクラスの動作は他の Map 実装とは若干異なります。

null 値と null キーの両方がサポートされています。 このクラスには、 HashMap クラスと同様のパフォーマンス特性があり、 <em>initial capacity</em> と <em>load factor</em> の同じ効率パラメーターがあります。

ほとんどのコレクション クラスと同様に、このクラスは同期されません。 同期された WeakHashMap は、 Collections#synchronizedMap Collections.synchronizedMap メソッドを使用して構築できます。

このクラスは主に、 equals メソッドが == 演算子を使用してオブジェクト ID をテストするキー オブジェクトで使用することを目的としています。 このようなキーが破棄された後は再作成できないため、後で WeakHashMap でそのキーを検索することは不可能であり、そのエントリが削除されたことに驚きます。 このクラスは、 equals メソッドがオブジェクト ID ( String インスタンスなど) に基づいていないキー オブジェクトと完全に連携します。 ただし、このような再作成可能なキー オブジェクトでは、キーが破棄された WeakHashMap エントリを自動的に削除すると、混乱を招く可能性があります。

WeakHashMap クラスの動作はガベージ コレクターのアクションに一部依存するため、このクラスにはいくつかの使い慣れた (必須ではありませんが) Mapインバリアントは保持されません。 ガベージ コレクターはいつでもキーを破棄できるため、 WeakHashMap は、不明なスレッドがエントリを自動的に削除しているかのように動作する可能性があります。 特に、 WeakHashMap インスタンスで同期し、そのミューテーター メソッドを呼び出さない場合でも、 size メソッドは時間の経過と同時に小さい値を返し、 isEmpty メソッドが false を返してから trueできます。 containsKey メソッドは特定のキーの true 以降の false を返し、 get メソッドは特定のキーの値を返しますが、後で戻 nullput メソッドが null を返し、 remove メソッドがマップ内にあるように見えたキーの false を返し、キー セット、値コレクション、およびエントリ セットを連続して調べて、要素の数を連続して小さくします。

WeakHashMap内の各キー オブジェクトは、弱参照の参照先として間接的に格納されます。 そのため、キーは、マップの内側と外側の両方で、弱い参照がガベージ コレクターによってクリアされた後にのみ、自動的に削除されます。

<strong>Implementation note:</strong>WeakHashMap 内の値オブジェクトは、通常の厳密な参照によって保持されます。 したがって、キーが破棄されないようにするため、値オブジェクトが直接または間接的に独自のキーを強く参照しないように注意する必要があります。 値オブジェクトは、 WeakHashMap 自体を介してそのキーを間接的に参照する可能性があることに注意してください。つまり、値オブジェクトは、関連する値オブジェクトが最初の値オブジェクトのキーを強く参照する他のキー オブジェクトを強く参照する可能性があります。 マップ内の値がそれらに対する強い参照を保持しているマップに依存しない場合、これに対処する 1 つの方法は、挿入する前に WeakReferences 内で値自体をラップし、次のように m.put(key, new WeakReference(value))し、各 getでラップを解除することです。

このクラスのすべての "コレクション ビュー メソッド" によって返されるコレクションの iterator メソッドによって返される反復子は 、フェイル ファストです。反復子が作成された後にいつでもマップが構造的に変更された場合、反復子独自の remove メソッドを使用する場合を除き、反復子は ConcurrentModificationExceptionをスローします。 したがって、同時変更が発生した場合、反復子は、将来不確定な時点で任意の非決定論的な動作を危険にさらすのではなく、迅速かつクリーンに失敗します。

反復子のフェイルファスト動作は、一般的に言えば、非同期の同時変更が存在する場合にハード保証することは不可能であるため、保証できないことに注意してください。 フェイルファスト反復子は、ベスト エフォートベースで ConcurrentModificationException をスローします。 したがって、正しさのためにこの例外に依存するプログラムを記述するのは間違っています。 反復子のフェイルファスト動作はバグを検出するためにのみ使用する必要があります。

このクラスは、 Java Collections Framework のメンバーです。

1.2 で追加されました。

Javaドキュメント。

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

コンストラクター

Name 説明
WeakHashMap()

既定の初期容量 (16) と負荷係数 (0) を使用して、新しい空の WeakHashMap を構築します。

WeakHashMap(IDictionary)

指定したマップと同じマッピングを持つ新しい WeakHashMap を構築します。

WeakHashMap(Int32, Single)

指定された初期容量と特定の負荷係数を使用して、新しい空の WeakHashMap を構築します。

WeakHashMap(Int32)

指定された初期容量と既定の負荷係数 (0) を使用して、新しい空の WeakHashMap を構築します。

WeakHashMap(IntPtr, JniHandleOwnership)

JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

プロパティ

Name 説明
Class

この Objectのランタイム クラスを返します。

(継承元 Object)
Handle

基になる Android インスタンスへのハンドル。

(継承元 Object)
IsEmpty

このマップにキーと値のマッピングが含まれている場合は true を返します。

(継承元 AbstractMap)
JniIdentityHashCode

相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。

(継承元 Object)
JniManagedPeerState

ランタイムによって最後に割り当てられた状態フラグを取得します。

(継承元 JavaObject)
JniPeerMembers

このJava バインドのメンバーにアクセスするために使用される JNI メタデータを取得します。

PeerReference

このJava ピアの JNI オブジェクト参照を取得します。

(継承元 Object)
ThresholdClass

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

ThresholdType

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

Name 説明
Clear()

このマップからすべてのマッピングを削除します (省略可能な操作)。

(継承元 AbstractMap)
Clone()

このオブジェクトのコピーを作成して返します。

(継承元 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

このピアの構築をランタイムの値マネージャーに委任します。

(継承元 JavaObject)
ContainsKey(Object)

このマップに指定したキーのマッピングが含まれている場合は true を返します。

(継承元 AbstractMap)
ContainsValue(Object)

このマップが 1 つ以上のキーを指定した値にマップする場合は true を返します。

(継承元 AbstractMap)
Dispose()

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
Dispose(Boolean)

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
DisposeUnlessReferenced()

マッピングで同じマネージド インスタンスが保持されない限り、このピアを破棄するように値マネージャーに要求します。

(継承元 JavaObject)
EntrySet()

このマップに含まれるマッピングの Set ビューを返します。

Equals(Object)

別のマネージド ピアが同じJava オブジェクトを参照しているかどうかをテストします。

(継承元 JavaObject)
Equals(Object)

他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。

(継承元 Object)
ForEach(IBiConsumer)

弱いキーがクリアされていないマップ エントリに対して、指定された操作を呼び出します。

Get(Object)

指定したキーがマップされる値を返します。このマップにキーのマッピングが含まれている場合は null を返します。

(継承元 AbstractMap)
GetHashCode()

オブジェクトのハッシュ コード値を返します。

(継承元 Object)
JavaFinalize()
古い.

オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。

(継承元 Object)
KeySet()

このマップに含まれるキーの Set ビューを返します。

(継承元 AbstractMap)
NewWeakHashMap(Int32)

予想されるマッピング数に適した、新しい空の WeakHashMap を作成します。

Notify()

このオブジェクトのモニターで待機している 1 つのスレッドを起動します。

(継承元 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>notified</em> または <em>interrupted</em>。

(継承元 Object)
Wait(Int64, Int32)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)
Wait(Int64)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)

明示的なインターフェイスの実装

Name 説明
IJavaPeerable.Disposed()

このピアを破棄済みとしてマークし、disposingが true に設定されたDisposeを呼び出します。

(継承元 JavaObject)
IJavaPeerable.Finalized()

このピアを破棄済みとしてマークし、disposingが false に設定されたDisposeを呼び出します。

(継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

このピアで使用されるネイティブの control-block ポインターを取得します。

(継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

ランタイムによって提供される ID ハッシュ コードを格納します。

(継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

格納されているマネージド ピア状態フラグを置き換えます。

(継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

参照が無効な場合は、ピア参照を更新し、破棄されたピアの制御ブロックを解放します。

(継承元 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

ランタイムのJava オブジェクト参照からこのインスタンスを削除します。

拡張メソッド

Name 説明
GetJniTypeName(IJavaPeerable)

インスタンス selfの型の JNI 名を取得します。

JavaAs<TResult>(IJavaPeerable)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

JavaCast<TResult>(IJavaObject)

Android ランタイムチェック型変換を実行します。

JavaCast<TResult>(IJavaObject)

互換性のあるマネージド ピアを再利用するか、要求された型のラッパーを取得します。

TryJavaCast<TResult>(IJavaPeerable, TResult)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

適用対象