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