Google Guava官方教程

向右看齐 2022-06-17 13:40 271阅读 0赞

[原文链接][Link 1] [译文链接][Link 2] **译者:** 沈义扬，**罗立树，何一昕，*\****武祖 \* **校对**：方腾飞

## **引言** ##

Guava工程包含了若干被Google的 Java项目广泛依赖 的核心库，例如：集合 \[collections\] 、缓存 \[caching\] 、原生类型支持 \[primitives support\] 、并发库 \[concurrency libraries\] 、通用注解 \[common annotations\] 、字符串处理 \[string processing\] 、I/O 等等。 所有这些工具每天都在被Google的工程师应用在产品服务中。

查阅Javadoc并不一定是学习这些库最有效的方式。在此，我们希望通过此文档为Guava中最流行和最强大的功能，提供更具可读性和解释性的说明。

## **译文格式说明** ##

*  Guava中的类被首次引用时，都会链接到Guava的API文档。如：[Optional][]。
 *  Guava和JDK中的方法被引用时，一般都会链接到Guava或JDK的API文档，一些人所共知的JDK方法除外。如：Optional.of(T)，Map.get(key)
 *  译者对文档的额外说明以斜体显示，并且以“*译者注\**：\*”开始。

**目录**

## **1. 基本工具 \[Basic utilities\]** ##

让使用Java语言变得更舒适

1.1 [使用和避免null][null]：null是模棱两可的，会引起令人困惑的错误，有些时候它让人很不舒服。很多Guava工具类用快速失败拒绝null值，而不是盲目地接受

1.2 [前置条件][Link 3]: 让方法中的条件检查更简单

1.3 [常见Object方法][Object]: 简化Object方法实现，如hashCode()和toString()

1.4 [排序: Guava强大的”流畅风格比较器”][Guava]

1.5 [Throwables][]：简化了异常和错误的传播与检查

## **2. 集合\[Collections\]** ##

Guava对JDK集合的扩展，这是Guava最成熟和为人所知的部分

2.1 [不可变集合][Link 4]: 用不变的集合进行防御性编程和性能提升。

2.2 [新集合类型][Link 5]: multisets, multimaps, tables, bidirectional maps等

2.3 [强大的集合工具类][Link 6]: 提供java.util.Collections中没有的集合工具

2.4 [扩展工具类][Link 7]：让实现和扩展集合类变得更容易，比如创建`Collection的装饰器，或实现迭代器`

## **3. [缓存][Link 8]\[Caches\]** ##

Guava Cache：本地缓存实现，支持多种缓存过期策略

## **4. [函数式风格][Link 9]\[Functional idioms\]** ##

Guava的函数式支持可以显著简化代码，但请谨慎使用它

## **5. 并发\[Concurrency\]** ##

强大而简单的抽象，让编写正确的并发代码更简单

5.1 [ListenableFuture][]：完成后触发回调的Future

5.2 [Service框架][Service]：抽象可开启和关闭的服务，帮助你维护服务的状态逻辑

## **6. [字符串处理][Link 10]\[Strings\]** ##

非常有用的字符串工具，包括分割、连接、填充等操作

## **7. [原生类型][Link 11]\[Primitives\]** ##

扩展 JDK 未提供的原生类型（如int、char）操作， 包括某些类型的无符号形式

## **8. [区间][Link 12]\[Ranges\]** ##

可比较类型的区间API，包括连续和离散类型

## **9. [I/O][I_O]** ##

简化I/O尤其是I/O流和文件的操作，针对Java5和6版本

## **10. [散列][Link 13]\[Hash\]** ##

提供比`Object.hashCode()`更复杂的散列实现，并提供布鲁姆过滤器的实现

## **11. [事件总线][Link 14]\[EventBus\]** ##

发布-订阅模式的组件通信，但组件不需要显式地注册到其他组件中

## **12. [数学运算][Link 15]\[Math\]** ##

优化的、充分测试的数学工具类

## **13. [反射][Link 16]\[Reflection\]** ##

Guava 的 Java 反射机制工具类

[Link 1]: http://code.google.com/p/guava-libraries/wiki/GuavaExplained
[Link 2]: http://ifeve.com/?p=8776
[Optional]: http://docs.guava-libraries.googlecode.com/git-history/release/javadoc/com/google/common/base/Optional.html
[null]: http://ifeve.com/using-and-avoiding-null/
[Link 3]: http://ifeve.com/google-guava-preconditions/
[Object]: http://ifeve.com/google-guava-commonobjectutilities/
[Guava]: http://ifeve.com/google-guava-ordering/
[Throwables]: http://ifeve.com/google-guava-throwables/
[Link 4]: http://ifeve.com/google-guava-immutablecollections/
[Link 5]: http://ifeve.com/google-guava-newcollectiontypes/
[Link 6]: http://ifeve.com/google-guava-collectionutilities/
[Link 7]: http://ifeve.com/google-guava-collectionhelpersexplained/
[Link 8]: http://ifeve.com/google-guava-cachesexplained
[Link 9]: http://ifeve.com/google-guava-functional/
[ListenableFuture]: http://ifeve.com/google-guava-listenablefuture/
[Service]: http://ifeve.com/google-guava-serviceexplained/
[Link 10]: http://ifeve.com/google-guava-strings/
[Link 11]: http://ifeve.com/google-guava-primitives/
[Link 12]: http://ifeve.com/google-guava-ranges/
[I_O]: http://ifeve.com/google-guava-io/
[Link 13]: http://ifeve.com/google-guava-hashing/
[Link 14]: http://ifeve.com/google-guava-eventbus/
[Link 15]: http://ifeve.com/google-guava-math/
[Link 16]: http://ifeve.com/guava-reflection/