IdentityHashMap クラス

定義

名前空間:: Java.Util

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ Map インターフェイスを実装します。

[Android.Runtime.Register("java/util/IdentityHashMap", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public class IdentityHashMap : Java.Util.AbstractMap, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable

[<Android.Runtime.Register("java/util/IdentityHashMap", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type IdentityHashMap = class
    inherit AbstractMap
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable
    interface IMap

継承: Object

JavaObject

Object

AbstractMap
IdentityHashMap

属性: RegisterAttribute JavaTypeParametersAttribute

実装: IJavaObject IJavaPeerable ISerializable ICloneable IMap IDisposable

注釈

このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ Map インターフェイスを実装します。つまり、IdentityHashMapでは、k1場合にのみ、2 つのキーk2と(k1==k2)が等しいと見なされます。 (通常の Map 実装 ( HashMap など) では、2 つのキー k1 と k2 は、 (k1==null ? k2==null : k1.equals(k2))場合にのみ等しいと見なされます)。

<b>このクラスは汎用の実装Map。このクラスは Map インターフェイスを実装しますが、意図的に Map's 一般的なコントラクトに違反しているため、オブジェクトを比較するときに equals メソッドを使用する必要があります。このクラスは、参照等価セマンティクスが必要なまれなケースでのみ使用するように設計されています。</b>

このマップのビューコレクションには、要素の参照等価セマンティクスもあります。詳細については、 keySet() keySet、 values() values、および entrySet() entrySet メソッドを参照してください。

このクラスの一般的な用途は、シリアル化やディープコピーなど、 トポロジを保持するオブジェクトグラフ変換です。このような変換を実行するには、既に処理されているすべてのオブジェクト参照を追跡する "ノードテーブル" をプログラムで保持する必要があります。ノードテーブルは、オブジェクトが等しい場合でも、個別のオブジェクトを等しくすることはできません。このクラスのもう 1 つの一般的な用途は、 プロキシオブジェクトを維持することです。たとえば、デバッグ機能では、デバッグ対象のプログラム内の各オブジェクトのプロキシオブジェクトを保持することが必要な場合があります。

このクラスは、省略可能なすべてのマップ操作を提供し、 null 値と null キーを許可します。このクラスは、マップの順序について保証しません。特に、順序が時間の経過と同時に一定であることを保証するものではありません。

このクラスは、システム ID ハッシュ関数 (get) がバケット間で要素を適切に分散すると仮定して、基本操作 (putとSystem#identityHashCode(Object)) に一定時間のパフォーマンスを提供します。

このクラスには 1 つのチューニングパラメーターがあります (パフォーマンスには影響しますが、セマンティクスには影響しません)。 予想される最大サイズです。このパラメーターは、マップが保持すると予想されるキーと値のマッピングの最大数です。内部的には、このパラメーターを使用して、最初にハッシュテーブルを構成するバケットの数を決定します。予想される最大サイズとバケット数の間の正確な関係は指定されていません。

マップのサイズ (キーと値のマッピングの数) が予想される最大サイズを十分に超えると、バケットの数が増えます。バケットの数 ("rehashing") を増やすとかなりコストがかかる可能性があるため、予想される最大サイズが十分に大きい ID ハッシュマップを作成する場合に課金されます。一方、コレクションビューの繰り返しでは、ハッシュテーブル内のバケット数に比例した時間が必要になるため、反復のパフォーマンスやメモリ使用量に特に関心がある場合は、予想される最大サイズを高く設定しないようにします。

<strong>この実装が同期されていないことを確認します。</strong> 複数のスレッドが同時に ID ハッシュマップにアクセスし、少なくとも 1 つのスレッドがマップを構造的に変更する場合は、外部で同期する 必要があります 。 (構造変更とは、1 つ以上のマッピングを追加または削除する操作です。インスタンスに既に含まれているキーに関連付けられている値を変更するだけでは、構造変更ではありません)。これは通常、マップを自然にカプセル化するオブジェクトを同期することによって実現されます。

このようなオブジェクトが存在しない場合は、 Collections#synchronizedMap Collections.synchronizedMap メソッドを使用してマップを "ラップ" する必要があります。これは、マップへの誤った同期されていないアクセスを防ぐために、作成時に行うのが最善です。

Map m = Collections.synchronizedMap(new IdentityHashMap(...));

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

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

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

1.4 で追加されました。

java.util.IdentityHashMapの Java ドキュメント。

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

コンストラクター

名前	説明
IdentityHashMap()	既定の予想最大サイズ (21) を使用して、新しい空の ID ハッシュマップを構築します。
IdentityHashMap(IDictionary)	指定したマップ内のキーと値のマッピングを含む新しい ID ハッシュマップを構築します。
IdentityHashMap(Int32)	指定された最大サイズを持つ新しい空のマップを構築します。
IdentityHashMap(IntPtr, JniHandleOwnership)	JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

プロパティ

名前	説明
Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
IsEmpty	追加する (継承元 AbstractMap)
JniIdentityHashCode	相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュコードを取得します。 (継承元 Object)
JniManagedPeerState	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
JniPeerMembers	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。
PeerReference	このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object)
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

名前	説明
Clear()	追加する (継承元 AbstractMap)
Clone()	この ID ハッシュマップの簡易コピーを返します。キーと値自体は複製されません。
Construct(JniObjectReference, JniObjectReferenceOptions)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
ContainsKey(Object)	追加する (継承元 AbstractMap)
ContainsValue(Object)	追加する (継承元 AbstractMap)
Dispose()	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
Dispose(Boolean)	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
DisposeUnlessReferenced()	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
EntrySet()	このマップに含まれるマッピングの `Set` ビューを返します。
Equals(Object)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
ForEach(IBiConsumer)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。
Get(Object)	追加する (継承元 AbstractMap)
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
JavaFinalize()	オブジェクトへの参照がなくなったとガベージコレクションによって判断されたときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
KeySet()	追加する (継承元 AbstractMap)
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object)
Put(Object, Object)	追加する (継承元 AbstractMap)
PutAll(IDictionary)	追加する (継承元 AbstractMap)
Remove(Object, Object)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。
Remove(Object)	追加する (継承元 AbstractMap)
Replace(Object, Object, Object)	追加する
ReplaceAll(IBiFunction)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 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)

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

名前	説明
IJavaPeerable.Disposed()	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
IJavaPeerable.Finalized()	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。 (継承元 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。

拡張メソッド

名前	説明
GetJniTypeName(IJavaPeerable)	インスタンス `self`の型の JNI 名を取得します。
JavaAs<TResult>(IJavaPeerable)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。
JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュテーブルを持つ `Map` インターフェイスを実装します。
TryJavaCast<TResult>(IJavaPeerable, TResult)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。

適用対象