来自于 Wisdom 的 Guava 指南中文版

还有一部分代码的阅读与分析

在灵感匮乏不能开始新项目的时候，阅读优秀的代码也是十分有效的提升

Guava: Google 的 Java 核心类库

Build Status Maven Central

Guava 是 Google 提供的一组 Java 核心类库，包括新的集合框架(比如 multimap 和 multiset), 不可变集合 (immutable collections), 图形库(graph library), 函数 (functional types), 内存中缓存技术(in-memory cache), 以及用于并发的 API, I/O, 哈希算法(hashing), 原语(primitives), 反射(reflection), 字符串处理(string processing)，以后还会有更多!

Guava 有两种风格

  • JRE 风格请使用 JDK 1.8 或者更高版本。
  • 如果你使用的是 JDK 1.7 版本或者 Android 的话 ，请使用 Android 版本。你可以在 android directory 中找到 Guava 安卓版.

最新版本

最新的版本是 Guava 24.1, 创建于 2018-03-14.

Guava 在 Maven 仓库中的 id 为com.google.guava, 块ID(artifact ID) 是 guava. JRE 请使用24.1-jre 版本, Android 请使用 24.1-android 版本。

想要通过 Maven 将 Guava 加入到你的项目，请在你的 pom.xml 中加入以下配置：

  1. <dependency>
  2.   <groupId>com.google.guava</groupId>
  3.   <artifactId>guava</artifactId>
  4.   <version>24.1-jre</version>
  5.   <!-- or, for Android: -->
  6.   <version>24.1-android</version>
  7. </dependency>

通过 Gradle 将 Guava 加入到你的项目:

  1. dependencies {
  2.   compile 'com.google.guava:guava:24.1-jre'
  3.   // or, for Android:
  4.   compile 'com.google.guava:guava:24.1-android'
  5. }

想了解更多将 Guava 引入的方式，请参见 Using Guava in your build.

快照

Guava 的最新的快照是通过 Maven 构建的、基于 master 分支的 HEAD-jre-SNAPSHOT, 或者是应用于 Android 的 HEAD-android-SNAPSHOT 分支。

  • 快照-API 文档: guava
  • 快照-版本更新: guava

关于 Guava

链接

警告

  1. 在类或者方法上添加@Beta 注解的 API可能会发生变化，他们可以随意在任何时间以任何方式被修改，或者可能被移除。如果您的代码和一个类库(即，他可以被其他用户在不受你控制的路径下使用), 您就不应使用带有@Beta 注解的 API, 除非你 重新打包 他们. 如果您的代码是一个类库，我们强烈建议您使用Guava Beta Checker 工具去检查您没有使用带有 @Beta 注解的 API

  2. 没有被@Beta注解标记的API在不确定的将来会保持二进制兼容(在之前，我们有时会在弃用期结束之后移除掉这些API。最后一次移除 “非@Beta”的API是在 21.0 版本。) 然而@Deprecated(已经弃用)的API仍然存在(除非他们是@Beta)。我们没有再次开始删除这些东西的计划，但是从官方的角度来说，我们可能在出现意外时(比如说发生了严重的安全问题的)再次的开启这个计划(删除 API)。 [注：我也没太搞懂他说的什么意思…可能是我翻译的有问题?]

  3. 除非另有说明，所有的对象序列化的方式都有可能被更改。对此你不应该特别的关注，你只要相信这些对象在未来版本的库中都能被序列化就可以了。

  4. 我们的类在设计之初就没有设计成可以防范非法调用的功能，所以你不应该将他们用在“可信”与“不可信”的代码之间的通信上。

  5. 对于主流版本，我们只在 Linux 上使用 OpenJDK_1.8 来进行单元测试。对于某些功能来说，尤其是 com.google.common.io可能在其他的环境下无法正常的工作。对于 Android 版本，我们的单元测试可以成功运行在 Android 15 (Android 4.0.3) 以上的版本.

这里之下可以看作目录

Guava 用户指南 中文

文章列表