Language

IdentityHashMap クラス

定義

このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュ テーブルを持つ 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
継承
属性
実装

注釈

このクラスは、キー (および値) を比較するときに、オブジェクトの等価性の代わりに参照等価性を使用して、ハッシュ テーブルを持つ 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 ドキュメント。

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

コンストラクター

Name 説明
IdentityHashMap()

既定の予想最大サイズ (21) を使用して、新しい空の ID ハッシュ マップを構築します。

IdentityHashMap(IDictionary)

指定したマップ内のキーと値のマッピングを含む新しい ID ハッシュ マップを構築します。

IdentityHashMap(Int32)

指定された最大サイズを持つ新しい空のマップを構築します。

IdentityHashMap(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()

この ID ハッシュ マップの簡易コピーを返します。キーと値自体は複製されません。

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)
Notify()

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

(継承元 Object)
NotifyAll()

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

(継承元 Object)
Put(Object, Object)

指定した値を、このマップ内の指定したキーに関連付けます (省略可能な操作)。

(継承元 AbstractMap)
PutAll(IDictionary)

指定したマップからすべてのマッピングをこのマップにコピーします (省略可能な操作)。

(継承元 AbstractMap)
Remove(Object, Object)

指定した値に現在マップされている場合にのみ、指定したキーのエントリを削除します。

Remove(Object)

キーが存在する場合は、このマップからキーのマッピングを削除します (省略可能な操作)。

(継承元 AbstractMap)
Replace(Object, Object, Object)

指定した値に現在マップされている場合にのみ、指定したキーのエントリを置き換えます。

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側で有効であることを確認します。

適用対象