Kotlin Extension in action - Kotlin重构项目谈

Extension in action

去年的Google IO大会让Kotlin语言大火,大量开发者尝试使用Kotlin进行开发,然而很多人抱怨道:“Kotlin有什么好的啊?没有什么感觉啊?不就是一些语法糖吗?”… 究其原因,很多人依然在写着Java Style的Kotlin,并没有尝试着去感悟Kotlin的语法糖背后的设计思维,以及如何将那些语法特性运用在生产环境的项目中。

最近的一些时间,我们在使用Kotlin对项目基础架构进行重新设计,于是在这篇文章写下我们的心得体会~

导读:

拓展

拓展干什么?

拓展功能是一个非常有魅力的功能,它可以让我们对已有的SDK进行功能的增强(在保证代码优雅的情况下)。

  • 场景1:在我们的项目中,为了做到APP的沉浸,需要获取到StatusBar的高度,在Java里面,你可以写一个某某Util来获取这个信息,而在Kotlin中,你可以使用拓展属性来为Activity进行拓展。
inline val Activity.statusBarHeight
    get() = resources.getIdentifier("status_bar_height", "dimen", "android")
            .takeIf { it > 0 }?.let {
                resources.getDimensionPixelSize(it)
            } ?: 0

inline val Activity.navigationBarHeight
    get() = resources.getIdentifier("navigation_bar_height", "dimen", "android")
            .takeIf { it > 0 }?.let {
                resources.getDimensionPixelSize(it)
            } ?: 0

在使用拓展属性的时候,就有着使用自己原生的属性一样的感觉。而我们还不算完,我们可以使用多个拓展属性,拓展方法的配合来让我们的拓展功能更加优雅。比如说,获取了statusBarHeight后,我们对外层view进行重新设置padding来让其达成沉浸式的效果。这时候我们就可以这样子来写:

fun Activity.fitSystemWindowWithStatusBar(view: View) = with(view) {
    setPadding(paddingLeft, paddingTop + statusBarHeight, paddingRight, paddingBottom)
    if (layoutParams.height > 0)
        layoutParams.height += statusBarHeight
}

在Activity里面对View带哦用这个方法,就像是Activity自己的方法一样。(Activity自己就支持了沉浸式耶)

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.gpa2_activity_evaluate)
        
        // init toolbar
        toolbar = findViewById<Toolbar>(R.id.toolbar).also {
            fitSystemWindowWithStatusBar(it)
            setSupportActionBar(it)
        }

参考代码:UISupport.kt

  • 场景2:OkHttp封装网络框架的时候,比如说我们需要对不同的请求使用不同的Ineceptor(对于某个域名下的请求要加入Token,对于非该域名的访问不加入任何Token和UA)。应该怎么做?

或者应该问… 怎么样才是优雅的做法?你的大脑闪过:那我创建两个Client好了… (极其暴力)
这个时候,我们就需要用到Kotlin的拓展属性来做这件事情。你也许会疑惑… 这个怎么用在这里?让我们来慢慢看~

预备知识:OkHttp的Interceptor设计理念与使用

OkHttp拦截器
object ServiceFactory {

    internal const val TRUSTED_HOST = "open.twtstudio.com"
    internal const val BASE_URL = "https://$TRUSTED_HOST/api/"

    internal const val APP_KEY = "xxxxxxx"
    internal const val APP_SECRET = "xxxxxx"

    private val loggingInterceptor = HttpLoggingInterceptor()
            .apply { level = HttpLoggingInterceptor.Level.BODY }

    val client = OkHttpClient.Builder()
            .addInterceptor(UserAgentInterceptor.forTrusted)
            .addInterceptor(SignatureInterceptor.forTrusted)
            .addInterceptor(AuthorizationInterceptor.forTrusted)
            .authenticator(RealAuthenticator)
            .addNetworkInterceptor(loggingInterceptor)
            .addNetworkInterceptor(CodeCorrectionInterceptor.forTrusted)
            .build()

    //省略其他代码...
}

你会发现,每一个Interceptor的后面都会加上一个.forTrusted,这里就是对于拓展属性的运用。那么我们如何设计这里?

internal inline val Request.isTrusted
    get() = url().host() == ServiceFactory.TRUSTED_HOST

/**
 * A wrapped interceptor only applied to trusted request.
 *
 * @see ServiceFactory
 */
internal val Interceptor.forTrusted
    get() = Interceptor {
        if (it.request().isTrusted) intercept(it)
        else it.proceed(it.request())
    }

为所有的Interceptor类型添加forTrusted拓展属性。在取得这个属性的时候,返回的是一个Interceptor的实现,因为Interceptor接口只有一个方法,所以可以直接用lambda表达式来写,表达式大括号里面便是对Response intercept(Chain chain) throws IOException这个方法的实现,其实就是在这里加了一层AOP,如果要拦截的Request是Trusted,我们就调用被拓展对象的intercept方法来拦截它,否则直接放行,传到下一层chain。

在这里我们也对于Request进行了isTrusted属性的拓展,这种属性拓展,可以大幅度提高代码的可读性,因为你发现,即使我不去看isTrusted拓展的实现,我也可以推测出这个属性的意思。这样子就很可读…

已经可以了大佬

多说几句,这种使用拓展属性的写法,对于基础库封装和其他的场景,可以通过拓展属性/拓展方法通俗易懂的命名来大幅度提高代码的可读性 —— Rickygao同学(大意是这样子的)

如果你要抬杠,可以说java里面封装静态Util也可以做到… 但代码可读性还是会有一层的差距的 (逃

再举一个这方面的例子,我们写了一个Interceptor来处理OkHttp请求的签名。我们先看一段代码

internal object SignatureInterceptor : Interceptor {
    override fun intercept(chain: Interceptor.Chain): Response =
            chain.proceed(chain.request().signed)
}

我们只看到这一部分,看到chain.request().signed的时候,你就应该想到:“哦,这个地方是发了一个Request的签名后处理版”。如果我们只是为了梳理代码逻辑,看到这里就已经足够了… 我们已经知道了这个Interceptor是签名了网络请求(就可以溜了

如果我们要详细看签名逻辑,我们可以点进去signed拓展看它的逻辑。

internal inline val Request.signed
    get() = when (method()) {
        "HEAD" -> this
        "GET" -> newBuilder().url(url().signed).build()
        "POST", "PUT", "PATCH", "DELETE" -> newBuilder().method(method(), body()?.signed).build()
        else -> this
    }

这里我们可以看到,signed对于不同请求类型进行处理(when简直好用到爆炸),然后我们发现对于不同的请求,有着不同分支处理,比如说GET它sign了url,POST什么的,对body做sign… (因为是inline拓展,所以不用担心性能 逃

这块我们就看到这里。你会发现,通过拓展属性的抽离,你可以在不把实现一层层看完的情况下,对于代码组织依然有着清晰的理解… Kotlin拓展的魅力。

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

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,571评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,330评论 25 707
  • 前言 人生苦多,快来 Kotlin ,快速学习Kotlin! 什么是Kotlin? Kotlin 是种静态类型编程...
    任半生嚣狂阅读 26,131评论 9 118
  • 今天早上格外忙,早早起床做饭,照顾婆婆吃了早饭,收拾整理好房间,洗漱赶紧上班。(8点到单位签到,忙碌的一天开始了)...
    津哥铁狼阅读 386评论 1 2
  • 三星C系发布今晚7点,三星将在北京发布全新的C系列手机,这两天也关注了不少这方面的信息。我只能说:好头疼啊 目前看...
    adonisjph阅读 257评论 0 0