《安卓-深入淺出MVVM教程》應(yīng)用篇-04 State Lcee （加載/空/錯(cuò)誤/內(nèi)容視圖）

簡(jiǎn)介

背景

這幾年 MVP 架構(gòu)在安卓界非常流行，幾乎已經(jīng)成為主流框架，它讓業(yè)務(wù)邏輯和 UI操作相對(duì)獨(dú)立，使得代碼結(jié)構(gòu)更清晰。

MVVM 在前端火得一塌糊涂，而在安卓這邊卻基本沒見到幾個(gè)人在用，看到介紹 MVVM 也最多是講 DataBinding 或介紹思想的。偶爾看到幾篇提到應(yīng)用的，還是對(duì)谷歌官網(wǎng)的Architecture Components 文章的翻譯。

相信大家看別人博客或官方文檔的時(shí)候，總會(huì)碰到一些坑。要么入門教程寫得太復(fù)雜（無(wú)力吐槽，前面寫一堆原理，各種高大上的圖，然并卵，到實(shí)踐部分一筆帶過，你確定真的是入門教程嗎）。要么就是簡(jiǎn)單得就是一個(gè) hello world，然后就沒有下文了（看了想罵人）。

實(shí)在看不下去的我，決定插手你的人生。

01 Hello MVVM (快速入門)
02 Repository （數(shù)據(jù)倉(cāng)庫(kù)）
03 Cache （本地緩存）
04 State Lcee （加載/空/錯(cuò)誤/內(nèi)容視圖）
05 Simple Data Source （簡(jiǎn)單的數(shù)據(jù)源）
06 Load More （加載更多）
07 DataBinding （數(shù)據(jù)與視圖綁定）
08 RxJava2
09 Dragger2
10 Abstract （抽象）
11 Demo （例子）
12-n 待定（歡迎 github 提建議）

原理篇

01 MyLiveData（最簡(jiǎn)單的LiveData）
02-n 待定（并不是解讀源碼，那樣太無(wú)聊了，打算帶你從0擼一個(gè) Architecture）

關(guān)于提問

本人水平和精力有限，如果有大佬發(fā)現(xiàn)哪里寫錯(cuò)了或有好的建議，歡迎在本教程附帶的 github倉(cāng)庫(kù) 提issue。
What？為什么不在博客留言？考慮到國(guó)內(nèi)轉(zhuǎn)載基本無(wú)視版權(quán)的情況，一般來(lái)說(shuō)你都不是在源出處看到這篇文章，所以留言我也一般是看不到的。

教程附帶代碼

https://github.com/ittianyu/MVVM

應(yīng)用篇放在 app 模塊下，原理篇放在 implementation 模塊下。
每一節(jié)代碼采用不同包名，相互獨(dú)立。

前言

上一節(jié)我們加入了緩存。這一節(jié)我來(lái)回答上一次的問題。

重新請(qǐng)求數(shù)據(jù)

下拉刷新或者重發(fā)請(qǐng)求是常見的需求。
怎么在 MVVM 中實(shí)現(xiàn)呢？

其實(shí)第一節(jié)就有提到，LiveData 直接調(diào)用 setValue 或 PostValue 就會(huì)觸發(fā)一次數(shù)據(jù)更新操作。

為了使得 username 可以改變，我們要把他定義為一個(gè)可變的 LiveData。
那么我們?cè)趺丛?username 改變的時(shí)候去更新 user 呢？

我們可以通過 Transformations.switchMap 來(lái)生成一個(gè)監(jiān)聽 username 的 LiveData

public class UserViewModel extends ViewModel {
    private UserRepository userRepository = UserRepository.getInstance();
    private MutableLiveData<String> ldUsername;
    private LiveData<User> ldUser;

    public LiveData<User> getUser() {
        if (null == ldUser) {
            ldUsername = new MutableLiveData<>();
            ldUser = Transformations.switchMap(ldUsername, new Function<String, LiveData<User>>() {
                @Override
                public LiveData<User> apply(String username) {
                    return userRepository.getUser(username);
                }
            });
        }
        return ldUser;
    }

    public void reload(String username) {
        ldUsername.setValue(username);
    }

}

當(dāng)需要請(qǐng)求數(shù)據(jù)的時(shí)候，View 中調(diào)用 reload 方法即可觸發(fā)。
這里不再往下講了，因?yàn)檫€要加入多狀態(tài)。

多狀態(tài)視圖

最常見的狀態(tài)是 Loading Content Empty Error

Bean

所以首先想到的是定義枚舉類型

public enum Status {
    Loading,
    Content,
    Empty,
    Error,
}

有了類型該怎么使用？
作為 MVVM 架構(gòu)，核心思想是根據(jù) Data 渲染 View，所以很自然想到根據(jù)狀態(tài)和數(shù)據(jù)來(lái)渲染 View。然而狀態(tài)和數(shù)據(jù)是難以分離的，所以一般會(huì)想到通過一個(gè) bean 來(lái)把數(shù)據(jù)和狀態(tài)包裝起來(lái)。

public class Lcee<T> {
    public final Status status;
    public final T data;
    public final Throwable error;

    public Lcee(Status status, T data, Throwable error) {
        this.status = status;
        this.data = data;
        this.error = error;
    }
}

為了方便外部使用，我們?cè)俣x一些工廠方法。

    public static <T> Lcee<T> content(T data) {
        return new Lcee<>(Status.Content, data, null);
    }

    public static <T> Lcee<T> error(T data, Throwable error) {
        return new Lcee<>(Status.Error, data, error);
    }
    public static <T> Lcee<T> error(Throwable error) {
        return error(null, error);
    }

    public static <T> Lcee<T> empty(T data) {
        return new Lcee<>(Status.Empty, data, null);
    }
    public static <T> Lcee<T> empty() {
        return empty(null);
    }

    public static <T> Lcee<T> loading(T data) {
        return new Lcee<>(Status.Loading, data, null);
    }
    public static <T> Lcee<T> loading() {
        return loading(null);
    }

Model

DataSource
因?yàn)?bean 變了，所以 DataSource 和實(shí)現(xiàn)都得修改。

先把接口的返回值改成 LiveData<Lcee<User>>

public interface UserDataSource {
    LiveData<Lcee<User>> queryUserByUsername(String username);
}

UserRepository
UserRepository 里面的返回值也要改

public LiveData<Lcee<User>> getUser(String username) {
...
}

LocalUserDataSource

然后先改本地?cái)?shù)據(jù)源 LocalUserDataSource
這里出現(xiàn)了一個(gè) MediatorLiveData，這是什么鬼？
它也是一個(gè) LiveData，不過可以添加多個(gè)數(shù)據(jù)源
我沒聽錯(cuò)吧？他自己不是數(shù)據(jù)源嗎？
是的，他可以觀察其他數(shù)據(jù)。

因?yàn)檫@樣，我們就可以實(shí)現(xiàn) LiveData<User> 轉(zhuǎn)換為 LiveData<Lcee<User>>

@Override
public LiveData<Lcee<User>> queryUserByUsername(String username) {
    final MediatorLiveData<Lcee<User>> data = new MediatorLiveData<>();
    data.setValue(Lcee.<User>loading());

    data.addSource(userService.queryByUsername(username), new Observer<User>() {
        @Override
        public void onChanged(@Nullable User user) {
            if (null == user) {
                data.setValue(Lcee.<User>empty());
            } else {
                data.setValue(Lcee.content(user));
            }
        }
    });
    return data;
}

RemoteUserDataSource

而遠(yuǎn)程數(shù)據(jù)源就不用轉(zhuǎn)換了，只需要修改一下 LiveData 的類型。

@Override
public LiveData<Lcee<User>> queryUserByUsername(String username) {
    final MutableLiveData<Lcee<User>> data = new MutableLiveData<>();
    data.setValue(Lcee.<User>loading());

    userApi.queryUserByUsername(username)
            .enqueue(new Callback<User>() {
                @Override
                public void onResponse(Call<User> call, Response<User> response) {
                    User user = response.body();
                    if (null == user) {
                        data.setValue(Lcee.<User>empty());
                        return;
                    }
                    data.setValue(Lcee.content(user));
                    // update cache
                    LocalUserDataSource.getInstance().addUser(user);
                }

                @Override
                public void onFailure(Call<User> call, Throwable t) {
                    t.printStackTrace();
                    data.setValue(Lcee.<User>error(t));
                }
            });
    return data;
}

ViewModel

因?yàn)閿?shù)據(jù)變了，ViewModel 也得做小修改，實(shí)際上就是改了返回值

public LiveData<Lcee<User>> getUser() {
...
}

View

View 要根據(jù)數(shù)據(jù)渲染，現(xiàn)在數(shù)據(jù)改了， View 自然也要改。

重新請(qǐng)求數(shù)據(jù)

為了可以實(shí)現(xiàn)輸入用戶名然后進(jìn)行重新請(qǐng)求數(shù)據(jù)，我們得不得加入編輯框和按鈕，其實(shí)就是左邊輸入框，右邊按鈕

<LinearLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:gravity="center_vertical"
    android:orientation="horizontal">

    <EditText
        android:id="@+id/et_username"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:imeOptions="actionSearch"
        android:singleLine = "true"
        android:text="ittianyu" />

    <Button
        android:id="@+id/btn_search"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="search" />

</LinearLayout>

相應(yīng)的，在 Activity 中初始化

etUsername = (EditText) findViewById(R.id.et_username);

為了方便取值，定義一個(gè)方法

private String getUsername() {
    return etUsername.getText().toString();
}

還記得一開始說(shuō)的，重新請(qǐng)求數(shù)據(jù)嗎，現(xiàn)在可以調(diào)用這樣一個(gè)方法就實(shí)現(xiàn)重新請(qǐng)求數(shù)據(jù)了。

private void reload() {
    // reload
    userViewModel.reload(getUsername());
}

多狀態(tài)視圖

XML
為了顯示4種狀態(tài)視圖，我們需要先定義
把狀態(tài)視圖整合到一起后就是這樣的。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center_vertical"
        android:orientation="horizontal">

        <EditText
            android:id="@+id/et_username"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:imeOptions="actionSearch"
            android:singleLine = "true"
            android:text="ittianyu" />

        <Button
            android:id="@+id/btn_search"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="search" />

    </LinearLayout>

    <FrameLayout
        android:id="@+id/v_root"
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <LinearLayout
            android:id="@+id/v_content"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:gravity="center"
            android:orientation="vertical">

            <TextView
                android:id="@+id/tv_id"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:gravity="center" />

            <TextView
                android:id="@+id/tv_name"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:gravity="center" />

        </LinearLayout>

        <FrameLayout
            android:id="@+id/v_error"
            android:layout_width="match_parent"
            android:layout_height="match_parent">

            <TextView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:layout_gravity="center"
                android:gravity="center"
                android:text="Network error, click to reload" />

        </FrameLayout>

        <FrameLayout
            android:id="@+id/v_empty"
            android:layout_width="match_parent"
            android:layout_height="match_parent">

            <TextView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:layout_gravity="center"
                android:gravity="center"
                android:text="User not exist" />

        </FrameLayout>

        <FrameLayout
            android:id="@+id/v_loading"
            android:layout_width="match_parent"
            android:layout_height="match_parent">

            <ProgressBar
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_gravity="center" />

        </FrameLayout>

    </FrameLayout>
</LinearLayout>

初始化View
然后記得初始化

vContent = findViewById(R.id.v_content);
vError = findViewById(R.id.v_error);
vLoading = findViewById(R.id.v_loading);
vEmpty = findViewById(R.id.v_empty);

修改觀察的數(shù)據(jù)類型
這里也要修改觀察的數(shù)據(jù)類型

private void initData() {
...
    userViewModel.getUser().observe(this, new Observer<Lcee<User>>() {
        @Override
        public void onChanged(@Nullable Lcee<User> data) {
            updateView(data);
        }
    });

    reload();
}

響應(yīng)事件
具體怎么渲染的等下再說(shuō)，我們還需要處理一些用戶點(diǎn)擊事件。

用戶點(diǎn)擊錯(cuò)誤/空視圖后，觸發(fā)重新加載。
點(diǎn)擊搜索按鈕/鍵盤回車后，隱藏鍵盤，觸發(fā)重新加載

private void initEvent() {
    View.OnClickListener reloadClickListener = new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            hideKeyboard();
            reload();
        }
    };
    vError.setOnClickListener(reloadClickListener);
    vEmpty.setOnClickListener(reloadClickListener);

    findViewById(R.id.btn_search).setOnClickListener(reloadClickListener);

    etUsername.setOnKeyListener(new View.OnKeyListener() {
        @Override
        public boolean onKey(View v, int keyCode, KeyEvent event) {
            if (keyCode == KeyEvent.KEYCODE_ENTER) {
                hideKeyboard();
                reload();
                return true;
            }
            return false;
        }
    });
}

private void hideKeyboard() {
    ((InputMethodManager) getSystemService(INPUT_METHOD_SERVICE))
            .hideSoftInputFromWindow(UserActivity.this.getCurrentFocus().getWindowToken(),
                    InputMethodManager.HIDE_NOT_ALWAYS);
}

渲染
接下來(lái)就是重點(diǎn)，渲染 view
根據(jù)四種狀態(tài)去渲染

private void updateView(Lcee<User> lcee) {
    switch (lcee.status) {
        case Content: {
            showContent();
            tvId.setText(lcee.data.getId() + "");
            tvName.setText(lcee.data.getName());
            break;
        }
        case Empty: {
            showEmpty();
            break;
        }
        case Error: {
            showError();
            break;
        }
        case Loading: {
            showLoading();
            break;
        }
    }
}

同時(shí)為了方便調(diào)用，我們封裝 4 個(gè)方法來(lái)切換 4 種視圖

private void showContent() {
    vContent.setVisibility(View.VISIBLE);
    vEmpty.setVisibility(View.GONE);
    vError.setVisibility(View.GONE);
    vLoading.setVisibility(View.GONE);
}

private void showEmpty() {
    vContent.setVisibility(View.GONE);
    vEmpty.setVisibility(View.VISIBLE);
    vError.setVisibility(View.GONE);
    vLoading.setVisibility(View.GONE);
}

private void showError() {
    vContent.setVisibility(View.GONE);
    vEmpty.setVisibility(View.GONE);
    vError.setVisibility(View.VISIBLE);
    vLoading.setVisibility(View.GONE);
}

private void showLoading() {
    vContent.setVisibility(View.GONE);
    vEmpty.setVisibility(View.GONE);
    vError.setVisibility(View.GONE);
    vLoading.setVisibility(View.VISIBLE);
}

總結(jié)

到此為止，我們解決了一大難題。
What？你已經(jīng)掌握 MVVM 了？

不存在的.jpg

好戲才剛剛開始

最后編輯于：2017.12.11 05:17:31

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

人面猴
序言：七十年代末，一起剝皮案震驚了整個(gè)濱河市，隨后出現(xiàn)的幾起案子，更是在濱河造成了極大的恐慌，老刑警劉巖，帶你破解...
沈念sama閱讀 228,030評(píng)論 6贊 531
死咒
序言：濱河連續(xù)發(fā)生了三起死亡事件，死亡現(xiàn)場(chǎng)離奇詭異，居然都是意外死亡，警方通過查閱死者的電腦和手機(jī)，發(fā)現(xiàn)死者居然都...
沈念sama閱讀 98,310評(píng)論 3贊 415
救了他兩次的神仙讓他今天三更去死
文/潘曉璐我一進(jìn)店門，熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)，“玉大人，你說(shuō)我怎么就攤上這事?！?“怎么了？”我有些...
開封第一講書人閱讀 175,951評(píng)論 0贊 373
道士緝兇錄：失蹤的賣姜人
文/不壞的土叔我叫張陵，是天一觀的道長(zhǎng)。經(jīng)常有香客問我，道長(zhǎng)，這世上最難降的妖魔是什么？我笑而不...
開封第一講書人閱讀 62,796評(píng)論 1贊 309
?港島之戀（遺憾婚禮）
正文為了忘掉前任，我火速辦了婚禮，結(jié)果婚禮上，老公的妹妹穿的比我還像新娘。我一直安慰自己，他們只是感情好，可當(dāng)我...
茶點(diǎn)故事閱讀 71,566評(píng)論 6贊 407
惡毒庶女頂嫁案：這布局不是一般人想出來(lái)的
文/花漫我一把揭開白布。她就那樣靜靜地躺著，像睡著了一般。火紅的嫁衣襯著肌膚如雪。梳的紋絲不亂的頭發(fā)上，一...
開封第一講書人閱讀 55,055評(píng)論 1贊 322
城市分裂傳說(shuō)
那天，我揣著相機(jī)與錄音，去河邊找鬼。笑死，一個(gè)胖子當(dāng)著我的面吹牛，可吹牛的內(nèi)容都是我干的。我是一名探鬼主播，決...
沈念sama閱讀 43,142評(píng)論 3贊 440
雙鴛鴦連環(huán)套：你想象不到人心有多黑
文/蒼蘭香墨我猛地睜開眼，長(zhǎng)吁一口氣：“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼！你這毒婦竟也來(lái)了？” 一聲冷哼從身側(cè)響起，我...
開封第一講書人閱讀 42,303評(píng)論 0贊 288
萬(wàn)榮殺人案實(shí)錄
序言：老撾萬(wàn)榮一對(duì)情侶失蹤，失蹤者是張志新（化名）和其女友劉穎，沒想到半個(gè)月后，有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體，經(jīng)...
沈念sama閱讀 48,799評(píng)論 1贊 333
?護(hù)林員之死
正文獨(dú)居荒郊野嶺守林人離奇死亡，尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛以下內(nèi)容為張勛視角年9月15日...
茶點(diǎn)故事閱讀 40,683評(píng)論 3贊 354
?白月光啟示錄
正文我和宋清朗相戀三年，在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
茶點(diǎn)故事閱讀 42,899評(píng)論 1贊 369
活死人
序言：一個(gè)原本活蹦亂跳的男人離奇死亡，死狀恐怖，靈堂內(nèi)的尸體忽然破棺而出，到底是詐尸還是另有隱情，我是刑警寧澤，帶...
沈念sama閱讀 38,409評(píng)論 5贊 358
?日本核電站爆炸內(nèi)幕
正文年R本政府宣布，位于F島的核電站，受9級(jí)特大地震影響，放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜，卻給世界環(huán)境...
茶點(diǎn)故事閱讀 44,135評(píng)論 3贊 347
男人毒藥：我在死后第九天來(lái)索命
文/蒙蒙一、第九天我趴在偏房一處隱蔽的房頂上張望。院中可真熱鬧，春花似錦、人聲如沸。這莊子的主人今日做“春日...
開封第一講書人閱讀 34,520評(píng)論 0贊 26
一樁弒父案，背后竟有這般陰謀
文/蒼蘭香墨我抬頭看了看天上的太陽(yáng)。三九已至，卻和暖如春，著一層夾襖步出監(jiān)牢的瞬間，已是汗流浹背。一陣腳步聲響...
開封第一講書人閱讀 35,757評(píng)論 1贊 282
情欲美人皮
我被黑心中介騙來(lái)泰國(guó)打工，沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留，地道東北人。一個(gè)月前我還...
沈念sama閱讀 51,528評(píng)論 3贊 390
代替公主和親
正文我出身青樓，卻偏偏與公主長(zhǎng)得像，于是被迫代替她去往敵國(guó)和親。傳聞我的和親對(duì)象是個(gè)殘疾皇子，可洞房花燭夜當(dāng)晚...
茶點(diǎn)故事閱讀 47,844評(píng)論 2贊 372

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频

《安卓-深入淺出MVVM教程》應(yīng)用篇-04 State Lcee （加載/空/錯(cuò)誤/內(nèi)容視圖）

《安卓-深入淺出MVVM教程》應(yīng)用篇-04 State Lcee （加載/空/錯(cuò)誤/內(nèi)容視圖）

簡(jiǎn)介

背景

目錄

應(yīng)用篇：

原理篇

關(guān)于提問

教程附帶代碼

前言

重新請(qǐng)求數(shù)據(jù)

多狀態(tài)視圖

Bean

Model

ViewModel

View

重新請(qǐng)求數(shù)據(jù)

多狀態(tài)視圖

總結(jié)

推薦閱讀更多精彩內(nèi)容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美 国产 综合 欧美 视频

《安卓-深入淺出MVVM教程》應(yīng)用篇-04 State Lcee （加載/空/錯(cuò)誤/內(nèi)容視圖）

簡(jiǎn)介

背景

目錄

應(yīng)用篇：

原理篇

關(guān)于提問

教程附帶代碼

前言

重新請(qǐng)求數(shù)據(jù)

多狀態(tài)視圖

Bean

Model

ViewModel

View

重新請(qǐng)求數(shù)據(jù)

多狀態(tài)視圖

總結(jié)

推薦閱讀更多精彩內(nèi)容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频