KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > EDU > oswego > cs > dl > util > concurrent > SynchronizedByte


1 /*
2   File: SynchronizedByte.java
3
4   Originally written by Doug Lea and released into the public domain.
5   This may be used for any purposes whatsoever without acknowledgment.
6   Thanks for the assistance and support of Sun Microsystems Labs,
7   and everyone contributing, testing, and using this code.
8
9   History:
10   Date Who What
11   19Jun1998 dl Create public version
12 */

13
14 package EDU.oswego.cs.dl.util.concurrent;
15
16 /**
17  * A class useful for offloading synch for byte instance variables.
18  *
19  * <p>[<a HREF="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
20  **/

21
22 public class SynchronizedByte extends SynchronizedVariable implements Comparable JavaDoc, Cloneable JavaDoc {
23
24   protected byte value_;
25
26   /**
27    * Make a new SynchronizedByte with the given initial value,
28    * and using its own internal lock.
29    **/

30   public SynchronizedByte(byte initialValue) {
31     super();
32     value_ = initialValue;
33   }
34
35   /**
36    * Make a new SynchronizedByte with the given initial value,
37    * and using the supplied lock.
38    **/

39   public SynchronizedByte(byte initialValue, Object JavaDoc lock) {
40     super(lock);
41     value_ = initialValue;
42   }
43
44   /**
45    * Return the current value
46    **/

47   public final byte get() { synchronized(lock_) { return value_; } }
48
49   /**
50    * Set to newValue.
51    * @return the old value
52    **/

53
54   public byte set(byte newValue) {
55     synchronized (lock_) {
56       byte old = value_;
57       value_ = newValue;
58       return old;
59     }
60   }
61
62   /**
63    * Set value to newValue only if it is currently assumedValue.
64    * @return true if successful
65    **/

66   public boolean commit(byte assumedValue, byte newValue) {
67     synchronized(lock_) {
68       boolean success = (assumedValue == value_);
69       if (success) value_ = newValue;
70       return success;
71     }
72   }
73
74
75   /**
76    * Atomically swap values with another SynchronizedByte.
77    * Uses identityHashCode to avoid deadlock when
78    * two SynchronizedBytes attempt to simultaneously swap with each other.
79    * (Note: Ordering via identyHashCode is not strictly guaranteed
80    * by the language specification to return unique, orderable
81    * values, but in practice JVMs rely on them being unique.)
82    * @return the new value
83    **/

84
85   public byte swap(SynchronizedByte other) {
86     if (other == this) return get();
87     SynchronizedByte fst = this;
88     SynchronizedByte snd = other;
89     if (System.identityHashCode(fst) > System.identityHashCode(snd)) {
90       fst = other;
91       snd = this;
92     }
93     synchronized(fst.lock_) {
94       synchronized(snd.lock_) {
95         fst.set(snd.set(fst.get()));
96         return get();
97       }
98     }
99   }
100
101   /**
102    * Increment the value.
103    * @return the new value
104    **/

105   public byte increment() {
106     synchronized (lock_) {
107       return ++value_;
108     }
109   }
110
111   /**
112    * Decrement the value.
113    * @return the new value
114    **/

115   public byte decrement() {
116     synchronized (lock_) {
117       return --value_;
118     }
119   }
120
121   /**
122    * Add amount to value (i.e., set value += amount)
123    * @return the new value
124    **/

125   public byte add(byte amount) {
126     synchronized (lock_) {
127       return value_ += amount;
128     }
129   }
130
131   /**
132    * Subtract amount from value (i.e., set value -= amount)
133    * @return the new value
134    **/

135   public byte subtract(byte amount) {
136     synchronized (lock_) {
137       return value_ -= amount;
138     }
139   }
140
141   /**
142    * Multiply value by factor (i.e., set value *= factor)
143    * @return the new value
144    **/

145   public synchronized byte multiply(byte factor) {
146     synchronized (lock_) {
147       return value_ *= factor;
148     }
149   }
150
151   /**
152    * Divide value by factor (i.e., set value /= factor)
153    * @return the new value
154    **/

155   public byte divide(byte factor) {
156     synchronized (lock_) {
157       return value_ /= factor;
158     }
159   }
160
161   /**
162    * Set the value to the negative of its old value
163    * @return the new value
164    **/

165   public byte negate() {
166     synchronized (lock_) {
167       value_ = (byte)(-value_);
168       return value_;
169     }
170   }
171
172   /**
173    * Set the value to its complement
174    * @return the new value
175    **/

176   public byte complement() {
177     synchronized (lock_) {
178       value_ = (byte)~value_;
179       return value_;
180     }
181   }
182
183   /**
184    * Set value to value &amp; b.
185    * @return the new value
186    **/

187   public byte and(byte b) {
188     synchronized (lock_) {
189       value_ = (byte)(value_ & b);
190       return value_;
191     }
192   }
193
194   /**
195    * Set value to value | b.
196    * @return the new value
197    **/

198   public byte or(byte b) {
199     synchronized (lock_) {
200       value_ = (byte)(value_ | b);
201       return value_;
202     }
203   }
204
205
206   /**
207    * Set value to value ^ b.
208    * @return the new value
209    **/

210   public byte xor(byte b) {
211     synchronized (lock_) {
212       value_ = (byte)(value_ ^ b);
213       return value_;
214     }
215   }
216
217   public int compareTo(byte other) {
218     byte val = get();
219     return (val < other)? -1 : (val == other)? 0 : 1;
220   }
221
222   public int compareTo(SynchronizedByte other) {
223     return compareTo(other.get());
224   }
225
226   public int compareTo(Object JavaDoc other) {
227     return compareTo((SynchronizedByte)other);
228   }
229
230   public boolean equals(Object JavaDoc other) {
231     if (other != null &&
232         other instanceof SynchronizedByte)
233       return get() == ((SynchronizedByte)other).get();
234     else
235       return false;
236   }
237
238   public int hashCode() {
239     return (int)(get());
240   }
241
242   public String JavaDoc toString() { return Byte.toString(get()); }
243
244 }
245
246
Popular Tags