HashMap 클래스

정의

네임스페이스:

Java.Util

어셈블리:

Mono.Android.dll

인터페이스의 해시 테이블 기반 구현입니다 Map .

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

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

상속

Object

Object

AbstractMap

HashMap

파생

Java.Util.LinkedHashMap

특성

RegisterAttribute JavaTypeParametersAttribute

구현

IJavaObject IJavaPeerable ISerializable ICloneable IMap IDisposable

설명

인터페이스의 해시 테이블 기반 구현입니다 Map . 이 구현은 모든 선택적 맵 작업을 제공하고 값과 null 키를 허용합니다null. (클래스는 HashMap 비동기화되고 null을 허용한다는 점을 제외하고 와 거의 동일합니다 Hashtable.) 이 클래스는 맵의 순서를 보장하지 않습니다. 특히 시간이 지남에 따라 주문이 일정하게 유지된다는 보장은 없습니다.

이 구현은 해시 함수가 버킷 간에 요소를 제대로 분산한다고 가정하여 기본 작업(get 및 put)에 대한 일정한 시간 성능을 제공합니다. 컬렉션 뷰를 반복하려면 instance "용량"HashMap(버킷 수)과 크기(키-값 매핑 수)에 비례하는 시간이 필요합니다. 따라서 반복 성능이 중요한 경우 초기 용량을 너무 높게 설정(또는 부하 인자가 너무 낮음)하지 않는 것이 매우 중요합니다.

의 HashMap instance 성능에 영향을 주는 두 가지 매개 변수인 초기 용량 및 로드 팩터가 있습니다. 용량은 해시 테이블의 버킷 수이며 초기 용량은 해시 테이블을 만들 때의 용량일 뿐입니다. 부하 계수는 해시 테이블이 용량을 자동으로 늘리기 전에 가져올 수 있는 전체 용량의 측정값입니다. 해시 테이블의 항목 수가 부하 계수 및 현재 용량의 곱을 초과하면 해시 테이블이 다시 해시되어 (즉, 내부 데이터 구조가 다시 작성됨) 해시 테이블에 버킷 수의 약 2배가 됩니다.

일반적으로 기본 로드 팩터(.75)는 시간과 공간 비용 간에 좋은 절충을 제공합니다. 값이 높을수록 공간 오버헤드가 줄어들지만 조회 비용이 증가합니다(및 put를 포함하여 get 클래스의 HashMap 대부분의 작업에 반영됨). 다시 해시 작업의 수를 최소화하기 위해 초기 용량을 설정할 때 맵의 예상 항목 수와 해당 부하 요소를 고려해야 합니다. 초기 용량이 로드 팩터로 나눈 최대 항목 수보다 크면 다시 해시 작업이 발생하지 않습니다.

많은 매핑을 instance 저장 HashMap 해야 하는 경우 충분히 큰 용량으로 매핑을 만들면 테이블을 증가시키는 데 필요한 자동 다시 해시를 수행하는 것보다 매핑을 더 효율적으로 저장할 수 있습니다. 동일한 hashCode() 여러 키를 사용하는 것은 해시 테이블의 성능을 저하시키는 확실한 방법입니다. 영향을 개선하기 위해 키가 인 경우 이 클래스는 Comparable키 간의 비교 순서를 사용하여 관계를 끊을 수 있습니다.

<strong>이 구현은 동기화되지 않습니다.</strong> 여러 스레드가 해시 맵에 동시에 액세스하고 하나 이상의 스레드가 구조적으로 맵을 수정하는 경우 외부에서 동기화 되어야 합니다 . 구조 수정은 하나 이상의 매핑을 추가하거나 삭제하는 작업입니다. instance 이미 포함된 키와 연결된 값을 변경하는 것은 구조적 수정이 아닙니다. 이 작업은 일반적으로 맵을 자연스럽게 캡슐화하는 일부 개체에서 동기화하여 수행됩니다.

이러한 개체가 없으면 메서드를 사용하여 Collections#synchronizedMap Collections.synchronizedMap 맵을 "래핑"해야 합니다. 이는 맵에 대한 실수로 비동기화된 액세스를 방지하기 위해 생성 시 가장 잘 수행됩니다.

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

이 클래스의 모든 "컬렉션 뷰 메서드"에서 반환되는 반복기는 장애 조치(fail-fast)입니다. 반복기가 생성된 후 언제든지 맵이 구조적으로 수정되면 반복기의 자체 remove 메서드를 통하지 않으면 반복기가 을 ConcurrentModificationExceptionthrow합니다. 따라서 동시 수정에 직면하여 반복기는 나중에 결정되지 않은 시간에 임의적이고 비결정적인 동작을 위험에 빠뜨리지 않고 빠르고 깨끗하게 실패합니다.

반복기의 장애 조치(fail-fast) 동작은 일반적으로 비동기화 동시 수정이 있을 때 하드 보장을 할 수 없으므로 보장할 수 없습니다. 장애 조치(fail-fast) 반복기는 최선을 다해 throw ConcurrentModificationException 합니다. 따라서 이 예외의 정확성에 따라 프로그램을 작성하는 것은 잘못된 것입니다. 반복기의 장애 조치(fail-fast) 동작은 버그를 검색하는 데만 사용해야 합니다.

이 클래스는 Java Collections Framework의 멤버입니다.

1.2에 추가되었습니다.

에 대한 Java 설명서입니다 java.util.HashMap.

이 페이지의 일부는 만들고 공유하며 에 설명된 조건에 따라 사용되는 작업을 기반으로 수정됩니다.

생성자

HashMap()	기본 초기 용량(16)과 기본 로드 팩터(0)를 사용하여 빈 HashMap 을 생성합니다.
HashMap(IDictionary)	지정된 Map와 동일한 매핑을 사용하여 새 HashMap 를 생성합니다.
HashMap(Int32)	지정된 초기 용량과 기본 로드 팩터(0)를 사용하여 빈 HashMap 을 생성합니다.
HashMap(Int32, Single)	지정된 초기 용량 및 로드 팩터를 사용하여 빈 HashMap 을 생성합니다.
HashMap(IntPtr, JniHandleOwnership)	JNI 개체의 관리형 표현을 만들 때 사용되는 생성자입니다. 런타임에서 호출합니다.

속성

Class	이 Object의 런타임 클래스를 반환합니다. (다음에서 상속됨 Object)
Handle	기본 Android instance 대한 핸들입니다. (다음에서 상속됨 Object)
IsEmpty	추가할 항목 (다음에서 상속됨 AbstractMap)
JniIdentityHashCode	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
JniPeerMembers	인터페이스의 해시 테이블 기반 구현입니다 Map .
PeerReference	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
ThresholdClass	이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.
ThresholdType	이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.

메서드

Clear()	추가할 항목 (다음에서 상속됨 AbstractMap)
Clone()	이 HashMap instance 단순 복사본을 반환합니다. 키와 값 자체는 복제되지 않습니다.
Compute(Object, IBiFunction)	인터페이스의 해시 테이블 기반 구현입니다 Map .
ComputeIfAbsent(Object, IFunction)	인터페이스의 해시 테이블 기반 구현입니다 Map .
ComputeIfPresent(Object, IBiFunction)	인터페이스의 해시 테이블 기반 구현입니다 Map .
ContainsKey(Object)	추가할 항목 (다음에서 상속됨 AbstractMap)
ContainsValue(Object)	추가할 항목 (다음에서 상속됨 AbstractMap)
Dispose()	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
Dispose(Boolean)	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
EntrySet()	이 맵에 Set 포함된 매핑의 보기를 반환합니다.
Equals(Object)	다른 개체가 이 개체와 "같음"인지 여부를 나타냅니다. (다음에서 상속됨 Object)
ForEach(IBiConsumer)	인터페이스의 해시 테이블 기반 구현입니다 Map .
Get(Object)	추가할 항목 (다음에서 상속됨 AbstractMap)
GetHashCode()	개체의 해시 코드 값을 반환합니다. (다음에서 상속됨 Object)
GetOrDefault(Object, Object)	인터페이스의 해시 테이블 기반 구현입니다 Map .
JavaFinalize()	가비지 수집에서 개체에 대한 참조가 더 이상 없다고 판단할 때 개체의 가비지 수집기에서 호출됩니다. (다음에서 상속됨 Object)
KeySet()	추가할 항목 (다음에서 상속됨 AbstractMap)
Merge(Object, Object, IBiFunction)	인터페이스의 해시 테이블 기반 구현입니다 Map .
Notify()	이 개체의 모니터에서 대기 중인 단일 스레드를 해제합니다. (다음에서 상속됨 Object)
NotifyAll()	이 개체의 모니터에서 대기 중인 모든 스레드를 해제합니다. (다음에서 상속됨 Object)
Put(Object, Object)	추가할 항목 (다음에서 상속됨 AbstractMap)
PutAll(IDictionary)	추가할 항목 (다음에서 상속됨 AbstractMap)
PutIfAbsent(Object, Object)	인터페이스의 해시 테이블 기반 구현입니다 Map .
Remove(Object)	추가할 항목 (다음에서 상속됨 AbstractMap)
Remove(Object, Object)	있는 경우 이 맵에서 지정된 키에 대한 매핑을 제거합니다.
Replace(Object, Object)	인터페이스의 해시 테이블 기반 구현입니다 Map .
Replace(Object, Object, Object)	인터페이스의 해시 테이블 기반 구현입니다 Map .
ReplaceAll(IBiFunction)	인터페이스의 해시 테이블 기반 구현입니다 Map .
SetHandle(IntPtr, JniHandleOwnership)	Handle 속성을 설정합니다. (다음에서 상속됨 Object)
Size()	추가할 항목 (다음에서 상속됨 AbstractMap)
ToArray<T>()	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
ToString()	개체의 문자열 표현을 반환합니다. (다음에서 상속됨 Object)
UnregisterFromRuntime()	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
Values()	추가할 항목 (다음에서 상속됨 AbstractMap)
Wait()	현재 스레드가 깨어날 때까지 대기하게 합니다( 일반적으로 <알림을 받><거나 <>중단/>em>)합니다<. (다음에서 상속됨 Object)
Wait(Int64)	현재 스레드가 깨어날 때까지 대기하게 합니다. 일반적으로 <>알림을 받<거나 <중단</>내보내>>거나 일정량의 실시간이 경과할 때까지 대기합니다. (다음에서 상속됨 Object)
Wait(Int64, Int32)	현재 스레드가 깨어날 때까지 대기하게 합니다. 일반적으로 <>알림을 받<거나 <중단</>내보내>>거나 일정량의 실시간이 경과할 때까지 대기합니다. (다음에서 상속됨 Object)

명시적 인터페이스 구현

IJavaPeerable.Disposed()	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
IJavaPeerable.DisposeUnlessReferenced()	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
IJavaPeerable.Finalized()	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
IJavaPeerable.JniManagedPeerState	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)

확장 메서드

JavaCast<TResult>(IJavaObject)	Android 런타임 확인 형식 변환을 수행합니다.
JavaCast<TResult>(IJavaObject)	인터페이스의 해시 테이블 기반 구현입니다 Map .
GetJniTypeName(IJavaPeerable)	인터페이스의 해시 테이블 기반 구현입니다 Map .