我是靠谱客的博主 落后冰淇淋,最近开发中收集的这篇文章主要介绍Retrofit+Jetpack(LiveData,Lifecycles,ViewModel,Room)+koin构建Android 官方的推荐架构指南MVVM架构,觉得挺不错的,现在分享给大家,希望可以做个参考。

概述

在这里插入图片描述

基本架构:Android 官方的推荐架构指南https://developer.android.google.cn/jetpack/guide#recommended-app-arch

在这里插入图片描述
请注意,每个组件仅依赖于其下一级的组件。
例如,Activity 和 Fragment 仅依赖于视图模型。存储区是唯一依赖于其他多个类的类;在本例中,存储区依赖于持久性数据模型和远程后端数据源。

这种设计打造了一致且愉快的用户体验。无论用户上次使用应用是在几分钟前还是几天之前,现在回到应用时都会立即看到应用在本地保留的用户信息。如果此数据已过时,则应用的存储区模块将开始在后台更新数据

  • 获取本地数据:

Activity持有ViewModel,
ViewModel持有Repository,
Repository持有Dao,
Dao定义具体的增删改查方法

  • 获取网络数据:

Activity持有ViewModel,
ViewModel持有Repository,
Repository持有Service,
Service定义具体的get,post请求方法

下面是参考官方的sunflower项目的案例

  • 获取本地数据库数据

先来俩按钮:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/tv_add"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="添加本地数据" />
    <Button
        android:id="@+id/tv_getList"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="获取电影列表" />


</LinearLayout>

然后设置各自的点击事件
既然是参照sunflower,我们先看本地数据操作的流程:
简单来说:Activity持有ViewModel,ViewModel持有Repository,Repository持有Dao,Dao定义具体的增删改查方法

1.初始化数据库和定义Dao
//entities是个数组,可以存放多张表
@Database(entities = [User::class], version = 1, exportSchema = false)
abstract class AppDataBase : RoomDatabase() {
//把你的Dao都在这里定义为抽象方法即可
    abstract fun getUserDao(): UserDao

    companion object {
        const val DATABASE_NAME = "zx-db"

        @Volatile
        private var instance: AppDataBase? = null

        fun getInstance(context: Context): AppDataBase {
            return instance ?: synchronized(this) {
                instance ?: buildDatabase(context).also { instance = it }
            }
        }

        private fun buildDatabase(context: Context): AppDataBase {
            return Room.databaseBuilder(context, AppDataBase::class.java, DATABASE_NAME).build()
        }
    }
}
@Entity
data class User (
    @PrimaryKey
    val id: Int,
    val name:String,
    val age: Int
)
@Dao
interface UserDao {
    @Query("select * from User ORDER BY id")
    fun getUsers(): LiveData<List<User>>

    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insertUsers(users: List<User>)
}
2.创建Repository
class UserRepository constructor(private val userDao: UserDao) {


    fun getUser() = userDao.getUsers()
    suspend fun insertUser(users: List<User>) = userDao.insertUsers(users)

    companion object {
        @Volatile
        private var instance: UserRepository? = null

        fun getInstance(userDao: UserDao) =
            instance ?: synchronized(this) {
                instance
                    ?: UserRepository(userDao)
                        .also { instance = it }
            }
    }
}
3.创建ViewModel(使用ViewModelProvider.Factory 创建)
class UserListViewModel constructor(val userRepository: UserRepository) : ViewModel() {

    val users: LiveData<List<User>> = userRepository.getUser()

    suspend fun insertUser(users: List<User>) = userRepository.insertUser(users)



}
class UserListViewModelFactory constructor(val repository: UserRepository) :
    ViewModelProvider.Factory {

    override fun <T : ViewModel?> create(modelClass: Class<T>): T {
        return UserListViewModel(repository) as T
    }
}
4.最后在MainActivity中得到ViewModel并调用相应方法
class MainActivity : AppCompatActivity() {
//初始化viewmodel
private val userViewModel: UserListViewModel by viewModels {
          val appDataBase = AppDataBase.getInstance(this)
          val repository = UserRepository.getInstance(appDataBase.getUserDao())
          UserListViewModelFactory(repository)
      }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

      //观察users
        userViewModel.users.observe(this, Observer {
            for (a in it) {
                println("${a.name},${a.age},${a.id}")
            }
        })

      tv_add.setOnClickListener {

            val user1: User = User(1, "张飞", 22)
            val user2: User = User(2, "诸葛亮", 23)
            val user3: User = User(3, "张对对对", 27)
            val user4: User = User(4, "张对对对22", 27)

            val users = listOf<User>(user1, user2, user3, user4)

            lifecycleScope.launch {
                userViewModel.insertUser(users)
            }

        }
 }
}
  • 获取网络数据

这样操作本地数据的方法就完成了,下面我们看看使用Retrofit网络请求的处理,也是一样
Activity持有ViewModel,ViewModel持有Repository,Repository持有Service,Service定义具体的get,post请求方法

1.先定义好一个Service
interface MsgService {
    @GET("videoHomeTab")
    suspend fun getVideoTab(): HttpResponse<List<Video>>
}

创建一个kt文件,所有的data都写在这一个里面

data class Video(
    val nameType: Int,
    val apiUrl: String,
    val name: String,
    val tabType: Int,
    val id: Int
)
data class HttpResponse<out T>(val code: Int, val msg: String, val result: T)
2.创建Repository
class MsgRepository constructor(
    private val msgService: MsgService
) {
    suspend fun getVideoTab(): HttpResult<List<Video>> {
        return apiCall { msgService.getVideoTab() }
    }

    companion object {
        @Volatile
        private var instance: MsgRepository? = null

        fun getInstance(msgService: MsgService) =
            instance ?: synchronized(this) {
                instance
                    ?: MsgRepository(msgService)
                        .also { instance = it }
            }
    }

}
sealed class HttpResult<out T> {

    data class Success<out T>(val data: T) : HttpResult<T>()

    data class Error(val e: String) : HttpResult<Nothing>()


    override fun toString(): String {
        return when (this) {
            is Success<*> -> "Success[data=$data]"
            is Error -> "Error[exception=$e]"
        }
    }

    fun data(): T {
        return (this as Success<T>).data
    }

    fun isSucceed(): Boolean {
        return this is Success
    }

    fun error(): String {
        return (this as Error).e
    }

    companion object {

        fun handleException(e: Exception): String {
            val context: Context = IApplication.CONTEXT

            val result = when (e) {
                null -> context.getString(R.string.basic_error_unknown)
                is CertificateException, is SSLHandshakeException
                -> context.getString(R.string.basic_error_certificate)
                is MalformedURLException -> context.getString(R.string.basic_error_service_domain)
                is HttpException -> context.getString(R.string.basic_error_service)
                is InterruptedIOException, is SocketException, is TimeoutException, is UnknownHostException
                -> context.getString(R.string.basic_error_network)
                is JsonSyntaxException -> context.getString(R.string.basic_error_response_parse)
                is IOException -> context.getString(R.string.basic_error_request)
                is ClassCastException -> context.getString(R.string.basic_error_data_structure)
                else -> e.toString()

            }
            return result

        }
    }


}

创建一个kt文件

suspend fun <T> apiCall(call: suspend () -> HttpResponse<T>): HttpResult<T> {
    return try {
        call().let {
            if (it.code == 0 || it.code == 200) {
                HttpResult.Success(it.result)
            } else {
                HttpResult.Error(it.msg)
            }
        }
    } catch (e: Exception) {
        HttpResult.Error(HttpResult.handleException(e))
    }


}
3.创建ViewModel(使用ViewModelProvider.Factory 创建)
class MsgViewModel constructor(val repository: MsgRepository) : ViewModel() {

    private val _getVideoTab = MutableLiveData<HttpResult<List<Video>>>()
    val getVideoTab: LiveData<HttpResult<List<Video>>>
        get() = _getVideoTab


    fun getVideoTab() {
        viewModelScope.launch {
            _getVideoTab.value = repository.getVideoTab()
        }
    }

}
class MsgViewModelFactory constructor(val repository: MsgRepository) : ViewModelProvider.Factory {
    override fun <T : ViewModel?> create(modelClass: Class<T>): T {
        return MsgViewModel(repository) as T
    }
}
4.最后在MainActivity中得到ViewModel并调用相应方法
class MainActivity : AppCompatActivity() {

     private val msgViewModel: MsgViewModel by viewModels {
       val retrofit = retrofitClient.createRetrofit("https://api.apiopen.top")
       val msgService = retrofit.create(MsgService::class.java)
       val repository = MsgRepository.getInstance(msgService)
       MsgViewModelFactory(repository)
   }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        msgViewModel.getVideoTab.observe(this, Observer {
            if (it.isSucceed()) {
                for (a in it.data()) {
                    println("${a.apiUrl},${a.name}")
                }

            } else {
                Toast.makeText(this, it.error(), Toast.LENGTH_LONG).show()
            }
        })
}

}

retrofit的配置:

class RetrofitClient {


    fun createRetrofit(baseUrl: String): Retrofit {
        return Retrofit.Builder()
            .baseUrl(baseUrl)
            .client(provideClient(OkHttpClient.Builder()))
            .addConverterFactory(GsonConverterFactory.create())
            .build()

    }

    private fun provideClient(builder: OkHttpClient.Builder): OkHttpClient {
        if (BuildConfig.DEBUG) {
            builder.addNetworkInterceptor(initLogInterceptor())
        }
        builder.addInterceptor(initHeader())
        builder.connectTimeout(30, TimeUnit.SECONDS)
        builder.readTimeout(30, TimeUnit.SECONDS)
        builder.writeTimeout(30, TimeUnit.SECONDS)
        return builder.build()
    }

    //----------------------------------------具体配置---------------------------------------------

    private fun initHeader(): Interceptor {
        return Interceptor { chain ->
            val originalRequest = chain.request()
            val requestBuilder = originalRequest.newBuilder()
                .header("Content-Type", "application/json")
                .header("Accept", "application/json")
                .method(originalRequest.method, originalRequest.body)
            val request = requestBuilder.build()
            chain.proceed(request)
        }
    }

    private fun initLogInterceptor(): HttpLoggingInterceptor {
        val loggingInterceptor = HttpLoggingInterceptor()
        loggingInterceptor.level = HttpLoggingInterceptor.Level.BODY
        return loggingInterceptor
    }
}
class IApplication : Application() {
    companion object {
        var CONTEXT: Context by Delegates.notNull()
    }

    override fun onCreate() {
        super.onCreate()
        CONTEXT = applicationContext
    }
}

上述基本就实现了获取本地和网络数据

但是viewmodle的初始化不是很完美,我这边是koin来简化一下,并且把dao和service合并到一个Repository里面来
改动的地方:

1.MsgRepository持有dao和service
class MsgRepository constructor(
    private val msgService: MsgService, private val userDao: UserDao
) {

    suspend fun getVideoTab(): HttpResult<List<Video>> {
        return apiCall { msgService.getVideoTab() }
    }

    fun getUser() = userDao.getUsers()
    suspend fun insertUser(users: List<User>) = userDao.insertUsers(users)

    companion object {
        @Volatile
        private var instance: MsgRepository? = null

        fun getInstance(msgService: MsgService, userDao: UserDao) =
            instance ?: synchronized(this) {
                instance
                    ?: MsgRepository(msgService, userDao)
                        .also { instance = it }
            }
    }

}

这里就可以就同一个Repository直接调用了

class MsgViewModel constructor(val repository: MsgRepository) : ViewModel() {

    private val _getVideoTab = MutableLiveData<HttpResult<List<Video>>>()
    val getVideoTab: LiveData<HttpResult<List<Video>>>
        get() = _getVideoTab

    fun getVideoTab() {
        viewModelScope.launch {
            _getVideoTab.value = repository.getVideoTab()
        }
    }

    val users: LiveData<List<User>> = repository.getUser()

    suspend fun insertUser(users: List<User>) = repository.insertUser(users)
}
2.创建AppModule.kt文件
val viewModelModule = module {
    factory { MsgViewModel(get()) }
}
val repositoryModule = module {
    single { MsgRepository(get(), get()) }
}
val dataModule = module {
    single {
        RetrofitClient().createRetrofit("https://api.apiopen.top").create(MsgService::class.java)
    }
    single {
        AppDataBase.getInstance(IApplication.CONTEXT).getUserDao()
    }
}

val appModule = listOf(viewModelModule, repositoryModule, dataModule)
3.Application中初始化
class IApplication : Application() {
    companion object {
        var CONTEXT: Context by Delegates.notNull()
    }

    override fun onCreate() {
        super.onCreate()
        CONTEXT = applicationContext
    //初始化koin
        startKoin {
            androidContext(this@IApplication)
            modules(appModule)

        }
    }
}
4.最后Mainactiviy就可以这样调用了
class MainActivity : AppCompatActivity() {
    //通过koin获取ViewModel
    val msgViewModel: MsgViewModel by inject()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        observers()


        tv_add.setOnClickListener {

            val user1: User = User(1, "张飞", 22)
            val user2: User = User(2, "诸葛亮", 23)
            val user3: User = User(3, "张对对对", 27)
            val user4: User = User(4, "张对对对22", 27)

            val users = listOf<User>(user1, user2, user3, user4)

            lifecycleScope.launch {
                msgViewModel.insertUser(users)
            }

        }

        tv_getList.setOnClickListener {
            msgViewModel.getVideoTab()
        }
    }

    private fun observers() {
    //通过msgViewModel获取网络数据
        msgViewModel.getVideoTab.observe(this, Observer {
            if (it.isSucceed()) {
                for (a in it.data()) {
                    println("${a.apiUrl},${a.name}")
                }

            } else {
                Toast.makeText(this, it.error(), Toast.LENGTH_LONG).show()
            }
        })

//通过msgViewModel获取本地数据
        msgViewModel.users.observe(this, Observer {
            for (a in it) {
                println("${a.name},${a.age},${a.id}")
            }
        })

    }
}

本案例涉及到的技术框架:LiveData,Lifecycles,ViewModel,Room,Koin,Retrofit
官方文档:https://developer.android.google.cn/jetpack

最后

以上就是落后冰淇淋为你收集整理的Retrofit+Jetpack(LiveData,Lifecycles,ViewModel,Room)+koin构建Android 官方的推荐架构指南MVVM架构的全部内容,希望文章能够帮你解决Retrofit+Jetpack(LiveData,Lifecycles,ViewModel,Room)+koin构建Android 官方的推荐架构指南MVVM架构所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。

本图文内容来源于网友提供,作为学习参考使用,或来自网络收集整理,版权属于原作者所有。
点赞(50)

评论列表共有 0 条评论

立即
投稿
返回
顶部