IdentityHashMap 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이 클래스는 Map
키(및 값)를 비교할 때 개체 같음 대신 reference-equality를 사용하여 해시 테이블을 사용하여 인터페이스를 구현합니다.
[Android.Runtime.Register("java/util/IdentityHashMap", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public class IdentityHashMap : Java.Util.AbstractMap, IDisposable, Java.Interop.IJavaPeerable, 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
키(및 값)를 비교할 때 개체 같음 대신 reference-equality를 사용하여 해시 테이블을 사용하여 인터페이스를 구현합니다. 즉, 에서 IdentityHashMap
두 개의 키 k1
및 k2
가 인 경우에만 (k1==k2)
같음으로 간주됩니다. (일반적인 Map
구현(예: HashMap
)에서는 두 개의 키가 k1
있고 k2
가 인 경우에만 (k1==null ? k2==null : k1.equals(k2))
같음으로 간주됩니다.
<b>이 클래스는 범용 Map
구현이 아닙니다. 이 클래스는 인터페이스를 Map
구현하지만 개체를 Map's
비교할 때 메서드를 equals
사용해야 하는 일반 계약을 의도적으로 위반합니다. 이 클래스는 참조-같음 의미 체계가 필요한 드문 경우에만 사용하도록 설계되었습니다.</B>
이 클래스의 일반적인 사용은 직렬화 또는 딥 복사와 같은 토폴로지 보존 개체 그래프 변환입니다. 이러한 변환을 수행하려면 프로그램에서 이미 처리된 모든 개체 참조를 추적하는 "노드 테이블"을 유지해야 합니다. 노드 테이블은 같은 경우에도 고유 개체와 동일하지 않아야 합니다. 이 클래스의 또 다른 일반적인 사용은 프록시 개체를 유지 관리하는 것입니다. 예를 들어 디버깅 기능은 디버깅 중인 프로그램의 각 개체에 대해 프록시 개체를 유지 관리할 수 있습니다.
이 클래스는 모든 선택적 맵 작업을 제공하고 값과 null
키를 허용합니다null
. 이 클래스는 맵의 순서를 보장하지 않습니다. 특히 시간이 지남에 따라 주문이 일정하게 유지된다는 보장은 없습니다.
이 클래스는 시스템 ID 해시 함수()가 버킷 간에 요소를 제대로 분산한다고 가정하여 기본 작업(get
System#identityHashCode(Object)
및 put
)에 대한 일정한 시간 성능을 제공합니다.
이 클래스에는 성능에 영향을 주지만 의미 체계는 아닌 하나의 튜닝 매개 변수가 있습니다. 예상 최대 크기입니다. 이 매개 변수는 맵이 보유해야 하는 최대 키-값 매핑 수입니다. 내부적으로 이 매개 변수는 처음에 해시 테이블을 구성하는 버킷 수를 결정하는 데 사용됩니다. 예상되는 최대 크기와 버킷 수 간의 정확한 관계는 지정되지 않습니다.
맵의 크기(키-값 매핑 수)가 예상 최대 크기를 충분히 초과하면 버킷 수가 증가합니다. 버킷 수("다시 해시")를 늘리면 비용이 많이 들 수 있으므로 예상 최대 크기가 충분히 큰 ID 해시 맵을 만드는 데 비용이 듭니다. 반면에 컬렉션 뷰를 반복하려면 해시 테이블의 버킷 수에 비례하는 시간이 필요하므로 특히 반복 성능 또는 메모리 사용량과 관련하여 예상되는 최대 크기를 너무 높게 설정하지 않아야 합니다.
<strong>이 구현은 동기화되지 않습니다.</strong> 여러 스레드가 ID 해시 맵에 동시에 액세스하고 하나 이상의 스레드가 구조적으로 맵을 수정하는 경우 외부에서 동기화 되어야 합니다 . 구조 수정은 하나 이상의 매핑을 추가하거나 삭제하는 작업입니다. instance 이미 포함된 키와 연결된 값을 변경하는 것은 구조적 수정이 아닙니다. 이 작업은 일반적으로 맵을 자연스럽게 캡슐화하는 일부 개체에서 동기화하여 수행됩니다.
이러한 개체가 없으면 메서드를 사용하여 Collections#synchronizedMap Collections.synchronizedMap
맵을 "래핑"해야 합니다. 이는 맵에 대한 실수로 비동기화된 액세스를 방지하기 위해 생성 시 가장 잘 수행됩니다.
Map m = Collections.synchronizedMap(new IdentityHashMap(...));
이 클래스의 모든 "컬렉션 뷰 메서드"에서 반환된 컬렉션의 메서드에서 반환 iterator
되는 반복기는 장애 조치(fail-fast)입니다. 반복기가 생성된 후 언제든지 맵이 구조적으로 수정되면 반복기의 자체 remove
메서드를 통하지 않으면 반복기가 을 ConcurrentModificationException
throw합니다. 따라서 동시 수정에 직면하여 반복기는 나중에 결정되지 않은 시간에 임의적이고 비결정적인 동작을 위험에 빠뜨리지 않고 빠르고 깨끗하게 실패합니다.
반복기의 장애 조치(fail-fast) 동작은 일반적으로 비동기화 동시 수정이 있을 때 하드 보장을 할 수 없으므로 보장할 수 없습니다. 장애 조치(fail-fast) 반복기는 최선을 다해 throw ConcurrentModificationException
합니다. 따라서 이 예외의 정확성에 따라 프로그램을 작성하는 것은 잘못된 것입니다. 장애 조치(fail-fast) 반복기는 버그를 검색하는 데만 사용해야 합니다.
이 클래스는 Java Collections Framework의 멤버입니다.
1.4에 추가되었습니다.
에 대한 Java 설명서입니다 java.util.IdentityHashMap
.
이 페이지의 일부는 만들고 공유하며 에 설명된 조건에 따라 사용되는 작업을 기반으로 수정됩니다.
생성자
IdentityHashMap() |
기본 예상 최대 크기(21)를 사용하여 비어 있는 새 ID 해시 맵을 생성합니다. |
IdentityHashMap(IDictionary) |
지정된 맵의 키-값 매핑을 포함하는 새 ID 해시 맵을 생성합니다. |
IdentityHashMap(Int32) |
지정된 예상 최대 크기로 비어 있는 새 맵을 생성합니다. |
IdentityHashMap(IntPtr, JniHandleOwnership) |
JNI 개체의 관리형 표현을 만들 때 사용되는 생성자입니다. 런타임에서 호출합니다. |
속성
Class |
이 |
Handle |
기본 Android instance 대한 핸들입니다. (다음에서 상속됨 Object) |
IsEmpty |
추가할 항목 (다음에서 상속됨 AbstractMap) |
JniIdentityHashCode |
이 클래스는 |
JniPeerMembers |
이 클래스는 |
PeerReference |
이 클래스는 |
ThresholdClass |
이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. |
ThresholdType |
이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. |
메서드
Clear() |
추가할 항목 (다음에서 상속됨 AbstractMap) |
Clone() |
이 ID 해시 맵의 단순 복사본을 반환합니다. 키와 값 자체는 복제되지 않습니다. |
ContainsKey(Object) |
추가할 항목 (다음에서 상속됨 AbstractMap) |
ContainsValue(Object) |
추가할 항목 (다음에서 상속됨 AbstractMap) |
Dispose() |
이 클래스는 |
Dispose(Boolean) |
이 클래스는 |
EntrySet() |
이 맵에 |
Equals(Object) |
다른 개체가 이 개체와 "같음"인지 여부를 나타냅니다. (다음에서 상속됨 Object) |
ForEach(IBiConsumer) |
이 클래스는 |
Get(Object) |
추가할 항목 (다음에서 상속됨 AbstractMap) |
GetHashCode() |
개체의 해시 코드 값을 반환합니다. (다음에서 상속됨 Object) |
JavaFinalize() |
가비지 수집에서 개체에 대한 참조가 더 이상 없다고 판단할 때 개체의 가비지 수집기에서 호출됩니다. (다음에서 상속됨 Object) |
KeySet() |
추가할 항목 (다음에서 상속됨 AbstractMap) |
Notify() |
이 개체의 모니터에서 대기 중인 단일 스레드를 해제합니다. (다음에서 상속됨 Object) |
NotifyAll() |
이 개체의 모니터에서 대기 중인 모든 스레드를 해제합니다. (다음에서 상속됨 Object) |
Put(Object, Object) |
추가할 항목 (다음에서 상속됨 AbstractMap) |
PutAll(IDictionary) |
추가할 항목 (다음에서 상속됨 AbstractMap) |
Remove(Object) |
추가할 항목 (다음에서 상속됨 AbstractMap) |
ReplaceAll(IBiFunction) |
이 클래스는 |
SetHandle(IntPtr, JniHandleOwnership) |
Handle 속성을 설정합니다. (다음에서 상속됨 Object) |
Size() |
추가할 항목 (다음에서 상속됨 AbstractMap) |
ToArray<T>() |
이 클래스는 |
ToString() |
개체의 문자열 표현을 반환합니다. (다음에서 상속됨 Object) |
UnregisterFromRuntime() |
이 클래스는 |
Values() |
추가할 항목 (다음에서 상속됨 AbstractMap) |
Wait() |
현재 스레드가 깨어날 때까지 대기하게 합니다( 일반적으로 <알림을 받><거나 <>중단/>em>)합니다<. (다음에서 상속됨 Object) |
Wait(Int64) |
현재 스레드가 깨어날 때까지 대기하게 합니다. 일반적으로 <>알림을 받<거나 <중단</>내보내>>거나 일정량의 실시간이 경과할 때까지 대기합니다. (다음에서 상속됨 Object) |
Wait(Int64, Int32) |
현재 스레드가 깨어날 때까지 대기하게 합니다. 일반적으로 <>알림을 받<거나 <중단</>내보내>>거나 일정량의 실시간이 경과할 때까지 대기합니다. (다음에서 상속됨 Object) |
명시적 인터페이스 구현
IJavaPeerable.Disposed() |
이 클래스는 |
IJavaPeerable.DisposeUnlessReferenced() |
이 클래스는 |
IJavaPeerable.Finalized() |
이 클래스는 |
IJavaPeerable.JniManagedPeerState |
이 클래스는 |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
이 클래스는 |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
이 클래스는 |
IJavaPeerable.SetPeerReference(JniObjectReference) |
이 클래스는 |
확장 메서드
JavaCast<TResult>(IJavaObject) |
Android 런타임 확인 형식 변환을 수행합니다. |
JavaCast<TResult>(IJavaObject) |
이 클래스는 |
GetJniTypeName(IJavaPeerable) |
이 클래스는 |