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
类(比如 Player
和 Administrator
),使用不同的构造方式会影响输出的类名:
- 使用
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 中通过 Thread
和 Runnable
来执行异步任务:
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