可选类(Optional Class)
可选是用于包含非null对象的不可变对象。 可选对象用于表示缺少值的null。 此类具有各种实用程序方法,以便于代码处理可用或不可用的值,而不是检查空值。
Class 声明 (Class Declaration)
以下是com.google.common.base.Optional《T》类的声明 -
@GwtCompatible(serializable = true)
public abstract class Optional<T>
extends Object
implements Serializable
Class Methods
Sr.No | 方法和描述 |
---|---|
1 | static 《T》 Optional《T》 absent() 返回没有包含引用的Optional实例。 |
2 | abstract Set《T》 asSet() 返回一个不可变的单例集,其唯一元素是包含的实例(如果存在); 否则为空的不可变Set。 |
3 | abstract boolean equals(Object object) 如果object是Optional实例,并且包含的引用彼此相等或两者都不存在,则返回true。 |
4 | static 《T》 Optional《T》 fromNullable(T nullableReference) 如果nullableReference为非null,则返回包含该引用的Optional实例; 否则返回缺席()。 |
5 | abstract T get() 返回必须存在的包含实例。 |
6 | abstract int hashCode() 返回此实例的哈希码。 |
7 | abstract boolean isPresent() 如果此holder包含(非null)实例,则返回true。 |
8 | static 《T》 Optional《T》 of(T reference) 返回包含给定非null引用的Optional实例。 |
9 | abstract Optional《T》 or(Optional《? extends T》 secondChoice) 如果存在值,则返回此Optional; 第二个选择。 |
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) 如果实例存在,则使用给定的函数进行转换; 否则,返回absent()。 |
方法继承 (Methods Inherited)
该类继承以下类中的方法 -
- java.lang.Object
可选类的示例
使用您选择的任何编辑器在C:/》 Guava.创建以下java程序C:/》 Guava.
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