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
|
lazySet(V newValue)
Eventually sets to the given 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 obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object .
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait()
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object.
|
final
void
|
wait(long timeout, int nanos)
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object, or
some other thread interrupts the current thread, or a certain
amount of real time has elapsed.
|
final
void
|
wait(long timeout)
Causes the current thread to wait until either another thread invokes the
notify() method or the
notifyAll() method for this object, or a
specified amount of time has elapsed.
|
|
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
lazySet
(V newValue)
Eventually sets to the given 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 |