10分钟搞定Guava开发环境：从依赖配置到第一个程序

10分钟搞定Guava开发环境：从依赖配置到第一个程序

【免费下载链接】guava Google core libraries for Java 项目地址: https://gitcode.com/GitHub_Trending/gua/guava

你还在为Java项目配置依赖头疼？还在纠结JRE和Android版本怎么选？本文将用最直观的步骤，带你10分钟内从零搭建Google Guava（Java核心库）开发环境，完成第一个实用程序。读完你将掌握：Maven/Gradle依赖配置、两种环境差异对比、基础工具类使用，以及避坑指南。

项目概述：为什么选择Guava？

Guava是Google提供的Java核心库，包含了新的集合类型（如Multimap和Multiset）、不可变集合、图形库，以及并发、I/O、哈希、原语、字符串等工具类。它被广泛应用于Google内部的大多数Java项目，也是许多其他公司的首选工具库。

项目核心文件结构：

• 主目录：GitHub_Trending/gua/guava
• 核心代码：guava/src
• 测试代码：guava-tests/test
• 构建配置：pom.xml

环境准备：JRE vs Android版本选择

Guava提供两种"风味"的版本：

• JRE版本：适用于Java 8+环境
• Android版本：适用于Android平台或需要与Android兼容的库

版本差异对比表

特性	JRE版本	Android版本
最低要求	Java 8+	Android API 19+
功能完整性	全部功能	部分功能精简
Maven坐标	33.5.0-jre	33.5.0-android
典型用途	后端服务、桌面应用	移动应用开发

依赖配置：Maven与Gradle实现

Maven配置步骤

1. 在项目的pom.xml中添加依赖（位于项目根目录）：

<dependency>
  <groupId>com.google.guava</groupId>
  <artifactId>guava</artifactId>
  <version>33.5.0-jre</version>
  <!-- 安卓环境替换为：<version>33.5.0-android</version> -->
</dependency>

2. 核心POM文件位置：
   • 项目根POM：pom.xml
   • Android模块POM：android/pom.xml
   • Guava模块POM：guava/pom.xml

Gradle配置步骤

在build.gradle中添加：

dependencies {
  // JRE环境
  implementation("com.google.guava:guava:33.5.0-jre")
  
  // 或Android环境
  // implementation("com.google.guava:guava:33.5.0-android")
}

第一个程序：字符串工具类实战

下面我们使用Guava的字符串工具类编写一个简单的字符串处理程序，演示Guava的基本用法。

import com.google.common.base.Strings;

public class GuavaDemo {
    public static void main(String[] args) {
        // 检查字符串是否为空或空白
        String testStr = "  Guava Demo  ";
        System.out.println("是否为空：" + Strings.isNullOrEmpty(testStr));
        System.out.println("是否为空白：" + Strings.isNullOrEmpty(testStr.trim()));
        
        // 字符串填充
        String paddedStr = Strings.padEnd("Guava", 10, '*');
        System.out.println("右填充：" + paddedStr);
        
        // 重复字符串
        String repeated = Strings.repeat("Guava", 3);
        System.out.println("重复字符串：" + repeated);
    }
}

运行结果：

是否为空：false
是否为空白：false
右填充：Guava*****
重复字符串：GuavaGuavaGuava

核心工具类源码位置：guava/src/com/google/common/base/Strings.java

避坑指南：常见问题解决

Beta API使用警告

Guava中标有@Beta注解的API可能会发生变化。如果你的代码是一个库，强烈建议使用Guava Beta Checker确保不使用任何Beta API。

相关源码：guava-testlib/src/com/google/common/testing/IgnoreJRERequirement.java

依赖冲突解决

Guava自身有一个运行时依赖：com.google.guava:failureaccess:1.0.3。如果遇到依赖冲突，可以在pom.xml中明确指定版本：

<dependency>
  <groupId>com.google.guava</groupId>
  <artifactId>failureaccess</artifactId>
  <version>1.0.3</version>
</dependency>

failureaccess模块位置：futures/failureaccess

进阶学习资源

• 官方用户指南：Guava Explained
• 测试用例参考：guava-tests/test
• 基准测试代码：guava-tests/benchmark
• 贡献指南：CONTRIBUTING.md

总结与下一步

通过本文，你已经成功搭建了Guava开发环境并运行了第一个程序。下一步建议：

1. 探索不可变集合：guava/src/com/google/common/collect/ImmutableList.java
2. 尝试并发工具类：guava/src/com/google/common/util/concurrent
3. 研究I/O工具：guava/src/com/google/common/io

现在你已经掌握了Guava的基础配置，开始用它简化你的Java项目吧！如有问题，可查阅README.md或在项目issue tracker提交问题。

【免费下载链接】guava Google core libraries for Java 项目地址: https://gitcode.com/GitHub_Trending/gua/guava