Class Overview
An object reference that may be updated atomically. See the java.util.concurrent.atomic
package specification for description
of the properties of atomic variables.
Summary
Public Constructors |
|
AtomicReference(V initialValue)
Creates a new AtomicReference with the given initial value.
|
|
AtomicReference()
Creates a new AtomicReference with null initial value.
|
Public Methods |
final
boolean
|
compareAndSet(V expect, V update)
Atomically sets the value to the given updated value
if the current value == the expected value.
|
final
V
|
get()
Gets the current value.
|
final
V
|
getAndSet(V newValue)
Atomically sets to the given value and returns the old value.
|
final
void
|
set(V newValue)
Sets to the given value.
|
String
|
toString()
Returns the String representation of the current value.
|
final
boolean
|
weakCompareAndSet(V expect, V update)
Atomically sets the value to the given updated value
if the current value == the expected value.
|
[Expand]
Inherited Methods |
From class java.lang.Object
Object
|
clone()
Creates and returns a copy of this Object .
|
boolean
|
equals(Object o)
Compares this instance with the specified object and indicates if they
are equal.
|
void
|
finalize()
Is called before the object's memory is being reclaimed by the VM.
|
final
Class<? extends Object>
|
getClass()
Returns the unique instance of Class which represents this
object's class.
|
int
|
hashCode()
Returns an integer hash code for this object.
|
final
void
|
notify()
Causes a thread which is waiting on this object's monitor (by means of
calling one of the wait() methods) to be woken up.
|
final
void
|
notifyAll()
Causes all threads which are waiting on this object's monitor (by means
of calling one of the wait() methods) to be woken up.
|
String
|
toString()
Returns a string containing a concise, human-readable description of this
object.
|
final
void
|
wait(long millis, int nanos)
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
specified timeout expires.
|
final
void
|
wait(long millis)
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
specified timeout expires.
|
final
void
|
wait()
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.
|
|
Public Constructors
public
AtomicReference
(V initialValue)
Creates a new AtomicReference with the given initial value.
Parameters
initialValue
| the initial value
|
public
AtomicReference
()
Creates a new AtomicReference with null initial value.
Public Methods
public
final
boolean
compareAndSet
(V expect, V update)
Atomically sets the value to the given updated value
if the current value ==
the expected value.
Parameters
expect
| the expected value |
update
| the new value |
Returns
- true if successful. False return indicates that
the actual value was not equal to the expected value.
public
final
V
getAndSet
(V newValue)
Atomically sets to the given value and returns the old value.
public
final
void
set
(V newValue)
public
String
toString
()
Returns the String representation of the current value.
Returns
- the String representation of the current value.
public
final
boolean
weakCompareAndSet
(V expect, V update)
Atomically sets the value to the given updated value
if the current value ==
the expected value.
May fail spuriously
and does not provide ordering guarantees, so is only rarely an
appropriate alternative to compareAndSet
.
Parameters
expect
| the expected value |
update
| the new value |