IMap インターフェイス

定義

[Android.Runtime.Register("java/util/Map", "", "Java.Util.IMapInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public interface IMap : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/util/Map", "", "Java.Util.IMapInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type IMap = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

派生

Android.Util.ArrayMap

Java.Util.AbstractMap

Java.Util.Concurrent.ConcurrentHashMap

Java.Util.Concurrent.IConcurrentMap

Java.Util.EnumMap

その他…

属性

RegisterAttribute JavaTypeParametersAttribute

実装

IJavaObject IJavaPeerable IDisposable

注釈

キーを値にマップするオブジェクト。 マップに重複するキーを含めることはできません。各キーは最大 1 つの値にマップできます。

このインターフェイスは、インターフェイスではなく完全に抽象クラスであった Dictionary クラスの代わりに使用されます。

Map インターフェイスには、3 つのコレクション ビューが用意されています。これにより、マップの内容を一連のキー、値のコレクション、またはキーと値のマッピングのセットとして表示できます。 マップの 順序 は、マップのコレクション ビュー上の反復子が要素を返す順序として定義されます。 TreeMap クラスのような一部のマップ実装では、遭遇順序に関して特定の保証が行われます。HashMap クラスのような他の実装では保証されません。 一般に、検出順序が定義されたマップは、 SequencedMap インターフェイスのサブタイプです。

注: 変更可能なオブジェクトがマップ キーとして使用される場合は、細心の注意を払う必要があります。 オブジェクトがマップ内のキーである間に、オブジェクトの値が equals 比較に影響する方法で変更された場合、マップの動作は指定されません。 この禁止の特別なケースは、マップ自体をキーとして含めないようにすることです。 マップ自体を値として含めることもできますが、 equals メソッドと hashCode メソッドは、このようなマップ上で明確に定義されなくなりました。

すべての汎用マップ実装クラスは、空のマップを作成する void (引数なし) コンストラクターと、 Map型の単一の引数を持つコンストラクターという 2 つの "標準" コンストラクターを提供する必要があります。このコンストラクターは、その引数と同じキー値マッピングを持つ新しいマップを作成します。 実際には、後者のコンストラクターを使用すると、ユーザーは任意のマップをコピーでき、目的のクラスと同等のマップが生成されます。 (インターフェイスにコンストラクターを含めることはできません)、この推奨事項を適用する方法はありませんが、JDK 内のすべての汎用マップ実装が準拠しています。

このインターフェイスに含まれる "破壊的" メソッド、つまり、操作対象のマップを変更するメソッドは、このマップが操作をサポートしていない場合に UnsupportedOperationException をスローするように指定されます。 この場合、呼び出しがマップに影響を与えない場合、これらのメソッドは UnsupportedOperationException をスローする可能性がありますが、必須ではありません。 たとえば、変更できないマップで #putAll(Map) メソッドを呼び出すと、マッピングが "重ね合わせ" になるマップが空の場合、例外をスローする場合がありますが、必須ではありません。

一部のマップ実装では、キーと値に制限があります。 たとえば、一部の実装では null キーと値が禁止され、一部の実装ではキーの型に制限があります。 無効なキーまたは値を挿入しようとすると、通常は NullPointerException または ClassCastException、チェックされていない例外がスローされます。 不適格なキーまたは値の存在を照会しようとすると、例外がスローされるか、単に false が返される可能性があります。一部の実装は以前の動作を示し、一部は後者を示します。 より一般的には、マップへの不適格な要素の挿入が完了しない不適格なキーまたは値に対する操作を試みると、実装のオプションで例外がスローされたり、成功したりする可能性があります。 このような例外は、このインターフェイスの仕様では "省略可能" としてマークされます。

Collections Framework インターフェイスの多くのメソッドは、 Object#equals(Object) equals メソッドの観点から定義されています。 たとえば、#containsKey(Object) containsKey(Object key) メソッドの仕様には、"このマップにtrueのようなキー kのマッピングが含まれている場合にのみ、(key==null ? k==null : key.equals(k))が返されます" と表示されます。 この仕様は、null 以外の引数Map.containsKeyを使用してkeyを呼び出すと、キー key.equals(k)に対してkが呼び出されることを意味するものではありません。 実装では、最適化を自由に実装できます。そのため、最初に 2 つのキーのハッシュ コードを比較するなどして、 equals 呼び出しを回避できます。 ( Object#hashCode() 仕様では、等しくないハッシュ コードを持つ 2 つのオブジェクトが等しくできないことが保証されます)。より一般的には、さまざまな Collections Framework インターフェイスの実装は、実装者が適切と判断した場合でも、基になる Object メソッドの指定された動作を自由に利用できます。

マップの再帰的トラバーサルを実行する一部のマップ操作は、マップが直接または間接的に自身を含む自己参照インスタンスの例外で失敗することがあります。 これには、 clone()、 equals()、 hashCode() 、および toString() メソッドが含まれます。 実装では必要に応じて自己参照シナリオを処理できますが、最新の実装では処理されません。

<h2>"変更不可">変更できないマップ</h2>

Map#of() Map.of、Map#ofEntries(Map.Entry...) Map.ofEntries、およびMap#copyOf Map.copyOfの静的ファクトリ メソッドを使用すると、変更できないマップを簡単に作成できます。 これらのメソッドによって作成される Map インスタンスには、次の特性があります。

<ul><li><>変更できません</i>。 キーと値を追加、削除、または更新することはできません。 Map でミューテーター メソッドを呼び出すと、常に UnsupportedOperationException がスローされます。 ただし、含まれているキーまたは値自体が変更可能な場合は、マップの動作に一貫性がない場合や、その内容が変わる可能性があります。 <li>キーと値 null 禁止します。 キーまたは値を null して作成しようとすると、 NullPointerExceptionになります。 <li>すべてのキーと値をシリアル化できる場合はシリアル化できます。 <li>作成時に重複するキーを拒否します。 静的ファクトリ メソッドに渡されたキーが重複すると、 IllegalArgumentException。 <li>マッピングの反復順序は指定されておらず、変更される可能性があります。 <li>値に基づいています。 プログラマは、#equals(Object) と等しいインスタンスを交換可能として扱い、同期に使用しないでください。または、予期しない動作が発生する可能性があります。 たとえば、将来のリリースでは、同期が失敗する可能性があります。 呼び出し元は、返されるインスタンスの ID に関する想定を行う必要はありません。 ファクトリは、新しいインスタンスを自由に作成したり、既存のインスタンスを再利用したりできます。 <li>シリアル化フォーム ページで指定されたとおりに シリアル化されます 。 </ul>

このインターフェイスは、Java コレクション フレームワークのメンバーです。

1.2 で追加されました。

Javaドキュメント。

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