Java 8 中使用 Optional 处理 null 对象

Java 8 中使用 Optional 处理 null 对象

文章目录

  !版权声明:本博客内容均为原创,每篇博文作为知识积累,写博不易,转载请注明出处。


系统环境:

  • Java JDK 版本:1.8

参考地址:

一、Optional 简介

Optional 是一个容器对象,可以存储对象、字符串等值,当然也可以存储 null 值。Optional 提供很多有用的方法,能帮助我们将 Java 中的对象等一些值存入其中,这样我们就不用显式进行空值检测,使我们能够用少量的代码完成复杂的流程。

比如它提供了:

  • of() 方法,可以将值存入 Optional 容器中,如果存入的值是 null 则抛异常。
  • ofNullable() 方法,可以将值存入 Optional 容器中,即使值是 null 也不会抛异常。
  • get() 方法,可以获取容器中的值,如果值为 null 则抛出异常。
  • getElse() 方法,可以获取容器中的值,如果值为 null 则返回设置的默认值。
  • isPresent() 方法,该方法可以判断存入的值是否为空。
  • ...等等一些其它常用方法,下面会进行介绍。

可以说,使用 Optional 可以帮助我们解决业务中,减少值动不动就抛出空指针异常问题,也减少 null 值的判断,提高代码可读性等,这里我们介绍下,如果使用这个 Optional 类。

二、Optional 类描述

  • Optional 类所在包: java.util.Optional
  • Optional 类声明: public final class Optional extends Object
  • Optional 类方法:
public Optional filter(Predicate<? super T> predicate)
方法名称 修饰符、返回类型 方法描述
empty() static <T> Optional<T> 方法描述
equals(Object obj) boolean 判断其他对象是否等于 Optional。
filter(Predicate<? super T> predicate) Optional<T> 如果有值并且满足断言条件返回包含该值的 Optional,否则返回空 Optional。
get() T 如果在这个 Optional 中包含这个值则返回值,否则抛出 NoSuchElementException 异常。
hashCode() int 返回存在值的哈希码,如果值不存在则返回 0。
ifPresent(Consumer<? super T> consumer) void 如果值存在则使用该值调用 consumer , 否则不做任何事情。
isPresent() boolean 如果值存在则方法会返回 true,否则返回 false。
flatMap(Function<? super T,Optional<U>> mapper) <U>Optional<U> 如果值存在,返回基于 Optional 包含的映射方法的值,否则返回一个空的 Optional。
map(Function<? super T,? extends U> mapper) <U>Optional<U> 如果有值,则对其执行调用映射函数得到返回值。如果返回值不为 null,则创建包含映射返回值的 Optional 作为 map 方法返回值,否则返回空 Optional。
of(T value) static <T> Optional<T> 返回一个指定非 null 值的 Optional。
ofNullable(T value) static <T> Optional 果为非空,返回 Optional 描述的指定值,否则返回空的 Optional。
orElse(T other) T 如果该值存在就直接返回, 否则返回指定的其它值。
orElseGet(Supplier<? extends T> other) T 如果该值存在就返回值,否则触发 other,并返回 other 调用的结果。
orElseThrow(Supplier<? extends X> exceptionSupplier) <X extends Throwable> T 如果存在该值,返回包含的值,否则抛出由 Supplier 继承的异常。
toString() String 返回一个 Optional 的非空字符串,用来调试。

三、Optional 常用方法及使用示例

1、静态方法 Optional.of()

  • 方法作用: 为指定的值创建一个指定非 null 值的 Optional。
  • 方法描述: of 方法通过工厂方法创建 Optional 实例,需要注意的是传入的参数不能为 null,否则抛出 NullPointerException。
  • 返回类型: Optional
  • 示例代码:

调用两个 Optional.of() 方法,一个传入正常参数,另一个传入 null 参数:

1public static void main(String[] args) {
2    // 传入正常值,正常返回一个 Optional 对象
3    Optional<String> optional1 = Optional.of("mydlq");
4    
5    // 传入参数为 null,抛出 NullPointerException.
6    Optional optional2 = Optional.of(null);
7}

运行代码,可以观察到控制台输出内容如下:

1Exception in thread "main" java.lang.NullPointerException
2	at java.util.Objects.requireNonNull(Objects.java:203)
3	at java.util.Optional.<init>(Optional.java:96)
4	at java.util.Optional.of(Optional.java:108)
5	at club.mydlq.OptionalExample.main(OptionalExample.java:12)

可以看到传入正常参数正常返回 Optional 对象,传入 null 参数返回 NullPointerException 异常。

2、静态方法 Optional.ofNullable()

  • 方法作用: 为指定的值创建一个 Optional 对象,如果指定的参数为 null,不抛出异常,直接则返回一个空的 Optional 对象。
  • 方法描述: ofNullable 方法是和 of 方式一样,都是用于创建 Optional 对象,只是传入的参数 null 时,会返回一个空的 Optional 对象,而不会抛出 NullPointerException 异常。
  • 返回类型: Optional
  • 示例代码:

调用 Optional.ofNullable() 方法,传入 null 参数:

1public static void main(String[] args) {
2    // 传入正常值,正常返回一个 Optional 对象
3    Optional<String> optional1 = Optional.ofNullable("mydlq");
4    
5    // 传入 null 参数,正常返回 Optional 对象
6    Optional optional2 = Optional.ofNullable(null);
7}

运行代码,可以观察到正常传入值和传入 null 值时,都没有抛出异常。

3、对象方法 isPresent()

  • 方法作用: 如果值存在则方法会返回 true,否则返回 false。
  • 方法描述: 该方法其实就是用于判断创建 Optional 时传入参数的值是否为空,实现代码就简单一行,即 value != null 所以如果不为空则返回 true,否则返回 false。
  • 返回类型: boolean
  • 示例代码:
1public static void main(String[] args) {
2    // 传入正常值,正常返回一个 Optional 对象,并使用 isPresent 方法
3    Optional optional1 = Optional.ofNullable("mydlq");
4    System.out.println("传入正常值返回:" + optional1.isPresent());
5
6    // 传入参数为 null 生成一个 Optional 对象,并使用 isPresent 方法
7    Optional optional2 = Optional.ofNullable(null);
8    System.out.println("传入 null 值返回:" + optional2.isPresent());
9}

运行代码,可以观察到控制台输出内容如下:

1传入正常值返回:true
2传入 null 值返回:false

可以看到传入正常参数时调用 Optional 对象的 isPresent 方法时返回 true,传入 null 参数返回 false。

4、对象方法 get()

  • 方法作用: 如果 Optional 有值则将其返回,否则抛出 NoSuchElementException 异常。
  • 方法描述: get 方法内部实现其实就是判断 Otpional 对象中的 value 属性是否为 null,如果是就抛出 NoSuchElementException 异常,否则返回这个 value 值。
  • 返回类型: T
  • 示例代码:
1public static void main(String[] args) {
2    // 传入正常值,正常返回一个 Optional 对象,并使用 get 方法获取值
3    Optional optional1 = Optional.ofNullable("mydlq");
4    System.out.println(optional1.get());
5
6    // 传入参数为 null 生成一个 Optional 对象,并使用 get 方法获取值
7    Optional optional2 = Optional.ofNullable(null);
8    System.out.println(optional2.get());
9}

运行代码,可以观察到控制台输出内容如下:

1传入正常参数:mydlq
2Exception in thread "main" java.util.NoSuchElementException: No value present
3	at java.util.Optional.get(Optional.java:135)
4	at club.mydlq.OptionalExample.main(OptionalExample.java:14)

可以观察到传入正常值的 Optional 调用 get 方法正常输出值,通过空的 optional 对象使用 get 方法获取值时,抛出 NoSuchElementException 异常:

5、对象方法 ifPresent()

  • 方法作用: 如果值存在则使用该值调用 consumer , 否则不做任何事情。
  • 方法描述: 该方法 ifPresent(Consumer<? super T> consumer) 中参数接收的是 Consumer 类,它包含一个接口方法 accept(),该方法能够对传入的值进行处理,但不会返回结果。这里传入参数可以传入 Lamdda 表达式或 Consumer 对象及实现 Consumer 接口的类的对象。
  • 返回类型: void
  • 示例代码:
 1public static void main(String[] args) {
 2    // 创建 Optional 对象,然后调用 Optional 对象的 ifPresent 方法,传入 Lambda 表达式
 3    Optional optional1 = Optional.ofNullable("mydlq1");
 4    optional1.ifPresent((value) -> System.out.println("Optional 的值为:" + value));
 5
 6    // 创建 Optional 对象,调用 Optional 对象的 ifPresent 方法,传入实现 Consumer 匿名内部类
 7    Optional optional2 = Optional.ofNullable("mydlq2");
 8    Consumer<String> consumer = new Consumer() {
 9        @Override
10        public void accept(Object value) {
11            System.out.println("Optional 的值为:" + value);
12        }
13    };
14    optional2.ifPresent(consumer);
15}

运行代码,可以观察到控制台输出内容如下:

1Optional 的值为:mydlq1
2Optional 的值为:mydlq2

可以观察到,调用 ifPresent 使用 lambda 或者内部匿名类方法,都是为了再执行 Optional 对象的 ifPresent 方法时,执行一段代码逻辑。

6、对象方法 orElse()

  • 方法作用: 如果该值存在就直接返回, 否则返回指定的其它值。
  • 方法描述: orElse 方法实现很简单,就是使用三目表达式对传入的参数值进行 null 验证,即 value != null ? value : other; 如果为 null 则返回 true,否则返回 false。
  • 返回类型: T
  • 示例代码:
 1public static void main(String[] args) {
 2    // 传入正常参数,获取一个 Optional 对象,并使用 orElse 方法设置默认值
 3    Optional optional1 = Optional.ofNullable("mydlq");
 4    Object object1 = optional1.orElse("默认值");
 5    System.out.println("如果值不为空:"+object1);
 6
 7    // 传入 null 参数,获取一个 Optional 对象,并使用 orElse 方法设置默认值
 8    Optional optional2 = Optional.ofNullable(null);
 9    Object object2 = optional2.orElse("默认值");
10    System.out.println("如果值为空:"+object2);
11}

运行代码,可以观察到控制台输出内容如下:

1如果值不为空:mydlq
2如果值为空:默认值

可以观察到,如果 Optional 的值为空,则返回 orElse() 方法设置的默认值,否则返回 Optional 中的值。

7、对象方法 orElseGet()

  • 方法作用: 如果该值存在就返回值,否则触发 other,并返回 other 调用的结果。
  • 方法描述: orElseGet 方法和 orElse 方法类似,都是在 Optional 值为空时,返回一个默认操作,只不过 orElse 返回的是默认值,而 orElseGet 是执行 lambda 表达式,然后返回 lambda 表达式执行后的结果。
  • 返回类型: T
  • 示例代码:
 1public static void main(String[] args) {
 2    // 传入正常参数,获取一个 Optional 对象,并使用 orElse 方法设置默认值
 3    Optional optional1 = Optional.ofNullable("mydlq");
 4    Object object1 = optional1.orElseGet(() -> {
 5        String defaultVal = "执行逻辑和生成的默认值";
 6        return defaultVal;
 7    });
 8    System.out.println("输出的值为:"+object1);
 9
10    // 传入 null 参数,获取一个 Optional 对象,并使用 orElse 方法设置默认值
11    Optional optional2 = Optional.ofNullable(null);
12    Object object2 = optional2.orElseGet(() -> {
13        String defaultVal = "执行逻辑和生成的默认值";
14        return defaultVal;
15    });
16    System.out.println("输出的值为:"+object2);
17}

运行代码,可以观察到控制台输出内容如下:

1输出的值为:mydlq
2输出的值为:执行逻辑和生成的默认值

可也观察到,当 Optional 值为不为空时正常返回带值的 Optional,如果 Optional 为空则返回 orElseGet 方法中 lambda 表达式执行后生成的值。

8、对象方法 orElseThrow()

  • 方法作用: 如果 Optional 存在该值,返回包含的值,否则抛出由 Supplier 继承的异常。
  • 方法描述: orElseThrow 方法其实就是判断创建 Optional 时传入的参数是否为 null,如果是非 null 则返回传入的值,否则抛出 异常。
  • 返回类型: T
  • 示例代码:
 1public static void main(String[] args) {
 2    // 传入正常参数,获取一个 Optional 对象,并使用 orElseThrow 方法
 3    try {
 4        Optional optional1 = Optional.ofNullable("mydlq");
 5        Object object1 = optional1.orElseThrow(() -> {
 6                    System.out.println("执行逻辑,然后抛出异常");
 7                    return new RuntimeException("抛出异常");
 8                }
 9        );
10        System.out.println("输出的值为:" + object1);
11    } catch (Throwable throwable) {
12        throwable.printStackTrace();
13    }
14    
15    // 传入 null 参数,获取一个 Optional 对象,并使用 orElseThrow 方法
16    try {
17        Optional optional2 = Optional.ofNullable(null);
18        Object object2 = optional2.orElseThrow(() -> {
19                    System.out.println("执行逻辑,然后抛出异常");
20                    return new RuntimeException("抛出异常");
21                }
22        );
23        System.out.println("输出的值为:" + object2);
24    } catch (Throwable throwable) {
25        throwable.printStackTrace();
26    }
27}

运行代码,可以观察到控制台输出内容如下:

1值为不为空输出的值:mydlq
2执行逻辑,然后抛出异常
3java.lang.RuntimeException: 抛出异常
4	at club.mydlq.OptionalExample.lambda$main$1(OptionalExample.java:25)
5	at java.util.Optional.orElseThrow(Optional.java:290)
6	at club.mydlq.OptionalExample.main(OptionalExample.java:23)

可以观察到,当创建 Optional 时如果传入的参数为空则执行 Lambda 表达式代码逻辑后抛出异常信息,否则返回传入的参数值。

9、对象方法 map()

  • 方法作用: 如果有值,则对其执行调用映射函数得到返回值。如果返回值不为 null,则创建包含映射返回值的 Optional 作为 map 方法返回值,否则返回空 Optional。
  • 方法描述: map 方法主要用于获取某个对象中的某个属性值的 Optional 对象时使用。map 方法调用时,首先验证传入的映射函数是否为空,如果为空则抛出异常。然后,再检测 Optional 的 value 是否为空,如果是,则返回一个空 value 的 Optional 对象。如果传入的映射函数和 Optinal 的 value 都不为空,则返回一个带 value 对象属性的 Optional 对象。
  • 返回类型: Optional<U>
  • 示例代码:

示例1: 创建 Map 集合,存储一些键值对信息,通过 Optional 操作 Map 获取值,然后观察:

 1public static void main(String[] args) {
 2    // 创建 map 对象
 3    Map<String, String> userMap = new HashMap<>();
 4    userMap.put("name1", "mydlq");
 5    userMap.put("name2", null);
 6
 7    // 传入 Map 对象参数,获取一个 Optional 对象,获取 name1 属性
 8    Optional<String> optional1 = Optional.of(userMap).map(value -> value.get("name1"));
 9
10    // 传入 Map 对象参数,获取一个 Optional 对象,获取 name2 属性
11    Optional<String> optional2 = Optional.of(userMap).map(value -> value.get("name2"));
12
13    // 获取 Optional 的值
14    System.out.println("获取的 name1 的值:" + optional1.orElse("默认值"));
15    System.out.println("获取的 name2 的值:" + optional2.orElse("默认值"));
16}

运行代码,可以观察到控制台输出内容如下:

1获取的 Optional 的值:mydlq
2获取的 Optional 的值:默认值

示例2: 创建一个用户类,使用 Optional 操作用户对象,获取其 name 参数,结合 Optional 的 map 方法获取值,进行观察:

 1public class User {
 2
 3    private String name;
 4    
 5    public User(String name) {
 6        this.name = name;
 7    }
 8
 9    public String getName() {
10        return name;
11    }
12    public void setName(String name) {
13        this.name = name;
14    }
15}

使用 Optional 的 map 方法对值处理:

 1public static void main(String[] args) {
 2    // 创建一个对象,设置姓名属性而不设置性别,这时候性别为 null
 3    User user1 = new User("测试名称");
 4    User user2 = new User();
 5
 6    // 使用 Optional 存储 User 对象
 7    Optional<User> optional1 = Optional.ofNullable(user1);
 8    Optional<User> optional2 = Optional.ofNullable(user2);
 9
10    // 获取对象的 name 属性值
11    String name1 = optional1.map(User::getName).orElse("未填写");
12    String name2 = optional2.map(User::getName).orElse("未填写");
13
14    // 输出结果
15    System.out.println("获取的名称:" + name1);
16    System.out.println("获取的名称:" + name2);
17}

运行代码,可以观察到控制台输出内容如下:

1获取的名称:测试名称
2获取的名称:未填写

总结:

通过上面两个示例观察到,通过 Optional 对象的 map 方法能够获取映射对象中的属,创建 Optional 对象,并以此属性充当 Optional 的值,结合 orElse 方法,如果获取的属性的值为空,则设置个默认值。

10、对象方法 flatMap()

  • 方法作用: 如果值存在,返回基于 Optional 包含的映射方法的值,否则返回一个空的 Optional。
  • 方法描述: flatMap 方法和 map 方法类似,唯一的不同点就是 map 方法会对返回的值进行 Optional 封装,而 flatMap 不会,它需要手动执行 Optional.of 或 Optional.ofNullable 方法对 Optional 值进行封装。
  • 返回类型: Optional<U>
  • 示例代码:
 1public static void main(String[] args) {
 2    // 创建 map 对象
 3    Map<String, String> userMap = new HashMap<>();
 4    userMap.put("name", "mydlq");
 5    userMap.put("sex", "男");
 6
 7    // 传入 Map 对象参数,获取一个 Optional 对象
 8    Optional<Map<String, String>> optional1 = Optional.of(userMap);
 9
10    // 使用 Optional 的 flatMap 方法,获取 Map 中的 name 属性
11    // 然后通过获取的值手动创建一个新的 Optional 对象
12    Optional optional2 = optional1.flatMap(value -> Optional.ofNullable(value.get("name")));
13
14    // 获取 Optional 的 value
15    System.out.println("获取的 Optional 的值:" + optional2.get());
16}

运行代码,可以观察到控制台输出内容如下:

1获取的 Optional 的值:mydlq

根据结果观察,可以看到 flatMap 和 map 方法没有什么区别,但是仔细看,代码中调用 flatMap 后,需要手动执行 of 或 ofNullable 方法创建了 Optional 对象。

11、对象方法 filter()

  • 方法作用: 如果有值并且满足断言条件返回包含该值的 Optional,否则返回空 Optional。
  • 方法描述: filter 方法通过传入的限定条件对 Optional 实例的值进行过滤,如果 Optional 值不为空且满足限定条件就返回包含值的 Optional,否则返回空的 Optional。这里设置的限定条件需要使用实现了 Predicate 接口的 lambda 表达式来进行配置。
  • 返回类型: Optional<T>
  • 示例代码:
 1public static void main(String[] args) {
 2    // 创建一个测试的 Optional 对象
 3    Optional<String> optional = Optional.ofNullable("mydlq");
 4    // 调用 Optional 的 filter 方法,设置一个满足的条件,然后观察获取的 Optional 对象值是否为空
 5    Optional optional1 =optional.filter((value) -> value.length() > 2);
 6    System.out.println("Optional 的值不为空::" + optional.isPresent());
 7
 8    // 调用 Optional 的 filter 方法,设置一个不满足的条件,然后观察获取的 Optional 对象值是否为空
 9    Optional optional2 =optional.filter((value) -> value.length() <2);
10    System.out.println("Optional 的值不为空::" + optional2.isPresent());
11}

运行代码,可以观察到控制台输出内容如下:

1Optional 的值不为空:true
2Optional 的值不为空:false

根据结果可以观察到,可以通过 filter 设置一个条件来判断 Optional 的值,如果满足条件就返回带值的 Optional,否则返回空的 Optional。

四、Optional 常用示例组合

在介绍一栏中已经说过 Optional 是个容器,它可用保存类型的 T 的值,即使 T 为 null 也可以使用 Optional 存储,这样我就不用显示进行空值检测,防止空指针异常。

上面也介绍了 Optional 的各种方法,在实际使用中这些方法常常组合使用。且很多方法也常与 Lambda 表达式结合,获取我们想要的结果的值。

下面是常用的示例,可以作为参考:

对集合中的对象属性进行过滤

创建一个 User 对象实体类,里面包含 name 属性:

 1public class User {
 2    private String name;
 3
 4    public User(String name) {
 5        this.name = name;
 6    }
 7
 8    public String getName() {
 9        return name;
10    }
11    public void setName(String name) {
12        this.name = name;
13    }
14}

创建一个使用 main 方法的类,创建几个 User 对象且设置不同的值,有的对象为 null 有的属性不设置,然后通过 Optional 获取 name 属性值加入集合,进行测试:

 1import java.util.ArrayList;
 2import java.util.List;
 3import java.util.Optional;
 4
 5public class OptionalExample {
 6
 7    /**
 8     * 测试的 main 方法
 9     */
10    public static void main(String[] args) {
11        // 创建一个测试的用户集合
12        List<User> userList = new ArrayList<>();
13
14        // 创建几个测试用户
15        User user1 = new User("abc");
16        User user2 = new User("efg");
17        User user3 = null;
18
19        // 将用户加入集合
20        userList.add(user1);
21        userList.add(user2);
22        userList.add(user3);
23
24        // 创建用于存储姓名的集合
25        List<String> nameList = new ArrayList();
26        // 循环用户列表获取用户信息,值获取不为空且用户以 a 开头的姓名,
27        // 如果不符合条件就设置默认值,最后将符合条件的用户姓名加入姓名集合
28        for (User user : userList) {
29            nameList.add(Optional.ofNullable(user).map(User::getName).filter(value -> value.startsWith("a")).orElse("未填写"));
30        }
31
32        // 输出名字集合中的值
33        System.out.println("通过 Optional 过滤的集合输出:");
34        nameList.stream().forEach(System.out::println);
35    }
36
37}

输出运行结果:

1通过 Optional 过滤的集合输出:
2abc
3未填写
4未填写

通过上面,可以观察到,使用 Optional 有时候可以很方便的过滤一些属性,而且它的方法可以通过链式调用,方法间相互组合使用,使我们用少量的代码就能完成复杂的逻辑。

---END---


  !版权声明:本博客内容均为原创,每篇博文作为知识积累,写博不易,转载请注明出处。