Guava Optional 类

Optional 是一个不可变对象，用于包含非空对象。Optional 对象用于表示没有值的空对象。这个类有各种实用方法，以便于处理值是否可用，而不是检查空值。

类声明

下面是 com.google.common.base.Optional 类的声明 −

@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)表示返回包含的实例（如果存在）；否则返回defaultValue的值。
12	abstract T orNull()返回包含的实例（如果存在）；否则返回null。
13	static <T> Iterable<T> presentInstances(Iterable<? extends Optional<? extends T>> optionals)表示返回提供的可选实例中每个存在的值，以顺序排列，并跳过不存在()的出现。
14	abstract String toString() 返回此实例的字符串表示形式。
15	abstract <V> Optional<V> transform (Function<? super T, V> function) 如果实例存在，则使用给定的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