吐血整理的Google Guava

一、概述

  Guava 是由Google开发的基于Java的开源库，包含许多Google核心库，它有助于最佳编码实践，并有助于减少编码错误。它为集合 [collections] 、缓存 [caching] 、原生类型支持 [primitives support] 、并发库 [concurrency libraries] 、通用注解 [common annotations] 、字符串处理 [string processing] 、I/O 等等提供实用程序方法。

<!-- https://mvnrepository.com/artifact/com.google.guava/guava -->
<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>${laster.version}</version>
</dependency>

源码包的简单说明

二、使用手册

2.1 基本工具 [Basic utilities]

2.1.1 使用和避免null

  到目前为止，臭名昭著的 NullPointerException 是导致Java应用程序失败的最常见原因。通过查看Google底层代码库，我们发现95%的集合类不接受null值作为元素。我们认为， 相比默默地接受null，使用快速失败操作拒绝null值对开发者更有帮助。此外，Null的含糊语义让人很不舒服。Null很少可以明确地表示某种语义，例如，Map.get(key)返回Null时，可能表示map中的值是null，亦或map中没有key对应的值。Null可以表示失败、成功或几乎任何情况。使用Null以外的特定值，会让你的逻辑描述变得更清晰。鉴于这些原因，很多Guava工具类对Null值都采用快速失败操作，除非工具类本身提供了针对Null值的因变措施。
  大多数情况下，开发人员使用null表明的是某种缺失情形：可能是已经有一个默认值，或没有值，或找不到值。例如，Map.get返回null就表示找不到给定键对应的值。Guava用 Optional<t> 表示可能为null的T类型引用，一个Optional实例可能包含非null的引用，也可能什么也不包括。它从不说包含的是null值，而是用存在或缺失来表示，但Optional从不会包含null值引用。

创建Optional实例（以下都是静态方法）：

用Optional实例查询引用（以下都是非静态方法）：

2.1.2 常见Object方法

• equals

  当一个对象中的字段可以为null时，实现 Object.equals 会很痛苦，因为不得不分别对它们进行null检查。使用 Objects.equal 帮助你执行null敏感的equals判断，从而避免抛出NullPointerException。例如:

  package org.dllwh.guava.basicutilities;
  import com.google.common.base.Objects;
   
  public final class ObjectHelper {
      public static void main(String[] args) {
          System.out.println(Objects.equal("a", "a"));
          System.out.println(Objects.equal(null, "a"));
          System.out.println(Objects.equal("a", null));
          System.out.println(Objects.equal(null, null));
      }
  }
   
  

• hashCode

  用对象的所有字段作散列[hash]运算应当更简单。Guava的 Objects.hashCode(Object...) 会对传入的字段序列计算出合理的、顺序敏感的散列值。你可以使用Objects.hashCode(field1, field2, …, fieldn)来代替手动计算散列值。

2.1.3 前置条件

Guava在 Preconditions 类中提供了若干前置条件判断的实用方法，让方法调用的前置条件判断更简单。

每个方法都有三个变种：

• 没有额外参数：抛出的异常中没有错误消息；
• 有一个Object对象作为额外参数：抛出的异常使用Object.toString() 作为错误消息；
• 有一个String对象作为额外参数，并且有一组任意数量的附加Object对象：这个变种处理异常消息的方式有点类似printf，但考虑GWT的兼容性和效率，只支持%s指示符。

2.2 强大的集合工具类[Collections]

任何对JDK集合框架有经验的程序员都熟悉和喜欢 java.util.Collections 包含的工具方法。Guava对JDK集合的扩展，提供了更多的工具方法：适用于所有集合的静态方法，这是Guava最流行和成熟的部分之一。在Guava Collections中，Guava提供了一些用于处理这些集合实例的类，接下来用相对直观的方式把工具类与特定集合接口的对应关系归纳如下：

2.2.1 Lists

Lists是Guava Collections中提供的用于处理List实例的实用类，翻开源代码，我们看到，其内部使用了静态工厂方法代替构造器，提供了许多用于List子类构造和操作的静态方法，我们简单的依次进行说明，如下：

除了静态工厂方法和函数式编程方法，Lists 为List类型的对象提供了若干工具方法：

示例如下：

public final class ListsHelper {
    public static void main(String[] args) {
        /**
         * 一些构造List实例的方法很简单
         * 如：newArrayList(),newLinkedList()等
         * 这里不再赘述
         */
        String str = "i love u";
        String[] strs = {"i like u", "i miss u"};
        /**
         * asList：返回一个不可变的List
         * 其中包含指定的第一个元素和附加的元素数组组成
         * 修改这个数组将反映到返回的List上
         */
        List<string> list = Lists.asList(str, strs);
        System.out.println(list);
        // 对strs数组的修改会反映到List中
        strs[1] = "i hate u";
 
        System.out.println(list);
 
        /**
         * partition：根据size传入的List进行切割，切割成符合要求的小的List
         * 并将这些小的List存入一个新的List对象中返回
         */
        List<list<string>&gt; lists = Lists.partition(list, 2);
        System.out.println(lists);
        /**
         * charactersOf：将传进来的String或者CharSequence分割为单个的字符
         * 并存入到一个ImmutableList对象中返回
         * ImmutableList：一个高性能、不可变的、随机访问列表的实现
         */
        ImmutableList<character> characters = Lists.charactersOf("realfighter");
        System.out.println(characters);
        /**
         * reverse：返回一个传入List内元素倒序后的List
         */
        List<string> reverse = Lists.reverse(list);
        System.out.println(reverse);
    }
}
 

2.2.2 Maps

Guava Maps 对java Map封装和升级，实现强大、简洁应用方式。首先让我们看看Guava创建Map方法：

2.2.3 Sets

2.3 字符串处理[Strings]

2.3.1 字符串处理 Strings

Strings 类主要提供了对字符串的一些操作。主要方法如下：

2.3.2 连接器[Joiner]

Joiner 是用来连接字符串的，它能以指定的字符对多个字符串进行连接。比如，我们要将一个List中的元素用逗号连接起来，这是日常开发中很常见的逻辑处理，那以前我们可能会这样写：

List<string> list = Lists.newArrayList("a","b","c");
StringBuffer buffer = new StringBuffer();
for(int i = 0; i &lt; list.size(); i++){
    if(i &gt; 0){
        buffer.append(",");
    }
    buffer.append(list.get(i));
}
System.out.println(buffer.toString());
 

用分隔符把字符串序列连接起来也可能会遇上不必要的麻烦，如果字符串序列中含有null，那连接操作会更难，而Fluent风格的[Joiner让连接字符串更简单。

Joiner.on(";").skipNulls().join("hello World", null, "独泪了无痕");
 

Joiner也可以用来连接对象类型，在这种情况下，它会把对象的toString()值连接起来。

// return "a,b,c"
Joiner.on(",").join(Arrays.asList("a","b","c"));
 
// return "id=123&name=dllwh"
Joiner.on("&").withKeyValueSeparator("=").join(ImmutableMap.of("id", "123", "name", "dllwh"));
 

常用方法如下：

> joiner实例总是不可变的，用来定义joiner目标语义的配置方法总会返回一个新的joiner实例，这使得joiner实例都是线程安全的，所以可以将其定义为static final常量。

2.3.3 拆分器[Splitter]

Splitter 能将一个字符串按照分隔符生成字符串集合，是 Joiner的反向操作。常用方法如下：

示例如下：

public final class SplitterHelper {
    public static void main(String[] args) {
        String string = " ,a,b,";
        System.out.println(Splitter.on(",").split(string));
        System.out.println(Splitter.on(",").trimResults().split(string));
        System.out.println(Splitter.on(",").omitEmptyStrings().split(string));
        System.out.println(Splitter.on(",").trimResults().omitEmptyStrings().split(string));
 
        // 根据长度拆分
        string = "12345678";
        System.out.println(Splitter.fixedLength(2).split(string));
 
        // 拆分成Map
        System.out.println(Splitter.on("&").withKeyValueSeparator("=").split("id=123&name=dllwh"));
    }
}
 

> splitter实例总是不可变的，用来定义splitter目标语义的配置方法总会返回一个新的splitter实例，这使得splitter实例都是线程安全的

2.3.4 字符匹配器[CharMatcher]

> CharMatcher，将字符的匹配和处理解耦，并提供丰富的方法供你使用！

CharMatcher本身提供了很多CharMatcher实现类,如下:

构造对象

CharMatcher提供了多种多样的方法操作CharSequence中的特定字符。其中最常用的罗列如下：

2.3.5 字符集[Charsets]

Charsets 针对所有Java平台都要保证支持的六种字符集提供了常量引用。尝试使用这些常量，而不是通过名称获取字符集实例。

public final class Charsets {
    @GwtIncompatible
    public static final Charset US_ASCII = Charset.forName("US-ASCII");
    public static final Charset ISO_8859_1 = Charset.forName("ISO-8859-1");
    public static final Charset UTF_8 = Charset.forName("UTF-8");
    @GwtIncompatible
    public static final Charset UTF_16BE = Charset.forName("UTF-16BE");
    @GwtIncompatible
    public static final Charset UTF_16LE = Charset.forName("UTF-16LE");
    @GwtIncompatible
    public static final Charset UTF_16 = Charset.forName("UTF-16");
 
    private Charsets() {
    }
}
 

2.4 原生类型[Primitives]

Java的原生类型就是指基本类型：byte、short、int、long、float、double、char和boolean。原生类型不能当作对象或泛型的类型参数使用，这意味着许多通用方法都不能应用于它们。Guava提供了若干通用工具，包括原生类型数组与集合API的交互，原生类型和字节数组的相互转换，以及对某些原生类型的无符号形式的支持。

————————————————
版权声明：本文为CSDN博主「独泪了无痕」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/duleilewuhen/article/details/111502505

吐血整理的Google Guava - 独泪了无痕 - OSCHINA - 中文开源技术交流社区