Guava新集合-Multiset

Multiset集合

　　Multiset是什么？顾名思义，Multiset和Set的区别就是能够保存多个相同的对象。在JDK中，List和Set有一个基本的区别，就是List能够包含多个相同对象，且是有顺序的，而Set不能有重复，且不保证顺序（有些实现有顺序，例如LinkedHashSet和SortedSet等）因此Multiset占据了List和Set之间的一个灰色地带：容许重复，可是不保证顺序。 
　　常见使用场景：Multiset有一个有用的功能，就是跟踪每种对象的数量，因此你能够用来进行数字统计。 

package guava;

import com.google.common.collect.HashMultiset;
import com.google.common.collect.Multiset;
import org.junit.Test;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * Created by g on 2016/8/4.
 */
public class MultisetTest {
 
    // 普通实现方式
    @Test
    public void testWordCount() {
        String strWorld = "abc|efg|cbd|abc|efg|xyz";
        String[] words = strWorld.split("\\|");
        Map<String, Integer> countMap = new HashMap<String, Integer>();
        for (String word : words) {
            Integer count = countMap.get(word);
            if (count == null) {
                countMap.put(word, 1);
            } else {
                countMap.put(word, count + 1);
            }
        }
        System.out.println("countMap：");
        for (String key : countMap.keySet()) {
            System.out.println(key + " count：" + countMap.get(key));
        }
    }

    // guava实现方式
    @Test
    public void testMultsetWordCount() {
        String strWorld = "abc|efg|cbd|abc|efg|xyz";
        String[] words = strWorld.split("\\|");
        List<String> wordList = new ArrayList<String>();
        for (String word : words) {
            wordList.add(word);
        }
        Multiset<String> wordsMultiset = HashMultiset.create();
        wordsMultiset.addAll(wordList);

        for (String key : wordsMultiset.elementSet()) {
            System.out.println(key + " count：" + wordsMultiset.count(key));
        }
    }
}

　Multiset主要方法

　　Multiset接口定义的接口主要有：
　　　　add(E element) :向其中添加单个元素
　　　　add(E element,int occurrences) : 向其中添加指定个数的元素
　　　　count(Object element) : 返回给定参数元素的个数
　　　　remove(E element) : 移除一个元素，其count值 会响应减小
　　　　remove(E element,int occurrences): 移除相应个数的元素
　　　　elementSet() : 将不一样的元素放入一个Set中
　　　　entrySet(): 相似与Map.entrySet 返回Set<Multiset.Entry>。包含的Entry支持使用getElement()和getCount()
　　　　setCount(E element ,int count): 设定某一个元素的重复次数
　　　　setCount(E element,int oldCount,int newCount): 将符合原有重复个数的元素修改成新的重复次数
　　　　retainAll(Collection c) : 保留出如今给定集合参数的全部的元素 
　　　　removeAll(Collectionc) : 去除出现给给定集合参数的全部的元素

Multiset不是Map

　　须要注意的是Multiset不是一个Map<E,Integer>,尽管Multiset提供一部分相似的功能实现。其它值得关注的差异有:
　　Multiset中的元素的重复个数只会是正数，且最大不会超过Integer.MAX_VALUE。设定计数为0的元素将不会出现multiset中，也不会出现elementSet()和entrySet()的返回结果中。
　　multiset.size() 方法返回的是全部的元素的总和，至关因而将全部重复的个数相加。若是须要知道每一个元素的个数可使用elementSet().size()获得.(于是调用add(E)方法会是multiset.size()增长1).
　　multiset.iterator() 会循环迭代每个出现的元素，迭代的次数与multiset.size()相同。 iterates over each occurrence of each element, so the length of the iteration is equal to multiset.size().
　　Multiset 支持添加、移除多个元素以及从新设定元素的个数。执行setCount(element,0)至关于移除multiset中全部的相同元素。
　　调用multiset.count(elem)方法时，若是该元素不在该集中，那么返回的结果只会是0。

　　Multiset的实现　

　　Guava提供了Multiset的多种实现，这些实现基本对应了JDK中Map的实现： 
　　Map                               Corresponding Multiset   Supports null elements
　　HashMap                       HashMultiset                          Yes
　　TreeMap                        TreeMultiset                           Yes (if the comparator does)
　　LinkedHashMap            LinkedHashMultiset              Yes
　　ConcurrentHashMap    ConcurrentHashMultiset        No
　　ImmutableMap              ImmutableMultiset                   No