集合框架源码分析四(Collections类详细分析)

我认为Collections类主要是完成了两个主要功能 
1.提供了若干简单而又有用的算法,比如排序,二分查找,求最大最小值等等。 
2.提供对集合进行包装的静态方法。比如把指定的集合包装成线程安全的集合、包装成不可修改的集合、包装成类型安全的集合等。 

package java.util;
import java.io.Serializable;
import java.io.ObjectOutputStream;
import java.io.IOException;
import java.lang.reflect.Array;




public class Collections{
    // Suppresses default constructor, ensuring non-instantiability.
    private Collections() {
    }


    // 算法


    /*
     * 
     * 算法需要用到的一些参数。所有的关于List的算法都有两种实现,一种是适合随机访问的
     * List,另一种是适合连续访问的。
     */
    private static final int BINARYSEARCH_THRESHOLD   = 5000;
    private static final int REVERSE_THRESHOLD        =   18;
    private static final int SHUFFLE_THRESHOLD        =    5;
    private static final int FILL_THRESHOLD           =   25;
    private static final int ROTATE_THRESHOLD         =  100;
    private static final int COPY_THRESHOLD           =   10;
    private static final int REPLACEALL_THRESHOLD     =   11;
    private static final int INDEXOFSUBLIST_THRESHOLD =   35;


    /**
     *
     * List中的所有元素必须实现Compareable接口,即每个 元素必须是可比的。
     * 
     * 算法的实现原理为:
     * 把指定的List转化为一个对象数组,对数组进行排序,然后迭代List的每一个元素,
     * 在同样的位置重新设置数组中排好序的元素
     */
    public static > void sort(List list) {
Object[] a = list.toArray(); //转化为对象数组
Arrays.sort(a); //对数组排序,使用了归并排序.对此归并的详细分析可见我另一篇博客
ListIterator i = list.listIterator();
for (int j=0; j //迭代元素
   i.next();
   i.set((T)a[j]); //在同样的位置重设排好序的值
}
    }
    
    


    /**
     * 传一个实现了Comparator接口的对象进来。
     * c.compare(o1,o2);来比较两个元素
     */
    public static void sort(List list, Comparator c) {
Object[] a = list.toArray();
Arrays.sort(a, (Comparator)c);
ListIterator i = list.listIterator();
for (int j=0; j    i.next();
   i.set(a[j]);
}
    }




    /**
     *
     * 使用二分查找在指定List中查找指定元素key。
     * List中的元素必须是有序的。如果List中有多个key,不能确保哪个key值被找到。
     * 如果List不是有序的,返回的值没有任何意义
     * 
     * 对于随机访问列表来说,时间复杂度为O(log(n)),比如1024个数只需要查找log2(1024)=10次,
     * log2(n)是最坏的情况,即最坏的情况下都只需要找10次
     * 对于链表来说,查找中间元素的时间复杂度为O(n),元素比较的时间复杂度为O(log(n))
     * 
     * @return 查找元素的索引。如果返回的是负数表明找不到此元素,但可以用返回值计算
     *  应该将key插入到集合什么位置,任然能使集合有序(如果需要插入key值的话)。
     * 公式:point  = -i - 1
     * 
     */
    public static int binarySearch(List> list, T key) {
        if (list instanceof RandomAccess || list.size()             return Collections.indexedBinarySearch(list, key);
        else
            return Collections.iteratorBinarySearch(list, key);
    }


    /**
     * 使用索引化二分查找。
     * size小于5000的链表也用此方法查找
     */
    private static int indexedBinarySearch(List> list, T key){
int low = 0; //元素所在范围的下界
int high = list.size()-1; //上界

while (low <= high) {
   int mid = (low + high) >>> 1;
   Comparable midVal = list.get(mid); //中间值
   int cmp = midVal.compareTo(key); //指定元素与中间值比较

   if (cmp < 0)
    low = mid + 1; //重新设置上界和下界
   else if (cmp > 0)
    high = mid - 1;
   else
    return mid; // key found
}
return -(low + 1);  // key not found
    }


    /**
     * 迭代式二分查找,线性查找,依次查找得中间值
     * 
     */
    private static int iteratorBinarySearch(List> list, T key){
int low = 0;
int high = list.size()-1;
       ListIterator> i = list.listIterator();

       while (low <= high) {
           int mid = (low + high) >>> 1;
           Comparable midVal = get(i, mid);
           int cmp = midVal.compareTo(key);

           if (cmp < 0)
               low = mid + 1;
           else if (cmp > 0)
               high = mid - 1;
           else
               return mid; // key found
       }
       return -(low + 1);  // key not found
    }




    private static T get(ListIterator i, int index) {
T obj = null;
        int pos = i.nextIndex(); //根据当前迭代器的位置确定是向前还是向后遍历找中间值
        if (pos <= index) {
            do {
                obj = i.next();
            } while (pos++ < index);
        } else {
            do {
                obj = i.previous();
            } while (--pos > index);
        }
        return obj;
    }


    /**
     * 提供实现了Comparator接口的对象比较元素
     */
    public static int binarySearch(List list, T key, Comparator c) {
        if (c==null)
            return binarySearch((List) list, key);


        if (list instanceof RandomAccess || list.size()             return Collections.indexedBinarySearch(list, key, c);
        else
            return Collections.iteratorBinarySearch(list, key, c);
    }


    private static int indexedBinarySearch(List l, T key, Comparator c) {
int low = 0;
int high = l.size()-1;

while (low <= high) {
   int mid = (low + high) >>> 1;
   T midVal = l.get(mid);
   int cmp = c.compare(midVal, key);

   if (cmp < 0)
low = mid + 1;
   else if (cmp > 0)
high = mid - 1;
   else
return mid; // key found
}
return -(low + 1);  // key not found
    }


    private static int iteratorBinarySearch(List l, T key, Comparator c) {
int low = 0;
int high = l.size()-1;
       ListIterator i = l.listIterator();

       while (low <= high) {
           int mid = (low + high) >>> 1;
           T midVal = get(i, mid);
           int cmp = c.compare(midVal, key);

           if (cmp < 0)
               low = mid + 1;
           else if (cmp > 0)
               high = mid - 1;
           else
               return mid; // key found
       }
       return -(low + 1);  // key not found
    }


    private interface SelfComparable extends Comparable {}




    /**
     * 
     * 逆序排列指定列表中的元素
     */
    public static void reverse(List list) {
        int size = list.size();
        //如果是size小于18的链表或是基于随机访问的列表
        if (size < REVERSE_THRESHOLD || list instanceof RandomAccess) {
            for (int i=0, mid=size>>1, j=size-1; i //第一个与最后一个,依次交换
                swap(list, i, j); //交换i和j位置的值
        } else { //基于迭代器的逆序排列算法
            ListIterator fwd = list.listIterator();
            ListIterator rev = list.listIterator(size);
            for (int i=0, mid=list.size()>>1; i //这..,一个思想你懂得
            Object tmp = fwd.next();
                fwd.set(rev.previous());
                rev.set(tmp);
            }
        }
    }


    /**
     * 
     * 对指定列表中的元素进行混排
     */
    public static void shuffle(List list) {
        if (r == null) {
            r = new Random();
        }
        shuffle(list, r);
    }
    private static Random r;


    /**
     * 
     * 提供一个随机数生成器对指定List进行混排
     * 
     * 基本算法思想为:
     * 逆向遍历list,从最后一个元素到第二个元素,然后重复交换当前位置
     * 与随机产生的位置的元素值。
     *
     * 如果list不是基于随机访问并且其size>5,会先把List中的复制到数组中,
     * 然后对数组进行混排,再把数组中的元素重新填入List中。
     * 这样做为了避免迭代器大跨度查找元素影响效率
     */
    public static void shuffle(List list, Random rnd) {
        int size = list.size();
        if (size < SHUFFLE_THRESHOLD || list instanceof RandomAccess) {
            for (int i=size; i>1; i--) //从i-1个位置开始与随机位置元素交换值
                swap(list, i-1, rnd.nextInt(i));
        } else {
            Object arr[] = list.toArray(); //先转化为数组


            //对数组进行混排
            for (int i=size; i>1; i--)
                swap(arr, i-1, rnd.nextInt(i));


            // 然后把数组中的元素重新填入List
            ListIterator it = list.listIterator();
            for (int i=0; i                 it.next();
                it.set(arr[i]);
            }
        }
    }


    /**
     * 交换List中两个位置的值
     */
    public static void swap(List list, int i, int j) {
final List l = list;
l.set(i, l.set(j, l.get(i))); //互换i和j位置的值
    }


    /**
     * 交换数组俩位置的值。好熟悉啊
     */
    private static void swap(Object[] arr, int i, int j) {
        Object tmp = arr[i];
        arr[i] = arr[j];
        arr[j] = tmp;
    }


    /**
     * 
     * 用obj替换List中的所有元素
     * 依次遍历赋值即可
     */
    public static void fill(List list, T obj) {
        int size = list.size();


        if (size < FILL_THRESHOLD || list instanceof RandomAccess) {
            for (int i=0; i                 list.set(i, obj);
        } else {
            ListIterator itr = list.listIterator();
            for (int i=0; i                 itr.next();
                itr.set(obj);
            }
        }
    }


    /**
     * 
     * 复制源列表的所有元素到目标列表,
     * 如果src.size > dest.size 将抛出一个异常
     * 如果src.size < dest.size dest中多出的元素将不受影响
     * 同样是依次遍历赋值
     */
    public static void copy(List dest, List src) {
        int srcSize = src.size();
        if (srcSize > dest.size())
            throw new IndexOutOfBoundsException("Source does not fit in dest");


        if (srcSize < COPY_THRESHOLD ||
            (src instanceof RandomAccess && dest instanceof RandomAccess)) {
            for (int i=0; i                 dest.set(i, src.get(i));
        } else { //一个链表一个线性表也可以用迭代器赋值
            ListIterator di=dest.listIterator();
            ListIterator si=src.listIterator();
            for (int i=0; i                 di.next();
                di.set(si.next());
            }
        }
    }


    /**
     * 
     * 返回集合中的最小元素。前提是其中的元素都是可比的,即实现了Comparable接口
     * 找出一个通用的算法其实不容易,尽管它的思想不难。
     * 反正要依次遍历完所有元素,所以直接用了迭代器
     */
    public static > T min(Collection coll) {
Iterator i = coll.iterator();
T candidate = i.next();
while (i.hasNext()) {
   T next = i.next();
   if (next.compareTo(candidate) < 0)
    candidate = next;
}
return candidate;
    }


    /**
     * 根据提供的比较器求最小元素
     */
    public static T min(Collection coll, Comparator comp) {
        if (comp==null)
        //返回默认比较器,其实默认比较器什么也不做,只是看集合元素是否实现了Comparable接口,
        //否则抛出ClassCastException
            return (T)min((Collection) (Collection) coll);


Iterator i = coll.iterator();
T candidate = i.next(); //假设第一个元素为最小元素


        while (i.hasNext()) {
   T next = i.next();
   if (comp.compare(next, candidate) < 0)
    candidate = next;
        }
        return candidate;
    }


    /**
     * 求集合中最大元素
     */
    public static > T max(Collection coll) {
Iterator i = coll.iterator();
T candidate = i.next();

   while (i.hasNext()) {
   T next = i.next();
   if (next.compareTo(candidate) > 0)
    candidate = next;
}
return candidate;
    }


    /**
     * 根据指定比较器求集合中最大元素
     */
    public static T max(Collection coll, Comparator comp) {
        if (comp==null)
        return (T)max((Collection) (Collection) coll);


        Iterator i = coll.iterator();
        T candidate = i.next();


        while (i.hasNext()) {
        T next = i.next();
        if (comp.compare(next, candidate) > 0)
        candidate = next;
        }
return candidate;
    }


    /**
     * 
     * 旋转移位List中的元素通过指定的distance。每个元素移动后的位置为:
     * (i + distance)%list.size.此方法不会改变列表的长度
     * 
     * 比如,类表元素为: [t, a, n, k, s , w]
     * 执行Collections.rotate(list, 2)或
     * Collections.rotate(list, -4)后, list中的元素将变为
     * [s, w, t, a, n , k]。可以这样理解:正数表示向后移,负数表示向前移
     *
     */
    public static void rotate(List list, int distance) {
        if (list instanceof RandomAccess || list.size() < ROTATE_THRESHOLD)
            rotate1((List)list, distance);
        else
            rotate2((List)list, distance);
    }


    private static void rotate1(List list, int distance) {
        int size = list.size();
        if (size == 0)
            return;
        distance = distance % size; //distance始终处于0到size(不包括)之间
        if (distance < 0)
            distance += size; //还是以向后移来计算的
        if (distance == 0)
            return;


        for (int cycleStart = 0, nMoved = 0; nMoved != size; cycleStart++) {
            T displaced = list.get(cycleStart);
            int i = cycleStart;
            do {
                i += distance; //求新位置
                if (i >= size)
                    i -= size; //超出size就减去size
                displaced = list.set(i, displaced); //为新位置赋原来的值
                nMoved ++; //如果等于size证明全部替换完毕
            } while(i != cycleStart); //依次类推,求新位置的新位置
        }
    }


    private static void rotate2(List list, int distance) {
        int size = list.size();
        if (size == 0)
            return;
        int mid =  -distance % size;
        if (mid < 0)
            mid += size;
        if (mid == 0)
            return;
        //好神奇啊
        reverse(list.subList(0, mid));
        reverse(list.subList(mid, size));
        reverse(list);
    }


    /**
     * 
     * 把指定集合中所有与oladVal相等的元素替换成newVal
     * 只要list发生了改变就返回true
     */
    public static boolean replaceAll(List list, T oldVal, T newVal) {
        boolean result = false;
        int size = list.size();
        if (size < REPLACEALL_THRESHOLD || list instanceof RandomAccess) {
            if (oldVal==null) {
                for (int i=0; i                     if (list.get(i)==null) {
                        list.set(i, newVal);
                        result = true;
                    }
                }
            } else {
                for (int i=0; i                     if (oldVal.equals(list.get(i))) {
                        list.set(i, newVal);
                        result = true;
                    }
                }
            }
        } else {
            ListIterator itr=list.listIterator();
            if (oldVal==null) {
                for (int i=0; i                     if (itr.next()==null) {
                        itr.set(newVal);
                        result = true;
                    }
                }
            } else {
                for (int i=0; i                     if (oldVal.equals(itr.next())) {
                        itr.set(newVal);
                        result = true;
                    }
                }
            }
        }
        return result;
    }


    /**
     * 
     * target是否是source的子集,如果是返回target第一个元素的索引,
     * 否则返回-1。
     * 其实这里和串的模式匹配差不多。这里使用的是基本的回溯法。
     * 
     */
    public static int indexOfSubList(List source, List target) {
        int sourceSize = source.size();
        int targetSize = target.size();
        int maxCandidate = sourceSize - targetSize;


        if (sourceSize < INDEXOFSUBLIST_THRESHOLD ||
            (source instanceof RandomAccess&&target instanceof RandomAccess)) {
   nextCand:for (int candidate = 0; candidate <= maxCandidate; candidate++) {
                for (int i=0, j=candidate; i                     if (!eq(target.get(i), source.get(j)))
                        continue nextCand;  // 元素失配,跳到外部循环
                return candidate;  // All elements of candidate matched target
            }
        } else {  // Iterator version of above algorithm
            ListIterator si = source.listIterator();
   nextCand:for (int candidate = 0; candidate <= maxCandidate; candidate++) {
                ListIterator ti = target.listIterator();
                for (int i=0; i                     if (!eq(ti.next(), si.next())) {
                        // 回溯指针,然后跳到外部循环继续执行
                        for (int j=0; j                             si.previous();
                        continue nextCand;
                    }
                }
                return candidate;
            }
        }
        return -1;  //没有找到匹配的子串返回-1
    }


    /**
     * 如果有一个或多个字串,返回最后一个出现的子串的第一个元素的索引
     */
    public static int lastIndexOfSubList(List source, List target) {
        int sourceSize = source.size();
        int targetSize = target.size();
        int maxCandidate = sourceSize - targetSize;


        if (sourceSize < INDEXOFSUBLIST_THRESHOLD ||
            source instanceof RandomAccess) {   // Index access version
   nextCand:for (int candidate = maxCandidate; candidate >= 0; candidate--) {
                for (int i=0, j=candidate; i                     if (!eq(target.get(i), source.get(j))) //从source的maxCandidate位置开始比较。然后是maxCandidate-1,依次类推
                        continue nextCand;  // Element mismatch, try next cand
                return candidate;  // All elements of candidate matched target
            }
        } else {  // Iterator version of above algorithm
            if (maxCandidate < 0)
                return -1;
            ListIterator si = source.listIterator(maxCandidate);
  nextCand: for (int candidate = maxCandidate; candidate >= 0; candidate--) {
                ListIterator ti = target.listIterator();
                for (int i=0; i                     if (!eq(ti.next(), si.next())) {
                        if (candidate != 0) {
                            // Back up source iterator to next candidate
                            for (int j=0; j<=i+1; j++)
                                si.previous();
                        }
                        continue nextCand;
                    }
                }
                return candidate;
            }
        }
        return -1;  // No candidate matched the target
    }




    // Unmodifiable Wrappers


    /**
     * 
     * 返回一个关于指定集合的不可修改的视图。
     * 任何试图修改该视图的操作都将抛出一个UnsupportedOperationException
     * 
     * Collection返回的视图的equals方法不是调用底层集合的equals方法
     * 而是继承了Object的equals方法。hashCode方法也是一样的。
     * 因为Set和List的equals方法并不相同。
     */
    public static Collection unmodifiableCollection(Collection c) {
    return new UnmodifiableCollection(c);
    }


    
    static class UnmodifiableCollection implements Collection, Serializable {
// use serialVersionUID from JDK 1.2.2 for interoperability
private static final long serialVersionUID = 1820017752578914078L;

final Collection c;

UnmodifiableCollection(Collection c) {
           if (c==null)
               throw new NullPointerException();
           this.c = c;
   }

public int size()    {return c.size();}
public boolean isEmpty()    {return c.isEmpty();}
public boolean contains(Object o)   {return c.contains(o);}
public Object[] toArray()           {return c.toArray();}
public T[] toArray(T[] a)       {return c.toArray(a);}
   public String toString()            {return c.toString();}

public Iterator iterator() {
   return new Iterator() {
Iterator i = c.iterator();

public boolean hasNext() {return i.hasNext();}
public E next() {return i.next();}
public void remove() { //试图修改集合的操作都将抛出此异常
   throw new UnsupportedOperationException();
       }
   };
       }

public boolean add(E e){
   throw new UnsupportedOperationException();
   }
public boolean remove(Object o) {
   throw new UnsupportedOperationException();
   }

public boolean containsAll(Collection coll) {
   return c.containsAll(coll);
   }
public boolean addAll(Collection coll) {
   throw new UnsupportedOperationException();
   }
public boolean removeAll(Collection coll) {
   throw new UnsupportedOperationException();
   }
public boolean retainAll(Collection coll) {
   throw new UnsupportedOperationException();
   }
public void clear() {
   throw new UnsupportedOperationException();
   }
    }


    /**
     * 返回一个不可修改Set。
     * 调用的是底层集合的equals方法
     */
    public static Set unmodifiableSet(Set s) {
    return new UnmodifiableSet(s);
    }


    /**
     * @serial include
     */
    static class UnmodifiableSet extends UnmodifiableCollection
    implements Set, Serializable {
private static final long serialVersionUID = -9215047833775013803L;

UnmodifiableSet(Set s) {super(s);}
public boolean equals(Object o) {return o == this || c.equals(o);}
public int hashCode() {return c.hashCode();}
    }


    /**
     * 返回一个不可修改的Sort Set
     */
    public static SortedSet unmodifiableSortedSet(SortedSet s) {
    return new UnmodifiableSortedSet(s);
    }


    static class UnmodifiableSortedSet
                    extends UnmodifiableSet
                    implements SortedSet, Serializable {
    private static final long serialVersionUID = -4929149591599911165L;
        private final SortedSet ss;


        UnmodifiableSortedSet(SortedSet s) {super(s); ss = s;}


        public Comparator comparator() {return ss.comparator();}


        public SortedSet subSet(E fromElement, E toElement) {
            return new UnmodifiableSortedSet(ss.subSet(fromElement,toElement));
        }
        public SortedSet headSet(E toElement) {
            return new UnmodifiableSortedSet(ss.headSet(toElement));
        }
        public SortedSet tailSet(E fromElement) {
            return new UnmodifiableSortedSet(ss.tailSet(fromElement));
        }


        public E first()           {return ss.first();}
        public E last()             {return ss.last();}
    }


    /**
     * 返回一个 不可修改的List
     * 如果原List实现了RandomAccess接口,返回的List也将实现此接口
     */
    public static List unmodifiableList(List list) {
return (list instanceof RandomAccess ?
               new UnmodifiableRandomAccessList(list) :
               new UnmodifiableList(list));
    }




    static class UnmodifiableList extends UnmodifiableCollection
     implements List {
        static final long serialVersionUID = -283967356065247728L;
final List list;

UnmodifiableList(List list) {
   super(list);
   this.list = list;
}

public boolean equals(Object o) {return o == this || list.equals(o);}
public int hashCode() {return list.hashCode();}

public E get(int index) {return list.get(index);}
public E set(int index, E element) {
   throw new UnsupportedOperationException();
       }
public void add(int index, E element) {
   throw new UnsupportedOperationException();
       }
public E remove(int index) {
   throw new UnsupportedOperationException();
       }
public int indexOf(Object o)            {return list.indexOf(o);}
public int lastIndexOf(Object o)        {return list.lastIndexOf(o);}
public boolean addAll(int index, Collection c) {
   throw new UnsupportedOperationException();
       }
public ListIterator listIterator() {return listIterator(0);}

public ListIterator listIterator(final int index) {
   return new ListIterator() {
ListIterator i = list.listIterator(index);

public boolean hasNext()     {return i.hasNext();}
public E next()     {return i.next();}
public boolean hasPrevious() {return i.hasPrevious();}
public E previous()     {return i.previous();}
public int nextIndex()       {return i.nextIndex();}
public int previousIndex()   {return i.previousIndex();}

public void remove() {
   throw new UnsupportedOperationException();
               }
public void set(E e) {
   throw new UnsupportedOperationException();
               }
public void add(E e) {
   throw new UnsupportedOperationException();
               }
   };
}


public List subList(int fromIndex, int toIndex) {
           return new UnmodifiableList(list.subList(fromIndex, toIndex));
   }


        /**
         * UnmodifiableRandomAccessList instances are serialized as
         * UnmodifiableList instances to allow them to be deserialized
         * in pre-1.4 JREs (which do not have UnmodifiableRandomAccessList).
         * This method inverts the transformation.  As a beneficial
         * side-effect, it also grafts the RandomAccess marker onto
         * UnmodifiableList instances that were serialized in pre-1.4 JREs.
         *
         * Note: Unfortunately, UnmodifiableRandomAccessList instances
         * serialized in 1.4.1 and deserialized in 1.4 will become
         * UnmodifiableList instances, as this method was missing in 1.4.
         * 这个,自己看吧...
         */
        private Object readResolve() {
            return (list instanceof RandomAccess
   ? new UnmodifiableRandomAccessList(list)
   : this);
        }
    }


    
    static class UnmodifiableRandomAccessList extends UnmodifiableList
                                              implements RandomAccess{
        UnmodifiableRandomAccessList(List list) {
            super(list);
        }


        public List subList(int fromIndex, int toIndex) {
            return new UnmodifiableRandomAccessList(
                list.subList(fromIndex, toIndex));
        }


        private static final long serialVersionUID = -2542308836966382001L;


        /**
         * Allows instances to be deserialized in pre-1.4 JREs (which do
         * not have UnmodifiableRandomAccessList).  UnmodifiableList has
         * a readResolve method that inverts this transformation upon
         * deserialization.
         */
        private Object writeReplace() {
            return new UnmodifiableList(list);
        }
    }


    /**
     * 返回一个不可修改的map
     */
    public static Map unmodifiableMap(Map m) {
    return new UnmodifiableMap(m);
    }




    private static class UnmodifiableMap implements Map, Serializable {
// use serialVersionUID from JDK 1.2.2 for interoperability
private static final long serialVersionUID = -1034234728574286014L;

private final Map m;

UnmodifiableMap(Map m) {
           if (m==null)
               throw new NullPointerException();
           this.m = m;
   }

public int size()         {return m.size();}
public boolean isEmpty()         {return m.isEmpty();}
public boolean containsKey(Object key)   {return m.containsKey(key);}
public boolean containsValue(Object val) {return m.containsValue(val);}
public V get(Object key)         {return m.get(key);}

public V put(K key, V value) {
   throw new UnsupportedOperationException();
   }
public V remove(Object key) {
   throw new UnsupportedOperationException();
   }
public void putAll(Map m) {
   throw new UnsupportedOperationException();
   }
public void clear() {
   throw new UnsupportedOperationException();
   }

private transient Set keySet = null;
private transient Set> entrySet = null;
private transient Collection values = null;

//返回的key集也是不可修改的
public Set keySet() {
   if (keySet==null)
    keySet = unmodifiableSet(m.keySet());
   return keySet;
}

//EntrySet被重新进行包装
public Set> entrySet() {
   if (entrySet==null)
    entrySet = new UnmodifiableEntrySet(m.entrySet());
   return entrySet;
}

public Collection values() {
   if (values==null)
    values = unmodifiableCollection(m.values());
   return values;
}


public boolean equals(Object o) {return o == this || m.equals(o);}
public int hashCode()           {return m.hashCode();}
        public String toString()        {return m.toString();}


        /**
         * 
         * 需要重新包装返回的EntrySet对象
         */
        static class UnmodifiableEntrySet extends UnmodifiableSet> {
        private static final long serialVersionUID = 7854390611657943733L;


            UnmodifiableEntrySet(Set> s) {
                super((Set)s);
            }
            public Iterator> iterator() {
                return new Iterator>() {
                //父类UnmodifiableColletion的c
                Iterator> i = c.iterator();


                    public boolean hasNext() {
                        return i.hasNext();
                    }
                    public Map.Entry next() {
                    return new UnmodifiableEntry(i.next());
                    }
                    public void remove() {
                        throw new UnsupportedOperationException();
                    }
                };
            }


            public Object[] toArray() {
                Object[] a = c.toArray();
                for (int i=0; i                     a[i] = new UnmodifiableEntry((Map.Entry)a[i]);
                return a;
            }


            public T[] toArray(T[] a) {
               
            Object[] arr = c.toArray(a.length==0 ? a : Arrays.copyOf(a, 0));


                for (int i=0; i                     arr[i] = new UnmodifiableEntry((Map.Entry)arr[i]);


                if (arr.length > a.length)
                    return (T[])arr;


                System.arraycopy(arr, 0, a, 0, arr.length);
                if (a.length > arr.length)
                    a[arr.length] = null;
                return a;
            }




            public boolean contains(Object o) {
                if (!(o instanceof Map.Entry))
                    return false;
                return c.contains(new UnmodifiableEntry((Map.Entry) o));
            }


            public boolean containsAll(Collection coll) {
                Iterator e = coll.iterator();
                while (e.hasNext())
                    if (!contains(e.next())) // Invokes safe contains() above
                        return false;
                return true;
            }
            public boolean equals(Object o) {
                if (o == this)
                    return true;


                if (!(o instanceof Set))
                    return false;
                Set s = (Set) o;
                if (s.size() != c.size())
                    return false;
                return containsAll(s); // Invokes safe containsAll() above
            }


            /**
             * 重新包装Entry。
             */
            private static class UnmodifiableEntry implements Map.Entry {
                private Map.Entry e;


                UnmodifiableEntry(Map.Entry e) {this.e = e;}


                public K getKey()  {return e.getKey();}
                public V getValue()  {return e.getValue();}
                public V setValue(V value) { //调用set方法将抛出一个异常
                    throw new UnsupportedOperationException();
                }
                public int hashCode()  {return e.hashCode();}
                public boolean equals(Object o) {
                    if (!(o instanceof Map.Entry))
                        return false;
                    Map.Entry t = (Map.Entry)o;
                    return eq(e.getKey(),   t.getKey()) &&
                           eq(e.getValue(), t.getValue());
                }
                public String toString()  {return e.toString();}
            }
        }
    }


    /**
     * 返回一个不可修改的SortedMap
     */
    public static SortedMap unmodifiableSortedMap(SortedMap m) {
    return new UnmodifiableSortedMap(m);
    }




    static class UnmodifiableSortedMap extends UnmodifiableMap
 implements SortedMap, Serializable {
    private static final long serialVersionUID = -8806743815996713206L;


        private final SortedMap sm;


        UnmodifiableSortedMap(SortedMap m) {super(m); sm = m;}


        public Comparator comparator() {return sm.comparator();}


        public SortedMap subMap(K fromKey, K toKey) {
            return new UnmodifiableSortedMap(sm.subMap(fromKey, toKey));
        }
        public SortedMap headMap(K toKey) {
            return new UnmodifiableSortedMap(sm.headMap(toKey));
        }
        public SortedMap tailMap(K fromKey) {
            return new UnmodifiableSortedMap(sm.tailMap(fromKey));
        }


        public K firstKey()           {return sm.firstKey();}
        public K lastKey()            {return sm.lastKey();}
    }




    // 同步包装


    /**
     * 
     * 返回一个线程安全的集合
     * 但是当用户遍历此集合时,需要手动进行同步
     *  Collection c = Collections.synchronizedCollection(myCollection);
     *     ...
     *  synchronized(c) {
     *      Iterator i = c.iterator(); // Must be in the synchronized block
     *      while (i.hasNext())
     *         foo(i.next());
     *  }
     * 
     */
    public static Collection synchronizedCollection(Collection c) {
    return new SynchronizedCollection(c);
    }


    static Collection synchronizedCollection(Collection c, Object mutex) {
    return new SynchronizedCollection(c, mutex);
    }


    /**
     * @serial include
     */
    static class SynchronizedCollection implements Collection, Serializable {
// use serialVersionUID from JDK 1.2.2 for interoperability
private static final long serialVersionUID = 3053995032091335093L;

final Collection c;  // 返回的集合
final Object mutex;     // 需要同步的对象

SynchronizedCollection(Collection c) {
       if (c==null)
            throw new NullPointerException();
   this.c = c;
       mutex = this;
   }
SynchronizedCollection(Collection c, Object mutex) {
   this.c = c;
       this.mutex = mutex;
    }


public int size() {
   synchronized(mutex) {return c.size();}
        }
public boolean isEmpty() {
   synchronized(mutex) {return c.isEmpty();}
        }
public boolean contains(Object o) {
   synchronized(mutex) {return c.contains(o);}
        }
public Object[] toArray() {
   synchronized(mutex) {return c.toArray();}
        }
public T[] toArray(T[] a) {
   synchronized(mutex) {return c.toArray(a);}
        }


public Iterator iterator() {
            return c.iterator(); // 必须用户自己手动同步
        }


public boolean add(E e) {
   synchronized(mutex) {return c.add(e);}
        }
public boolean remove(Object o) {
   synchronized(mutex) {return c.remove(o);}
        }


public boolean containsAll(Collection coll) {
   synchronized(mutex) {return c.containsAll(coll);}
        }
public boolean addAll(Collection coll) {
   synchronized(mutex) {return c.addAll(coll);}
        }
public boolean removeAll(Collection coll) {
   synchronized(mutex) {return c.removeAll(coll);}
        }
public boolean retainAll(Collection coll) {
   synchronized(mutex) {return c.retainAll(coll);}
        }
public void clear() {
   synchronized(mutex) {c.clear();}
        }
public String toString() {
   synchronized(mutex) {return c.toString();}
        }
        private void writeObject(ObjectOutputStream s) throws IOException {
   synchronized(mutex) {s.defaultWriteObject();}
        }
    }


    /**
     * 返回一个线程安全的Set
     */
    public static Set synchronizedSet(Set s) {
    return new SynchronizedSet(s);
    }


    static Set synchronizedSet(Set s, Object mutex) {
    return new SynchronizedSet(s, mutex);
    }


    /**
     * @serial include
     */
    static class SynchronizedSet extends SynchronizedCollection implements Set {
    private static final long serialVersionUID = 487447009682186044L;


SynchronizedSet(Set s) {
           super(s);
   }
SynchronizedSet(Set s, Object mutex) {
           super(s, mutex);
   }


public boolean equals(Object o) {
   synchronized(mutex) {return c.equals(o);}
   }
public int hashCode() {
   synchronized(mutex) {return c.hashCode();}
   }
    }


    /**
     * 返回一个线程安全的SortedSet
     */
    public static SortedSet synchronizedSortedSet(SortedSet s) {
    return new SynchronizedSortedSet(s);
    }


    /**
     * @serial include
     */
    static class SynchronizedSortedSet extends SynchronizedSetimplements SortedSet{
    private static final long serialVersionUID = 8695801310862127406L;


        final private SortedSet ss;


        SynchronizedSortedSet(SortedSet s) {
            super(s);
            ss = s;
        }
        SynchronizedSortedSet(SortedSet s, Object mutex) {
            super(s, mutex);
            ss = s;
        }


        public Comparator comparator() {
        synchronized(mutex) {return ss.comparator();}
        }


        public SortedSet subSet(E fromElement, E toElement) {
   synchronized(mutex) {
                return new SynchronizedSortedSet(
                    ss.subSet(fromElement, toElement), mutex);
            }
        }
        public SortedSet headSet(E toElement) {
        synchronized(mutex) {
                return new SynchronizedSortedSet(ss.headSet(toElement), mutex);
            }
        }
        public SortedSet tailSet(E fromElement) {
        synchronized(mutex) {
               return new SynchronizedSortedSet(ss.tailSet(fromElement),mutex);
            }
        }


        public E first() {
        synchronized(mutex) {return ss.first();}
        }
        public E last() {
        synchronized(mutex) {return ss.last();}
        }
    }


    /**
     * 返回一个线程安全的List,
     * 如果List是基于随机访问的,返回的List同样实现了RandomAccess接口
     */
    public static List synchronizedList(List list) {
    return (list instanceof RandomAccess ?
                new SynchronizedRandomAccessList(list) :
                new SynchronizedList(list));
    }


    static List synchronizedList(List list, Object mutex) {
    return (list instanceof RandomAccess ?
                new SynchronizedRandomAccessList(list, mutex) :
                new SynchronizedList(list, mutex));
    }


    /**
     * @serial include
     */
    static class SynchronizedListextends SynchronizedCollection implements List {
        static final long serialVersionUID = -7754090372962971524L;


        final List list;


        SynchronizedList(List list) {
        super(list);
        this.list = list;
        }
        SynchronizedList(List list, Object mutex) {
            super(list, mutex);
            this.list = list;
        }


        public boolean equals(Object o) {
        synchronized(mutex) {return list.equals(o);}
        }
        public int hashCode() {
        synchronized(mutex) {return list.hashCode();}
        }


        public E get(int index) {
        synchronized(mutex) {return list.get(index);}
        }
        public E set(int index, E element) {
        synchronized(mutex) {return list.set(index, element);}
        }
        public void add(int index, E element) {
        synchronized(mutex) {list.add(index, element);}
        }
        public E remove(int index) {
        synchronized(mutex) {return list.remove(index);}
        }


        public int indexOf(Object o) {
        synchronized(mutex) {return list.indexOf(o);}
        }
        public int lastIndexOf(Object o) {
        synchronized(mutex) {return list.lastIndexOf(o);}
        }


        public boolean addAll(int index, Collection c) {
        synchronized(mutex) {return list.addAll(index, c);}
        }


        public ListIterator listIterator() {
        return list.listIterator(); // Must be manually synched by user
        }


        public ListIterator listIterator(int index) {
        return list.listIterator(index); // Must be manually synched by user
        }


        public List subList(int fromIndex, int toIndex) {
        synchronized(mutex) {
                return new SynchronizedList(list.subList(fromIndex, toIndex),
                                            mutex);
            }
        }




        private Object readResolve() {
            return (list instanceof RandomAccess
   ? new SynchronizedRandomAccessList(list)
   : this);
        }
    }


    /**
     * @serial include
     */
    static class SynchronizedRandomAccessListextends SynchronizedList
implements RandomAccess {


        SynchronizedRandomAccessList(List list) {
            super(list);
        }


        SynchronizedRandomAccessList(List list, Object mutex) {
            super(list, mutex);
        }


        public List subList(int fromIndex, int toIndex) {
        synchronized(mutex) {
                return new SynchronizedRandomAccessList(
                    list.subList(fromIndex, toIndex), mutex);
            }
        }


        static final long serialVersionUID = 1530674583602358482L;


        private Object writeReplace() {
            return new SynchronizedList(list);
        }
    }


    /**
     * 返回一个线程安全的map
     */
    public static Map synchronizedMap(Map m) {
return new SynchronizedMap(m);
    }


    /**
     * @serial include
     */
    private static class SynchronizedMap
implements Map, Serializable {
// use serialVersionUID from JDK 1.2.2 for interoperability
private static final long serialVersionUID = 1978198479659022715L;


private final Map m;     // Backing Map
        final Object      mutex; // Object on which to synchronize


SynchronizedMap(Map m) {
            if (m==null)
                throw new NullPointerException();
            this.m = m;
            mutex = this;
        }


SynchronizedMap(Map m, Object mutex) {
            this.m = m;
            this.mutex = mutex;
        }


public int size() {
   synchronized(mutex) {return m.size();}
        }
public boolean isEmpty(){
   synchronized(mutex) {return m.isEmpty();}
        }
public boolean containsKey(Object key) {
   synchronized(mutex) {return m.containsKey(key);}
        }
public boolean containsValue(Object value){
   synchronized(mutex) {return m.containsValue(value);}
        }
public V get(Object key) {
   synchronized(mutex) {return m.get(key);}
        }


public V put(K key, V value) {
   synchronized(mutex) {return m.put(key, value);}
        }
public V remove(Object key) {
   synchronized(mutex) {return m.remove(key);}
        }
public void putAll(Map map) {
   synchronized(mutex) {m.putAll(map);}
        }
public void clear() {
   synchronized(mutex) {m.clear();}
}


private transient Set keySet = null;
private transient Set> entrySet = null;
private transient Collection values = null;


public Set keySet() {
            synchronized(mutex) {
                if (keySet==null)
                    keySet = new SynchronizedSet(m.keySet(), mutex);
                return keySet;
            }
}


public Set> entrySet() {
            synchronized(mutex) {
                if (entrySet==null)
                    entrySet = new SynchronizedSet>(m.entrySet(), mutex);
                return entrySet;
            }
}


public Collection values() {
            synchronized(mutex) {
                if (values==null)
                    values = new SynchronizedCollection(m.values(), mutex);
                return values;
            }
        }


public boolean equals(Object o) {
            synchronized(mutex) {return m.equals(o);}
        }
public int hashCode() {
            synchronized(mutex) {return m.hashCode();}
        }
public String toString() {
   synchronized(mutex) {return m.toString();}
        }
        private void writeObject(ObjectOutputStream s) throws IOException {
   synchronized(mutex) {s.defaultWriteObject();}
        }
    }


    /**
     * 返回一个线程安全的SortedSet
     */
    public static SortedMap synchronizedSortedMap(SortedMap m) {
return new SynchronizedSortedMap(m);
    }




    /**
     * @serial include
     */
    static class SynchronizedSortedMap
extends SynchronizedMap
implements SortedMap
    {
private static final long serialVersionUID = -8798146769416483793L;


        private final SortedMap sm;


SynchronizedSortedMap(SortedMap m) {
            super(m);
            sm = m;
        }
SynchronizedSortedMap(SortedMap m, Object mutex) {
            super(m, mutex);
            sm = m;
        }


public Comparator comparator() {
   synchronized(mutex) {return sm.comparator();}
        }


        public SortedMap subMap(K fromKey, K toKey) {
   synchronized(mutex) {
                return new SynchronizedSortedMap(
                    sm.subMap(fromKey, toKey), mutex);
            }
        }
        public SortedMap headMap(K toKey) {
   synchronized(mutex) {
                return new SynchronizedSortedMap(sm.headMap(toKey), mutex);
            }
        }
        public SortedMap tailMap(K fromKey) {
   synchronized(mutex) {
               return new SynchronizedSortedMap(sm.tailMap(fromKey),mutex);
            }
        }


        public K firstKey() {
   synchronized(mutex) {return sm.firstKey();}
        }
        public K lastKey() {
   synchronized(mutex) {return sm.lastKey();}
        }
    }


    // Dynamically typesafe collection wrappers


    /**
     * 
     * 返回一个动态的类型安全的集合。任何试图插入错误类型的元素的操作将立刻抛出
     * ClassCastException
     * 动态类型安全视图的一个主要作用是用作debug调试,
     * 因为它能正确反映出出错的位置。
     * 例如:ArrayList strings = new ArrayList();
     * ArrayList rawList = strings;
     * rawList.add(new Date());
     * add方法并不进行类型检查,所以存入了非String的对象。只有在重新获取该对象
     * 转化为String类型的时候才抛出异常。
     * 而动态类型安全的集合能在add时就会抛出ClassCastException。
     * 这种方法的优点是错误可以在正确的位置被报告
     * 
     *
     */
    public static Collection checkedCollection(Collection c,Class type) {
        return new CheckedCollection(c, type);
    }


    /**
     * @serial include
     */
    static class CheckedCollection implements Collection, Serializable {
        private static final long serialVersionUID = 1578914078182001775L;


        final Collection c;
        final Class type;


        void typeCheck(Object o) {
            if (!type.isInstance(o)) //o是否能被转换成type类型
                throw new ClassCastException("Attempt to insert " +
                   o.getClass() + " element into collection with element type "
                   + type);
        }


        CheckedCollection(Collection c, Class type) {
            if (c==null || type == null)
                throw new NullPointerException();
            this.c = c;
            this.type = type;
        }


        public int size()                   { return c.size(); }
        public boolean isEmpty()            { return c.isEmpty(); }
        public boolean contains(Object o)   { return c.contains(o); }
        public Object[] toArray()           { return c.toArray(); }
        public T[] toArray(T[] a)       { return c.toArray(a); }
        public String toString()            { return c.toString(); }
        public boolean remove(Object o)     { return c.remove(o); }
        public boolean containsAll(Collection coll) {
            return c.containsAll(coll);
        }
        public boolean removeAll(Collection coll) {
            return c.removeAll(coll);
        }
        public boolean retainAll(Collection coll) {
            return c.retainAll(coll);
        }
        public void clear() {
            c.clear();
        }


        public Iterator iterator() {
   return new Iterator() {
private final Iterator it = c.iterator();
public boolean hasNext() { return it.hasNext(); }
public E next()          { return it.next(); }
public void remove()     {        it.remove(); }};
        }


        public boolean add(E e){
            typeCheck(e); //添加元素需要进行类型检查
            return c.add(e);
        }


        public boolean addAll(Collection coll) {
            E[] a = null;
            try {
                a = coll.toArray(zeroLengthElementArray()); //根据zero数组的类型来转换集合为数组。如果coll中含有其他类型这里就会抛出异常
            } catch (ArrayStoreException e) {
                throw new ClassCastException();
            }


            boolean result = false;
            for (E e : a)
                result |= c.add(e); //只要集合发生了改变就返回true
            return result;
        }


        private E[] zeroLengthElementArray = null; // Lazily initialized


        /*
         * We don't need locking or volatile, because it's OK if we create
         * several zeroLengthElementArrays, and they're immutable.
         */
        E[] zeroLengthElementArray() {
            if (zeroLengthElementArray == null)
                zeroLengthElementArray = (E[]) Array.newInstance(type, 0);
            return zeroLengthElementArray;
        }
    }


    /**
     * 返回一个会检查类型的集合Set
     */
    public static Set checkedSet(Set s, Class type) {
        return new CheckedSet(s, type);
    }


    /**
     * @serial include
     */
    static class CheckedSet extends CheckedCollection
                                 implements Set, Serializable{
        private static final long serialVersionUID = 4694047833775013803L;


        CheckedSet(Set s, Class elementType) { super(s, elementType); }


        public boolean equals(Object o) { return o == this || c.equals(o); }
        public int hashCode()           { return c.hashCode(); }
    }


    /**
     * 返回一个类型安全的集合SortedSet
     */
    public static SortedSet checkedSortedSet(SortedSet s,Class type) {
        return new CheckedSortedSet(s, type);
    }


    /**
     * @serial include
     */
    static class CheckedSortedSet extends CheckedSet
        implements SortedSet, Serializable{
        private static final long serialVersionUID = 1599911165492914959L;
        private final SortedSet ss;


        CheckedSortedSet(SortedSet s, Class type) {
            super(s, type);
            ss = s;
        }


        public Comparator comparator() { return ss.comparator(); }
        public E first()                   { return ss.first(); }
        public E last()                    { return ss.last(); }


        public SortedSet subSet(E fromElement, E toElement) {
            return new CheckedSortedSet(ss.subSet(fromElement,toElement),
                                           type);
        }
        public SortedSet headSet(E toElement) {
            return new CheckedSortedSet(ss.headSet(toElement), type);
        }
        public SortedSet tailSet(E fromElement) {
            return new CheckedSortedSet(ss.tailSet(fromElement), type);
        }
    }


    /**
     * 返回一个类型安全的集合List
     */
    public static List checkedList(List list, Class type) {
        return (list instanceof RandomAccess ?
                new CheckedRandomAccessList(list, type) :
                new CheckedList(list, type));
    }


    /**
     * @serial include
     */
    static class CheckedList extends CheckedCollection
                                implements List
    {
        static final long serialVersionUID = 65247728283967356L;
        final List list;


        CheckedList(List list, Class type) {
            super(list, type);
            this.list = list;
        }


        public boolean equals(Object o)  { return o == this || list.equals(o); }
        public int hashCode()            { return list.hashCode(); }
        public E get(int index)          { return list.get(index); }
        public E remove(int index)       { return list.remove(index); }
        public int indexOf(Object o)     { return list.indexOf(o); }
        public int lastIndexOf(Object o) { return list.lastIndexOf(o); }


        public E set(int index, E element) {
            typeCheck(element);
            return list.set(index, element);
        }


        public void add(int index, E element) {
            typeCheck(element);
            list.add(index, element);
        }


        public boolean addAll(int index, Collection c) {
            // See CheckCollection.addAll, above, for an explanation
            E[] a = null;
            try {
                a = c.toArray(zeroLengthElementArray());
            } catch (ArrayStoreException e) {
                throw new ClassCastException();
            }


            return list.addAll(index, Arrays.asList(a));
        }
        public ListIterator listIterator()   { return listIterator(0); }


        public ListIterator listIterator(final int index) {
            return new ListIterator() {
                ListIterator i = list.listIterator(index);


                public boolean hasNext()     { return i.hasNext(); }
                public E next()              { return i.next(); }
                public boolean hasPrevious() { return i.hasPrevious(); }
                public E previous()          { return i.previous(); }
                public int nextIndex()       { return i.nextIndex(); }
                public int previousIndex()   { return i.previousIndex(); }
                public void remove()         { i.remove(); }


                public void set(E e) {
                    typeCheck(e);
                    i.set(e);
                }


                public void add(E e) {
                    typeCheck(e);
                    i.add(e);
                }
            };
        }


        public List subList(int fromIndex, int toIndex) {
            return new CheckedList(list.subList(fromIndex, toIndex), type);
        }
    }


    /**
     * @serial include
     */
    static class CheckedRandomAccessList extends CheckedList
                                            implements RandomAccess
    {
        private static final long serialVersionUID = 1638200125423088369L;


        CheckedRandomAccessList(List list, Class type) {
            super(list, type);
        }


        public List subList(int fromIndex, int toIndex) {
            return new CheckedRandomAccessList(
                list.subList(fromIndex, toIndex), type);
        }
    }


    /**
     * 返回一个类型安全的集合Map
     */
    public static Map checkedMap(Map m, Class keyType,
                                              Class valueType) {
        return new CheckedMap(m, keyType, valueType);
    }




    /**
     * @serial include
     */
    private static class CheckedMap implements Map,
                                                         Serializable
    {
        private static final long serialVersionUID = 5742860141034234728L;


        private final Map m;
        final Class keyType;
        final Class valueType;


        //需要对key与value都进行类型检查
        private void typeCheck(Object key, Object value) {
            if (!keyType.isInstance(key))
                throw new ClassCastException("Attempt to insert " +
                    key.getClass() + " key into collection with key type "
                    + keyType);


            if (!valueType.isInstance(value))
                throw new ClassCastException("Attempt to insert " +
                    value.getClass() +" value into collection with value type "
                    + valueType);
        }


        CheckedMap(Map m, Class keyType, Class valueType) {
            if (m == null || keyType == null || valueType == null)
                throw new NullPointerException();
            this.m = m;
            this.keyType = keyType;
            this.valueType = valueType;
        }


        public int size()                      { return m.size(); }
        public boolean isEmpty()               { return m.isEmpty(); }
        public boolean containsKey(Object key) { return m.containsKey(key); }
        public boolean containsValue(Object v) { return m.containsValue(v); }
        public V get(Object key)               { return m.get(key); }
        public V remove(Object key)            { return m.remove(key); }
        public void clear()                    { m.clear(); }
        public Set keySet()                 { return m.keySet(); }
        public Collection values()          { return m.values(); }
        public boolean equals(Object o)        { return o == this || m.equals(o); }
        public int hashCode()                  { return m.hashCode(); }
        public String toString()               { return m.toString(); }


        public V put(K key, V value) {
            typeCheck(key, value);
            return m.put(key, value);
        }


        public void putAll(Map t) {
            // See CheckCollection.addAll, above, for an explanation
            K[] keys = null;
            try {
                keys = t.keySet().toArray(zeroLengthKeyArray());
            } catch (ArrayStoreException e) {
                throw new ClassCastException();
            }
            V[] values = null;
            try {
                values = t.values().toArray(zeroLengthValueArray());
            } catch (ArrayStoreException e) {
                throw new ClassCastException();
            }


            if (keys.length != values.length)
                throw new ConcurrentModificationException();


            for (int i = 0; i < keys.length; i++)
                m.put(keys[i], values[i]);
        }


        // Lazily initialized
        private K[] zeroLengthKeyArray   = null;
        private V[] zeroLengthValueArray = null;


        /*
         * We don't need locking or volatile, because it's OK if we create
         * several zeroLengthValueArrays, and they're immutable.
         */
        private K[] zeroLengthKeyArray() {
            if (zeroLengthKeyArray == null)
                zeroLengthKeyArray = (K[]) Array.newInstance(keyType, 0);
            return zeroLengthKeyArray;
        }
        private V[] zeroLengthValueArray() {
            if (zeroLengthValueArray == null)
                zeroLengthValueArray = (V[]) Array.newInstance(valueType, 0);
            return zeroLengthValueArray;
        }


        private transient Set> entrySet = null;


        public Set> entrySet() {
            if (entrySet==null)
                entrySet = new CheckedEntrySet(m.entrySet(), valueType);
            return entrySet;
        }


        /**
         * We need this class in addition to CheckedSet as Map.Entry permits
         * modification of the backing Map via the setValue operation.  This
         * class is subtle: there are many possible attacks that must be
         * thwarted.
         *
         * @serial exclude
         */
        static class CheckedEntrySet implements Set> {
            Set> s;
            Class valueType;


            CheckedEntrySet(Set> s, Class valueType) {
                this.s = s;
                this.valueType = valueType;
            }


            public int size()                   { return s.size(); }
            public boolean isEmpty()            { return s.isEmpty(); }
            public String toString()            { return s.toString(); }
            public int hashCode()               { return s.hashCode(); }
            public boolean remove(Object o)     { return s.remove(o); }
            public boolean removeAll(Collection coll) {
                return s.removeAll(coll);
            }
            public boolean retainAll(Collection coll) {
                return s.retainAll(coll);
            }
            public void clear() {
                s.clear();
            }


            public boolean add(Map.Entry e){
                throw new UnsupportedOperationException();
            }
            public boolean addAll(Collection> coll) {
                throw new UnsupportedOperationException();
            }




            public Iterator> iterator() {
                return new Iterator>() {
                    Iterator> i = s.iterator();


                    public boolean hasNext() { return i.hasNext(); }
                    public void remove()     { i.remove(); }


                    public Map.Entry next() {
                        return new CheckedEntry(i.next(), valueType);
                    }
                };
            }


            public Object[] toArray() {
                Object[] source = s.toArray();


                /*
                 * Ensure that we don't get an ArrayStoreException even if
                 * s.toArray returns an array of something other than Object
                 */
                Object[] dest = (CheckedEntry.class.isInstance(
                    source.getClass().getComponentType()) ? source :
                                 new Object[source.length]);


                for (int i = 0; i < source.length; i++)
                    dest[i] = new CheckedEntry((Map.Entry)source[i],
                                                    valueType);
                return dest;
            }


            public T[] toArray(T[] a) {
                // We don't pass a to s.toArray, to avoid window of
                // vulnerability wherein an unscrupulous multithreaded client
                // could get his hands on raw (unwrapped) Entries from s.
                Object[] arr = s.toArray(a.length==0 ? a : Arrays.copyOf(a, 0));


                for (int i=0; i                     arr[i] = new CheckedEntry((Map.Entry)arr[i],
                                                   valueType);
                if (arr.length > a.length)
                    return (T[])arr;


                System.arraycopy(arr, 0, a, 0, arr.length);
                if (a.length > arr.length)
                    a[arr.length] = null;
                return a;
            }


            /**
             * This method is overridden to protect the backing set against
             * an object with a nefarious equals function that senses
             * that the equality-candidate is Map.Entry and calls its
             * setValue method.
             */
            public boolean contains(Object o) {
                if (!(o instanceof Map.Entry))
                    return false;
                return s.contains(
                    new CheckedEntry((Map.Entry) o, valueType));
            }


            /**
             * The next two methods are overridden to protect against
             * an unscrupulous collection whose contains(Object o) method
             * senses when o is a Map.Entry, and calls o.setValue.
             */
            public boolean containsAll(Collection coll) {
                Iterator e = coll.iterator();
                while (e.hasNext())
                    if (!contains(e.next())) // Invokes safe contains() above
                        return false;
                return true;
            }


            public boolean equals(Object o) {
                if (o == this)
                    return true;
                if (!(o instanceof Set))
                    return false;
                Set that = (Set) o;
                if (that.size() != s.size())
                    return false;
                return containsAll(that); // Invokes safe containsAll() above
            }


            /**
             * This "wrapper class" serves two purposes: it prevents
             * the client from modifying the backing Map, by short-circuiting
             * the setValue method, and it protects the backing Map against
             * an ill-behaved Map.Entry that attempts to modify another
             * Map Entry when asked to perform an equality check.
             */
            private static class CheckedEntry implements Map.Entry {
                private Map.Entry e;
                private Class valueType;


                CheckedEntry(Map.Entry e, Class valueType) {
                    this.e = e;
                    this.valueType = valueType;
                }


                public K getKey()        { return e.getKey(); }
                public V getValue()      { return e.getValue(); }
                public int hashCode()    { return e.hashCode(); }
                public String toString() { return e.toString(); }




                public V setValue(V value) {
                    if (!valueType.isInstance(value))
                        throw new ClassCastException("Attempt to insert " +
                        value.getClass() +
                        " value into collection with value type " + valueType);
                    return e.setValue(value);
                }


                public boolean equals(Object o) {
                    if (!(o instanceof Map.Entry))
                        return false;
                    Map.Entry t = (Map.Entry)o;
                    return eq(e.getKey(),   t.getKey()) &&
                           eq(e.getValue(), t.getValue());
                }
            }
        }
    }


    /**
     * 返回一个类型安全的集合SortedMap
     */
    public static SortedMap checkedSortedMap(SortedMap m,
                                                        Class keyType,
                                                        Class valueType) {
        return new CheckedSortedMap(m, keyType, valueType);
    }


    /**
     * @serial include
     */
    static class CheckedSortedMap extends CheckedMap
        implements SortedMap, Serializable
    {
        private static final long serialVersionUID = 1599671320688067438L;


        private final SortedMap sm;


        CheckedSortedMap(SortedMap m,
                         Class keyType, Class valueType) {
            super(m, keyType, valueType);
            sm = m;
        }


        public Comparator comparator() { return sm.comparator(); }
        public K firstKey()                       { return sm.firstKey(); }
        public K lastKey()                        { return sm.lastKey(); }


        public SortedMap subMap(K fromKey, K toKey) {
            return new CheckedSortedMap(sm.subMap(fromKey, toKey),
                                             keyType, valueType);
        }


        public SortedMap headMap(K toKey) {
            return new CheckedSortedMap(sm.headMap(toKey),
                                             keyType, valueType);
        }


        public SortedMap tailMap(K fromKey) {
            return new CheckedSortedMap(sm.tailMap(fromKey),
                                             keyType, valueType);
        }
    }


    // 其他


    /**
     * 不可变的空集
     */
    public static final Set EMPTY_SET = new EmptySet();


    /**
     *
     * 返回一个不可变的空集
     * size始终为0
     */
    public static final Set emptySet() {
return (Set) EMPTY_SET;
    }


    /**
     * @serial include
     */
    private static class EmptySet extends AbstractSet implements Serializable {
// use serialVersionUID from JDK 1.2.2 for interoperability
private static final long serialVersionUID = 1582296315990362920L;


        public Iterator iterator() {
            return new Iterator() {
                public boolean hasNext() {
                    return false;
                }
                public Object next() {
                    throw new NoSuchElementException();
                }
                public void remove() {
                    throw new UnsupportedOperationException();
                }
            };
        }


        public int size() {return 0;}


        public boolean contains(Object obj) {return false;}


        // Preserves singleton property
        private Object readResolve() {
            return EMPTY_SET;
        }
    }


 
    public static final List EMPTY_LIST = new EmptyList();




    public static final List emptyList() {
return (List) EMPTY_LIST;
    }


    /**
     * @serial include
     */
    private static class EmptyList extends AbstractList
implements RandomAccess, Serializable {
// use serialVersionUID from JDK 1.2.2 for interoperability
private static final long serialVersionUID = 8842843931221139166L;


        public int size() {return 0;}


        public boolean contains(Object obj) {return false;}


        public Object get(int index) {
            throw new IndexOutOfBoundsException("Index: "+index);
        }


        // Preserves singleton property
        private Object readResolve() {
            return EMPTY_LIST;
        }
    }




    public static final Map EMPTY_MAP = new EmptyMap();


 
    public static final Map emptyMap() {
return (Map) EMPTY_MAP;
    }


    private static class EmptyMap
extends AbstractMap
implements Serializable {


        private static final long serialVersionUID = 6428348081105594320L;


        public int size()                          {return 0;}


        public boolean isEmpty()                   {return true;}


        public boolean containsKey(Object key)     {return false;}


        public boolean containsValue(Object value) {return false;}


        public Object get(Object key)              {return null;}


        public Set keySet()                {return Collections.emptySet();}


        public Collection values()         {return Collections.emptySet();}


        public Set> entrySet() {
   return Collections.emptySet();
}


        public boolean equals(Object o) {
            return (o instanceof Map) && ((Map)o).size()==0;
        }


        public int hashCode()                      {return 0;}


        // Preserves singleton property
        private Object readResolve() {
            return EMPTY_MAP;
        }
    }


    /**
     * 
     * 返回只包含一个元素的不可变的集合
     */
    public static Set singleton(T o) {
return new SingletonSet(o);
    }


    /**
     * @serial include
     */
    private static class SingletonSet extends AbstractSet
implements Serializable{
// use serialVersionUID from JDK 1.2.2 for interoperability
    private static final long serialVersionUID = 3193687207550431679L;


        final private E element;


        SingletonSet(E e) {element = e;}


        public Iterator iterator() {
            return new Iterator() {
                private boolean hasNext = true;
                public boolean hasNext() {
                    return hasNext;
                }
                public E next() {
                    if (hasNext) {
                        hasNext = false;
                        return element;
                    }
                    throw new NoSuchElementException();
                }
                public void remove() {
                    throw new UnsupportedOperationException();
                }
            };
        }


        public int size() {return 1;}


        public boolean contains(Object o) {return eq(o, element);}
    }




    public static List singletonList(T o) {
return new SingletonList(o);
    }


    private static class SingletonList
extends AbstractList
implements RandomAccess, Serializable {


        static final long serialVersionUID = 3093736618740652951L;


        private final E element;


        SingletonList(E obj)                {element = obj;}


        public int size()                   {return 1;}


        public boolean contains(Object obj) {return eq(obj, element);}


        public E get(int index) {
            if (index != 0)
              throw new IndexOutOfBoundsException("Index: "+index+", Size: 1");
            return element;
        }
    }




    public static Map singletonMap(K key, V value) {
    return new SingletonMap(key, value);
    }


    private static class SingletonMap extends AbstractMap
 implements Serializable {
    private static final long serialVersionUID = -6979724477215052911L;


        private final K k;
        private final V v;


        SingletonMap(K key, V value) {
            k = key;
            v = value;
        }


        public int size()                          {return 1;}


        public boolean isEmpty()                   {return false;}


        public boolean containsKey(Object key)     {return eq(key, k);}


        public boolean containsValue(Object value) {return eq(value, v);}


        public V get(Object key)                   {return (eq(key, k) ? v : null);}


        private transient Set keySet = null;
        private transient Set> entrySet = null;
        private transient Collection values = null;


        public Set keySet() {
        if (keySet==null)
        keySet = singleton(k);
        return keySet;
        }


        public Set> entrySet() {
        if (entrySet==null)
        entrySet = Collections.>singleton(
        new SimpleImmutableEntry(k, v));
        return entrySet;
        }


public Collection values() {
   if (values==null)
values = singleton(v);
   return values;
}


    }


    /**
     * 
     * 返回一个包含N个o元素的比可变的集合
     * @param  n 添加的指定元素的个数
     * @param  o 被重复添加的元素
     */
    public static List nCopies(int n, T o) {
if (n < 0)
   throw new IllegalArgumentException("List length = " + n);
        return new CopiesList(n, o);
    }


    /**
     * @serial include
     */
    private static class CopiesListextends AbstractList
implements RandomAccess, Serializable{
        static final long serialVersionUID = 2739099268398711800L;


        final int n;
        final E element;


        CopiesList(int n, E e) {
   assert n >= 0;
            this.n = n;
            element = e;
        }


        public int size() {
            return n;
        }


        public boolean contains(Object obj) {
            return n != 0 && eq(obj, element);
        }


        public int indexOf(Object o) {
        return contains(o) ? 0 : -1;
        }


        public int lastIndexOf(Object o) {
        return contains(o) ? n - 1 : -1;
        }


        public E get(int index) {
            if (index < 0 || index >= n)
                throw new IndexOutOfBoundsException("Index: "+index+
                                                    ", Size: "+n);
            return element;
        }


public Object[] toArray() {
   final Object[] a = new Object[n];
   if (element != null)
Arrays.fill(a, 0, n, element);
   return a;
}


public T[] toArray(T[] a) {
   final int n = this.n;
   if (a.length < n) {
a = (T[])java.lang.reflect.Array
   .newInstance(a.getClass().getComponentType(), n);
if (element != null)
   Arrays.fill(a, 0, n, element);
   } else {
Arrays.fill(a, 0, n, element);
if (a.length > n)
   a[n] = null;
   }
   return a;
}


public List subList(int fromIndex, int toIndex) {
   if (fromIndex < 0)
throw new IndexOutOfBoundsException("fromIndex = " + fromIndex);
   if (toIndex > n)
throw new IndexOutOfBoundsException("toIndex = " + toIndex);
   if (fromIndex > toIndex)
throw new IllegalArgumentException("fromIndex(" + fromIndex +
  ") > toIndex(" + toIndex + ")");
   return new CopiesList(toIndex - fromIndex, element);
}
    }


    /**
     * 返回一个比较器,该比较器能使集合按降序排列
     * 例如:
     * Arrays.sort(a, Collections.reverseOrder());
     *  能按字母表相反的顺序排列数组
     * 
     */
    public static Comparator reverseOrder() {
        return (Comparator) REVERSE_ORDER;
    }


    private static final Comparator REVERSE_ORDER = new ReverseComparator();


    /**
     * @serial include
     */
    private static class ReverseComparator
implements Comparator>, Serializable {


// use serialVersionUID from JDK 1.2.2 for interoperability
private static final long serialVersionUID = 7207038068494060240L;


        public int compare(Comparable c1, Comparable c2) {
            return c2.compareTo(c1);
        }


        private Object readResolve() { return reverseOrder(); }
    }


    /**
     * 根据指定比较器的相反顺序排列集合
     */
    public static Comparator reverseOrder(Comparator cmp) {
        if (cmp == null)
        return reverseOrder();
        return new ReverseComparator2(cmp);
    }


    /**
     * @serial include
     */
    private static class ReverseComparator2 implements Comparator,
        Serializable{
        private static final long serialVersionUID = 4374092139857L;


 
        private Comparator cmp;


        ReverseComparator2(Comparator cmp) {
            assert cmp != null;
            this.cmp = cmp;
        }


        public int compare(T t1, T t2) {
            return cmp.compare(t2, t1);
        }
    }


    /**
     * 基于c之上返回一个枚举集
     */
    public static Enumeration enumeration(final Collection c) {
return new Enumeration() {
   Iterator i = c.iterator();

   public boolean hasMoreElements() {
    return i.hasNext();
   }

   public T nextElement() {
    return i.next();
   }
    };
    }


    /**
     * 根据枚举集中的元素返回一个ArrayList
     */
    public static ArrayList list(Enumeration e) {
        ArrayList l = new ArrayList();
        while (e.hasMoreElements())
            l.add(e.nextElement());
        return l;
    }


    /**
     * 判断两对象是否相等或同位空
     */
    private static boolean eq(Object o1, Object o2) {
        return (o1==null ? o2==null : o1.equals(o2));
    }


    /**
     * 返回c中与o相等的元素的个数
     */
    public static int frequency(Collection c, Object o) {
        int result = 0;
        if (o == null) {
            for (Object e : c)
                if (e == null)
                    result++;
        } else {
            for (Object e : c)
                if (o.equals(e))
                    result++;
        }
        return result;
    }


    /**
     * 
     * 如果两指定集合没有共同的元素则返回true
     */
    public static boolean disjoint(Collection c1, Collection c2) {
        /*
         * 
         * 优先遍历的始终是size小的集合或非Set的集合
         */
        if ((c1 instanceof Set) && !(c2 instanceof Set) ||
            (c1.size() > c2.size())) {
            Collection tmp = c1;
            c1 = c2;
            c2 = tmp;
        }


        for (Object e : c1)
            if (c2.contains(e))
                return false;
        return true;
    }


    /**
     * 把所有指定元素添加到集合c中,
     * 有一个元素添加成功就返回true
     */
    public static boolean addAll(Collection c, T... elements) {
        boolean result = false;
        for (T element : elements)
            result |= c.add(element);
        return result;
    }


    /**
     * 根据指定的map返回一个set
     * set存储的是map的键值
     */
    public static Set newSetFromMap(Map map) {
        return new SetFromMap(map);
    }


    private static class SetFromMap extends AbstractSet
        implements Set, Serializable
    {
        private final Map m;  // The backing map
        private transient Set s;       // Its keySet


        SetFromMap(Map map) {
            if (!map.isEmpty())
                throw new IllegalArgumentException("Map is non-empty");
            m = map;
            s = map.keySet();
        }


        public void clear()               {        m.clear(); }
        public int size()                 { return m.size(); }
        public boolean isEmpty()          { return m.isEmpty(); }
        public boolean contains(Object o) { return m.containsKey(o); }
        public boolean remove(Object o)   { return m.remove(o) != null; }
        public boolean add(E e) { return m.put(e, Boolean.TRUE) == null; }
        public Iterator iterator()     { return s.iterator(); }
        public Object[] toArray()         { return s.toArray(); }
        public T[] toArray(T[] a)     { return s.toArray(a); }
        public String toString()          { return s.toString(); }
        public int hashCode()             { return s.hashCode(); }
        public boolean equals(Object o)   { return o == this || s.equals(o); }
        public boolean containsAll(Collection c) {return s.containsAll(c);}
        public boolean removeAll(Collection c)   {return s.removeAll(c);}
        public boolean retainAll(Collection c)   {return s.retainAll(c);}
// addAll is the only inherited implementation


        private static final long serialVersionUID = 2454657854757543876L;


        private void readObject(java.io.ObjectInputStream stream)
            throws IOException, ClassNotFoundException
        {
            stream.defaultReadObject();
            s = m.keySet();
        }
    }


    /**
     * 
     * 把指定Deque包装成一个后进先出的队列
     * add方法对应push,remove方法对应pop等。
     * 
     */
    public static Queue asLifoQueue(Deque deque) {
        return new AsLIFOQueue(deque);
    }


    static class AsLIFOQueue extends AbstractQueue
        implements Queue, Serializable {
private static final long serialVersionUID = 1802017725587941708L;
        private final Deque q;
        AsLIFOQueue(Deque q)           { this.q = q; }
        public boolean add(E e)           { q.addFirst(e); return true; }
        public boolean offer(E e)         { return q.offerFirst(e); }
        public E poll()                   { return q.pollFirst(); }
        public E remove()                 { return q.removeFirst(); }
        public E peek()                   { return q.peekFirst(); }
        public E element()                { return q.getFirst(); }
        public void clear()               {        q.clear(); }
        public int size()                 { return q.size(); }
        public boolean isEmpty()          { return q.isEmpty(); }
        public boolean contains(Object o) { return q.contains(o); }
        public boolean remove(Object o)   { return q.remove(o); }
        public Iterator iterator()     { return q.iterator(); }
        public Object[] toArray()         { return q.toArray(); }
        public T[] toArray(T[] a)     { return q.toArray(a); }
        public String toString()          { return q.toString(); }
public boolean containsAll(Collection c) {return q.containsAll(c);}
public boolean removeAll(Collection c)   {return q.removeAll(c);}
public boolean retainAll(Collection c)   {return q.retainAll(c);}
// We use inherited addAll; forwarding addAll would be wrong
    }
}

你可能感兴趣的:(菜鸟自学Java系列,collections,框架,object,list,distance,null)