整理一波Guava的使用技巧

桃扇骨 2023-09-25 20:28 49阅读 0赞

![format_png][]

### Guava简介 ###

Guava是Google发布的一个开源库，主要提供了一些在Java开发中非常有用的工具类和API，比如字符串处理、集合操作、函数式编程、缓存等等。不管是工作还是学习都是非常值得我们去熟悉的，一起来看看吧。

#### 字符串（Strings） ####

Strings是Guava提供的一组字符串工具，它提供了许多有用的方法来处理字符串。以下是Strings的主要方法：

*  `isNullOrEmpty(String string)`：判断字符串是否为空或null。
 *  `padEnd(String string, int minLength, char padChar)`：在字符串末尾填充指定字符，直到字符串达到指定长度。
 *  `padStart(String string, int minLength, char padChar)`：在字符串开头填充指定字符，直到字符串达到指定长度。
 *  `repeat(String string, int count)`：重复指定字符串指定次数。
 *  `commonPrefix(CharSequence a, CharSequence b)`：获取两个字符串的最长公共前缀。
 *  `commonSuffix(CharSequence a, CharSequence b)`：获取两个字符串的最长公共后缀。

以下是Strings的使用示例：

public class StringsDemo {
        public static void main(String[] args) {
            // 判断字符串是否为空或null
            String str1 = null;
            String str2 = "";
            System.out.println(Strings.isNullOrEmpty(str1));
            System.out.println(Strings.isNullOrEmpty(str2));
    
            // 在字符串末尾填充指定字符，直到字符串达到指定长度
            String str3 = "abc";
            String paddedStr1 = Strings.padEnd(str3, 6, '*');
            System.out.println(paddedStr1);
    
            // 在字符串开头填充指定字符，直到字符串达到指定长度
            String str4 = "abc";
            String paddedStr2 = Strings.padStart(str4, 6, '*');
            System.out.println(paddedStr2);
    
            // 重复指定字符串指定次数
            String str5 = "abc";
            String repeatedStr = Strings.repeat(str5, 3);
            System.out.println(repeatedStr);
    
            // 获取两个字符串的最长公共前缀
            String str6 = "abcdefg";
            String str7 = "abcdxyz";
            String commonPrefix = Strings.commonPrefix(str6, str7);
            System.out.println(commonPrefix);
    
            // 获取两个字符串的最长公共后缀
            String str8 = "abcdefg";
            String str9 = "xyzdefg";
        String commonSuffix = Strings.commonSuffix(str8, str9);
        System.out.println(commonSuffix);
    }
    复制代码

#### 集合操作（Collections） ####

Guava提供了一些非常有用的集合操作API，如下所示：

*  1.  ImmutableList

不可变集合是Guava的一个重要特性，它可以确保集合不被修改，从而避免并发访问的问题。ImmutabelList是不可变List的实现，下面是一个示例代码：

List<String> list = Lists.newArrayList("a", "b", "c");
    ImmutableList<String> immutableList = ImmutableList.copyOf(list);
    复制代码

*  1.  Iterables

Iterables类提供了一些有用的方法来操作集合，如下所示：

Iterable<String> iterable = Lists.newArrayList("a", "b", "c");
    
    // 判断集合是否为空
    boolean isEmpty = Iterables.isEmpty(iterable);
    
    // 获取第一个元素，如果集合为空返回null
    String first = Iterables.getFirst(iterable, null);
    
    // 获取最后一个元素，如果集合为空返回null
    String last = Iterables.getLast(iterable, null);
    
    // 获取所有符合条件的元素
    Iterable<String> filtered = Iterables.filter(iterable, new Predicate<String>() {
        @Override
        public boolean apply(String input) {
            return input.startsWith("a");
        }
    });
    
    // 转换集合类型
    List<String> newList = Lists.newArrayList(Iterables.transform(iterable, new Function<String, String>() {
        @Override
        public String apply(String input) {
            return input + input;
        }
    }));
    复制代码

*  1.  Multimaps

Multimaps提供了一个非常有用的数据结构，它允许一个键对应多个值，下面是一个示例代码：

ListMultimap<Integer, String> map = ArrayListMultimap.create();
    map.put(1, "a");
    map.put(1, "b");
    map.put(2, "c");
    List<String> values = map.get(1); // 返回[a, b]
    复制代码

*  4.Maps

Maps提供了一些有用的方法来操作Map，如下所示：

Map<Integer, String> map = ImmutableMap.of(1, "a", 2, "b", 3, "c");
    
    // 判断Map是否为空
    boolean isEmpty = Maps.isEmpty(map);
    
    // 获取Map中的所有键
    Set<Integer> keys = map.keySet();
    
    // 获取Map中的所有值
    Collection<String> values = map.values();
    
    // 获取Map中的所有键值对
    Set<Map.Entry<Integer, String>> entries = map.entrySet();
    
    // 根据键获取值，如果不存在则返回null
    String value = Maps.getIfPresent(map, 1);
    复制代码

#### 条件检查（Preconditions） ####

Preconditions是Guava提供的一组前置条件检查工具，它提供了一些检查参数是否符合预期的方法。以下是Preconditions的主要方法：

*  `checkArgument(boolean expression, String errorMessageTemplate, Object... errorMessageArgs)`：检查参数是否符合预期，并抛出IllegalArgumentException异常，可以包含错误信息模板和占位符。
 *  `checkNotNull(T reference, String errorMessageTemplate, Object... errorMessageArgs)`：检查参数是否为null，并抛出NullPointerException异常，可以包含错误信息模板和占位符。
 *  `checkState(boolean expression, String errorMessageTemplate, Object... errorMessageArgs)`：检查对象状态是否符合预期，并抛出IllegalStateException异常，可以包含错误信息模板和占位符。
 *  `checkElementIndex(int index, int size, String errorMessageTemplate, Object... errorMessageArgs)`：检查下标是否在集合的范围内，并抛出IndexOutOfBoundsException异常，可以包含错误信息模板和占位符。
 *  `checkPositionIndex(int index, int size, String errorMessageTemplate, Object... errorMessageArgs)`：检查下标是否在集合的范围内，可以等于集合的大小，并抛出IndexOutOfBoundsException异常，可以包含错误信息模板和占位符。
 *  `checkPositionIndexes(int start, int end, int size)`：检查开始下标和结束下标是否在集合的范围内，并抛出IndexOutOfBoundsException异常。

以下是Preconditions的使用示例：

public class PreconditionsDemo {
        public static void main(String[] args) {
            // 检查参数是否符合预期，并抛出IllegalArgumentException异常，可以包含错误信息模板和占位符
            String str1 = "abc";
            Preconditions.checkArgument(str1.length() < 3, "字符串长度必须小于3");
            // 检查参数是否为null，并抛出NullPointerException异常，可以包含错误信息模板和占位符
            String str2 = null;
            Preconditions.checkNotNull(str2, "字符串不能为空");
            // 检查对象状态是否符合预期，并抛出IllegalStateException异常，可以包含错误信息模板和占位符
            boolean flag1 = false;
            Preconditions.checkState(flag1, "状态不正确");
            // 检查下标是否在集合的范围内，并抛出IndexOutOfBoundsException异常，可以包含错误信息模板和占位符
            List<Integer> list1 = Lists.newArrayList(1, 2, 3, 4, 5);
            Preconditions.checkElementIndex(6, list1.size(), "下标越界");
            // 检查下标是否在集合的范围内，可以等于集合的大小，并抛出IndexOutOfBoundsException异常，可以包含错误信息模板和占位符
            List<Integer> list2 = Lists.newArrayList(1, 2, 3, 4, 5);
            Preconditions.checkPositionIndex(5, list2.size(), "下标越界");
            // 检查开始下标和结束下标是否在集合的范围内，并抛出IndexOutOfBoundsException异常
            List<Integer> list3 = Lists.newArrayList(1, 2, 3, 4, 5);
            Preconditions.checkPositionIndexes(2, 6, list3.size());
            // 可以在错误信息中使用占位符
            int value1 = 101;
            Preconditions.checkArgument(value1 <= 100, "值必须小于等于 %s", 100);
            // 可以使用Supplier来避免计算开销
            int value2 = 101;
            Preconditions.checkArgument(value2 <= 100, () -> "值必须小于等于 " + 100);
    }
    复制代码

#### 可以设置过期时间的本地缓存(CacheBuilder) ####

Cache是Guava提供的一个缓存工具类，它可以帮助我们在内存中缓存数据，提高程序的性能。以下是Cache的主要方法：

*  get(K key, Callable<? extends V> valueLoader)：获取指定key的缓存值，如果缓存中没有，则调用valueLoader加载数据并存入缓存。
 *  getIfPresent(Object key)：获取指定key的缓存值，如果缓存中没有，则返回null。
 *  getAllPresent(Iterable<?> keys)：获取指定keys的缓存值，如果缓存中没有，则返回null。
 *  put(K key, V value)：将指定key的缓存值存入缓存。
 *  putAll(Map<? extends K, ? extends V> m)：将指定Map的缓存值存入缓存。
 *  invalidate(Object key)：将指定key的缓存值从缓存中删除。
 *  invalidateAll(Iterable<?> keys)：将指定keys的缓存值从缓存中删除。
 *  invalidateAll()：将所有缓存值从缓存中删除。
 *  size()：获取缓存中缓存值的数量。
 *  asMap()：将缓存转换成Map。

public class CacheDemo {
        public static void main(String[] args) {
            Cache<String, String> cache = CacheBuilder.newBuilder()
                    .maximumSize(100)
                    .expireAfterWrite(10, TimeUnit.MINUTES)
                    .build();
    
            cache.put("key", "value");
    
            String value = cache.getIfPresent("key");
        }
    }
    复制代码

以上是Guava的主要工具类介绍及其使用场景,当然不止这些了，Guava还有Throwables（异常工具类），EventBus（事件总线）等等，它们可以大大提高我们程序的开发效率，同时也为我们提供了很多方便的工具方法。

[format_png]: https://img-blog.csdnimg.cn/img_convert/cad037e0e8618d20e966d7827ea94e11.webp?x-oss-process=image/format,png