Google Guava - GuavaExplained | User Guide(Guava用户指南)

GuavaExplained  Guava说明

Landing page for Guava explanations. 
explained, Featured

Updated Jun 4, 2013 by lowas...@google.com

Guava用户指南

Guava项目包含若干Google的核心库, 包含如下项目: collections, caching, primitives support, concurrency libraries, common annotations, string processing, I/O等等. 每个工具都在Google的生产环境中得到了应用,Google的工程师们每天都在使用它们.

但是通读JavaDoc并不是使用Java库的最有效方法. 这里, 我们尝试使用一种通俗易懂的方式着重介绍Guava中最常用和最强大的特性.

本wiki 正在编写中, 某些部分可能未完成.

• Basic utilities: 让Java更好用.
  • Using and avoiding null: null 是个很模糊的概念, 可能会导致令人混淆的错误, 而且有时的确让人不爽. 许多Guava工具类并不盲目接收null,一般会报错或快速失败.
  • Preconditions: 为你的方法提供更简单的前置条件.
  • Common object methods: 简化 Object 的方法实现, 像是hashCode() 和toString().
  • Ordering: Guava的强大 "流式比较器" 类.
  • Throwables: 简化exceptions和errors的传播和检查.
• Collections: Guava对JDK 集合系统的扩展. 这是Guava中最成熟和流行的部分.
  • Immutable collections, 用于防御式编程, 常量集合, 改进效率.
  • New collection types,  JDK collections没有涉及的场景: multisets, multimaps, tables, bidirectional maps等.
  • Powerful collection utilities, 用于提供 java.util.Collections没有提供的公共操作.
  • Extension utilities: 写一个 Collection 装饰器? 继承 Iterator? 都可以更简单.
• Caches: 本地缓存, 支持多种有效期设定.
• Functional idioms: 谨慎使用, Guava的functional idioms能够有效简化代码.
• Concurrency: 强大而简单的抽象, 可以使编写正确并发代码的工作简化.
  • ListenableFuture: Futures, 结束的时候回调.
  • Service: 可以启动和结束的事物, 注意不同的状态逻辑.
• Strings: 少量极度有用的工具: splitting, joining, padding等.
• Primitives:  JDK 未提供的原生类型的操作, 包含某些类型的 unsigned变量.
• Ranges: Guava的强大API可以轻松处理在Comparable 类型下的range, 不论连续或离散.
• I/O: 简化 I/O 操作, 尤其是在 I/O 流和文件上的操作, 用于Java 5/ 6.
• Hashing: 比 Object.hashCode()更高级的哈希工具, 包括 Bloom filters.
• EventBus: 组件间发布-订阅模式的交流, 无需组件之间分派.
• Math: 优化的, 完整测试的数学工具，提供了JDK没有涉及的功能.
• Reflection: 使用Java反射能力的Guava工具.
• Tips提示:精通Guava.
  • 理念Philosophy: Guava是什么, 不是什么, 及其目标.
  • Using Guava in your build, 使用诸如Maven, Gradle等构建系统.
  • Using ProGuard避免在你的JAR中加入不必要的Guava部件.
  • Apache Commons equivalents, 从 Apache Commons Collections转向Guava.
  • Compatibility,  Guava版本变化细节.
  • Idea Graveyard, 被否决的特性.
  • Friends, 我们喜欢和尊敬的其他开源项目.

注意: 如果要评论此Wiki的内容, 请使用guava-discuss的邮件列表.