Java 併發 - AtomicLongArray 類

java.util.concurrent.atomic.AtomicLongArray 類提供對底層 long 陣列的操作，這些操作可以原子地讀取和寫入，並且還包含高階原子操作。AtomicLongArray 支援對底層 long 陣列變數的原子操作。它具有 get 和 set 方法，這些方法的工作方式類似於對 volatile 變數的讀寫。也就是說，set 與隨後對同一變數的任何 get 之間存在 happens-before 關係。atomic compareAndSet 方法也具有這些記憶體一致性特性。

AtomicLongArray 方法

以下是 AtomicLongArray 類中可用的一些重要方法列表。

序號	方法及描述
1	public long addAndGet(int i, long delta) 原子地將給定值新增到索引 i 處的元素。
2	public boolean compareAndSet(int i, long expect, long update) 如果當前值 == 預期值，則原子地將位置 i 處的元素設定為給定的更新值。
3	public long decrementAndGet(int i) 原子地將索引 i 處的元素減 1。
4	public long get(int i) 獲取位置 i 處的當前值。
5	public long getAndAdd(int i, long delta) 原子地將給定值新增到索引 i 處的元素。
6	public long getAndDecrement(int i) 原子地將索引 i 處的元素減 1。
7	public long getAndIncrement(int i) 原子地將索引 i 處的元素加 1。
8	public long getAndSet(int i, long newValue) 原子地將位置 i 處的元素設定為給定值，並返回舊值。
9	public long incrementAndGet(int i) 原子地將索引 i 處的元素加 1。
10	public void lazySet(int i, long newValue) 最終將位置 i 處的元素設定為給定值。
11	public int length() 返回陣列的長度。
12	public void set(int i, long newValue) 將位置 i 處的元素設定為給定值。
13	public String toString() 返回陣列當前值的字串表示形式。
14	public boolean weakCompareAndSet(int i, long expect, long update) 如果當前值 == 預期值，則原子地將位置 i 處的元素設定為給定的更新值。

示例

以下 TestThread 程式展示了在基於執行緒的環境中使用 AtomicIntegerArray 變數。

線上演示

import java.util.concurrent.atomic.AtomicLongArray;

public class TestThread {
   private static AtomicLongArray atomicLongArray = new AtomicLongArray(10);

   public static void main(final String[] arguments) throws InterruptedException {

      for (int i = 0; i<atomicLongArray.length(); i++) {
         atomicLongArray.set(i, 1);
      }

      Thread t1 = new Thread(new Increment());
      Thread t2 = new Thread(new Compare());
      t1.start();
      t2.start();

      t1.join();
      t2.join();

      System.out.println("Values: ");
      
      for (int i = 0; i<atomicLongArray.length(); i++) {
         System.out.print(atomicLongArray.get(i) + " ");
      }
   }  

   static class Increment implements Runnable {

      public void run() {

         for(int i = 0; i<atomicLongArray.length(); i++) {
            long add = atomicLongArray.incrementAndGet(i);
            System.out.println("Thread " + Thread.currentThread().getId() 
               + ", index " +i + ", value: "+ add);
         }
      }
   }

   static class Compare implements Runnable {

      public void run() {

         for(int i = 0; i<atomicLongArray.length(); i++) {
            boolean swapped = atomicLongArray.compareAndSet(i, 2, 3);
            
            if(swapped) {
               System.out.println("Thread " + Thread.currentThread().getId()
                  + ", index " +i + ", value: 3");
            }
         }
      }
   }
}

這將產生以下結果。

輸出

Thread 9, index 0, value: 2
Thread 10, index 0, value: 3
Thread 9, index 1, value: 2
Thread 9, index 2, value: 2
Thread 9, index 3, value: 2
Thread 9, index 4, value: 2
Thread 10, index 1, value: 3
Thread 9, index 5, value: 2
Thread 10, index 2, value: 3
Thread 9, index 6, value: 2
Thread 10, index 3, value: 3
Thread 9, index 7, value: 2
Thread 10, index 4, value: 3
Thread 9, index 8, value: 2
Thread 9, index 9, value: 2
Thread 10, index 5, value: 3
Thread 10, index 6, value: 3
Thread 10, index 7, value: 3
Thread 10, index 8, value: 3
Thread 10, index 9, value: 3
Values: 
3 3 3 3 3 3 3 3 3 3

列印頁面