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, 해시 함수가 버킷 간에 요소를 제대로 분산하는 것으로 가정합니다. 컬렉션 뷰를 반복하려면 인스턴스의 HashMap "용량"(버킷 수)과 크기(키-값 매핑 수)에 비례하는 시간이 필요합니다. 따라서 반복 성능이 중요한 경우 초기 용량을 너무 높게 설정하거나 로드 팩터를 너무 낮게 설정하지 않는 것이 매우 중요합니다.

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

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

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

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

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

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

이 클래스의 모든 "컬렉션 뷰 메서드" 에서 반환하는 반복기는 실패합니다. 반복기가 생성된 후 언제든지 맵이 구조적으로 수정되는 경우 반복기의 자체 remove 메서드를 제외한 모든 방법으로 반복기가 throw ConcurrentModificationException됩니다. 따라서 동시 수정 시 반복기는 나중에 결정되지 않은 시간에 임의적이고 비결정적인 동작의 위험을 감수하지 않고 신속하고 깔끔하게 실패합니다.

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

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

1.2에 추가되었습니다.

에 대한 java.util.HashMapJava 설명서

이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.

생성자

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 인스턴스에 대한 핸들입니다. (다음에서 상속됨 Object)
IsEmpty	추가할 수 있습니다. (다음에서 상속됨 AbstractMap)
JniIdentityHashCode	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
JniPeerMembers	인터페이스의 해시 테이블 기반 구현입니다 Map .
PeerReference	인터페이스의 해시 테이블 기반 구현입니다 Map . (다음에서 상속됨 Object)
ThresholdClass	이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.
ThresholdType	이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.

메서드

Clear()	추가할 수 있습니다. (다음에서 상속됨 AbstractMap)
Clone()	이 HashMap 인스턴스의 단순 복사본을 반환합니다. 키와 값 자체는 복제되지 않습니다.
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()	현재 스레드가 각성될 때까지 대기하게 하며, 일반적으로 <알림을 받<>거나 <><중단/종료>합니다.> (다음에서 상속됨 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 .