经常使用的 Java 工具类之 Guava 使用

上篇咱们介绍 Apache 的相关工具类的使用，此次咱们介绍 Google 的工具类 Guava。

The Guava project contains several of Google's core libraries that we rely on in our Java-based projects: collections, caching, primitives support, concurrency libraries, common annotations, string processing, I/O, and so forth. Each of these tools really do get used every day by Googlers, in production services.
正如 Guava wiki 介绍，Guava 的是 Google 的工具类，提供字符串处理，I/O，集合类相关操做。若是你去翻看 JDK8 的代码，能够看到其不少新增类，Guava 以前其实已经实现，不少类名也都同样，能够看出 Guava 的影响。下面开始介绍 Guava 的使用。

Guava Collections

Guava 为集合类提供相关工具类以及一些集合的新类型，方便咱们平常开发。

集合新工具类- Lists

Lists.newArrayList() 使用静态方法直接建立 List 集合。

// 在JDK 7以前，构造新的集合时咱们须要重复声明范型
List<String> testList = new ArrayList<String>();
// 使用 Lists 以后咱们可使用静态方法自动推导
List<String> testList1 = Lists.newArrayList();
// 若是须要指定初始大小
List<String> capicatyList = Lists.newArrayListWithCapacity(100);
复制代码

Lists.partition() 按照指定大小拆分大集合

// 定义一个 10W 数量的集合
        List<String> largeList = Lists.newArrayListWithCapacity(100 * 1000);
        // 拆分红 100 个集合数量 1000 的大小的小集合
        List<List<String>> smallLists = Lists.partition(largeList, 1000);
复制代码

Lists.transform 将集合数据类型转化成其余类型的集合

List<String> largeList = Lists.newArrayListWithCapacity(100 * 1000);
		List<List<String>> smallLists = Lists.partition(largeList, 1000);
		  // function 方法能够执行转化动做，将类型 A 的对象 转化为 B 对象 
        List<Integer> a = Lists.transform(largeList, new Function<String, Integer>() {
            @Override
            public Integer apply(String input) {
                return input.hashCode() + 111;
            }
        });
复制代码

可是使用这个类的是须要注意一点，转化以后的集合，再也不支持 add 等修改集合的方法。若是使用遍历方法去修改集合里面对象，并不会产生效果。缘由在于转化以后的 List 只是原 List 的视图而已，因此获取转化后集合里的对象，好比调用 get 时，每次调用会是会使用 function 转化方法。

Returns a list that applies function to each element of fromList. The returned list is a transformed view of fromList; changes to fromList will be reflected in the returned list and vice versa
Guava transform 问题

新集合类

Multiset 若是光看类名的话，可能会觉得其只是实现 Set 接口的新类。其实否则，这个类实现是相似如下功能：

Map<String, Integer> counts = new HashMap<String, Integer>();
for (String word : words) {
    Integer count = counts.get(word);
    if (count == null) {
        counts.put(word, 1);
    } else {
        counts.put(word, count + 1);
    }
}
复制代码

若是存在上述需求，咱们再也不须要本身笨拙且容易出错的代码。如今咱们能够看若是使用 Multiset 实现上述代码。

Multiset<String> multiset = HashMultiset.create();
        // 统计每次单词出现的次数
        for (String word : words) {
            multiset.add(word);
        }
        // 输出单词的输出次数
        for (String word : multiset.elementSet()) {
            multiset.count(word);
        }
复制代码

有时候咱们须要实现一个键与多个值映射的功能，这时候咱们可能会使用 Map<K, List<V>> ，可是这种方法可能在实现中不当心就致使各类名空指针异常等。下面咱们使用 Multimap实现这种需求。

Multimap<Integer, People> multimap = ArrayListMultimap.create();
        // 统计同一年纪的 People 对象
        for (People people : peopleList) {
            multimap.put(people.getAge(), people);
        }

        // 输出统计结果
        for (Integer key : multimap.keySet()) {
            List<People> peoples = Lists.newArrayList(multimap.get(key));
            System.out.println(peoples);
        }

复制代码

字符串处理

Joiner 实现字符串链接功能。

// 实现的链接器将忽略 Null 
Joiner joiner = Joiner.on(";").skipNulls();
// 字符串为Harry;Ron;Hermione
return joiner.join("Harry", null, "Ron", "Hermione");
复制代码

Splitter 字符串拆分器，实现字符串按照指定字符拆分功能

// 如下拆分将将结果去除首部与尾部空格，以及去除空字符串。因此拆分以后结果为 foo bar qux
Splitter.on(',')
        .trimResults()
        .omitEmptyStrings()
        .split("foo,bar,, qux");
复制代码

CharMatcher 字符串匹配器，实现匹配筛选等动做。

String string = "12312ada[21`443#$$#@ asda";

        System.out.println(CharMatcher.DIGIT.retainFrom(string));//只保留数字 1231221443
        System.out.println(CharMatcher.JAVA_LETTER_OR_DIGIT.replaceFrom(string, "*")); // 数字与字母使用*号代替
        System.out.println(CharMatcher.DIGIT.matchesAllOf(string));//字符串是否都为数字

复制代码

Stopwatch

有时候咱们须要知道方法的调用时间，这个时候咱们每每使用下列代码：

long startTime = System.currentTimeMillis();
		  // 业务方法调用

        long endTime = System.currentTimeMillis();

        long totalTime = endTime - startTime;

复制代码

这种写法若是须要转化时间单位咱们还须要通过各类换算，若是须要计算多个调用时间，时间定义每每比较杂乱。咱们可使用 Stopwatch代替。

Stopwatch stopwatch = Stopwatch.createUnstarted();
        // 开始计量时间
        stopwatch.start();

        try {
            TimeUnit.SECONDS.sleep(10);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
        // 中止计量时间
        stopwatch.stop();
        // 根据输入时间单位获取相应的时间
        System.out.println(stopwatch.elapsed(TimeUnit.SECONDS));
复制代码

参考文档

1. Guava 中文翻译
2. Guava wiki