教程 > Guava 教程 > Guava 基础 阅读：39

Guava Optional 类

Optional 是用于包含非空对象的不可变对象。 可选对象用于表示没有值的 null。 此类具有各种实用方法，可帮助代码将值处理为可用或不可用，而不是检查空值。

类声明

以下是 com.google.common.base.Optional<T> 类的声明

@GwtCompatible(serializable = true)
public abstract class Optional<T>
   extends Object
      implements Serializable

类方法

序号 方法 说明
1 static <T> Optional<T> absent() 返回一个不包含引用的 Optional 实例。
2 abstract Set<T> asSet() 返回一个不可变的单例 Set，其唯一元素是包含的实例（如果存在）； 否则为空的不可变 Set。
3 abstract boolean equals(Object object) 如果 object 是 Optional 实例，并且包含的引用彼此相等或两者都不存在，则返回 true。
4 static <T> Optional<T> fromNullable(T nullableReference) 如果 nullableReference 为非空，则返回包含该引用的 Optional 实例； 否则返回 absent()。
5 abstract T get() 返回包含的实例，该实例必须存在。
6 abstract int hashCode() 返回此实例的哈希码。
7 abstract boolean isPresent() 如果此持有者包含一个（非空）实例，则返回 true。
8 static <T> Optional<T> of(T reference) 返回包含给定非空引用的 Optional 实例。
9 abstract Optional<T> or(Optional<? extends T> secondChoice) 如果存在值，则返回此 Optional； 否则 secondChoice 。
10 abstract T or(Supplier<? extends T> supplier) 如果存在则返回包含的实例； 否则 supplier.get()。
11 abstract T or(T defaultValue) 如果存在则返回包含的实例； 否则为默认值。
12 abstract T orNull() 如果存在则返回包含的实例； 否则为空。
13 static <T> Iterable<T> presentInstances(Iterable<? extends Optional<? extends T>> optionals) 按顺序从提供的可选值中返回每个存在实例的值，跳过 absent() 的出现。
14 abstract String toString() 返回此实例的字符串表示形式。
15 abstract <V> Optional<V> transform(Function<? super T,V> function) 如果实例存在，则使用给定的函数对其进行转换； 否则，返回 absent() 。

方法继承

该类继承了以下类的方法 -

  • java.lang.Object

Optional 类示例

在 C:/> Guava 中使用我们选择的任何编辑器创建以下 java 程序。

GuavaTester.java

import com.google.common.base.Optional;

public class GuavaTester {
   public static void main(String args[]) {
      GuavaTester guavaTester = new GuavaTester();

      Integer value1 =  null;
      Integer value2 =  new Integer(10);
      
      //Optional.fromNullable - allows passed parameter to be null.
      Optional<Integer> a = Optional.fromNullable(value1);
      
      //Optional.of - throws NullPointerException if passed parameter is null
      Optional<Integer> b = Optional.of(value2);        

      System.out.println(guavaTester.sum(a,b));
   }

   public Integer sum(Optional<Integer> a, Optional<Integer> b) {
      //Optional.isPresent - checks the value is present or not
      System.out.println("First parameter is present: " + a.isPresent());

      System.out.println("Second parameter is present: " + b.isPresent());

      //Optional.or - returns the value if present otherwise returns
      //the default value passed.
      Integer value1 = a.or(new Integer(0));    

      //Optional.get - gets the value, value should be present
      Integer value2 = b.get();

      return value1 + value2;
   }    
}

验证结果

使用 javac 编译器编译类，如下所示

C:\Guava>javac GuavaTester.java

现在运行 GuavaTester 以查看结果。

C:\Guava>java GuavaTester

结果如下

First parameter is present: false
Second parameter is present: true
10

查看笔记

扫码一下
查看教程更方便