EDU.oswego.cs.dl.util.concurrent

Class SynchronizedDouble

public class SynchronizedDouble extends SynchronizedVariable implements Comparable, Cloneable

A class useful for offloading synch for double instance variables.

[ Introduction to this package. ]

Field Summary
protected doublevalue_
Constructor Summary
SynchronizedDouble(double initialValue)
Make a new SynchronizedDouble with the given initial value, and using its own internal lock.
SynchronizedDouble(double initialValue, Object lock)
Make a new SynchronizedDouble with the given initial value, and using the supplied lock.
Method Summary
doubleadd(double amount)
Add amount to value (i.e., set value += amount)
booleancommit(double assumedValue, double newValue)
Set value to newValue only if it is currently assumedValue.
intcompareTo(double other)
intcompareTo(SynchronizedDouble other)
intcompareTo(Object other)
doubledivide(double factor)
Divide value by factor (i.e., set value /= factor)
booleanequals(Object other)
doubleget()
Return the current value
inthashCode()
doublemultiply(double factor)
Multiply value by factor (i.e., set value *= factor)
doubleset(double newValue)
Set to newValue.
doublesubtract(double amount)
Subtract amount from value (i.e., set value -= amount)
doubleswap(SynchronizedDouble other)
Atomically swap values with another SynchronizedDouble.
StringtoString()

Field Detail

value_

protected double value_

Constructor Detail

SynchronizedDouble

public SynchronizedDouble(double initialValue)
Make a new SynchronizedDouble with the given initial value, and using its own internal lock.

SynchronizedDouble

public SynchronizedDouble(double initialValue, Object lock)
Make a new SynchronizedDouble with the given initial value, and using the supplied lock.

Method Detail

add

public double add(double amount)
Add amount to value (i.e., set value += amount)

Returns: the new value

commit

public boolean commit(double assumedValue, double newValue)
Set value to newValue only if it is currently assumedValue.

Returns: true if successful

compareTo

public int compareTo(double other)

compareTo

public int compareTo(SynchronizedDouble other)

compareTo

public int compareTo(Object other)

divide

public double divide(double factor)
Divide value by factor (i.e., set value /= factor)

Returns: the new value

equals

public boolean equals(Object other)

get

public final double get()
Return the current value

hashCode

public int hashCode()

multiply

public double multiply(double factor)
Multiply value by factor (i.e., set value *= factor)

Returns: the new value

set

public double set(double newValue)
Set to newValue.

Returns: the old value

subtract

public double subtract(double amount)
Subtract amount from value (i.e., set value -= amount)

Returns: the new value

swap

public double swap(SynchronizedDouble other)
Atomically swap values with another SynchronizedDouble. Uses identityHashCode to avoid deadlock when two SynchronizedDoubles attempt to simultaneously swap with each other. (Note: Ordering via identyHashCode is not strictly guaranteed by the language specification to return unique, orderable values, but in practice JVMs rely on them being unique.)

Returns: the new value

toString

public String toString()