1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169
|
/*
File: SynchronizedChar.java
Originally written by Doug Lea and released into the public domain.
This may be used for any purposes whatsoever without acknowledgment.
Thanks for the assistance and support of Sun Microsystems Labs,
and everyone contributing, testing, and using this code.
History:
Date Who What
19Jun1998 dl Create public version
*/
package EDU.oswego.cs.dl.util.concurrent;
/**
* A class useful for offloading synch for char instance variables.
*
* <p>[<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
**/
public class SynchronizedChar extends SynchronizedVariable implements Comparable, Cloneable {
protected char value_;
/**
* Make a new SynchronizedChar with the given initial value,
* and using its own internal lock.
**/
public SynchronizedChar(char initialValue) {
super();
value_ = initialValue;
}
/**
* Make a new SynchronizedChar with the given initial value,
* and using the supplied lock.
**/
public SynchronizedChar(char initialValue, Object lock) {
super(lock);
value_ = initialValue;
}
/**
* Return the current value
**/
public final char get() { synchronized(lock_) { return value_; } }
/**
* Set to newValue.
* @return the old value
**/
public char set(char newValue) {
synchronized (lock_) {
char old = value_;
value_ = newValue;
return old;
}
}
/**
* Set value to newValue only if it is currently assumedValue.
* @return true if successful
**/
public boolean commit(char assumedValue, char newValue) {
synchronized(lock_) {
boolean success = (assumedValue == value_);
if (success) value_ = newValue;
return success;
}
}
/**
* Atomically swap values with another SynchronizedChar.
* Uses identityHashCode to avoid deadlock when
* two SynchronizedChars 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.)
* @return the new value
**/
public char swap(SynchronizedChar other) {
if (other == this) return get();
SynchronizedChar fst = this;
SynchronizedChar snd = other;
if (System.identityHashCode(fst) > System.identityHashCode(snd)) {
fst = other;
snd = this;
}
synchronized(fst.lock_) {
synchronized(snd.lock_) {
fst.set(snd.set(fst.get()));
return get();
}
}
}
/**
* Add amount to value (i.e., set value += amount)
* @return the new value
**/
public char add(char amount) {
synchronized (lock_) {
return value_ += amount;
}
}
/**
* Subtract amount from value (i.e., set value -= amount)
* @return the new value
**/
public char subtract(char amount) {
synchronized (lock_) {
return value_ -= amount;
}
}
/**
* Multiply value by factor (i.e., set value *= factor)
* @return the new value
**/
public synchronized char multiply(char factor) {
synchronized (lock_) {
return value_ *= factor;
}
}
/**
* Divide value by factor (i.e., set value /= factor)
* @return the new value
**/
public char divide(char factor) {
synchronized (lock_) {
return value_ /= factor;
}
}
public int compareTo(char other) {
char val = get();
return (val < other)? -1 : (val == other)? 0 : 1;
}
public int compareTo(SynchronizedChar other) {
return compareTo(other.get());
}
public int compareTo(Object other) {
return compareTo((SynchronizedChar)other);
}
public boolean equals(Object other) {
if (other != null &&
other instanceof SynchronizedChar)
return get() == ((SynchronizedChar)other).get();
else
return false;
}
public int hashCode() { // same hash as Char
return (int)(get());
}
public String toString() { return String.valueOf(get()); }
}
|