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.ObjectOptional 类示例
在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: falseSecond parameter is present: true10
