【Java8】Guava——Optional

Optional

使用场景

调用一个方法得到了返回值却不能直接将返回值作为参数去调用别的方法。我们首先要判断这个返回值是否为null，只有在非空的前提下才能将其作为其他方法的参数

表示可能为null的T类型引用

一个Optional<>实例可能包含非null的引用（我们称之为引用存在），也可能什么也不包括（称之为引用缺失）

Of

Optional.of(T) //为非null的值创建一个Optional
//返回String的实例
Optional<String> num = Optional.of("GuavaStudy") 
//传入参数为null，抛出NullPointerException
Optional<String> someNull = Optional.of(null)

ofNullable

//为指定的值创建一个Optional，如果指定的值为null，则返回一个空的Optional
Optional.ofNullable() 
//不报错
Optional<String> emptyValue = Optional.of(null)

present and get

//如果值存在返回true，否则返回false
Optional<String> name = Optional.of("test");
if(name.isPresent()) 
//如果Optional有值则将其返回，否则抛出NoSuchElementException
name.get(); //如果存在，则通过get取值

ifPresent and orElse

如果Optional实例有值则为其调用consumer，否则不做处理
Consumer类包含一个抽象方法。该抽象方法对传入的值进行处理，但没有返回值。Java8支持不用接口直接通过lambda表达式传入参数

name.ifPresent((value) -> System.out.println(value.length))

//如果有值则将其返回，否则返回指定的其它值。
//如果Optional实例有值则将其返回，否则返回orElse方法传入的参数
//if name == null 
//print "There is no value present!"
System.out.println(empty.orElse("There is no value present!"))
//if name != null
//print "test"
System.out.println(name.orElse("There is some value!"));

orElseGet

orElseGet与orElse方法类似，区别在于得到的默认值。orElse方法将传入的字符串作为默认值，orElseGet方法可以接受Supplier接口的实现用来生成默认值

//orElseGet可以接受一个lambda表达式生成默认值
//if name == null
//print "Default Value"
System.out.println(empty.orElseGet(() -> "Default Value"));
//if name != null
//print "test"
System.out.println(name.orElseGet(() -> "Default Value"));

orElseThrow

如果有值则将其返回，否则抛出supplier接口创建的异常
在orElseGet方法中，我们传入一个Supplier接口。然而，在orElseThrow中我们可以传入一个lambda表达式或方法，如果值不存在来抛出异常

//if name == null 抛出异常
name.orElseThrow(CustomerException::new);

map

如果有值，则对其执行调用mapping函数得到返回值。如果返回值不为null，则创建包含mapping返回值的Optional作为map方法返回值，否则返回空Optional

1.map方法执行传入的lambda表达式参数对Optional实例的值进行修改
2.为lambda表达式的返回值创建新的Optional实例作为map方法的返回值。

//test -> TEST
Optional<String> upperName = name.map((value) -> value.toUpperCase());
System.out.println(upperName.orElse("No value found"));

flatMap

如果有值，为其执行mapping函数返回Optional类型返回值，否则返回空Optional。flatMap与map（Funtion）方法类似，区别在于flatMap中的mapper返回值必须是Optional。调用结束时，flatMap不会对结果用Optional封装

flatMap方法与map方法类似，区别在于mapping函数的返回值不同。map方法的mapping函数返回值可以是任何类型T，而flatMap方法的mapping函数必须是Optional

1.flatMap与map（Function）非常类似，区别在于传入方法的lambda表达式的返回类型
2.map方法中的lambda表达式返回值可以是任意类型，在map函数返回之前会包装为Optional
3.但flatMap方法中的lambda表达式返回值必须是Optionl实例

Optional<String> upperName = name.flatMap((value) -> Optional.of(value.toUpperCase()))

filter

filter个方法通过传入限定条件对Optional实例的值进行过滤
如果有值并且满足断言条件返回包含该值的Optional，否则返回空Optional

1.filter方法检查给定的Option值是否满足某些条件

//如果满足则返回同一个Option实例，否则返回空Optional
Optional<String> longName = name.filter((value) -> value.length() > 3);

//另一个例子是Optional值不满足filter指定的条件
Optional<String> anotherName = Optional.of("a");
Optional<String> shortName = anotherName.filter((value) -> value.length() > 3);

---

其他API

T   or(T) 
T   orNull()
Set<T>  asSet()
//这些方法主要用来与混淆null/空的API进行交互
emptyToNull(String)
nullToEmpty(String) 
isNullOrEmpty(String) 
Optional.of(first).or(second) //用一个默认值来替换可能的null