Guava 简明教程
Guava - Optional Class
Optional 是用来存储非空对象的不可变对象。Optional 对象用来表示空值和缺失值。此类具有各种辅助方法，便于代码处理存在的或不存在的值，而不是检查空值。
Class Declaration
以下是有关 com.google.common.base.Optional<T> 类的声明 −
@GwtCompatible(serializable = true)
public abstract class Optional<T>
extends Object
implements SerializableClass Methods
Sr.No |
Method & Description |
1 |
static <T> Optional<T> absent() 返回不包含任何引用的 Optional 实例。 |
2 |
abstract Set<T> asSet() 如果存在，则返回一个包含包含实例的不可变单例 Set（如果不存在，则返回一个不可变的空 Set）。 |
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() 如果此持有者包含一个（非空）实例，则返回 true。 |
8 |
static <T> Optional<T> of(T reference) 返回包含给定的非空引用的 Optional 实例。 |
9 |
abstract Optional<T> or(Optional<? extends T> secondChoice) 如果此 Optional 具有存在的值，则返回此 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) 按顺序返回所提供的可选项中每个存在实例的值，跳过 absent() 的出现。 |
14 |
abstract String toString() 返回此实例的字符串表示形式。 |
15 |
abstract <V> Optional<V> transform(Function<? super T,V> function) 如果存在该实例，则使用给定的 Function 对它进行转换；否则，返回 absent()。 |
Example of Optional Class
使用任意你选择的编辑器在 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;
}
}