EDU.oswego.cs.dl.util.concurrent

Class SynchronizedInt

public class SynchronizedInt extends SynchronizedVariable implements Comparable, Cloneable

A class useful for offloading synch for int instance variables.

Field Summary
protected int	value_

Constructor Summary
	SynchronizedInt(int initialValue) Make a new SynchronizedInt with the given initial value, and using its own internal lock.
	SynchronizedInt(int initialValue, Object lock) Make a new SynchronizedInt with the given initial value, and using the supplied lock.

Method Summary
int	add(int amount) Add amount to value (i.e., set value += amount)
int	and(int b) Set value to value & b.
boolean	commit(int assumedValue, int newValue) Set value to newValue only if it is currently assumedValue.
int	compareTo(int other)
int	compareTo(SynchronizedInt other)
int	compareTo(Object other)
int	complement() Set the value to its complement
int	decrement() Decrement the value.
int	divide(int factor) Divide value by factor (i.e., set value /= factor)
boolean	equals(Object other)
int	get() Return the current value
int	hashCode()
int	increment() Increment the value.
int	multiply(int factor) Multiply value by factor (i.e., set value *= factor)
int	negate() Set the value to the negative of its old value
int	or(int b) Set value to value \| b.
int	set(int newValue) Set to newValue.
int	subtract(int amount) Subtract amount from value (i.e., set value -= amount)
int	swap(SynchronizedInt other) Atomically swap values with another SynchronizedInt.
String	toString()
int	xor(int b) Set value to value ^ b.

Constructor Detail

SynchronizedInt

public SynchronizedInt(int initialValue)

Make a new SynchronizedInt with the given initial value, and using its own internal lock.

SynchronizedInt

public SynchronizedInt(int initialValue, Object lock)

Make a new SynchronizedInt with the given initial value, and using the supplied lock.

Method Detail

add

public int add(int amount)

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

Returns: the new value

and

public int and(int b)

Set value to value & b.

Returns: the new value

commit

public boolean commit(int assumedValue, int newValue)

Set value to newValue only if it is currently assumedValue.

Returns: true if successful

compareTo

public int compareTo(SynchronizedInt other)

complement

public int complement()

Set the value to its complement

Returns: the new value

decrement

public int decrement()

Decrement the value.

Returns: the new value

divide

public int divide(int factor)

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

Returns: the new value

get

public final int get()

Return the current value

increment

public int increment()

Increment the value.

Returns: the new value

multiply

public int multiply(int factor)

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

Returns: the new value

negate

public int negate()

Set the value to the negative of its old value

Returns: the new value

or

public int or(int b)

Set value to value | b.

Returns: the new value

set

public int set(int newValue)

Set to newValue.

Returns: the old value

subtract

public int subtract(int amount)

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

Returns: the new value

Atomically swap values with another SynchronizedInt. Uses identityHashCode to avoid deadlock when two SynchronizedInts 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()

xor

public int xor(int b)

Set value to value ^ b.

Returns: the new value