EDU.oswego.cs.dl.util.concurrent

Class SynchronizedInt

Implemented Interfaces:
Cloneable, Comparable, Executor
Known Direct Subclasses:
WaitableInt

public class SynchronizedInt
extends SynchronizedVariable
implements Comparable, Cloneable

A class useful for offloading synch for int instance variables.

[ Introduction to this package. ]

Field Summary

protected int
value_

Fields inherited from class EDU.oswego.cs.dl.util.concurrent.SynchronizedVariable

lock_

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(SynchronizedInt other)
int
compareTo(Object other)
int
compareTo(int 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.

Methods inherited from class EDU.oswego.cs.dl.util.concurrent.SynchronizedVariable

execute, getLock

Field Details

value_

protected int value_

Constructor Details

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 Details

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)

compareTo

public int compareTo(Object other)

compareTo

public int compareTo(int 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

equals

public boolean equals(Object other)

get

public final int get()
Return the current value

hashCode

public int hashCode()

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

swap

public int swap(SynchronizedInt other)
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