Jetpack——ViewModel使用及源码分析

依赖引用:

        def lifecycle_version = "2.2.0"
        // ViewModel
        implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version"
        // ViewModel
        implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"

ViewModel是google提供的jetpack 架构中的用于管理activity、fragment界面相关数据的,同时也可以用于activity和fragment、fragment和fragment之间的数据通信。
ViewModel的使用比较简单,创建一个类继承自 ViewModel,在需要使用的activity或fragment进行实例化就可以了。

public class MyViewModel extends ViewModel {
    public int number=0;
    public MyViewModel(){

    }
    @Override
    protected void onCleared() {
        super.onCleared();
        //当不再使用ViewModel时,会调用该方法
    }
}

注意:如果ViewModel需要构造函数时,需要将其权限修饰符设置为public,否则在初始化时会报错;如果在ViewModel中涉及到需要使用上下文时,可以继承AndroidViewModel类,在起构造方法中需要传入一个Application实例,

public class MyApplicationViewModel extends AndroidViewModel {
    public MyApplicationViewModel(@NonNull Application application) {
        super(application);
    }
}
在activity中的使用:
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //实例化对应的viewModel
        MyViewModel viewModel = new ViewModelProvider(this).get(MyViewModel.class);
        //设置value
        viewModel.number = 1;
        //获取value
        int mun = viewModel.number;
    }
}

注意:ViewModel的实例方式有两种方式,不过最终调用的都是一种;

//实例化对应的viewModel
//方式一:
MyViewModel viewModel = new ViewModelProvider(this).get(MyViewModel.class);
//方式二:
MyViewModel viewModel=ViewModelProviders.of(this).get(MyViewModel.class);

不过第二种方式在使用的时候发现已经过时了,使用起来是不是感觉比较简单,使用完了,就去看看ViewModel的生命周期还有源码吧。

生命周期

viewmodel-lifecycle.png

ViewModel 对象存在的时间范围是获取 ViewModel 时传递给 ViewModelProvider 的 Lifecycle。ViewModel 将一直留在内存中,直到限定其存在时间范围的 Lifecycle 永久消失:对于 Activity,是在 Activity 完成时;而对于 Fragment,是在 Fragment 分离时;从图中可以看到,即使在activity发生横竖屏切换,activity重新创建后,数据依然可以保存在ViewModel中,并且ViewModel中可保存任意类型的数据,且不受大小限制,这比activity onSaveInstanceState 回调中Bundle要方便很多,在onCleared方法可以可以清除一些资源的引用,释放内存。
注意:ViewModel 绝不能引用视图、Lifecycle 或可能存储对 Activity 上下文的引用的任何类

activity、fragment之间的参数传递
public class SharedViewModel extends ViewModel {
        private final MutableLiveData<Item> selected = new MutableLiveData<Item>();

        public void select(Item item) {
            selected.setValue(item);
        }

        public LiveData<Item> getSelected() {
            return selected;
        }
    }
    public class MasterFragment extends Fragment {
        private SharedViewModel model;

        public void onViewCreated(@NonNull View view, Bundle savedInstanceState) {
            super.onViewCreated(view, savedInstanceState);
            model = new ViewModelProvider(requireActivity()).get(SharedViewModel.class);
            itemSelector.setOnClickListener(item -> {
                model.select(item);
            });
        }
    }
    public class DetailFragment extends Fragment {

        public void onViewCreated(@NonNull View view, Bundle savedInstanceState) {
            super.onViewCreated(view, savedInstanceState);
            SharedViewModel model = new ViewModelProvider(requireActivity()).get(SharedViewModel.class);
            model.getSelected().observe(getViewLifecycleOwner(), { item ->
               // Update the UI.
            });
        }
    }

保持ViewModel实例化是传入的activity或者说上下文一致时,就可以实现activity和fragment、fragment和fragment之间的数据共享了

源码分析:

上面说了下ViewModel的简单使用、生命周期及activity、fragment之间的数据共享,接下来就看看ViewModel的源码吧。
在activity中使用时,是通过创建ViewModelProvider实例并调用其get方法就可以获取到要使用的ViewModel实例,ViewModelProvider就是一个提供ViewModel的工具类。

MyViewModel myViewModel = new ViewModelProvider(this).get(MyViewModel.class);
public ViewModelProvider(@NonNull ViewModelStoreOwner owner) {
    //第一个参数会获取一个ViewModerStore实例
    //第二个参数获取一个Factory实现类的实例  如果系统存在默认的就使用默认的Factory 没有就使用创建好的NewInstanceFactory实例
        this(owner.getViewModelStore(), owner instanceof HasDefaultViewModelProviderFactory
                ? ((HasDefaultViewModelProviderFactory) owner).getDefaultViewModelProviderFactory()
                : NewInstanceFactory.getInstance());
    }

ViewModelStore是用来存储创建好的ViewModel实例,Factory实现类实例则是用来创建ViewModel实例的,这时这两个对象实例都已经创建好了,然后调用get方法,传入的是当前ViewModel的Class字节码。

@NonNull
    @MainThread
    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");
        }
        //DEFAULT_KEY 系统统一的key
        return get(DEFAULT_KEY + ":" + canonicalName, modelClass);
    }
private static final String DEFAULT_KEY =
            "androidx.lifecycle.ViewModelProvider.DefaultKey";

创建好的ViewModel实例会存储在ViewModelStore实例中的HashMap中的,

@NonNull
    @MainThread
    public <T extends ViewModel> T get(@NonNull String key, @NonNull Class<T> modelClass) {
        //从ViewModelStore实例中的HashMap中获取ViewModel实例 第一次获取到的肯定是null的
        ViewModel viewModel = mViewModelStore.get(key);
        if (modelClass.isInstance(viewModel)) {
            if (mFactory instanceof OnRequeryFactory) {
                ((OnRequeryFactory) mFactory).onRequery(viewModel);
            }
            //非第一次后 直接从ViewModelStore 中的HashMap中直接获取到ViewModel实例
            return (T) viewModel;
        } else {
            //noinspection StatementWithEmptyBody
            if (viewModel != null) {
                // TODO: log a warning.
            }
        }
        //通过Factory实现类对象根据对应的Class字节码创建ViewModel实例对象
        if (mFactory instanceof KeyedFactory) {
            viewModel = ((KeyedFactory) (mFactory)).create(key, modelClass);
        } else {
            viewModel = (mFactory).create(modelClass);
        }
        //将创建好的ViewModel实例添加到HashMap中
        mViewModelStore.put(key, viewModel);
        return (T) viewModel;
    }

ViewModelStore中对ViewModel的存储就是通过HashMap来实现的,

public class ViewModelStore {

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

    final void put(String key, ViewModel viewModel) {
        //存储最新的ViewModel
        ViewModel oldViewModel = mMap.put(key, viewModel);
        if (oldViewModel != null) {
            //会将之前ViewModel中的内存释放掉
            oldViewModel.onCleared();
        }
    }

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

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

    /**
     *  Clears internal storage and notifies ViewModels that they are no longer used.
     */
    public final void clear() {
        for (ViewModel vm : mMap.values()) {
            vm.clear();
        }
        mMap.clear();
    }
}

ViewModel的创建则是通过对应的Class字节码的newInstance来创建的,

public static class NewInstanceFactory implements Factory {

        private static NewInstanceFactory sInstance;

        /**
         * Retrieve a singleton instance of NewInstanceFactory.
         *
         * @return A valid {@link NewInstanceFactory}
         */
        @NonNull
        static NewInstanceFactory getInstance() {
            if (sInstance == null) {
                sInstance = new NewInstanceFactory();
            }
            return sInstance;
        }

        @SuppressWarnings("ClassNewInstance")
        @NonNull
        @Override
        public <T extends ViewModel> T create(@NonNull Class<T> modelClass) {
            //noinspection TryWithIdenticalCatches
            try {
                //创建ViewModel实例
                return modelClass.newInstance();
            } catch (InstantiationException e) {
                throw new RuntimeException("Cannot create an instance of " + modelClass, e);
            } catch (IllegalAccessException e) {
                throw new RuntimeException("Cannot create an instance of " + modelClass, e);
            }
        }
    }

到这里ViewModel的创建和存储就完成了,通过google的描述ViewModel是有生命周期的,并且在Activity销毁时,会清除掉缓存的ViewModel实例。

生命周期:

在activity中使用ViewModel时,创建ViewModelProvider实例要求传入一个ViewModelStoreOwner实现类对象,发现传入this就可以了,说明activity中有实现ViewModelStoreOwner接口,一找发现ComponentActivity实现了ViewModelStoreOwner接口,并在构造方法中对生命周期进行了监听。

public ComponentActivity() {
        Lifecycle lifecycle = getLifecycle();
        //noinspection ConstantConditions
        if (lifecycle == null) {
            throw new IllegalStateException("getLifecycle() returned null in ComponentActivity's "
                    + "constructor. Please make sure you are lazily constructing your Lifecycle "
                    + "in the first call to getLifecycle() rather than relying on field "
                    + "initialization.");
        }
        if (Build.VERSION.SDK_INT >= 19) {
            getLifecycle().addObserver(new LifecycleEventObserver() {
                @Override
                public void onStateChanged(@NonNull LifecycleOwner source,
                        @NonNull Lifecycle.Event event) {
                    if (event == Lifecycle.Event.ON_STOP) {
                        Window window = getWindow();
                        final View decor = window != null ? window.peekDecorView() : null;
                        if (decor != null) {
                            decor.cancelPendingInputEvents();
                        }
                    }
                }
            });
        }
        getLifecycle().addObserver(new LifecycleEventObserver() {
            @Override
            public void onStateChanged(@NonNull LifecycleOwner source,
                    @NonNull Lifecycle.Event event) {
                if (event == Lifecycle.Event.ON_DESTROY) {
                    if (!isChangingConfigurations()) {
                        //如果不是因为配置改变导致的onDestory 会调用ViewModelStore中的clear方法,清除掉缓存的ViewModel实例
                        getViewModelStore().clear();
                    }
                }
            }
        });

        if (19 <= SDK_INT && SDK_INT <= 23) {
            getLifecycle().addObserver(new ImmLeaksCleaner(this));
        }
    }

这样就保证了Activity销毁时,释放掉对应ViewModel中缓存的数据,保证内存的释放。

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

推荐阅读更多精彩内容