Java bean 鏈式獲取成員變數無需判空的工具設計

Soochow發表於2020-10-14

Java bean 鏈式獲取成員變數無需判空的工具設計

對於Java程式設計師來說,null是令人頭痛的東西。時常會受到空指標異常(NPE)的騷擾。連Java的發明者都承認這是他的一項巨大失誤。
那麼,有什麼辦法可以避免在程式碼中寫大量的判空語句呢?
有人說可以使用 JDK8提供的 Optional 來避免判空,但在巢狀比較深的物件中,需要不斷地判空,用起來還是有些麻煩。

本篇博文設計了一種可以鏈式呼叫物件成員而無需判空的工具,相比原有的if null邏輯 和 JDK8提供的 Optional 更加優雅易用,在工程實踐中大大提高了編碼效率,也讓程式碼更加的精準和優雅。

不優雅的判空呼叫

我想從事Java開發的小夥伴肯定有遇到過下面這種讓人難受的判空邏輯:
現在有一個User類,School 是它的成員變數

/**
* @author Axin
* @since 2020-09-20
* @summary 一個User類定義
 * (Ps:Data 是lombok元件提供的註解,簡化了get set等等的約定程式碼)
*/
@Data
public class User {

    private String name;

    private String gender;

    private School school;

    @Data
    public static class School {

        private String scName;

        private String adress;
    }
}

現在想要獲得School的成員變數 adress , 一般的處理方式:

public static void main(String[] args) {

    User axin = new User();
    User.School school = new User.School();
    axin.setName("hello");

    if (Objects.nonNull(axin) && Objects.nonNull(axin.getSchool())) {
        User.School userSc = axin.getSchool();
        System.out.println(userSc.getAdress());
    }
}

獲取adress時要對School進行判空,雖然有些麻煩,到也能用,通過 JDK8 提供的 Optional 工具也是可以,但還是有些麻煩。

而下文的 OptionalBean 提供一種可以鏈式不斷地呼叫成員變數而無需判空的方法,直接鏈式呼叫到你想要獲取的目標變數,而無需擔心空指標的問題。

鏈式呼叫成員變數

如果用了本文設計的工具 OptionalBean ,那麼上述的呼叫可以簡化成這樣:

public static void main(String[] args) {

    User axin = new User();
    User.School school = new User.School();
    axin.setName("hello");

    // 1. 基本呼叫
    String value1 = OptionalBean.ofNullable(axin)
            .getBean(User::getSchool)
            .getBean(User.School::getAdress).get();
    System.out.println(value1);
}

執行結果:

image

其中User的school變數為空,可以看到程式碼並沒有空指標,而是返回了null。這個工具怎麼實現的呢?

OptionalBean 工具

/**
* @author Axin
* @since 2020-09-10
* @summary 鏈式呼叫 bean 中 value 的方法
*/
public final class OptionalBean<T> {

    private static final OptionalBean<?> EMPTY = new OptionalBean<>();

    private final T value;

    private OptionalBean() {
        this.value = null;
    }

    /**
     * 空值會丟擲空指標
     * @param value
     */
    private OptionalBean(T value) {
        this.value = Objects.requireNonNull(value);
    }

    /**
     * 包裝一個不能為空的 bean
     * @param value
     * @param <T>
     * @return
     */
    public static <T> OptionalBean<T> of(T value) {
        return new OptionalBean<>(value);
    }

    /**
     * 包裝一個可能為空的 bean
     * @param value
     * @param <T>
     * @return
     */
    public static <T> OptionalBean<T> ofNullable(T value) {
        return value == null ? empty() : of(value);
    }

    /**
     * 取出具體的值
     * @param fn
     * @param <R>
     * @return
     */
    public T get() {
        return Objects.isNull(value) ? null : value;
    }

    /**
     * 取出一個可能為空的物件
     * @param fn
     * @param <R>
     * @return
     */
    public <R> OptionalBean<R> getBean(Function<? super T, ? extends R> fn) {
        return Objects.isNull(value) ? OptionalBean.empty() : OptionalBean.ofNullable(fn.apply(value));
    }

    /**
     * 如果目標值為空 獲取一個預設值
     * @param other
     * @return
     */
    public T orElse(T other) {
        return value != null ? value : other;
    }

    /**
     * 如果目標值為空 通過lambda表示式獲取一個值
     * @param other
     * @return
     */
    public T orElseGet(Supplier<? extends T> other) {
        return value != null ? value : other.get();
    }

    /**
     * 如果目標值為空 丟擲一個異常
     * @param exceptionSupplier
     * @param <X>
     * @return
     * @throws X
     */
    public <X extends Throwable> T orElseThrow(Supplier<? extends X> exceptionSupplier) throws X {
        if (value != null) {
            return value;
        } else {
            throw exceptionSupplier.get();
        }
    }

    public boolean isPresent() {
        return value != null;
    }

    public void ifPresent(Consumer<? super T> consumer) {
        if (value != null)
            consumer.accept(value);
    }

    @Override
    public int hashCode() {
        return Objects.hashCode(value);
    }

    /**
     * 空值常量
     * @param <T>
     * @return
     */
    public static<T> OptionalBean<T> empty() {
        @SuppressWarnings("unchecked")
        OptionalBean<T> none = (OptionalBean<T>) EMPTY;
        return none;
    }

}

工具設計主要參考了 Optional 的實現,再加上對鏈式呼叫的擴充套件就是上述的OptionalBean。

getBean 其實是當變數為空時返回了一個 包裝空值的 OptionalBean 物件,同時泛型的使用讓工具更加易用。

使用手冊

可以看到程式碼中也提供了和 Optional 一樣的擴充套件方法,如 ifPresent()、orElse()等等:

public static void main(String[] args) {

    User axin = new User();
    User.School school = new User.School();
    axin.setName("hello");

    // 1. 基本呼叫
    String value1 = OptionalBean.ofNullable(axin)
            .getBean(User::getSchool)
            .getBean(User.School::getAdress).get();
    System.out.println(value1);

    // 2. 擴充套件的 isPresent方法 用法與 Optional 一樣
    boolean present = OptionalBean.ofNullable(axin)
            .getBean(User::getSchool)
            .getBean(User.School::getAdress).isPresent();
    System.out.println(present);


    // 3. 擴充套件的 ifPresent 方法
    OptionalBean.ofNullable(axin)
            .getBean(User::getSchool)
            .getBean(User.School::getAdress)
            .ifPresent(adress -> System.out.println(String.format("地址存在:%s", adress)));

    // 4. 擴充套件的 orElse
    String value2 = OptionalBean.ofNullable(axin)
            .getBean(User::getSchool)
            .getBean(User.School::getAdress).orElse("家裡蹲");

    System.out.println(value2);

    // 5. 擴充套件的 orElseThrow
    try {
        String value3 = OptionalBean.ofNullable(axin)
                .getBean(User::getSchool)
                .getBean(User.School::getAdress).orElseThrow(() -> new RuntimeException("空指標了"));
    } catch (Exception e) {
        System.out.println(e.getMessage());
    }
}

run一下:

image

總結

設計了一種可以鏈式呼叫物件成員而無需判空的工具讓程式碼更加的精準和優雅,如果本文設計的工具滿足了剛好解決你的困擾,那就在專案中使用吧!

博主個人水平有限,如果有更的設計或者文中有錯誤,還請留言一起討論,互相進步!

相關文章