当前位置: 首页 > 文档资料 > Guava 中文文档 >

可选类(Optional Class)

优质
小牛编辑
125浏览
2023-12-01

可选是用于包含非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