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.

Field Summary
protected double	value_

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
double	add(double amount) Add amount to value (i.e., set value += amount)
boolean	commit(double assumedValue, double newValue) Set value to newValue only if it is currently assumedValue.
int	compareTo(double other)
int	compareTo(SynchronizedDouble other)
int	compareTo(Object other)
double	divide(double factor) Divide value by factor (i.e., set value /= factor)
boolean	equals(Object other)
double	get() Return the current value
int	hashCode()
double	multiply(double factor) Multiply value by factor (i.e., set value *= factor)
double	set(double newValue) Set to newValue.
double	subtract(double amount) Subtract amount from value (i.e., set value -= amount)
double	swap(SynchronizedDouble other) Atomically swap values with another SynchronizedDouble.
String	toString()

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(SynchronizedDouble other)

divide

public double divide(double factor)

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

Returns: the new value

get

public final double get()

Return the current value

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()