Java 工具库 Google Guava

Google Guava 是一个流行的 Java 工具库，提供了丰富的实用工具和数据结构扩展。它涵盖了集合框架、字符串处理、并发工具、缓存、事件总线等功能。

---

Maven 依赖

在项目中添加 Guava 依赖：

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>32.1.2-jre</version> <!-- 请根据需要选择最新版本 -->
</dependency>

---

主要功能模块

1. 集合工具

不可变集合

Guava 提供了线程安全的不可变集合。

import com.google.common.collect.ImmutableList;

public class ImmutableExample {
    public static void main(String[] args) {
        ImmutableList<String> list = ImmutableList.of("a", "b", "c");
        System.out.println(list);

        // list.add("d"); // 会抛出 UnsupportedOperationException
    }
}

Multimap

支持一个键映射到多个值。

import com.google.common.collect.ArrayListMultimap;
import com.google.common.collect.Multimap;

public class MultimapExample {
    public static void main(String[] args) {
        Multimap<String, String> multimap = ArrayListMultimap.create();
        multimap.put("key1", "value1");
        multimap.put("key1", "value2");
        multimap.put("key2", "value3");

        System.out.println(multimap.get("key1")); // 输出：[value1, value2]
    }
}

Table

支持双键映射的数据结构。

import com.google.common.collect.HashBasedTable;
import com.google.common.collect.Table;

public class TableExample {
    public static void main(String[] args) {
        Table<String, String, Integer> table = HashBasedTable.create();
        table.put("row1", "column1", 1);
        table.put("row1", "column2", 2);
        table.put("row2", "column1", 3);

        System.out.println(table.get("row1", "column1")); // 输出：1
    }
}

---

2. 字符串工具

字符串拼接

使用 Joiner。

import com.google.common.base.Joiner;

public class JoinerExample {
    public static void main(String[] args) {
        String result = Joiner.on(", ").skipNulls().join("a", null, "b", "c");
        System.out.println(result); // 输出：a, b, c
    }
}

字符串拆分

使用 Splitter。

import com.google.common.base.Splitter;

public class SplitterExample {
    public static void main(String[] args) {
        Iterable<String> parts = Splitter.on(",").omitEmptyStrings().trimResults().split("a, b, , c");
        parts.forEach(System.out::println); // 输出：a, b, c
    }
}

---

3. 缓存工具

Guava 提供了功能强大的内存缓存工具 Cache。

import com.google.common.cache.Cache;
import com.google.common.cache.CacheBuilder;

import java.util.concurrent.TimeUnit;

public class CacheExample {
    public static void main(String[] args) {
        Cache<String, String> cache = CacheBuilder.newBuilder()
                .maximumSize(100)
                .expireAfterWrite(10, TimeUnit.MINUTES)
                .build();

        cache.put("key1", "value1");
        System.out.println(cache.getIfPresent("key1")); // 输出：value1
    }
}

---

4. 并发工具

RateLimiter

Guava 提供了令牌桶算法的限流工具。

import com.google.common.util.concurrent.RateLimiter;

public class RateLimiterExample {
    public static void main(String[] args) {
        RateLimiter rateLimiter = RateLimiter.create(2); // 每秒允许 2 个请求
        for (int i = 0; i < 5; i++) {
            rateLimiter.acquire(); // 获取令牌
            System.out.println("Request " + i + " at " + System.currentTimeMillis());
        }
    }
}

ListenableFuture

Guava 提供了增强版的 Future，支持回调函数。

import com.google.common.util.concurrent.*;

import java.util.concurrent.Executors;

public class ListenableFutureExample {
    public static void main(String[] args) {
        ListeningExecutorService service = MoreExecutors.listeningDecorator(Executors.newFixedThreadPool(2));
        ListenableFuture<String> future = service.submit(() -> "Hello Guava!");

        Futures.addCallback(future, new FutureCallback<>() {
            public void onSuccess(String result) {
                System.out.println("Success: " + result);
            }

            public void onFailure(Throwable t) {
                System.out.println("Failed: " + t.getMessage());
            }
        }, service);

        service.shutdown();
    }
}

---

5. 事件总线

Guava 的 EventBus 提供了轻量级的事件发布-订阅框架。

import com.google.common.eventbus.EventBus;
import com.google.common.eventbus.Subscribe;

public class EventBusExample {
    public static void main(String[] args) {
        EventBus eventBus = new EventBus();

        eventBus.register(new EventListener());
        eventBus.post("Hello EventBus!");
    }

    public static class EventListener {
        @Subscribe
        public void handleEvent(String message) {
            System.out.println("Received message: " + message);
        }
    }
}

---

6. 其他功能

Preconditions

用于校验方法参数。

import com.google.common.base.Preconditions;

public class PreconditionsExample {
    public static void main(String[] args) {
        int age = -1;
        Preconditions.checkArgument(age > 0, "Age must be positive: %s", age); // 抛出 IllegalArgumentException
    }
}

Ordering

对集合排序的工具。

import com.google.common.collect.Ordering;

import java.util.Arrays;
import java.util.List;

public class OrderingExample {
    public static void main(String[] args) {
        List<String> names = Arrays.asList("John", "Alice", "Bob");
        List<String> sortedNames = Ordering.natural().sortedCopy(names);
        System.out.println(sortedNames); // 输出：[Alice, Bob, John]
    }
}

---

总结

Guava 提供了丰富的功能模块，常用功能包括：

• 集合扩展：ImmutableList、Multimap、Table。
• 字符串处理：Joiner、Splitter。
• 并发工具：RateLimiter、ListenableFuture。
• 缓存工具：CacheBuilder。
• 事件总线：EventBus。