Optional 类的Javadoc
描述如下:
这是一个可以为null
的容器对象;如果值存在则isPresent()
方法会返回true
,调用get()
方法会返回该对象。
1. 静态方法
1.1 Optional.of(T)
为非null
的值创建一个Optional
。
of
方法通过工厂方法创建Optional
类,需要注意的是,创建对象时传入的参数不能为null
;如果传入参数为null
,则抛出NullPointerException
。
// 调用工厂方法创建Optional实例
Optional<String> name = Optional.of("michael");// 若传入参数为null,则抛出NullPointerException
Optional<String> someNull = Optional.of(null);
1.2 Optional.ofNullable(T)
为指定的值创建一个Optional
,如果指定的值为null
,则返回一个空的Optional
。
ofNullable
与of
方法相似,唯一的区别是可以接受参数为null
的情况。
示例如下:
//下面创建了一个不包含任何值的Optional实例,例如,值为 null
Optional empty = Optional.ofNullable(null);
1.3 Optional.empty()
所有null
包装成的Optional
对象
Optional<Integer> optional1 = Optional.ofNullable(null);
Optional<Integer> optional2 = Optional.ofNullable(null);
System.out.println(optional1 == optional2);// true
System.out.println(optional1 == Optional.<Integer>empty());// trueObject o1 = Optional.<Integer>empty();
Object o2 = Optional.<String>empty();
System.out.println(o1 == o2);// true
2. 实例方法
2.1 ifPresent()
判断值是否存在
如果Optional
实例有值则为其调用consumer
,否则不做处理;
如果Optional
实例有值,调用ifPresent()
可以接受接口段或lambda表达式。
类似下面的代码:
Optional<Integer> optional1 = Optional.ofNullable(1);
Optional<Integer> optional2 = Optional.ofNullable(null);// isPresent判断值是否存在
System.out.println(optional1.isPresent() == true);
System.out.println(optional2.isPresent() == false);
ifPresent(Consumer consumer):如果optional
对象保存的值不是null
,则调用consumer
对象,否则不调用
// 如果不是null,调用Consumer
optional1.ifPresent(new Consumer<Integer>() {
@Overridepublic void accept(Integer t) {
System.out.println("value is " + t);}
});// 如果是null,不调用Consumer
optional2.ifPresent(new Consumer<Integer>() {
@Overridepublic void accept(Integer t) {
System.out.println("value is " + t);}
});
2.2 orElse(value)
如果optional对象保存的值不是null,则返回原来的值,否则返回value
示例如下:
Optional<Integer> optional1 = Optional.ofNullable(1);
Optional<Integer> optional2 = Optional.ofNullable(null);// 如果值不为null,orElse方法返回Optional实例的值
// 输出:1
System.out.println(optional1.orElse("There is some value"));// 如果为null,返回传入的消息
// 输出:There is no value present
System.out.println(optional2.orElse("There is no value present"));
2.3 orElseGet(Supplier supplier)
orElseGet
与orElse
方法类似,区别在于得到的默认值:
orElse
方法将传入的字符串作为默认值;
orElseGet
方法可以接受Supplier
接口的实现用来生成默认值。
示例如下:
Optional<String> name = Optional.of("michael");
Optional empty = Optional.ofNullable(null);//orElseGet与orElse方法类似,区别在于orElse传入的是默认值
//orElseGet可以接受一个lambda表达式生成默认值
//输出:Default Value
System.out.println(empty.orElseGet(() -> "Default Value"));// 输出:michael
System.out.println(name.orElseGet(() -> "Default Value"));
2.4 orElseThrow()
值不存在则抛出异常,存在则什么不做,有点类似Guava的Precoditions
Optional<Integer> optional1 = Optional.ofNullable(1);
Optional<Integer> optional2 = Optional.ofNullable(null);optional1.orElseThrow(() -> {
throw new IllegalStateException();
});try {
// 抛出异常optional2.orElseThrow(() -> {
throw new IllegalStateException();});
} catch (IllegalStateException e) {
e.printStackTrace();
}
2.5 filter(Predicate)
如果有值并且满足断言条件返回包含该值的Optional
,否则返回空Optional
。
下面的示例介绍了满足限定条件和不满足两种情况:
Optional<String> name = Optional.of("michael");// filter方法检查给定的Option值是否满足某些条件
// 如果满足则返回同一个Option实例,否则返回空Optional
Optional<String> longName = name.filter((value) -> value.length() > 6);
//输出 michael
System.out.println(longName.orElse("The name is less than 6 characters"));
// 另一个例子是Optional值不满足filter指定的条件
Optional<String> anotherName = Optional.of("mic");
Optional<String> shortName = anotherName.filter((value) -> value.length() > 6);
//输出:The name is less than 6 characters
System.out.println(shortName.orElse("The name is less than 6 characters"));
2.6 map(Function)
对Optional
中保存的值进行函数运算,并返回新的Optional
(可以是任何类型)
map方法示例如下:
Optional<String> name = Optional.of("michael");// map方法执行传入的lambda表达式参数对Optional实例的值进行修改
// 为lambda表达式的返回值创建新的Optional实例作为map方法的返回值
Optional<String> upperName = name.map((value) -> value.toUpperCase());
System.out.println(upperName.orElse("No value found"));Optional<Integer> optional1 = Optional.ofNullable(1);
Optional<Integer> optional2 = Optional.ofNullable(null);Optional<String> str1Optional = optional1.map((a) -> "key" + a);
Optional<String> str2Optional = optional2.map((a) -> "key" + a);System.out.println(str1Optional.get());// key1
System.out.println(str2Optional.isPresent());// false
2.7 flatMap()
功能与map()
相似,差别请看如下代码。flatMap
方法与map
方法类似,区别在于mapping
函数的返回值不同。map
方法的mapping
函数返回值可以是任何类型T
,而flatMap
方法的mapping
函数必须是Optional
。
Optional<Integer> optional1 = Optional.ofNullable(1);Optional<Optional<String>> str1Optional = optional1.map((a) -> {
return Optional.<String>of("key" + a);
});Optional<String> str2Optional = optional1.flatMap((a) -> {
return Optional.<String>of("key" + a);
});System.out.println(str1Optional.get().get());// key1
System.out.println(str2Optional.get());// key1