--- jsr166/src/test/tck/AtomicLongArrayTest.java 2003/09/14 20:42:40 1.3 +++ jsr166/src/test/tck/AtomicLongArrayTest.java 2009/11/16 05:30:07 1.12 @@ -1,13 +1,15 @@ /* - * Written by members of JCP JSR-166 Expert Group and released to the - * public domain. Use, modify, and redistribute this code in any way - * without acknowledgement. Other contributors include Andrew Wright, - * Jeffrey Hayes, Pat Fischer, Mike Judd. + * Written by Doug Lea with assistance from members of JCP JSR-166 + * Expert Group and released to the public domain, as explained at + * http://creativecommons.org/licenses/publicdomain + * Other contributors include Andrew Wright, Jeffrey Hayes, + * Pat Fisher, Mike Judd. */ import junit.framework.*; import java.util.concurrent.atomic.*; import java.io.*; +import java.util.*; public class AtomicLongArrayTest extends JSR166TestCase { public static void main (String[] args) { @@ -17,14 +19,67 @@ public class AtomicLongArrayTest extends return new TestSuite(AtomicLongArrayTest.class); } - public void testConstructor(){ + /** + * constructor creates array of given size with all elements zero + */ + public void testConstructor() { AtomicLongArray ai = new AtomicLongArray(SIZE); - for (int i = 0; i < SIZE; ++i) + for (int i = 0; i < SIZE; ++i) assertEquals(0,ai.get(i)); } - public void testGetSet(){ - AtomicLongArray ai = new AtomicLongArray(SIZE); + /** + * constructor with null array throws NPE + */ + public void testConstructor2NPE() { + try { + long[] a = null; + AtomicLongArray ai = new AtomicLongArray(a); + } catch (NullPointerException success) { + } catch (Exception ex) { + unexpectedException(); + } + } + + /** + * constructor with array is of same size and has all elements + */ + public void testConstructor2() { + long[] a = { 17L, 3L, -42L, 99L, -7L}; + AtomicLongArray ai = new AtomicLongArray(a); + assertEquals(a.length, ai.length()); + for (int i = 0; i < a.length; ++i) + assertEquals(a[i], ai.get(i)); + } + + /** + * get and set for out of bound indices throw IndexOutOfBoundsException + */ + public void testIndexing() { + AtomicLongArray ai = new AtomicLongArray(SIZE); + try { + ai.get(SIZE); + } catch (IndexOutOfBoundsException success) { + } + try { + ai.get(-1); + } catch (IndexOutOfBoundsException success) { + } + try { + ai.set(SIZE, 0); + } catch (IndexOutOfBoundsException success) { + } + try { + ai.set(-1, 0); + } catch (IndexOutOfBoundsException success) { + } + } + + /** + * get returns the last value set at index + */ + public void testGetSet() { + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); assertEquals(1,ai.get(i)); @@ -35,8 +90,26 @@ public class AtomicLongArrayTest extends } } - public void testCompareAndSet(){ - AtomicLongArray ai = new AtomicLongArray(SIZE); + /** + * get returns the last value lazySet at index by same thread + */ + public void testGetLazySet() { + AtomicLongArray ai = new AtomicLongArray(SIZE); + for (int i = 0; i < SIZE; ++i) { + ai.lazySet(i, 1); + assertEquals(1,ai.get(i)); + ai.lazySet(i, 2); + assertEquals(2,ai.get(i)); + ai.lazySet(i, -3); + assertEquals(-3,ai.get(i)); + } + } + + /** + * compareAndSet succeeds in changing value if equal to expected else fails + */ + public void testCompareAndSet() { + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); assertTrue(ai.compareAndSet(i, 1,2)); @@ -49,20 +122,50 @@ public class AtomicLongArrayTest extends } } - public void testWeakCompareAndSet(){ - AtomicLongArray ai = new AtomicLongArray(SIZE); + /** + * compareAndSet in one thread enables another waiting for value + * to succeed + */ + public void testCompareAndSetInMultipleThreads() { + final AtomicLongArray a = new AtomicLongArray(1); + a.set(0, 1); + Thread t = new Thread(new Runnable() { + public void run() { + while (!a.compareAndSet(0, 2, 3)) Thread.yield(); + }}); + try { + t.start(); + assertTrue(a.compareAndSet(0, 1, 2)); + t.join(LONG_DELAY_MS); + assertFalse(t.isAlive()); + assertEquals(a.get(0), 3); + } + catch (Exception e) { + unexpectedException(); + } + } + + /** + * repeated weakCompareAndSet succeeds in changing value when equal + * to expected + */ + public void testWeakCompareAndSet() { + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); - while(!ai.weakCompareAndSet(i, 1,2)); - while(!ai.weakCompareAndSet(i, 2,-4)); + while (!ai.weakCompareAndSet(i, 1,2)); + while (!ai.weakCompareAndSet(i, 2,-4)); assertEquals(-4,ai.get(i)); - while(!ai.weakCompareAndSet(i, -4,7)); + while (!ai.weakCompareAndSet(i, -4,7)); assertEquals(7,ai.get(i)); } } - public void testGetAndSet(){ - AtomicLongArray ai = new AtomicLongArray(SIZE); + /** + * getAndSet returns previous value and sets to given value at given index + */ + public void testGetAndSet() { + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); assertEquals(1,ai.getAndSet(i,0)); @@ -71,8 +174,11 @@ public class AtomicLongArrayTest extends } } - public void testGetAndAdd(){ - AtomicLongArray ai = new AtomicLongArray(SIZE); + /** + * getAndAdd returns previous value and adds given value + */ + public void testGetAndAdd() { + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); assertEquals(1,ai.getAndAdd(i,2)); @@ -82,8 +188,11 @@ public class AtomicLongArrayTest extends } } - public void testGetAndDecrement(){ - AtomicLongArray ai = new AtomicLongArray(SIZE); + /** + * getAndDecrement returns previous value and decrements + */ + public void testGetAndDecrement() { + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); assertEquals(1,ai.getAndDecrement(i)); @@ -92,8 +201,11 @@ public class AtomicLongArrayTest extends } } - public void testGetAndIncrement(){ - AtomicLongArray ai = new AtomicLongArray(SIZE); + /** + * getAndIncrement returns previous value and increments + */ + public void testGetAndIncrement() { + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); assertEquals(1,ai.getAndIncrement(i)); @@ -106,8 +218,11 @@ public class AtomicLongArrayTest extends } } + /** + * addAndGet adds given value to current, and returns current value + */ public void testAddAndGet() { - AtomicLongArray ai = new AtomicLongArray(SIZE); + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); assertEquals(3,ai.addAndGet(i,2)); @@ -117,8 +232,11 @@ public class AtomicLongArrayTest extends } } - public void testDecrementAndGet(){ - AtomicLongArray ai = new AtomicLongArray(SIZE); + /** + * decrementAndGet decrements and returns current value + */ + public void testDecrementAndGet() { + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); assertEquals(0,ai.decrementAndGet(i)); @@ -128,8 +246,11 @@ public class AtomicLongArrayTest extends } } + /** + * incrementAndGet increments and returns current value + */ public void testIncrementAndGet() { - AtomicLongArray ai = new AtomicLongArray(SIZE); + AtomicLongArray ai = new AtomicLongArray(SIZE); for (int i = 0; i < SIZE; ++i) { ai.set(i, 1); assertEquals(2,ai.incrementAndGet(i)); @@ -143,7 +264,7 @@ public class AtomicLongArrayTest extends } static final long COUNTDOWN = 100000; - + class Counter implements Runnable { final AtomicLongArray ai; volatile long counts; @@ -166,10 +287,14 @@ public class AtomicLongArrayTest extends } } + /** + * Multiple threads using same array of counters successfully + * update a number of times equal to total count + */ public void testCountingInMultipleThreads() { try { - final AtomicLongArray ai = new AtomicLongArray(SIZE); - for (int i = 0; i < SIZE; ++i) + final AtomicLongArray ai = new AtomicLongArray(SIZE); + for (int i = 0; i < SIZE; ++i) ai.set(i, COUNTDOWN); Counter c1 = new Counter(ai); Counter c2 = new Counter(ai); @@ -181,14 +306,17 @@ public class AtomicLongArrayTest extends t2.join(); assertEquals(c1.counts+c2.counts, SIZE * COUNTDOWN); } - catch(InterruptedException ie) { - fail("unexpected exception"); + catch (InterruptedException ie) { + unexpectedException(); } } + /** + * a deserialized serialized array holds same values + */ public void testSerialization() { - AtomicLongArray l = new AtomicLongArray(SIZE); - for (int i = 0; i < SIZE; ++i) + AtomicLongArray l = new AtomicLongArray(SIZE); + for (int i = 0; i < SIZE; ++i) l.set(i, -i); try { @@ -203,11 +331,19 @@ public class AtomicLongArrayTest extends for (int i = 0; i < SIZE; ++i) { assertEquals(l.get(i), r.get(i)); } - } catch(Exception e){ - e.printStackTrace(); - fail("unexpected exception"); + } catch (Exception e) { + unexpectedException(); } } + /** + * toString returns current value. + */ + public void testToString() { + long[] a = { 17, 3, -42, 99, -7}; + AtomicLongArray ai = new AtomicLongArray(a); + assertEquals(Arrays.toString(a), ai.toString()); + } + }