public class PriorityQueue<E> extends AbstractQueue<E> implements java.io.Serializable {
1 // 默認初始化大小 2 privatestaticfinalintDEFAULT_INITIAL_CAPACITY = 11; 3 4 // 用數組實現的二叉堆,下面的英文註釋確認了咱們前面的說法。 5 /** 6 * Priority queue represented as a balanced binary heap: the two 7 * children of queue[n] are queue[2*n+1] and queue[2*(n+1)]. The 8 * priority queue is ordered by comparator, or by the elements' 9 * natural ordering, if comparator is null: For each node n in the 10 * heap and each descendant d of n, n <= d. The element with the 11 * lowest value is in queue[0], assuming the queue is nonempty. 12 */ 13 private transient Object[] queue ; 14 15 // 隊列的元素數量 16 private int size = 0; 17 18 // 比較器 19 private final Comparator<? super E> comparator; 20 21 // 修改版本 22 private transient int modCount = 0;
1 /** 2 * 默認構造方法,使用默認的初始大小來構造一個優先隊列,比較器comparator爲空,這裏要求入隊的元素必須實現Comparator接口 3 */ 4 public PriorityQueue() { 5 this(DEFAULT_INITIAL_CAPACITY, null); 6 } 7 8 /** 9 * 使用指定的初始大小來構造一個優先隊列,比較器comparator爲空,這裏要求入隊的元素必須實現Comparator接口 10 */ 11 public PriorityQueue( int initialCapacity) { 12 this(initialCapacity, null); 13 } 14 15 /** 16 * 使用指定的初始大小和比較器來構造一個優先隊列 17 */ 18 public PriorityQueue( int initialCapacity, 19 Comparator<? super E> comparator) { 20 // Note: This restriction of at least one is not actually needed, 21 // but continues for 1.5 compatibility 22 // 初始大小不容許小於1 23 if (initialCapacity < 1) 24 throw new IllegalArgumentException(); 25 // 使用指定初始大小建立數組 26 this.queue = new Object[initialCapacity]; 27 // 初始化比較器 28 this.comparator = comparator; 29 } 30 31 /** 32 * 構造一個指定Collection集合參數的優先隊列 33 */ 34 public PriorityQueue(Collection<? extends E> c) { 35 // 從集合c中初始化數據到隊列 36 initFromCollection(c); 37 // 若是集合c是包含比較器Comparator的(SortedSet/PriorityQueue),則使用集合c的比較器來初始化隊列的Comparator 38 if (c instanceof SortedSet) 39 comparator = (Comparator<? super E>) 40 ((SortedSet<? extends E>)c).comparator(); 41 else if (c instanceof PriorityQueue) 42 comparator = (Comparator<? super E>) 43 ((PriorityQueue<? extends E>)c).comparator(); 44 // 若是集合c沒有包含比較器,則默認比較器Comparator爲空 45 else { 46 comparator = null; 47 // 調用heapify方法從新將數據調整爲一個二叉堆 48 heapify(); 49 } 50 } 51 52 /** 53 * 構造一個指定PriorityQueue參數的優先隊列 54 */ 55 public PriorityQueue(PriorityQueue<? extends E> c) { 56 comparator = (Comparator<? super E>)c.comparator(); 57 initFromCollection(c); 58 } 59 60 /** 61 * 構造一個指定SortedSet參數的優先隊列 62 */ 63 public PriorityQueue(SortedSet<? extends E> c) { 64 comparator = (Comparator<? super E>)c.comparator(); 65 initFromCollection(c); 66 } 67 68 /** 69 * 從集合中初始化數據到隊列 70 */ 71 private void initFromCollection(Collection<? extends E> c) { 72 // 將集合Collection轉換爲數組a 73 Object[] a = c.toArray(); 74 // If c.toArray incorrectly doesn't return Object[], copy it. 75 // 若是轉換後的數組a類型不是Object數組,則轉換爲Object數組 76 if (a.getClass() != Object[].class) 77 a = Arrays. copyOf(a, a.length, Object[]. class); 78 // 將數組a賦值給隊列的底層數組queue 79 queue = a; 80 // 將隊列的元素個數設置爲數組a的長度 81 size = a.length ; 82 }
1 /** 2 * 添加一個元素 3 */ 4 public boolean add(E e) { 5 return offer(e); 6 } 7 8 /** 9 * 入隊 10 */ 11 public boolean offer(E e) { 12 // 若是元素e爲空,則排除空指針異常 13 if (e == null) 14 throw new NullPointerException(); 15 // 修改版本+1 16 modCount++; 17 // 記錄當前隊列中元素的個數 18 int i = size ; 19 // 若是當前元素個數大於等於隊列底層數組的長度,則進行擴容 20 if (i >= queue .length) 21 grow(i + 1); 22 // 元素個數+1 23 size = i + 1; 24 // 若是隊列中沒有元素,則將元素e直接添加至根(數組小標0的位置) 25 if (i == 0) 26 queue[0] = e; 27 // 不然調用siftUp方法,將元素添加到尾部,進行上移判斷 28 else 29 siftUp(i, e); 30 return true; 31 }
1 /** 2 * 數組擴容 3 */ 4 private void grow(int minCapacity) { 5 // 若是最小須要的容量大小minCapacity小於0,則說明此時已經超出int的範圍,則拋出OutOfMemoryError異常 6 if (minCapacity < 0) // overflow 7 throw new OutOfMemoryError(); 8 // 記錄當前隊列的長度 9 int oldCapacity = queue .length; 10 // Double size if small; else grow by 50% 11 // 若是當前隊列長度小於64則擴容2倍,不然擴容1.5倍 12 int newCapacity = ((oldCapacity < 64)? 13 ((oldCapacity + 1) * 2): 14 ((oldCapacity / 2) * 3)); 15 // 若是擴容後newCapacity超出int的範圍,則將newCapacity賦值爲Integer.Max_VALUE 16 if (newCapacity < 0) // overflow 17 newCapacity = Integer. MAX_VALUE; 18 // 若是擴容後,newCapacity小於最小須要的容量大小minCapacity,則按找minCapacity長度進行擴容 19 if (newCapacity < minCapacity) 20 newCapacity = minCapacity; 21 // 數組copy,進行擴容 22 queue = Arrays.copyOf( queue, newCapacity); 23 }
1 /** 2 * 上移,x表示新插入元素,k表示新插入元素在數組的位置 3 */ 4 private void siftUp(int k, E x) { 5 // 若是比較器comparator不爲空,則調用siftUpUsingComparator方法進行上移操做 6 if (comparator != null) 7 siftUpUsingComparator(k, x); 8 // 若是比較器comparator爲空,則調用siftUpComparable方法進行上移操做 9 else 10 siftUpComparable(k, x); 11 } 12 13 private void siftUpComparable(int k, E x) { 14 // 比較器comparator爲空,須要插入的元素實現Comparable接口,用於比較大小 15 Comparable<? super E> key = (Comparable<? super E>) x; 16 // k>0表示判斷k不是根的狀況下,也就是元素x有父節點 17 while (k > 0) { 18 // 計算元素x的父節點位置[(n-1)/2] 19 int parent = (k - 1) >>> 1; 20 // 取出x的父親e 21 Object e = queue[parent]; 22 // 若是新增的元素k比其父親e大,則不須要"上移",跳出循環結束 23 if (key.compareTo((E) e) >= 0) 24 break; 25 // x比父親小,則須要進行"上移" 26 // 交換元素x和父親e的位置 27 queue[k] = e; 28 // 將新插入元素的位置k指向父親的位置,進行下一層循環 29 k = parent; 30 } 31 // 找到新增元素x的合適位置k以後進行賦值 32 queue[k] = key; 33 } 34 35 // 這個方法和上面的操做同樣,很少說了 36 private void siftUpUsingComparator(int k, E x) { 37 while (k > 0) { 38 int parent = (k - 1) >>> 1; 39 Object e = queue[parent]; 40 if (comparator .compare(x, (E) e) >= 0) 41 break; 42 queue[k] = e; 43 k = parent; 44 } 45 queue[k] = x; 46 }
1 /** 2 * 刪除並返回隊頭的元素,若是隊列爲空則拋出NoSuchElementException異常(該方法在AbstractQueue中) 3 */ 4 public E remove() { 5 E x = poll(); 6 if (x != null) 7 return x; 8 else 9 throw new NoSuchElementException(); 10 } 11 12 /** 13 * 刪除並返回隊頭的元素,若是隊列爲空則返回null 14 */ 15 public E poll() { 16 // 隊列爲空,返回null 17 if (size == 0) 18 return null; 19 // 隊列元素個數-1 20 int s = --size ; 21 // 修改版本+1 22 modCount++; 23 // 隊頭的元素 24 E result = (E) queue[0]; 25 // 隊尾的元素 26 E x = (E) queue[s]; 27 // 先將隊尾賦值爲null 28 queue[s] = null; 29 // 若是隊列中不止隊尾一個元素,則調用siftDown方法進行"下移"操做 30 if (s != 0) 31 siftDown(0, x); 32 return result; 33 } 34 35 /** 36 * 上移,x表示隊尾的元素,k表示被刪除元素在數組的位置 37 */ 38 private void siftDown(int k, E x) { 39 // 若是比較器comparator不爲空,則調用siftDownUsingComparator方法進行下移操做 40 if (comparator != null) 41 siftDownUsingComparator(k, x); 42 // 比較器comparator爲空,則調用siftDownComparable方法進行下移操做 43 else 44 siftDownComparable(k, x); 45 } 46 47 private void siftDownComparable(int k, E x) { 48 // 比較器comparator爲空,須要插入的元素實現Comparable接口,用於比較大小 49 Comparable<? super E> key = (Comparable<? super E>)x; 50 // 經過size/2找到一個沒有葉子節點的元素 51 int half = size >>> 1; // loop while a non-leaf 52 // 比較位置k和half,若是k小於half,則k位置的元素就不是葉子節點 53 while (k < half) { 54 // 找到根元素的左孩子的位置[2n+1] 55 int child = (k << 1) + 1; // assume left child is least 56 // 左孩子的元素 57 Object c = queue[child]; 58 // 找到根元素的右孩子的位置[2(n+1)] 59 int right = child + 1; 60 // 若是左孩子大於右孩子,則將c複製爲右孩子的值,這裏也就是找出左右孩子哪一個最小 61 if (right < size && 62 ((Comparable<? super E>) c).compareTo((E) queue [right]) > 0) 63 c = queue[child = right]; 64 // 若是隊尾元素比根元素孩子都要小,則不需"下移",結束 65 if (key.compareTo((E) c) <= 0) 66 break; 67 // 隊尾元素比根元素孩子都大,則須要"下移" 68 // 交換跟元素和孩子c的位置 69 queue[k] = c; 70 // 將根元素位置k指向最小孩子的位置,進入下層循環 71 k = child; 72 } 73 // 找到隊尾元素x的合適位置k以後進行賦值 74 queue[k] = key; 75 } 76 77 // 這個方法和上面的操做同樣,很少說了 78 private void siftDownUsingComparator(int k, E x) { 79 int half = size >>> 1; 80 while (k < half) { 81 int child = (k << 1) + 1; 82 Object c = queue[child]; 83 int right = child + 1; 84 if (right < size && 85 comparator.compare((E) c, (E) queue [right]) > 0) 86 c = queue[child = right]; 87 if (comparator .compare(x, (E) c) <= 0) 88 break; 89 queue[k] = c; 90 k = child; 91 } 92 queue[k] = x; 93 }
1 /** 2 * Establishes the heap invariant (described above) in the entire tree, 3 * assuming nothing about the order of the elements prior to the call. 4 */ 5 private void heapify() { 6 for (int i = (size >>> 1) - 1; i >= 0; i--) 7 siftDown(i, (E) queue[i]); 8 }
1 private void heapify() { 2 for (int i = (size >>> 1) - 1; i >= 0; i--) 3 siftDown(i, (E) queue[i]); 4 }