D uzm
D uzm
3月前 · 10 人阅读

框架详细介绍GitHub地址

KotlinMvcLib2

升级版的mvc模式,controller和activity生命周期绑定,利用livedata(与接收者的生命周期相关)来传输数据
网络访问封装了retrofit基本访问,并没有结合rxjava,如果需要可以自己来设置

第一步 导入库

1.在根builde.gradle的allprojects下面添加jitpack仓库

 repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io' }
    }

2.设置依赖基本设置,在根builde.gradle的buildscript下面添加统一设置

    ext.kotlin_version = '1.2.40'//你的kotlin版本
    ext.sdk_version = '27.1.1'//你的sdk版本 eg:implementation "com.android.support:recyclerview-v7:$sdk_version"
    ext.archLifecycleVersion = '1.1.1' //生命周期版本
    ext.minSdkVersion = 19//最小版本
    ext.targetSdkVersion = 28//最大支持
    ext.compileSdkVersion = 27//编译版本

3.导入依赖库

 api 'com.github.kotle:KotlinMvcLib2:1.0.4'

第二步 开始使用

建议自己写三个基类(model,controller,activty)来继承仓库的三个基类
因为这样你可以在自己基类里面处理一些通用的操作

1.你的网络层应该继承KtBaseModel,提供一些数据来源

class DemoModel : KtBaseModel() {
}

2.你的控制层应该继承KtBaseModel,提供一些数据来源

//如果需要model,传入model的泛型
class DemoController(application: Application):KtBaseController<DemoModel>(application) {
    override fun createNet(): DemoModel? = DemoModel()
    //对象销毁的时候调用,有activty通过自己的生命周期调用,在onDestroy()之前
    override fun onCleared() {
        super.onCleared()
    }
}
//如果功能简单 不需要model类,泛型处传入KtBaseModel,并且createNet()方法返回null
class DemoController(application: Application):KtBaseController<KtBaseModel>(application) {
    override fun createNet(): DemoModel? = null
    //对象销毁的时候调用,有activty通过自己的生命周期调用,在onDestroy()之前
    override fun onCleared() {
        super.onCleared()
    }
}

3.你的activity应该继承KtBaseActivity,并传入控制层的泛型

//注意:这里并不是通过new的方式来创建controller类,而是另外一种,在基类已经处理
class DemoActivity : KtBaseActivity<DemoController>() {
    //获取和activity关联的xml
    override fun getLayoutRes(): Int =R.layout.activity_demo
    //返回值为标题,如果不需要返回null
    override fun initTitle(toolbar: Toolbar): String? {
       return "我是标题,不需要返回null"
    }
    //这里可以做一些初始化操作,比如设置liveData的监听
    override fun onObserve(controller: DemoController) {
       
    }
    //在Activity的onCreate最后执行,防止重写activity发出一些警告(由于java和kotlin的一些不兼容)
    override fun initCreate(savedInstanceState: Bundle?) {
        
    }
}
//一些简单的activity,如果不需要Controller类,泛型传入KtBaseController<*>或者KtBaseController<KtBaseModel>
class DemoActivity : KtBaseActivity<KtBaseController<*>>() {
    //不需要controller,一点要重写此方法,返回false,否则会抛出异常
    override fun isNeedController(): Boolean {
        return false
    }
    //获取和activity关联的xml
    override fun getLayoutRes(): Int =R.layout.activity_demo
    //返回值为标题,如果不需要返回null
    override fun initTitle(toolbar: Toolbar): String? {
       return "我是标题,不需要返回null"
    }
    //这里可以做一些初始化操作,比如设置liveData的监听
    override fun onObserve(controller: KtBaseController<*>) {

    }
    //在Activity的onCreate最后执行,防止重写activity发出一些警告(由于java和kotlin的一些不兼容)
    override fun initCreate(savedInstanceState: Bundle?) {

    }
}

3.你的fragment应该继承KtBaseFragment,并传入控制层的泛型

class DemoFragment : KtBaseFragment<DemoController>() {
    override fun getLayoutRes(): Int = R.layout.fragment_demo
    //在onCreateView()的时候调用
    override fun onCreateRootView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?) {
    }

    override fun onObserve(controller: DemoController) {

    }

    override fun isNeedController(): Boolean {
        //如果不需要controller 返回false
        mController//拿到controller对象
        mRootView//拿到fragment对应的xml
        return super.isNeedController()
    }
}

第三步 通过KtLiveData来把controller的数据给activity

1.设置一个KtLiveData的变量

val test=KtLiveData<String>()
//然后推送数据
 test.set("在主线程用这个方法")
 test.post("在子线程用这个方法")

2.在Activity注册监听

 //这里可以做一些初始化操作,比如设置liveData的监听
    override fun onObserve(controller: DemoController) {
         controller.test.call(this, Observer { 
             //这里接收set或者post的值,在onStart()之后接收,在onStop()不在接收
         })
    }

其他

在KtBaseActivity有一个mController的变量,直接拿到congtroller对象
在KtBaseController,getViewModel()获取model对象,getApplication<>()拿到全局的application

关于网络框架的使用

1.新建一个Api接口,然后获取searvice

interface Api {
    @GET("open/xiaohua.json")
    fun getJokListRes():Call<ResponseBody>
}
//创建retrofit对象
val BASE_URL = "http://api.laifudao.com/"
val service by lazy { KtNet.ktCreateService(BASE_URL, Api::class.java) }
//然后发送请求
  KtNet.ktSendRequest(service.getJokListRes(), {
            //成功
       }, {
          //失败
        })

2.KtNet是封装的一个网络请求,完整代码如下

object KtNet {
    private var retrofit: Retrofit? = null
    private lateinit var api: Any
    /**
     * 默认的创建网络的请求,数据会转为Bean
     */
    fun <T> ktCreateService(baseUrl: String, t: Class<T>, client: OkHttpClient? = null): T {
        if (retrofit != null && retrofit?.baseUrl().toString() == baseUrl) {
            return (api as? T)!!
        }
        retrofit = Retrofit.Builder()
                .baseUrl(baseUrl)
                .client(client ?: OkHttpClient())
                .addConverterFactory(GsonConverterFactory.create())
                .build()
        api = retrofit!!.create<T>(t)!!
        return (api as? T)!!
    }

    /**
     * 有基本的使用功能,需要自定义转换器
     */
    fun <T> ktCreateBaseNet(baseUrl: String, apiClass: Class<T>, builder: ((Retrofit.Builder) -> Unit)? = null): T {
        val retrofitBuilder = Retrofit.Builder();
        retrofitBuilder.baseUrl(baseUrl)
        builder?.invoke(retrofitBuilder)
        return retrofitBuilder.build().create<T>(apiClass)
    }

    /**
     * 通过service发送请求,并回调
     */
    fun <T> ktSendRequest(request: retrofit2.Call<T>, success: (T) -> Unit, fail: ((Throwable?) -> Unit)? = null) {
        request.enqueue(object : Callback<T> {
            override fun onFailure(call: retrofit2.Call<T>?, t: Throwable?) {
                fail?.invoke(t)
                t?.printStackTrace()
            }

            override fun onResponse(call: retrofit2.Call<T>?, response: Response<T>?) {
                if (response?.body() == null) {
                    fail?.invoke(Throwable("response.body is null"))
                } else {
                    success.invoke(response.body()!!)
                }
            }
        })
    }
}

关于KtPermission

object KtPermission {
    private var noPermissionList = ArrayList<String>()
    //需要的权限添加到这个集合中
    private var needPermissions = ArrayList<String>()

    fun addNeedPermission(vararg permissions: String) {
        for (c in permissions) {
            if (!needPermissions.contains(c)) {
                needPermissions.add(c)
            }
        }
    }

    fun addNeedPermission(permissions: List<String>) {
        for (c in permissions) {
            if (!needPermissions.contains(c)) {
                needPermissions.add(c)
            }
        }
    }

    /**
     * ture 获取所有权限
     * false 没有获取所有权限
     */
    fun checkedPermission(context: Activity): Boolean {
        var isGetAllPermission = true
        noPermissionList.clear()
        needPermissions?.filter { ContextCompat.checkSelfPermission(context, it) == PackageManager.PERMISSION_DENIED }
                ?.forEach {
                    isGetAllPermission = false
                    noPermissionList.add(it)
                }
        if (!isGetAllPermission) {
            val p = Array(noPermissionList.size, { noPermissionList[it] })
            ActivityCompat.requestPermissions(context, p, 1)
        }
        return isGetAllPermission
    }
}
收藏 0
fun override controller null a
评论 ( 0 )