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阅读 194,319评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,801评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,567评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,156评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,019评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,090评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,500评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,192评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,474评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,566评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,338评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,212评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,572评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,890评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,169评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,478评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,661评论 2 335

推荐阅读更多精彩内容