1. 概述

Google Guava 是一套强大的 Java 工具库集合,极大地简化了日常开发工作。本文将带你了解 Guava 18 版本 中引入的新功能和改进。

2. MoreObjects 工具类

Guava 18 新增了 MoreObjects 类,它提供了一些在标准 java.util.Objects 中没有的实用方法。

目前该类主要提供了 toStringHelper 方法的三种实现方式:

  • toStringHelper(Class<?> clazz)
  • toStringHelper(Object self)
  • toStringHelper(String className)

这些方法可以帮你快速构建自定义的 toString() 输出,避免手写冗长的拼接逻辑。

假设我们有一个 User 类,希望在调用 toString() 时输出其字段信息:

public class User {

    private long id;
    private String name;

    public User(long id, String name) {
        this.id = id;
        this.name = name;
    }

    @Override
    public String toString() {
        return MoreObjects.toStringHelper(this)
            .add("id", id)
            .add("name", name)
            .toString();
    }
}

使用这个类创建一个实例并打印:

User user = new User(12L, "John Doe");
String userState = user.toString();
// 输出:User{id=12, name=John Doe}

其余两个构造方式效果类似,但类名来源不同:

使用 Class 参数

@Override
public String toString() {
    return MoreObjects.toStringHelper(User.class)
        .add("id", id)
        .add("name", name)
        .toString();
}

使用字符串参数

@Override
public String toString() {
    return MoreObjects.toStringHelper("User")
        .add("id", id)
        .add("name", name)
        .toString();
}

⚠️ 注意区别: 如果你继承了 User 类(比如 PlayerAdministrator),使用不同的构造方式会影响输出的类名:

  • 使用 toStringHelper(this):输出子类名,如 Player{id=12, name=John Doe}
  • 使用其他两种方式:始终输出父类名,如 User{id=12, name=John Doe}

3. FluentIterable 新增方法

3.1. 简介

FluentIterable 提供链式操作来处理 Iterable 集合,非常方便进行过滤、转换等操作。

举个例子,过滤出年龄大于等于 18 的用户:

List<User> users = new ArrayList<>();
users.add(new User(1L, "John", 45));
users.add(new User(2L, "Michelle", 27));
users.add(new User(3L, "Max", 16));
users.add(new User(4L, "Sue", 10));
users.add(new User(5L, "Bill", 65));

Predicate<User> byAge = user -> user.getAge() >= 18;

List<String> results = FluentIterable.from(users)
                           .filter(byAge)
                           .transform(Functions.toStringFunction())
                           .toList();

结果会包含 John、Michelle 和 Bill 的字符串表示。

**3.2. FluentIterable.of(E[]):从数组创建

你可以直接从数组创建 FluentIterable 实例:

User[] usersArray = { new User(1L, "John", 45), new User(2L, "Max", 15) } ;
FluentIterable<User> users = FluentIterable.of(usersArray);

之后就可以使用所有 FluentIterable 提供的链式方法了。

**3.3. FluentIterable.append(E…):追加元素

基于现有 FluentIterable 创建一个新的,并追加多个元素:

User[] usersArray = {new User(1L, "John", 45), new User(2L, "Max", 15)};

FluentIterable<User> users = FluentIterable.of(usersArray).append(
                                 new User(3L, "Sue", 23),
                                 new User(4L, "Bill", 17)
                             );

最终 users 包含 4 个元素 ✅

**3.4. FluentIterable.append(Iterable<? extends E>):追加集合

和上一个类似,但支持从任意 Iterable 追加内容:

User[] usersArray = { new User(1L, "John", 45), new User(2L, "Max", 15) };

List<User> usersList = new ArrayList<>();
usersList.add(new User(3L, "Diana", 32));

FluentIterable<User> users = FluentIterable.of(usersArray).append(usersList);

最终 users 包含 3 个元素 ✅

**3.5. FluentIterable.join(Joiner):拼接字符串

将所有元素通过 Joiner 拼接成一个字符串:

User[] usersArray = { new User(1L, "John", 45), new User(2L, "Max", 15) };
FluentIterable<User> users = FluentIterable.of(usersArray);
String usersString = users.join(Joiner.on("; "));

输出为:

User{id=1, name=John, age=45}; User{id=2, name=Max, age=15}

*4. Hashing.crc32c:CRC32C 哈希算法*

CRC32C 是一种校验码算法,广泛用于数据完整性检测。Guava 提供了便捷的方法来生成 CRC32C 校验值:

int receivedData = 123;
HashCode hashCode = Hashing.crc32c().hashInt(receivedData);
// hashCode: 495be649

**5. InetAddresses.decrement(InetAddress):IP 减一

该方法返回一个新的 InetAddress,其值比原地址小 1:

InetAddress address = InetAddress.getByName("127.0.0.5");
InetAddress decrementedAddress = InetAddresses.decrement(address);
// decrementedAddress: 127.0.0.4

⚠️ 虽然功能简单,但在网络编程或 IP 地址遍历场景中非常有用。

6. MoreExecutors 新增执行器

6.1. Java 线程回顾

Java 中通过 ThreadRunnable 来执行异步任务:

ConcurrentHashMap<String, Boolean> threadExecutions = new ConcurrentHashMap<>();
Runnable logThreadRun = () -> threadExecutions.put(Thread.currentThread().getName(), true);

Thread t = new Thread(logThreadRun);
t.run();

Boolean isThreadExecuted = threadExecutions.get("main");

上面代码会在主线程执行 ✅

如果要使用线程池:

ExecutorService executorService = Executors.newFixedThreadPool(2);
executorService.submit(logThreadRun);
executorService.submit(logThreadRun);
executorService.shutdown();

Boolean isThread1Executed = threadExecutions.get("pool-1-thread-1");
Boolean isThread2Executed = threadExecutions.get("pool-1-thread-2");
// isThread1Executed: true
// isThread2Executed: true

**6.2. MoreExecutors.directExecutor():直接执行器

这是一个轻量级执行器,会在调用线程中立即执行任务:

Executor executor = MoreExecutors.directExecutor();
executor.execute(logThreadRun);

Boolean isThreadExecuted = threadExecutions.get("main");
// isThreadExecuted: true

适用于需要同步执行的场景 ❗

**6.3. MoreExecutors.newDirectExecutorService():增强型直接执行器

返回一个 ListeningExecutorService 实例,功能更丰富,兼容旧版本的 sameThreadExecutor()

ListeningExecutorService executor = MoreExecutors.newDirectExecutorService();
executor.execute(logThreadRun);

它支持更多方法如:invokeAll, submit, shutdown, isShutdown 等,适合复杂调度场景 ✅

7. 总结

Guava 18 引入了许多实用的新功能和改进,特别是在字符串处理、集合操作和并发工具方面。对于追求代码简洁高效的开发者来说,非常值得集成到项目中。

📌 示例代码可在 GitHub 查看:https://github.com/eugenp/tutorials/tree/master/guava-modules/guava-18


原始标题:Guava 18: What's New?