JetPack+单Activity的一些思路

Google推JetPack已经有一段时间了,伴随之而来的是MVVM架构,使用ViewModel LiveData等工具来实现MVVM。

JetPack中还附带了一个Navigation,顾名思义,即导航功能,主要目的是用来实现单Activity架构,之前写过一篇文章,是利用fragmentation来实现单Activity架构,抱着学习的态度,这次的项目采用了Navigation来实现单Activity架构。

JetPack实现MVVM架构思路:

先附带项目的MVVM架构图:


mvvm架构.png

绿色代表View层
蓝色代表ViewModel层
红色代表Model层

各层之间均是单向依赖,即V层向VM层发起请求,VM层向M层获取数据,再通过LiveData作为桥梁,V层监听LiveData数据,数据变化时更新UI。

举个代码例子吧,登录流程:

  • 首先是V层代码:
class LoginFragment : BaseFragment(), View.OnClickListener {
  private val viewModel by lazy {
    ViewModelProviders.of(this).get(LoginViewModel::class.java)
  }

  ... ...

  override fun bindView(savedInstanceState: Bundle?, rootView: View) {
    observe()
    fragmentLoginSignInLayoutSignIn.setOnClickListener(this)
  }

  override fun onClick(v: View?) {
    when (v?.id) {
      R.id.fragmentLoginSignInLayoutSignIn -> {
            //调用登录
            viewModel.login(
                fragmentLoginSignInLayoutAccount.text.toString(),
                fragmentLoginSignInLayoutPassword.text.toString()
            )
        }
      ... ...
    }
  }

  /**
   * 监听数据变化
   */
  private fun observe() {
    //登录监听
    viewModel.loginLiveData.observe(this, Observer {
        if (it.errorCode != 0) {
            toast(it.errorMsg)
        } else {
            Navigation.findNavController(fragmentLoginSignInLayoutSignIn)
                .navigate(R.id.action_loginFragment_to_mainFragment)
        }
    })
    //注册监听
    viewModel.registerLiveData.observe(this, Observer {
        if (it.errorCode != 0) {
            toast(it.errorMsg)
        } else {
            toast("注册成功,返回登录页登录")
            getSignInAnimation(fragmentLoginSignUpLayout)
        }
    })
    //loading窗口监听
    viewModel.isLoading.observe(this, Observer {
        if (it) {
            showLoading()
        } else {
            dismissAllLoading()
        }
    })
  }
}

获取LoginViewModel的实例,点击登录按钮时,调用其login(userName:String,password:String)方法,在observe()方法中获取其LiveData数据的observe方法,监听其数据变化,在Observer匿名类里进行UI的更新。

  • VM层代码:
class LoginViewModel(application: Application) : BaseViewModel(application) {

  /**
   * 登录数据
   */
  var loginLiveData = MutableLiveData<LoginResponse>()
  /**
   * 注册数据
   */
  var registerLiveData = MutableLiveData<LoginResponse>()
  /**
   * 登出数据
   */
  var logOutLiveData = MutableLiveData<LoginResponse>()

  private val repository = LoginRepository.getInstance(PackRatNetUtil.getInstance())

  fun login(username: String, password: String) {
    launch {
        loginLiveData.postValue(repository.login(username, password))
    }
  }

  fun register(username: String, password: String, repassword: String) {
    launch {
        registerLiveData.postValue(repository.register(username, password, repassword))
    }
  }

  fun logOut() {
    launch {
        logOutLiveData.postValue(repository.logOut())
    }
  }

}

很简单,做的就是实例化LiveDatarepository数据依赖层,并调用repository获取数据,最后往里postValue赋值。我这里包装了一层BaseViewModel,它继承了AndroidViewModel,它与普通的ViewModel不同之处在于可以需要传入application参数,也就是可以获取一个全局context引用。

abstract class BaseViewModel(application: Application) : AndroidViewModel(application){
  /**
   * 加载变化
   */
  var isLoading = MutableLiveData<Boolean>()
  /**
   * 统一协程处理
   */
  fun launch(block:suspend() -> Unit) = viewModelScope.launch {
    try {
        isLoading.value = true
        withContext(Dispatchers.IO){
            block()
        }
        isLoading.value = false
    }catch (t:Throwable){
        t.printStackTrace()
        getApplication<PackRatApp>().toast(t.message)
        isLoading.value = false
    }
  }
}

抽离了一个协程方法,耗时操作统一到IO线程操作,loading在耗时方法完成时置为false,通知页面关闭弹窗。

  • M层代码
class LoginRepository private constructor(
private val net: PackRatNetUtil
) {
  companion object {
    @Volatile
    private var instance: LoginRepository? = null

    fun getInstance(net: PackRatNetUtil) =
        instance ?: synchronized(this) {
            instance ?: LoginRepository(net).apply {
                instance = this
            }
        }
  }

  suspend fun login(username: String, password: String) =
    net.fetchLoginResult(username, password)

  suspend fun register(username: String, password: String, repassword: String) =
    net.fetchRegisterResult(username, password, repassword)

  suspend fun logOut() =
    net.fetchQuitResult()
}

这里做的事情也很简单,从网络层获取数据,当然,如果需要存放本地数据库,可以如下实现:

class CollectRepository private constructor(
private var collectDao: CollectDao,
private var net: PackRatNetUtil
) {
  companion object {
    @Volatile
    private var instance: CollectRepository? = null

    fun getInstance(collectDao: CollectDao, net: PackRatNetUtil) =
        instance ?: synchronized(this) {
            instance ?: CollectRepository(collectDao, net).apply {
                instance = this
            }
        }
  }

  /**
   * 获取收藏列表数据
   */
  suspend fun getCollects() = try {
    net.fetchCollectList()
  } catch (t: Throwable) {
    t.printStackTrace()
    collectDao.getCollectList()
  }


  /**
   * 设置收藏列表存储入数据库
   */
  suspend fun setCollects(collects: List<Collect>) {
    collects.forEach {
        collectDao.insert(it)
        log(content = it.content)
    }
  }
}

传入本地数据库及网络层的实例,然后依照不同的情况分别获取数据。

class PackRatNetUtil private constructor() {
  companion object {
    @Volatile
    private var instance: PackRatNetUtil? = null

    fun getInstance() = instance ?: synchronized(this) {
        instance ?: PackRatNetUtil().apply {
            instance = this
        }
    }
  }

  private val collectService = ServiceCreator.create(CollectService::class.java)

  private val loginService = ServiceCreator.create(LoginService::class.java)

  /**
   * 从服务器获取收藏列表
   */
  suspend fun fetchCollectList() = collectService.getCollectAsync().await()

  /**
   * 获取登录结果
   */
  suspend fun fetchLoginResult(username: String, password: String) =
    loginService.loginAsync(username, password).await()

  /**
   * 此方法用于retrofit使用 [Call] 的 [Callback] 回调与协程 [await] 的回调相连
   * 不过 retrofit 后续提供了[CoroutineCallAdapterFactory],可返回[Deferred]作为回调
   * @Deprecated 引入[com.jakewharton.retrofit:retrofit2-kotlin-coroutines-adapter]包可以使用Deferred作为回调
   */
  private suspend fun <T> Call<T>.await(): T = suspendCoroutine { continuation ->
    enqueue(object : Callback<T> {
        override fun onFailure(call: Call<T>, t: Throwable) {
            continuation.resumeWithException(t)
        }

        override fun onResponse(call: Call<T>, response: Response<T>) {
            val body = response.body()
            if (body != null) {
                continuation.resume(body)
            } else {
                continuation.resumeWithException(NullPointerException("response body is null"))
            }
        }
    })
  }
}

这里提下,之前retrofit没有提供coroutines-adapter依赖包时,不能使用Deferred作为回调,可重写其Call的await方法,将协程的resume方法与resumeWithException方法与之对应,从而使retrofit能更好的与协程使用,不过retrofit后续提供了

implementation "com.jakewharton.retrofit:retrofit2-kotlin-coroutines-adapter:$retrofitCoroutineVersion"

所以可在其apiService里使用Deferred作为回调。

interface LoginService {
  @FormUrlEncoded
  @POST("user/login")
  fun loginAsync(
    @Field("username") username: String,
    @Field("password") password: String
  ): Deferred<LoginResponse>

  @FormUrlEncoded
  @POST("user/register")
  fun registerAsync(
    @Field("username") username: String,
    @Field("password") password: String,
    @Field("repassword") repassword: String
  ): Deferred<LoginResponse>

  @FormUrlEncoded
  @GET("user/logout/json")
  fun quitAsync(): Deferred<LoginResponse>
}

MVVM其核心思路就在于各层之间单向依赖单向交流,不能出现V层直接请求数据等操作。

Navigation实现单activity思路:

尝试了一段时间的Navigation,总体使用下来感觉还行,代码思路挺清晰的,通过xml来管理fragment的行为,activity中只需执行行为就ok了。当然,我这里只是简单的使用无传参的Navigation,其实官方的教程已经很详细的说明了每一个步骤:官方Navigation使用介绍
按照步骤下来应该能轻易的实现tab切换页面的效果,着重说下文档外的一些封装实现:

我的项目分为了两个navigation 分别是navigation_mainnavigation_home

  • navigation_main主要是负责 登录页 首页 独立页面的fragment处理 起着全局导航的作用

  • navigation_home主要负责Collect Todo Me首页三个模块的处理

对应的抽象了一层Fragment用来处理不同的navigation

首页的导航:

abstract class BaseHomeNavFragment:BaseFragment() {

  /**
   * 全局的fragment导航,不是首页三个tab的导航
   * 实际上用的是PackRat\app\src\main\res\navigation\navigation_main.xml
   */
  protected val mainNavController by lazy {
    Navigation.findNavController(activity!!, R.id.activityRootFragment)
  }

  /**
   * 首页三个tab的导航
   */
  protected val homeNavController by lazy {
    Navigation.findNavController(activity!!, R.id.fragmentMainFragment)
  }

  override fun onBackPressed(): Boolean {
    homeNavController.popBackStack()
    return true
  }
}

全局导航:

abstract class BaseMainNavFragment : BaseFragment() {

  /**
   * 全局的fragment导航
   * 用的是PackRat\app\src\main\res\navigation\navigation_main.xml
   */
  protected val mainNavController by lazy {
    Navigation.findNavController(activity!!, R.id.activityRootFragment)
  }

  override fun onBackPressed(): Boolean {
    //执行全局导航的fragment返回栈
    mainNavController.popBackStack()
    return true
  }
}

实例化出来的两个 NavController 主要是方便子类调用,不需要反复实例化。后续在使用过程中仅需如下使用:

//登录监听
viewModel.loginLiveData.observe(this, Observer {
  if (it.errorCode != 0) {
     toast(it.errorMsg)
  } else {
      mainNavController.navigate(R.id.action_login_to_home)
  }
})
... ...
private fun clickEvent(){
  fragmentCollectFab.setOnClickListener {
    mainNavController.navigate(R.id.action_home_to_addCollect)
  }
}
... ...
private fun clickEvent(){
    fragmentAddCollectBackBtn.setOnClickListener {
        mainNavController.navigateUp()
    }
}

复写的onBackPressed用于处理实体返回键是否需要拦截,虽然在xml中的fragment可以通过设置app:defaultNavHost="true"来实现拦截返回键,但由于我的项目页面逻辑是先登录 登录成功后才跳转首页,如果直接用默认的拦截返回键,会出现首页按返回键退回到登陆页面,因此做了一层封装,主要思路参考的Android Jetpack之Fragment里监听返回键的最佳写法

RootActivity中复写OnBackPressed方法

class RootActivity : AppCompatActivity() {

  lateinit var currentFragment:BaseFragment

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_root)
    //如果已登录 跳转到首页
    if (!getSharedPreferences(
            Config.COOKIE_FILE,
            Context.MODE_PRIVATE
        ).getStringSet(Config.COOKIE_KEY, null).isNullOrEmpty()
    ) {
        Navigation.findNavController(this, R.id.activityRootFragment)
            .navigate(R.id.action_login_to_home)
    }
  }

  /**
   * 实体返回键的处理
   */
  override fun onBackPressed() {
    when{
        currentFragment.onBackPressed() -> {}
        else -> super.onBackPressed()
    }
  }
}

在BaseFragment中:

abstract class BaseFragment : Fragment() {

  /**
   * 提供AppCompatActivity实例
   */
  protected lateinit var mActivity: RootActivity

  override fun onAttach(context: Context) {
    super.onAttach(context)
    if (context is RootActivity) {
        mActivity = context
    }
  }
  ... ...
  /**
   * 是否拦截返回键 默认不拦截
   */
  open fun onBackPressed() = false

  override fun onActivityCreated(savedInstanceState: Bundle?) {
    super.onActivityCreated(savedInstanceState)
    mActivity.currentFragment = this
  }

}

意思很简单,就是在需要拦截返回键的Fragment中实现BaseFragmentonBackPressed方法,并返回true,返回true意味着在RootActivityOnBackPressed中执行BaseFragmentonBackPressed方法。

项目代码:https://github.com/512DIDIDI/PackRat

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

推荐阅读更多精彩内容