Jetpack-ViewModel

Jetpack-Lifecycle

Jetpack-LiveData

ViewModel

ViewModel是以能感知生命周期的方式存儲和管理界面相關數據的組件。感知生命周期是說當Activity或Fragment創建第一個實例的時候,它開始創建,當Activity銷毀或者Fragment分離的時候,它自動清理。比如:當屏幕旋轉時,它不會被重新創建,數據能夠被恢復。

當Activity配置發生變化時,我們也可以通過onSaveInstanceState() 方法保存數據,從 onCreate()onRestoreInstanceState方法中恢復其數據,但這種方式僅適合可以序列化再反序列化的少量數據,而不適合較大數量的數據,如用戶列表;而ViewModel可以。

Activity或Fragment主要用于界面的展示,如果數據存儲和恢復的相關邏輯放在其中,會使Activity或Fragment變得臃腫。使用ViewModel可以將它們分離開來。

使用

class MyViewModel : ViewModel() {
    private val users: MutableLiveData<List<User>> by lazy {
        MutableLiveData().also {
            it.value = loadUsers()
        }
    }

    fun getUsers(): LiveData<List<User>> {
        return users
    }

    private fun loadUsers():List<User> {
        //todo
    }
}
class MyActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        //通過ViewModelProviders獲取ViewModel實例
        val model = ViewModelProviders.of(this)[MyViewModel::class.java]
        model.getUsers().observe(this, Observer<List<User>>{ users ->
            //todo
        })
    }
}

ViewModel還存在一個子類:AndroidViewModel,它的構造方法接收一個Application類型的參數,方便在ViewModel中使用Context

//定義
class MyViewModel(application:Application) : AndroidViewModel(application) {}

//獲取實例
mViewModel = ViewModelProviders.of(this,ViewModelProvider.AndroidViewModelFactory(application)).get(MyViewModel::class.java)

從上面看到當ViewModel的構造方法中有參數時,在獲取實例的時候,傳入了一個參數:ViewModelProvider.factory,那么這個Factory的作用是什么呢?當我們調用ViewModelProviders.of(activity)獲取ViewModel實例的時候,它內部會默認調用ViewModel無參構造方法來創建實例;但是當ViewModel的構造方法有依賴時,這時候就需要我們自定義Factory來實例化ViewModel。比如:ViewModel的構造方法含有一個Int類型的參數,Factory的實現如下:

class MyViewModel(id: Int) : ViewModel() {}

//自定義Factory 
class MyViewModelFactory(private val arg: Int) : ViewModelProvider.Factory {

    override fun <T : ViewModel?> create(modelClass: Class<T>): T {
        return modelClass.getConstructor(Int::class.java).newInstance(arg)
    }
}

生命周期

ViewModel的存在是從第一次獲取ViewModel實例一直到Activity完全銷毀或者Fragment分離,Activity因配置發生變化而重新創建時,ViewModel是不會重新創建的。

當ViewModel銷毀的時候,它會調用onCleared()方法,來清理相關的資源。

因為ViewModel比Activity的生命周期要長,所以ViewMode一定不能持有View的引用。

實現原理

我們要使用ViewModel,首先調用ViewModelProviders.of(this).get(MyViewModel::class.java)來獲取實例。我們就以此為分析的入口,看一下該方法的實現:

public static ViewModelProvider of(@NonNull FragmentActivity activity) {
    return of(activity, null);
}

public static ViewModelProvider of(@NonNull FragmentActivity activity,@Nullable Factory factory) {
    Application application = checkApplication(activity);
    if (factory == null) {
        factory = ViewModelProvider.AndroidViewModelFactory.getInstance(application);
    }
    return new ViewModelProvider(activity.getViewModelStore(), factory);
}

從上面可以看出最終都會調用兩個參數的方法,new ViewModelProvider(activity.getViewModelStore(), factory);,第一個參數通過Activity獲取一個ViewModelStore對象,該方法是在ComponentActivity中實現的:

public ViewModelStore getViewModelStore() {
    if (getApplication() == null) {
        throw new IllegalStateException("Your activity is not yet attached to the "
                + "Application instance. You can't request ViewModel before onCreate call.");
    }
    if (mViewModelStore == null) {
        NonConfigurationInstances nc = (NonConfigurationInstances) getLastNonConfigurationInstance();
        if (nc != null) {
            // Restore the ViewModelStore from NonConfigurationInstances
            mViewModelStore = nc.viewModelStore;
        }
        if (mViewModelStore == null) {
            mViewModelStore = new ViewModelStore();
        }
    }
    return mViewModelStore;
}

Activity在配置發生變化時,如橫豎屏切換會觸發onSaveInstanceState()方法來保存狀態,除此之外Activity還提供了一個方法onRetainNonConfigurationInstance來保存狀態,最大的不同在于這個方法可以返回一個包含有狀態信息的Object。該方法是在onSaveInstanceState()方法之后調用,該方法不允許重寫。

public final Object onRetainNonConfigurationInstance() {
    Object custom = onRetainCustomNonConfigurationInstance();

    ViewModelStore viewModelStore = mViewModelStore;
    if (viewModelStore == null) {
        // No one called getViewModelStore(), so see if there was an existing
        // ViewModelStore from our last NonConfigurationInstance
        NonConfigurationInstances nc =
                (NonConfigurationInstances) getLastNonConfigurationInstance();
        if (nc != null) {
            viewModelStore = nc.viewModelStore;
        }
    }

    if (viewModelStore == null && custom == null) {
        return null;
    }

    NonConfigurationInstances nci = new NonConfigurationInstances();
    nci.custom = custom;
    nci.viewModelStore = viewModelStore;
    return nci;
}

Activity在配置發生變化的時候保存了viewModelStore,放到了NonConfigurationInstances中。上面的操作都圍繞著ViewModelStore,那么看一下它到底是什么?

public class ViewModelStore {

    private final HashMap<String, ViewModel> mMap = new HashMap<>();

    final void put(String key, ViewModel viewModel) {
        ViewModel oldViewModel = mMap.put(key, viewModel);
        if (oldViewModel != null) {
            oldViewModel.onCleared();
        }
    }

    final ViewModel get(String key) {
        return mMap.get(key);
    }

    Set<String> keys() {
        return new HashSet<>(mMap.keySet());
    }

    public final void clear() {
        for (ViewModel vm : mMap.values()) {
            vm.clear();
        }
        mMap.clear();
    }
}

ViewModelStore的代碼很簡單,就是用一個HashMap來存儲ViewModel。那么ViewModel又是從什么時候存進去的呢?那就要從ViewModel的創建說起,我們獲取ViewModel的實例調用的是ViewModelProvider的get()方法。

public <T extends ViewModel> T get(@NonNull Class<T> modelClass) {
    String canonicalName = modelClass.getCanonicalName();
    if (canonicalName == null) {
        throw new IllegalArgumentException("Local and anonymous classes can not be ViewModels");
    }
    return get(DEFAULT_KEY + ":" + canonicalName, modelClass);
}

public <T extends ViewModel> T get(@NonNull String key, @NonNull Class<T> modelClass) {
    ViewModel viewModel = mViewModelStore.get(key);

    if (modelClass.isInstance(viewModel)) {
        return (T) viewModel;
    } else {
        //noinspection StatementWithEmptyBody
        if (viewModel != null) {
            // TODO: log a warning.
        }
    }
    if (mFactory instanceof KeyedFactory) {
        viewModel = ((KeyedFactory) (mFactory)).create(key, modelClass);
    } else {
        viewModel = (mFactory).create(modelClass);
    }
    mViewModelStore.put(key, viewModel);
    return (T) viewModel;
}

get()方法的實現也比較簡單:先判斷緩存中是否存在ViewModel,如果不存在就使用Factory創建一個實例,然后加入到緩存中。

ViewModel存儲在ViewModelStore中,而ViewModelStore在Activity配置變化的時候會在onRetainNonConfigurationInstance()方法中保存起來,也就是說ViewModelStore不會因為Activity配置發生變化而重新創建。所以ViewModel也不會重新創建。

那么ViewModel是在什么時候銷毀的呢?ViewModel存儲在ViewModelStore里面的mMap中,它中有一個clear()方法,用來清除這個mMap,也就是清除ViewModel,那么我們就看一下這個方法是在哪里調用的?

public ComponentActivity() {
    ...
    getLifecycle().addObserver(new LifecycleEventObserver() {
        @Override
        public void onStateChanged(@NonNull LifecycleOwner source,
                @NonNull Lifecycle.Event event) {
            if (event == Lifecycle.Event.ON_DESTROY) {
                if (!isChangingConfigurations()) {
                    getViewModelStore().clear();
                }
            }
        }
    });
    ...
}

在Activity創建的時候會通過Lifecycle添加一個觀察者,觀察Activity的ON_DESTROY狀態。當處于該狀態時,判斷是否是配置變化觸發的,如果不是則調用ViewModelStore的clear()方法。從這里也可以看出,當Activity配置變化的時候并不會清理ViewModel。在Jetpack-Lifecycle中我們知道,當Activity調用onDestroy()時,狀態會變為ON_DESTROY

public final void clear() {
    for (ViewModel vm : mMap.values()) {
        vm.clear();
    }
    mMap.clear();
}

clear()方法中會調用ViewModel的clear()方法

final void clear() {
    mCleared = true;
    if (mBagOfTags != null) {
        synchronized (mBagOfTags) {
            for (Object value : mBagOfTags.values()) {
                // see comment for the similar call in setTagIfAbsent
                closeWithRuntimeException(value);
            }
        }
    }
    onCleared();
}

protected void onCleared() {
}

所以在ViewModel即將銷毀的時候會回調它的onCleared()方法,我們可以在該方法中做一些清理的工作。

KotlinAndroid

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

推薦閱讀更多精彩內容