Guava学习笔记：Google Guava 类库简介

Guava 是一个 Google 的基于java1.6的类库集合的扩展项目，包括 collections, caching, primitives support, concurrency libraries, common annotations, string processing, I/O, 等等. 这些高质量的 API 可以使你的JAVa代码更加优雅，更加简洁，让你工作更加轻松愉悦。下面我们就开启优雅Java编程学习之旅！

　　项目相关信息：

　　官方首页：http://code.google.com/p/guava-libraries
　　官方下载：http://code.google.com/p/guava-libraries/downloads/list
　　官方文档：http://docs.guava-libraries.googlecode.com/git/javadoc
http://www.ostools.net/apidocs/apidoc?api=guava

　　源码包的简单说明：
　　com.google.common.annotations：普通注解类型。
　　com.google.common.base：基本工具类库和接口。
　　com.google.common.cache：缓存工具包，非常简单易用且功能强大的JVM内缓存。
　　com.google.common.collect：带泛型的集合接口扩展和实现，以及工具类，这里你会发现很多好玩的集合。
　　com.google.common.eventbus：发布订阅风格的事件总线。
　　com.google.common.hash：哈希工具包。
　　com.google.common.io：I/O工具包。
　　com.google.common.math：原始算术类型和超大数的运算工具包。
　　com.google.common.net：网络工具包。
　　com.google.common.primitives：八种原始类型和无符号类型的静态工具包。
　　com.google.common.reflect：反射工具包。
　　com.google.common.util.concurrent：多线程工具包。

　　类库使用手册：

　　一. 基本工具类：让使用Java语言更令人愉悦。

　　1. 使用和避免 null：null 有语言歧义，会产生令人费解的错误，反正他总是让人不爽。很多 Guava 的工具类在遇到 null 时会直接拒绝或出错，而不是默默地接受他们。
　　2. 前提条件：更容易的对你的方法进行前提条件的测试。
　　3. 常见的对象方法：简化了Object常用方法的实现，如 hashCode() 和 toString()。
　　4. 排序： Guava 强大的 "fluent Comparator"比较器，提供多关键字排序。
　　5. Throwable类：简化了异常检查和错误传播。

　　二. 集合类：集合类库是 Guava 对 JDK 集合类的扩展，这是 Guava 项目最完善和为人所知的部分。

　　1. Immutable collections（不变的集合）：防御性编程，不可修改的集合，并且提高了效率。
　　2. New collection types(新集合类型)：JDK collections 没有的一些集合类型，主要有：multisets，multimaps，tables， bidirectional maps等等
　　3. Powerful collection utilities（强大的集合工具类）： java.util.Collections 中未包含的常用操作工具类
　　4. Extension utilities（扩展工具类）: 给 Collection 对象添加一个装饰器? 实现迭代器? 我们可以更容易使用这些方法。

　　三. 缓存: 本地缓存，可以很方便的操作缓存对象，并且支持各种缓存失效行为模式。

　　四. Functional idioms（函数式）: 简洁, Guava实现了Java的函数式编程，可以显著简化代码。

　　五. Concurrency（并发）：强大,简单的抽象,让我们更容易实现简单正确的并发性代码。

　　1. ListenableFuture（可监听的Future）: Futures,用于异步完成的回调。
　　2. Service: 控制事件的启动和关闭，为你管理复杂的状态逻辑。

　　六. Strings: 一个非常非常有用的字符串工具类: 提供 splitting，joining， padding 等操作。

　　七. Primitives: 扩展 JDK 中未提供的对原生类型（如int、char等）的操作，包括某些类型的无符号的变量。

　　八. Ranges: Guava 一个强大的 API，提供 Comparable 类型的范围处理，包括连续和离散的情况。

　　九. I/O: 简化 I/O 操作, 特别是对 I/O 流和文件的操作, for Java 5 and 6.

　　十. Hashing: 提供比 Object.hashCode() 更复杂的 hash 方法, 提供 Bloom filters.

　　十一. EventBus: 基于发布-订阅模式的组件通信，但是不需要明确地注册在委托对象中。

　　十二. Math: 优化的 math 工具类，经过完整测试。

　　十三. Reflection: Guava 的 Java 反射机制工具类。

====================================================

Google Collections 是Google的一个开源的collection扩展包，有效地丰富了目前JDK中的collections的操作方式，Google又一精品设计。

Immutable系列 - 让"真正不可变"成为可能

ImmutableMap 和 ImmutableSet 一经初始化是无法改变的,包括往里面新增数据。可以用应用于一些初始化数据，极大地减少了因为编码习惯而引起的代码风险。曾经在线上发生类似的问题：

        /**         * 号码库对应的类目         * 4001 QQ号码         * 50002402 移动卡号         * 50002403 联通卡号         * 50011764 电信卡号         */        final static List<Integer> applyCatId = new ArrayList<Integer>();        {                applyCatId.add(4001);                applyCatId.add(50002402);                applyCatId.add(50002403);                applyCatId.add(50011764);        }

作者原来的本意是希望在把这些数据当作初始化数据添加到List中去，但是因为编码的时候少写了一个static导致每次new这个类的的时候都往 list里新增初始化数据，进而导致系统内存溢出，最终导致系统崩溃。

下面是 ImmutableMap 和 ImmutableSet 一些例子：

        /**     * ImmutableMap 和 ImmutableSet 一经初始化是无法改变的,包括往里面新增数据。  * 可以用应用于一些初始化数据，极大地减少了因为编码习惯而引起的代码风险   */

  // 不可修改的Map 和 Set 适合存放一些初始化数据    // of 操作非常贴心和实在  final static Map<String, Integer> immutableMap = ImmutableMap.of("风清扬", 42,          "铁木真", 44, "黄药师", 32);

 // 如果你有很多的初始化数据那就用下面的方法吧 static Map<String, Integer> immutableMapMore = null;  static {      Builder<String, Integer> mapBuilder = ImmutableMap.builder();      mapBuilder.put("风清扬", 1);       immutableMapMore = mapBuilder.build();   }

  // 下面是Set的例子 final static Set<String> immutableSet = ImmutableSet.of("风清扬", "铁木真", "黄药师");

 static Set<String> immutableSetMore = null;   static {      com.google.common.collect.ImmutableSet.Builder<String> setBuilder = ImmutableSet               .builder();       setBuilder.add("风清扬");      immutableSetMore = setBuilder.build();   }

Multimap系列 - 让Map操作更简单一些

Multimap的出现可以减少我们的编码量，它主要应用以下类似的场景：学生分班打印：小宝=1班，小白=2班。。。我们需要按班级将所有的人员划分开来，并且能打印出各个班级的成员。

        //Multimap的使用 //在现实编码中我们经常会遇到以下的应用场景：   //学生分班打印：小宝=1班，小白=2班。。。  //我们需要按班级将所有的人员划分开来，并且能打印出各个班级的成员。    String[][] SAMPLE_DATA = {{"小宝","1"},{"小白","2"},{"小兰","1"}};

 //我们以前的设计    Map<String,Set<String>> map = new HashMap<String,Set<String>>(); for(String[] person : SAMPLE_DATA){      String name = person[0];        String clazz = person[1];       //最少要写4行代码来完成相应的功能       Set<String> _clazzSet = map.get(clazz);        if(_clazzSet == null){         _clazzSet = new HashSet<String>();     }     _clazzSet.add(name);      map.put(clazz, _clazzSet);    }

  //使用Multimap //Google 看来不打喜欢用new的方式   Multimap<String,String> multimap = HashMultimap.create();  for(String[] person : SAMPLE_DATA){      String name = person[0];        String clazz = person[1];       //一行就搞定了     multimap.put(clazz, name);    }

  //Multimap 全部采用HashMultimap.create() factory 模式产生新的对象    //类似的还有LinkedHashMultimap.create() ArrayListMultimap.create()    //等等常见的collect类型

BiMap系列 - 弥补了JDK的空缺

 //BiMap 是一个key，value都必须是唯一 的map，所以 他们的 key - value 是可以互查的。 BiMap<String,Integer> biMap = HashBiMap.create();  biMap.put("UUID-1", 1); biMap.put("UUID-2", 2); //key - value 互换 biMap.inverse();

Google Guava Collections 使用介绍:https://wenku.baidu.com/view/f60eaf6cb84ae45c3b358c19.html###