언어

WeakHashMap 클래스

정의

인터페이스의 Map 해시 테이블 기반 구현( <em>약한 키</em> 포함).

[Android.Runtime.Register("java/util/WeakHashMap", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public class WeakHashMap : Java.Util.AbstractMap, IDisposable
[<Android.Runtime.Register("java/util/WeakHashMap", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type WeakHashMap = class
    inherit AbstractMap
    interface IMap
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
상속
특성
구현

설명

인터페이스의 Map 해시 테이블 기반 구현( <em>약한 키</em> 포함). 키가 더 이상 일반 용도로 WeakHashMap 사용되지 않으면 항목이 자동으로 제거됩니다. 더 정확하게 말하면, 지정된 키에 대한 매핑이 있으면 가비지 수집기에서 키를 삭제하는 것을 방지하지 않습니다. 즉, 완료 가능하고 완료된 다음 회수됩니다. 키가 삭제되면 해당 항목이 맵에서 효과적으로 제거되므로 이 클래스는 다른 Map 구현과 다소 다르게 동작합니다.

null 값과 null 키가 모두 지원됩니다. 이 클래스는 클래스의 HashMap 성능 특성과 유사하며 em 초기 용량</em> 및 em<load factor>/em<의 >효율성 매개 변수가 <>동일합니다.

대부분의 컬렉션 클래스와 마찬가지로 이 클래스는 동기화되지 않습니다. 메서드를 사용하여 WeakHashMap 동기화를 Collections#synchronizedMap Collections.synchronizedMap 생성할 수 있습니다.

이 클래스는 주로 메서드가 연산자를 사용하여 개체 equals ID를 테스트하는 키 개체와 == 함께 사용하기 위한 것입니다. 이러한 키가 삭제되면 다시 만들 수 없으므로 나중에 해당 키를 WeakHashMap 조회할 수 없으며 해당 항목이 제거되었다는 사실에 놀랄 수 없습니다. 이 클래스는 인스턴스와 같은 equals 개체 String ID를 기반으로 하지 않는 메서드가 있는 키 개체와 완벽하게 잘 작동합니다. 그러나 이러한 다시 만들 수 있는 키 개체를 사용하면 키가 삭제된 항목의 WeakHashMap 자동 제거가 혼동될 수 있습니다.

클래스의 WeakHashMap 동작은 부분적으로 가비지 수집기의 동작에 따라 달라지므로 이 클래스에 대해 친숙한(필수는 아님) Map 고정이 몇 가지가 없습니다. 가비지 수집기는 언제든지 WeakHashMap 키를 삭제할 수 있으므로 알 수 없는 스레드가 자동으로 항목을 제거하는 것처럼 동작할 수 있습니다. 특히 인스턴스에서 WeakHashMap 동기화하고 해당 변경자 메서드를 호출하지 않더라도 메서드가 시간이 지남에 따라 더 작은 값을 반환하고, 메서드가 size 반환 isEmpty 한 다음false, true 지정된 키에 대해 containsKey 메서드가 반환하고 나중에 true 지정된 키에 대해 반환 false 하는 경우 메서드가 지정된 키 get 에 대한 값을 반환하지만 나중에 반환null할 수 있습니다. put 반환할 null 메서드와 remove 이전에 맵에 있는 것처럼 보였던 키에 대해 반환 false 하는 메서드 및 키 집합의 연속 검사에서 값 컬렉션 및 항목 집합이 연속적으로 더 적은 수의 요소를 생성하도록 합니다.

각 키 개체는 WeakHashMap 약한 참조의 참조로 간접적으로 저장됩니다. 따라서 키가 맵 내부 및 외부에서 약한 참조가 가비지 수집기에서 지워진 후에만 키가 자동으로 제거됩니다.

<strong>Implementation note:</strong> a의 값 개체 WeakHashMap 는 일반적인 강력한 참조에 의해 유지됩니다. 따라서 값 개체가 직접 또는 간접적으로 자신의 키를 강력하게 참조하지 않도록 주의해야 합니다. 그러면 키가 삭제되지 않기 때문에 주의해야 합니다. 값 개체는 자체를 통해 WeakHashMap 해당 키를 간접적으로 참조할 수 있습니다. 즉, 값 개체는 연결된 값 개체가 첫 번째 값 개체의 키를 강력하게 참조하는 다른 키 개체를 강력하게 참조할 수 있습니다. 맵의 값이 강력한 참조를 보유하는 맵에 의존하지 않는 경우 이를 처리하는 한 가지 방법은 삽입하기 전에 값을 직접 WeakReferences 래핑한 다음 각 m.put(key, new WeakReference(value))값을 래핑 해제하는 get것입니다.

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

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

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

1.2에 추가되었습니다.

에 대한 java.util.WeakHashMapJava 설명서

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

생성자

속성 Description
WeakHashMap()

기본 초기 용량(16) 및 로드 팩터(0)를 사용하여 비어 WeakHashMap 있는 새 값을 생성합니다.

WeakHashMap(IDictionary)

지정된 맵과 동일한 매핑을 사용하여 새 WeakHashMap 맵을 생성합니다.

WeakHashMap(Int32, Single)

지정된 초기 용량과 지정된 로드 팩터를 사용하여 비어 WeakHashMap 있는 새 값을 생성합니다.

WeakHashMap(Int32)

지정된 초기 용량과 기본 로드 팩터(0)를 사용하여 비어 WeakHashMap 있는 새 로드를 생성합니다.

WeakHashMap(IntPtr, JniHandleOwnership)

JNI 개체의 관리되는 표현을 만들 때 사용되는 생성자입니다. 런타임에서 호출합니다.

속성

속성 Description
Class

이 Object런타임 클래스를 반환합니다.

(다음에서 상속됨 Object)
Handle

기본 Android 인스턴스에 대한 핸들입니다.

(다음에서 상속됨 Object)
IsEmpty

이 맵에 키-값 매핑이 없으면 true를 반환합니다.

(다음에서 상속됨 AbstractMap)
JniIdentityHashCode

interop 런타임에 의해 이 Java 피어에 할당된 ID 해시 코드를 가져옵니다.

(다음에서 상속됨 Object)
JniManagedPeerState

런타임에서 마지막으로 할당한 상태 플래그를 가져옵니다.

(다음에서 상속됨 JavaObject)
JniPeerMembers

이 Java 바인딩의 멤버에 액세스하는 데 사용되는 JNI 메타데이터를 가져옵니다.

PeerReference

이 Java 피어에 대한 JNI 개체 참조를 가져옵니다.

(다음에서 상속됨 Object)
ThresholdClass

이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.

ThresholdType

이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.

메서드

속성 Description
Clear()

이 맵에서 모든 매핑을 제거합니다(선택적 작업).

(다음에서 상속됨 AbstractMap)
Clone()

이 개체의 복사본을 만들고 반환합니다.

(다음에서 상속됨 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

이 피어의 생성을 런타임의 값 관리자에 위임합니다.

(다음에서 상속됨 JavaObject)
ContainsKey(Object)

이 맵에 지정된 키에 대한 매핑이 포함되어 있으면 true를 반환합니다.

(다음에서 상속됨 AbstractMap)
ContainsValue(Object)

이 맵이 하나 이상의 키를 지정된 값에 매핑하면 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()

이 맵에 포함된 키의 집합 보기를 반환합니다.

(다음에서 상속됨 AbstractMap)
NewWeakHashMap(Int32)

예상되는 매핑 수에 적합한 비어 있는 새 WeakHashMap을 만듭니다.

Notify()

이 개체의 모니터에서 대기 중인 단일 스레드를 해제합니다.

(다음에서 상속됨 Object)
NotifyAll()

이 개체의 모니터에서 대기 중인 모든 스레드를 해제합니다.

(다음에서 상속됨 Object)
Put(Object, Object)

지정된 값을 이 맵의 지정된 키와 연결합니다(선택적 작업).

(다음에서 상속됨 AbstractMap)
PutAll(IDictionary)

지정된 맵의 모든 매핑을 이 맵에 복사합니다(선택적 작업).

(다음에서 상속됨 AbstractMap)
Remove(Object)

키의 매핑이 있는 경우 이 맵에서 키 매핑을 제거합니다(선택적 작업).

(다음에서 상속됨 AbstractMap)
ReplaceAll(IBiFunction)

약한 키가 지워지지 않은 항목의 값을 업데이트합니다.

SetHandle(IntPtr, JniHandleOwnership)

Handle 속성을 설정합니다.

(다음에서 상속됨 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

JNI 참조 복사본을 만들지 않고 제어 블록에 참조 값을 저장합니다.

(다음에서 상속됨 JavaObject)
Size()

이 맵의 키-값 매핑 수를 반환합니다.

(다음에서 상속됨 AbstractMap)
ToArray<T>()

이 Java 배열 래퍼에서 관리되는 배열을 만듭니다.

(다음에서 상속됨 Object)
ToString()

개체의 문자열 표현을 반환합니다.

(다음에서 상속됨 Object)
UnregisterFromRuntime()

interop 런타임에서 이 Java 피어의 등록을 취소합니다.

(다음에서 상속됨 Object)
Values()

이 맵에 포함된 값의 컬렉션 뷰를 반환합니다.

(다음에서 상속됨 AbstractMap)
Wait()

현재 스레드가 각성될 때까지 대기하게 하며, 일반적으로 <알림을 받><거나 ><>중단/종료<합니다.>

(다음에서 상속됨 Object)
Wait(Int64, Int32)

현재 스레드가 각성될 때까지 대기하게 하며, 일반적으로 <>알림을 받<거나 >중단/<종료><>하거나 일정량의 실시간 경과가 발생할 때까지 대기합니다.

(다음에서 상속됨 Object)
Wait(Int64)

현재 스레드가 각성될 때까지 대기하게 하며, 일반적으로 <>알림을 받<거나 >중단/<종료><>하거나 일정량의 실시간 경과가 발생할 때까지 대기합니다.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

속성 Description
IJavaPeerable.Disposed()

이 피어를 삭제된 것으로 표시하고 다음으로 설정된 호출 Disposedisposing 을 표시합니다 true.

(다음에서 상속됨 JavaObject)
IJavaPeerable.Finalized()

이 피어를 삭제된 것으로 표시하고 다음으로 설정된 호출 Disposedisposing 을 표시합니다 false.

(다음에서 상속됨 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

이 피어에서 사용하는 네이티브 컨트롤 블록 포인터를 가져옵니다.

(다음에서 상속됨 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

런타임에서 제공하는 ID 해시 코드를 저장합니다.

(다음에서 상속됨 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

저장된 관리되는 피어 상태 플래그를 바꿉니다.

(다음에서 상속됨 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

참조가 잘못되면 피어 참조를 업데이트하고 삭제된 피어의 제어 블록을 해제합니다.

(다음에서 상속됨 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

런타임의 Java 개체 조회에서 이 인스턴스를 제거합니다.

확장명 메서드

속성 Description
GetJniTypeName(IJavaPeerable)

인스턴스 self형식의 JNI 이름을 가져옵니다.

JavaAs<TResult>(IJavaPeerable)

형식self을 강제 TResult 변환하여 강제 변환이 Java 쪽에서 유효한지 확인합니다.

JavaCast<TResult>(IJavaObject)

Android 런타임 확인 형식 변환을 수행합니다.

JavaCast<TResult>(IJavaObject)

호환되는 관리되는 피어를 다시 사용하거나 요청된 형식의 래퍼를 가져옵니다.

TryJavaCast<TResult>(IJavaPeerable, TResult)

형식self을 강제 TResult 변환하여 강제 변환이 Java 쪽에서 유효한지 확인합니다.

적용 대상