Jetpack Architecture - ViewModel

简介

当前大前端主流的架构为 MVVM,即 Model-View-ViewModel,Model 表示数据模型,View 表示视图模型,视图与数据之间采用 ViewModel 层进行隔离,解耦视图与数据。

Android 官方推荐的 MVVM 架构如下图所示:

android MVVM architecture

可以看到,ViewModel 层充当数据持有者,它专门用于存放页面所需数据(ViewModel 层可以通过相应业务逻辑获取得到数据)。通常来说,一个页面所有数据都交由一个 ViewModel 进行维护,当 View 层需要进行渲染时,就可以通过 ViewModel 获取数据(View 层持有 ViewModel 的引用),最终将数据渲染到页面上。

在 Android Jetpack 中,已经为我们提供了一个 ViewModel 层相应类型:ViewModel,其源码如下所示:

package androidx.lifecycle;
...
public abstract class ViewModel {
    ...
    @SuppressWarnings("WeakerAccess")
    protected void onCleared() {
    }
}

可以看到,ViewModel是一个抽象类,其内部有一个protected方法:onCleared(),该方法在ViewModel被销毁时会自动被调用,子类可以覆写该方法,进行一些资源释放操作。

依赖引入

项目中要使用ViewModel,只需在 app 的 build.gradle 中引入:

dependencies {
    def lifecycle_version = '2.3.0'
    implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"
}

如果项目已引入appcompat包,则无需再独立引入ViewModel

implementation 'androidx.appcompat:appcompat:1.2.0'

生命周期

Android 官网ViewModel生命周期描述如下图所示:

ViewModel lifecycle

这里有一个很有趣的特性:ViewModel与其宿主Activity的生命周期一致,在Activity正常退出后,ViewModel就会触发回调其onCleared()方法,进行一些资源释放操作,然后退出,而当Activity非正常退出时(比如屏幕翻转导致Activity重新创建),ViewModel保持不变,因此,ViewModel的生命周期大于或等于宿主Activity生命周期。
:由于ViewModel生命周期可能大于Activity,因此,不要将宿主上下文Context传递给ViewModel,否则可能导致异常情况下,宿主Activity退出后却无法被回收,造成内存泄漏。如果ViewModel内部确实需要使用Context,可考虑使用AndroidViewModel,其内部维护一个Application上下文对象:

package androidx.lifecycle;
...
public class AndroidViewModel extends ViewModel {
    @SuppressLint("StaticFieldLeak")
    private Application mApplication;

    public AndroidViewModel(@NonNull Application application) {
        mApplication = application;
    }

    @SuppressWarnings("TypeParameterUnusedInFormals")
    @NonNull
    public <T extends Application> T getApplication() {
        //noinspection unchecked
        return (T) mApplication;
    }
}

Activity 中获取 ViewModel

下面通过一个小例子来阐述下ViewModel的使用:假设点击主页面MainActivity中的一个按钮,实现上网获取一个字符串,然后显示到当前页面上,具体操作步骤如下:

  1. 首先创建一个MyViewModel,获取页面所需数据:

    class MyViewModel : ViewModel() {
        // 数据
        var data: String = ""
    
        override fun onCleared() {
            super.onCleared()
        }
    
        // 模拟获取数据业务逻辑
        fun fetchData() {
            // skip detailed fetching process
            this.data = "fetchData: ${Math.random()}"
        }
    }
    
  2. 页面持有对应ViewModel,获取数据进行渲染到页面上,其具体步骤如下:

    1. 首先为Activity引入相关依赖,方便创建ViewModel

      dependencies {
          def activity_version = "1.2.1"
          implementation "androidx.activity:activity-ktx:$activity_version"
      }
      

      :引入上述依赖,才能在Activity中使用ViewModelProvider(ViewModelStoreOwner)该函数创建ViewModel

    2. 为页面创建相应布局:

      <!-- layout/activity_main.xml -->
      <?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:gravity="center_vertical"
          android:orientation="vertical">
      
          <TextView
              android:id="@+id/tvData"
              android:layout_width="match_parent"
              android:layout_height="wrap_content"
              android:gravity="center"
              android:text="Hello World!" />
      
          <Button
              android:id="@+id/btn"
              android:layout_width="match_parent"
              android:layout_height="wrap_content"
              android:text="fetch data" />
      
      </LinearLayout>
      
    3. 创建主页面,并实例化相应ViewModel

      class MainActivity : AppCompatActivity() {
      
          private lateinit var viewModel: MyViewModel
      
          override fun onCreate(savedInstanceState: Bundle?) {
              super.onCreate(savedInstanceState)
              setContentView(R.layout.activity_main)
      
              // 获取 ViewModel
              this.viewModel = ViewModelProvider(this).get(MyViewModel::class.java)
              this.showData(this.viewModel.data)
      
              this.btn.setOnClickListener {
                  // 获取数据
                  this.viewModel.fetchData()
                  // 显示数据
                  this.showData(this.viewModel.data)
              }
          }
      
          // 将数据渲染到页面
          private fun showData(data: String) {
              this.tvData.text = data
          }
      }
      

    到此,我们就成功将MainActivityMyViewModel绑定到一起了,MainActivity就可以从MyViewModel中获取数据并渲染到页面上,且即使翻转手机,让MainActivity重新创建,也不会导致数据丢失,因为新创建的MainActivity实例获取到的还是先前那个MyViewModel实例,故数据仍存在。

上面内容我们在Activity中创建的是不带参数的ViewModel,如果需要传递参数给ViewModel,只需实现一个ViewModelProvider.Factory即可,具体如下所示:

  1. 修改MyViewModel,提供带参数构造函数:

    class MyViewModel(private val prefix: String) : ViewModel() {
        var data: String = ""
        ...
        // 模拟获取数据业务逻辑
        fun fetchData() {
            // skip detailed fetching process
            this.data = "${this.prefix}: ${Math.random()}"
        }
    }
    
  2. 自定义ViewModelProvider.Factory,提供参数注入:

    class MyViewModelFactory(private val prefix: String) : ViewModelProvider.Factory {
        override fun <T : ViewModel?> create(modelClass: Class<T>): T {
            return MyViewModel(this.prefix) as T
        }
    }
    
  3. Activity通过ViewModelProvider.Factory获取ViewModel实例:

    class MainActivity : AppCompatActivity() {
    
        private val viewModel: MyViewModel by lazy {
            ViewModelProvider(this, MyViewModelFactory("retriveData")).get(MyViewModel::class.java)
        }
        ...
    }
    

    以上,我们就完成了在Activity中传递参数给ViewModel

:在Activity中获取ViewModel除了以上方法外,其实 Androidx 还提供了一些更简便的方法让我们获取Activity所需的ViewModel,具体方法如下:

  1. Acvitity中更加方便获取ViewModel,需要使用activity-ktx模块:

    dependencies {
        implementation "androidx.activity:activity-ktx:1.2.1"
    }
    
  2. 然后在Acvitity中就可使用如下方式获取所需ViewModel

    class MainActivity : AppCompatActivity() {
        // 通过扩展函数 viewModels() 获取 Activity 所需 ViewModel
        private val viewModel by viewModels<MyViewModel>()
        ...
    }
    

    :如果扩展函数viewModels()使用时报错,则在 app Module 的 build.gralde 进行如下配置:

    android {
        ...
        compileOptions {
            sourceCompatibility = 1.8
            targetCompatibility = 1.8
        }
    
        kotlinOptions {
            jvmTarget = "1.8"
        }
    }
    
  3. 如果需要传递参数给ViewModel,只需如下调用:

    
    class MainActivity : AppCompatActivity() {
        ...
        private val viewModel by viewModels<MyViewModel> { MyViewModelFactory("retriveData") }
    }
    

Fragment 中获取 ViewModel

Fragment中获取ViewModel的方式与Activity基本一致,大致如下所述:

  1. 通过ViewModelProvider获取:上文在MainActivity中使用ViewModelProvider(ViewModelStoreOwner)来获取页面所需ViewModel实例,刚好Fragment也实现了ViewModelStoreOwner接口,因此Fragment中使用ViewModel的方式与Activity基本一致,此处不再赘述。

  2. 通过扩展函数获取activity-ktx模块为Acvitity提供了相应扩展函数方便Acvitity获取ViewModel,对于Fragment而言,它也有相应的扩展函数方便其获取所需ViewModel实例,这个模块为fragment-ktx,具体操作如下所示:

    1. 引入相关依赖:

      dependencies {
          implementation "androidx.fragment:fragment-ktx:1.3.1"
      }
      
    2. 获取Fragment所需ViewModel,可采用如下方式:

      class MyFragment : Fragment() {
          // Get a reference to the ViewModel scoped to this Fragment
          val viewModel by viewModels<MyViewModel>()
          ...
      }
      
    3. 获取Fragment宿主AcvitityViewModel,可采用如下方式:

      class MyFragment : Fragment() {
          // Get a reference to the ViewModel scoped to its Activity
          val viewModel by activityViewModels<MyViewModel>()
      }
      

最后,事实上ViewModel经常跟LiveData一起使用,具体使用方法可参考:Jetpack Architecture - LiveData

附录

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

推荐阅读更多精彩内容