Guava – Optional 类

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

Optional 类定义

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

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

Optional 类函数

序号	函数和描述
1	static <T> Optional<T> absent() 返回一个没有包含引用的Optional实例.
2	abstract Set<T> asSet() 返回一个不可变的单子集合，如果该集合存在，其唯一的元素就是所包含的实例；否则就是一个空的不可变的集合.
3	abstract boolean equals(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() 如果这个持有人包含一个（非空的）实例，则返回真.
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) 从提供的选项中依次返回每个present实例的值，跳过absence()的出现次数.
14	abstract String toString() 返回这个实例的字符串表示.
15	abstract <V> Optional<V> transform(Function<? super T,V> function) 如果实例存在，则用给定的Function对其进行转换；否则，返回absent().

Optional 类继承

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

• 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