《安卓-深入淺出MVVM教程》應用篇-01Hello MVVM (快速入門)

簡介

背景

這幾年 MVP 架構在安卓界非常流行,幾乎已經成為主流框架,它讓業務邏輯 和 UI操作相對獨立,使得代碼結構更清晰。


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

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


實在看不下去的我,決定插手你的人生。

目錄

《安卓-深入淺出MVVM教程》大致分兩部分:應用篇、原理篇。
采用循序漸進方式,內容深入淺出,符合人類學習規律,希望大家用最少時間掌握 MVVM。

應用篇:

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

原理篇

01 MyLiveData(最簡單的LiveData)
02-n 待定(并不是解讀源碼,那樣太無聊了,打算帶你從0擼一個 Architecture)

關于提問

本人水平和精力有限,如果有大佬發現哪里寫錯了或有好的建議,歡迎在本教程附帶的 github倉庫 提issue。
What?為什么不在博客留言?考慮到國內轉載基本無視版權的情況,一般來說你都不是在源出處看到這篇文章,所以留言我也一般是看不到的。

教程附帶代碼

https://github.com/ittianyu/MVVM

應用篇放在 app 模塊下,原理篇放在 implementation 模塊下。
每一節代碼采用不同包名,相互獨立。

前言

快一年沒更新安卓技術棧了,今年年初就發現谷歌正在推 Architecture 。這是谷歌推出的快速實現 MVVM 架構的類庫。目前已經是RC版本了,正式版應該不遠了。體驗完這么一個架構之后,只能用一個字形容。

雖然不打算長久的做安卓開發,但在其位謀其職,考慮到安卓社區的發展,有必要給大家漲漲姿勢。

思想

什么是 MVVM?

很簡單, Model(數據) View(視圖) ViewModel(數據視圖管理器)

能不能具體點?

Model:bean(實體類)、Data Source(Http請求相關、數據庫相關)
View:xml、View、Activity、Fragment 等UI相關
ViewModel:這正是我要說的,先簡單理解為管理器

執行流程

ViewModel 負責調用 Model(可以稱之為數據源),拿到結果后,更新自身。而 View 與 ViewModel 雙向綁定(后面會講怎么實現綁定的),所以 View 就會自動更新。
這就是 MVVM 大致的思想。

環境配置

首先需要引入 Lifecycles, LiveData and ViewModel 這三個全家桶,而這些庫是放在谷歌 maven 上,所以你得在項目根 gradle 文件中加上谷歌 maven

allprojects {
    repositories {
        jcenter()
        maven { url 'https://maven.google.com' }
    }
}

然后在 app 模塊的 gradle 文件中加上如下 3 個庫,為了便于后面正式版發布后修改版本號,我們通過引用變量。

// Lifecycles, LiveData and ViewModel
compile "android.arch.lifecycle:runtime:$rootProject.lifecycleRuntime"
compile "android.arch.lifecycle:extensions:$rootProject.lifecycle"
annotationProcessor "android.arch.lifecycle:compiler:$rootProject.lifecycle"

相應的,你需要在根 gradle 文件中加上附加屬性(gradle 的語法)

ext {
    lifecycle = '1.0.0-rc1'
    lifecycleRuntime = '1.0.3'
}

Model

為了降低學習難度,打算寫一個展示用戶 id 和 name 的demo。
所以 bean 真的是簡單得只有2個屬性,省略了 get 和 set 方法(讀者練習時自己加上)。

public class User implements Serializable {
    private int id;
    private String name;
// ...getter setter and toString...
}

Model 就寫完了,what?說好的數據源呢?
慌,不要慌!下次再講。

View

所以相應的,我們定義 2 個 TextView 來展示 id 和 name。

a_activity_user.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:orientation="vertical"
    android:id="@+id/v_root"
    android:gravity="center"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

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

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

</LinearLayout>

然后在 Activity 中初始化并獲得引用。
這里需要注意,如果你的 support lib >= 26.0.0,則直接繼承 AppCompatActivity 就好。否則需要繼承 LifecycleActivity。

public class UserActivity extends AppCompatActivity {
    private TextView tvId;
    private TextView tvName;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.a_activity_user);
        initView();
        initData();
    }

    private void initView() {
        tvId = (TextView) findViewById(R.id.tv_id);
        tvName = (TextView) findViewById(R.id.tv_name);
    }

    private void initData() {
        // todo
    }

}

Lifecycle

上面提到 LifecycleActivity,實際上還有 LifecycleFragment,類似的,在 support lib >= 26.0.0 時,默認的 Activity 和 Fragment 基類里面已經集成了,不需要你做修改了。具體可以看官方文檔 Lifecycle

用于管理 Activity / Freagment 生命周期,方便查詢當前組件生命周期的狀態。對應的關系如下圖。

那到底有什么用?

只要持有 Lifecycle,就等于知道了容器的生命周期。
比如,實現 LifecycleObserver 之后,就可以在狀態發生改變時及時響應。也就是等同于讓 Model或其他也擁有了生命周期。(還有這種操作?)

定義一個定位監聽器,可以在生命周期不同狀態下,做對應的操作,再也不用在 Activity 中加生命周期注冊或取消操作了。

class MyLocationListener implements LifecycleObserver {
    private boolean enabled = false;
    public MyLocationListener(Context context, Lifecycle lifecycle, Callback callback) {
       ...
    }

    @OnLifecycleEvent(Lifecycle.Event.ON_START)
    void start() {
        if (enabled) {
           // connect
        }
    }

    public void enable() {
        enabled = true;
        if (lifecycle.getState().isAtLeast(STARTED)) {
            // connect if not connected
        }
    }

    @OnLifecycleEvent(Lifecycle.Event.ON_STOP)
    void stop() {
        // disconnect if connected
    }
}

而在 Activity 中,只需要傳入 lifecycle 就可以了。優雅得不像話。

myLocationListener = new MyLocationListener(this, getLifecycle(), location -> {
            // update UI
        });

ViewModel

ViewModel 就類似于 MVP 中的 Presenter 或者 MVC 中的 Controller。(不清楚什么是 MVC MVP 也沒關系,就是個概念而已)

現在我們完全沒有必要自己定義 ViewModel 來管理 UI 生命周期,谷歌大禮包中就有 ViewModel

所以很自然的我們寫出這樣的一個類。

public class UserViewModel extends ViewModel {}

你可能好奇 ViewModel,點進去看發現就是只有一個空方法的抽象類。可以,這很谷歌。但從 onCleared 這方法名可以看出,這還是有用處的。

LiveData

接下來就是要去調用 Model 并和 View 綁定,在繼續往下講之前,還需要介紹一下 LiveData,沒錯,就是它,可以輕松的實現和 View 的綁定。

它能自動響應生命周期方法,可被觀察(數據改變時通知觀察者),所以可以實現 Model 和 View 的綁定。

具有以下優點:

  • 避免內存泄露:由于 Observer 和 Lifecycle 綁定,當 Lifecycle 被銷毀后,Observer 自動被清理。
  • 避免崩潰:避免在 Activity 被銷毀后更新數據導致的崩潰情況
  • 數據可共享:數據可在多個 fragment 中共享。甚至可以通過單例的 LiveData 實現全局數據共享
  • 不需要在 Activity 中處理生命周期
  • 數據更新及時:當數據在 UI 不可見的時更新了,在可見時,數據會及時更新到UI上

具體用法

創建一個可變的 LiveData,也就是 MutableLiveData。
并通過一個方法返回。沒錯,就是這么簡單,只需要 new 出來就行了。

// Create a LiveData with a String
private MutableLiveData<String> mCurrentName;

public MutableLiveData<String> getCurrentName() {
    if (mCurrentName == null) {
        mCurrentName = new MutableLiveData<String>();
    }
    return mCurrentName;
}

在 Activity / Fragment 中 觀察 LiveData。也就是當 LiveData 數據發生變化時,自動回調方法來更新 UI。

final Observer<String> nameObserver = new Observer<String>() {
    @Override
    public void onChanged(@Nullable final String newName) {
        // Update the UI, in this case, a TextView.
        mNameTextView.setText(newName);
    }
};
getCurrentName().observe(this, nameObserver);

那什么時候會更新數據?

更新數據一般是 UI 這邊觸發的,比如我們給按鈕綁定一個事件,點擊之后去更改 name。

mButton.setOnClickListener(new OnClickListener() {
    @Override
    public void onClick(View v) {
        String anotherName = "John Doe";
        getCurrentName().setValue(anotherName);
    }
});

是的,你想更新 UI 上的文本,只需要修改 LiveData 中的數據即可。

ViewModel + LiveData

講完 LiveData,我們回到 ViewModel。
為了顯示 id 和 name,我們需要一個 LiveData<User>。
對外公開一個 getUser 方法 和 setUsername 方法。
這里你會發現 getUser 并不是線程安全的,因為這個案例不會有在多線程中 getUser,所以沒必要加,實際上還可以把 user 初始化放到成員變量定義的地方。

public class UserViewModel extends ViewModel {
    private MutableLiveData<User> user;

    public LiveData<User> getUser() {
        if (user == null)
            user = new MutableLiveData<>();
        return user;
    }

    public void setUsername(String username) {
        user.setValue(new User(1, username));
    }
}

View 和 ViewModel 綁定

之前提到了 LiveData,它可以方便的被觀察。
還有 ViewModel,可以自動響應生命周期。
所以就是這兩個東西,方便的實現綁定操作。

之前我已經初始化了 UserActivity 的View,現在來完善 initData。

通常來說,一個 View 只和一個 ViewModel 綁定。所以我們需要一個 Activity 級別的單例 ViewModel,我們可以通過 ViewModelProviders.of(this).get(UserViewModel.class) 來簡單的實現。

然后通過 userViewModel 取得 LiveData 并添加監聽(綁定操作)。

這個回調方法里面,我們就可以更新與該數據相關的 UI。

沒錯,綁定就是這么簡單便捷。

    private UserViewModel userViewModel;

    private void initData() {
        userViewModel = ViewModelProviders.of(this).get(UserViewModel.class);
        userViewModel.getUser().observe(this, new Observer<User>() {
            @Override
            public void onChanged(@Nullable User user) {
                updateView(user);
            }
        });

        userViewModel.setUsername("ittianyu");
    }

    private void updateView(User user) {
        tvId.setText(user.getId() + "");
        tvName.setText(user.getName());
    }

總結

有了這樣一個構架,以后就不需要為 n 處都要修改 View 導致的復雜的 UI 邏輯而頭疼了。

而數據請求也可以更純粹,不需要管 UI 是怎么顯示的。

簡單來說就是 請求數據完成并更新數據后,通過通知 UI 去根據數據來渲染界面。

沒錯,今后安卓也可以像前端那樣愉快的寫 UI 了。也可以像后端那樣層次分明的專心處理數據了,妙不可言。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,119評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,382評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,038評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,853評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,616評論 6 408
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,112評論 1 323
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,192評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,355評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,869評論 1 334
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,727評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,928評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,467評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,165評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,570評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,813評論 1 282
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,585評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,892評論 2 372

推薦閱讀更多精彩內容