Guava Optional类
1 什么是Guava Optional类
Optional 是一个不可变对象,用于包含非空对象。可选对象用于表示没有值的空值。此类具有各种实用程序方法,以方便代码处理可用或不可用的值,而不是检查空值。
2 Guava Optional类的语法
@GwtCompatible(serializable = true)
public abstract class Optional<T>
extends Object
implements Serializable
3 Guava Optional类的方法
方法 | 描述 |
---|---|
static <T> Optional<T> absent() | 返回一个不包含引用的 Optional 实例。 |
abstract Set<T> asSet() | 返回一个不可变的单例 Set,它的唯一元素是包含的实例(如果存在);否则为空的不可变 Set。 |
abstract boolean equals(Object object) | 如果 object 是一个 Optional 实例,并且包含的引用彼此相等或两者都不存在,则返回 true。 |
static <T> Optional<T> fromNullable(T nullableReference) | 如果 nullableReference 为非空,则返回一个包含该引用的 Optional 实例;否则返回不存在()。 |
abstract T get() | 返回包含的实例,该实例必须存在。 |
abstract int hashCode() | 返回此实例的哈希码。 |
abstract boolean isPresent() | 如果此持有者包含(非空)实例,则返回 true。 |
static <T> Optional<T> of(T reference) | 返回一个包含给定非空引用的 Optional 实例。 |
abstract Optional<T> or(Optional<? extends T> secondChoice) | 如果存在值,则返回此 Optional ;否则返回secondChoice 。 |
abstract T or(Supplier<? extends T> supplier) | 如果存在,则返回包含的实例。 |
abstract T or(T defaultValue) | 如果存在,则返回包含的实例;否则使用默认值。 |
abstract T orNull() | 如果存在,则返回包含的实例;否则为空。 |
static <T> Iterable<T> presentInstances(Iterable<? extends Optional<? extends T>> optionals) | 从提供的选项中按顺序返回每个当前实例的值,跳过出现的absent()。 |
abstract String toString() | 返回此实例的字符串表示形式。 |
abstract <V> Optional<V> transform(Function<? super T,V> function) | 如果实例存在,则使用给定的函数对其进行转换;否则,返回absent()。 |
5 Guava Optional类的例子
让我们看一个简单的Guava Optional类示例。
package com.yiidian;
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;
}
}
输出结果为:
热门文章
优秀文章