Google开源的Java公共类库，Guava 19.0 RC1 发布

jopen 9年前

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


源码包的简单说明：
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 反射机制工具类。



Guava 19.0 RC1 发布，主要改进：

common.base

  • Added CharMatcher static factory methods equivalent to the CharMatcher constants. For example, added CharMatcher.whitespace() which is equivalent to CharMatcher.WHITESPACE. Eventually, the constants will be deprecated and removed.

    • This is being done because using constants requires a large number of classes to be initialized when anything from CharMatcher is used; switching to static factory methods allows classes to be initialized only as needed for the type of CharMatcher actually being used.

  • Added Throwables.lazyStackTrace(Throwable) - Returns a List<StackTraceElement> that may load the stack trace elements lazily. Useful if you want to get only the first N elements of the stack trace efficiently.

  • Added lazyStackTraceIsLazy()- Returns whether or not the above method is able to use the special implementation that makes it lazy on the current platform.

  • Added VerifyException constructor overloads taking a Throwable cause.

common.cache

This package has graduated from @Beta, making it safe to use in library code.

  • Added visibility of CacheLoader.UnsupportedLoadingOperationException

  • Added RemovalNotification.create

    • These should only be needed if creating a custom cache implementation

common.collect

Added factory and builder methods for various ImmutableMaps and ImmutableMultimaps that take Iterable<Map.Entry>.

  • Added FluentIterable.toMultiset()

  • Added RangeSet.asDescendingSetOfRanges() and RangeMap.asDescendingMapOfRanges()

  • Added Lists.cartesianProduct(List...) and Lists.cartesianProduct(List<List>>)

  • Added Maps.newLinkedHashMapWithExpectedSize(int)

  • Re-added Multisets.removeOccurrences(Multiset, Multiset) which was (binary incompatibly) missing in 18.0 because it was replaced with Multisets.removeOccurences(Multiset, Iterable)

  • Deprecated MapConstraint and MapConstraints

  • Deprecated Sets.newSetFromMap(Map) - Java 6 provides Collections.newSetFromMap(Map)

  • Removed MapMaker.softValues()

common.eventbus

  • Added EventBus.identifier()

  • Removed protected method AsyncEventBus.dispatchQueuedEvents() (made package-private)

common.hash

  • Added BloomFilter.create overloads taking a long for the expectedInsertions

  • Added Hashing.sha384()

  • Added Hashing.concatenating(HashFunction, HashFunction, HashFunction...) and Hashing.concatenating(Iterable<HashFunction>)

common.io

  • Added ByteSource.sizeIfKnown()

  • Added CharSource.length()

  • Added CharSource.lengthIfKnown()

common.net

  • Added a couple new constants to HttpHeaders and MediaType

  • Updated public suffix list for InternetDomainName

common.reflect

  • Added TypeToken.isSubtypeOf(TypeToken), TypeToken.isSupertypeOf(TypeToken) and overloads of both that take a Type

  • Deprecated TypeToken.isAssignableFrom(TypeToken) and TypeToken.isAssignableFrom(Type) - isSupertypeOf provides equivalent behavior with a less confusing name

common.util.concurrent

  • Added AbstractFuture.newCancellationCause()

  • Added AbstractFuture.setFuture(ListenableFuture)

  • Added Futures.getChecked

  • Added Futures.catching and Futures.catchingAsync

  • Added Futures.transformAsync

  • Added Futures.withTimeout

  • Deprecated FutureFallback and Futures.withFallback methods - these are replaced with Futures.catching

  • Deprecated Futures.get methods taking a Class<X extends Exception> - these are replaced with Futures.getChecked

  • Deprecated Futures.transform methods taking an AsyncFunction - these are replaced with Futures.transformAsync

详细改进请看发行说明。

下载：https://github.com/google/guava/archive/v19.0-rc1.zip。