ClassValue.Remove(Class) Method

Definition

Removes the associated value for the given class.

[Android.Runtime.Register("remove", "(Ljava/lang/Class;)V", "GetRemove_Ljava_lang_Class_Handler", ApiSince=34)]
public virtual void Remove (Java.Lang.Class? type);
[<Android.Runtime.Register("remove", "(Ljava/lang/Class;)V", "GetRemove_Ljava_lang_Class_Handler", ApiSince=34)>]
abstract member Remove : Java.Lang.Class -> unit
override this.Remove : Java.Lang.Class -> unit

Parameters

type
Class

the type whose class value must be removed

Attributes

Remarks

Removes the associated value for the given class. If this value is subsequently #get read for the same class, its value will be reinitialized by invoking its #computeValue computeValue method. This may result in an additional invocation of the computeValue method for the given class.

In order to explain the interaction between get and remove calls, we must model the state transitions of a class value to take into account the alternation between uninitialized and initialized states. To do this, number these states sequentially from zero, and note that uninitialized (or removed) states are numbered with even numbers, while initialized (or re-initialized) states have odd numbers.

When a thread T removes a class value in state 2N, nothing happens, since the class value is already uninitialized. Otherwise, the state is advanced atomically to 2N+1.

When a thread T queries a class value in state 2N, the thread first attempts to initialize the class value to state 2N+1 by invoking computeValue and installing the resulting value.

When T attempts to install the newly computed value, if the state is still at 2N, the class value will be initialized with the computed value, advancing it to state 2N+1.

Otherwise, whether the new state is even or odd, T will discard the newly computed value and retry the get operation.

Discarding and retrying is an important proviso, since otherwise T could potentially install a disastrously stale value. For example: <ul> <li>T calls CV.get(C) and sees state 2N<li>T quickly computes a time-dependent value V0 and gets ready to install it <li>T is hit by an unlucky paging or scheduling event, and goes to sleep for a long time <li>...meanwhile, T2 also calls CV.get(C) and sees state 2N<li>T2 quickly computes a similar time-dependent value V1 and installs it on CV.get(C)<li>T2 (or a third thread) then calls CV.remove(C), undoing T2's work <li> the previous actions of T2 are repeated several times <li> also, the relevant computed values change over time: V1, V2, ... <li>...meanwhile, T wakes up and attempts to install V0; <em>this must fail</em> </ul> We can assume in the above scenario that CV.computeValue uses locks to properly observe the time-dependent states as it computes V1, etc. This does not remove the threat of a stale value, since there is a window of time between the return of computeValue in T and the installation of the new value. No user synchronization is possible during this time.

Java documentation for java.lang.ClassValue.remove(java.lang.Class<?>).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to