写点什么

携程 Kotlin DSL 开发与实践

  • 2019-09-24
  • 本文字数:4998 字

    阅读完需:约 16 分钟

携程Kotlin DSL开发与实践

每一个 DSL,都是一定意义上专有的语言,这篇文章希望能够用浅显易懂的方式,将 Kotlin DSL 的应用与实践经验分享给大家。希望对你有所启发,能够构建一门属于自己的专有“语言”。

一、简介

DSL(domain specific language),即领域专用语言:专门解决某一特定问题的计算机语言。由于它是以简洁的形式进行表达,整体上直观易懂,使得调用代码和读代码的成本都得以降低,即使是不懂编程语言的一般人都可以进行使用,所以近年来频频被提起,颇受关注。


DSL 分为外部 DSL 和内部 DSL。


DSL:在主程序设计语言之外,用一种单独的语言表示领域专有语言。可以是定制语法,或者遵循另外一种语法,如 XML、JSON。


内部 DSL:通常是基于通用编程语言实现,具有特定的风格,如 iOS 的依赖管理组件 CocoaPods 和 Android 的主流编译工具 Gradle。


这里主要分享在 Kotlin 中构建使用 DSL。

二、应用

Kotlin DSL 的应用广泛,包括 gradle 编写、编写 js、html、SQL 等。下面列举几个使用场景:

2.1 Trip.com 支付网络封装实践

在编写网络代码时,出现频率最高的就是 request 配置和大篇幅的 response 回调处理,那么这两部分的代码该如何优化?在 Trip.com 支付中利用 kotlin DSL 对网络进行二次封装,针对以上问题进行解决。


定义 request 配置,使得最终在做 request 配置时更为简洁:


fun requestBean(request: () -> BusinessBean) {    payClientBuilder.setRequestBean(request())}fun needRetry(needRetry: () -> Boolean) {    payClientBuilder.setNeedRetry(needRetry())}......
复制代码


定义回调模版,解决以下问题:部分网络请求,我们不关心结果,或者不关心 onFailed 的场景,避免掉这部分的冗余代码:


private var callSubSuccess: ((T) -> Unit)? = nullprivate var callSubFailed: ((Client.Error?) -> Unit)? = nullprivate var subCallback: PayNetCallback<T> = object : PayNetCallback<T> {    override fun onSucceed(response: T) {        callSubSuccess?.invoke(response)    }
override fun onFailed(error: Client.Error?) { callSubFailed?.invoke(error) }}fun subSuccess(subSuccess: (T) -> Unit) { callSubSuccess = subSuccess payClientBuilder.setSubCallBack(subCallback)}
fun subFailed(subFailed: (Client.Error?) -> Unit) { callSubFailed = subFailed payClientBuilder.setSubCallBack(subCallback)}
复制代码


预定义扩展函数


object PayNetworkClient {    fun <T : BusinessBean> init(        costClass: Class<T>,        config: PayClientConfigBuilder<T>.() -> Unit    ): PayClientBuilder.NetworkClient? {        var networkClient: payClientBuilder.NetworkClient?        with(PayClientConfigBuilder(costClass)) {            networkClient = build(config)        }        return networkClient    }}
复制代码


最终调用


val networkClient = PayNetworkClient.init(BusinessResponse::class.java) {    //配置部分    requestBean { request }    needRetry { false }    cancelOtherSession { "sendGetPayInfo" }    //回调部分,可根据需求添加subSuccess或subFailed    subSuccess { serviceSuccess(it) }    subFailed { serviceFailed(it) }}networkClient?.send()
复制代码


在定义 DSL 的过程中需要权衡冗余度、自由度、可扩展性。上面给出的伪代码消除了重复的模版代码,减少代码冗余,同时也做到自由选择配置项,有一定的自由度和可扩展性。

2.2 海外支付 SDK DSL 构建项目实践

众所周知 Android studio 中是使用 groovy 编写 gradle 脚本,而 groovy 由于是动态语言,不可避免的存在一个问题,就是代码提示不够智能,我们在使用 groovy 时往往需要配合文档进行编写;而 kotlin 是一种静态语言,使用它编写 gradle 脚本则可以有比较好的智能提示体验。


在 Gradle5.0 中,官方提供可以选择在项目中生成 Groovy 或者 kotlin DSL 构建脚本,并进一步的优化代码自动完成、重构和其他 IDE 辅助功能,为使用 Kotlin DSL 的 IDE 用户带来了极大的便利。



可见 gradle 官方也在努力将 kotlin DSL 推向大家视野中。


在我们最近的海外支付 SDK 中,采用该种方式构建项目, 部分 gradle 代码如下:


import org.jetbrains.kotlin.config.KotlinCompilerVersion
plugins { id("com.android.application") kotlin("android") kotlin("android.extensions")}
android { compileSdkVersion(28) defaultConfig { applicationId = "trip.pay.app" minSdkVersion(21) targetSdkVersion(28) versionCode = 1 versionName = "1.0" testInstrumentationRunner = "android.support.test.runner.AndroidJUnitRunner" } buildTypes { getByName("release") { isMinifyEnabled = true proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro") } }}
dependencies { implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar")))) implementation(kotlin("stdlib-jdk8", KotlinCompilerVersion.VERSION)) implementation("com.android.support:appcompat-v7:28.0.0") implementation("com.android.support.constraint:constraint-layout:1.1.3") implementation(project(":TripPay"))}
repositories { mavenLocal() maven(url = "maven地址")}
复制代码


可以看到使用 kotlin 编写和 groovy 编写区别不大,所以即使我们要将现有工程中的 groovy 脚本重写为 kotlin 脚本,工作量也不会过大。


以上种种都表明 Kotlin DSL 相对于 groovy 的优势非常明显,那么我们是不是应该立马开始改造现有的项目?


答案是“否”,因为它目前存在一个致命的缺陷,在首次编译项目时比 groovy DSL 慢很多,大项目中这一点会被放大,所以大家在上手之前需要慎重权衡利弊。


目前我们在海外支付 SDK 中利用 kotlin DSL 构建大约在 17s,利用 groovy DSL 构建大约在 16s,时间上来说几乎没有区别,所以小型项目推荐尝试使用!


相信在不久的未来 kotlin DSL 可以解决这个问题,那么利用 kotlin DSL 构建项目势必会成为趋势。

2.3 Anko

Anko 库包括 Anko Commons、Anko Layouts、Anko SQLite、Anko Coroutines,这些都是使用 kotlin DSL 编写,这里主要介绍 Anko Layouts。


在写 Android 布局时,我们都习惯性的使用 XML 进行编写,但是可以考虑丢下冗长的 XML 写法,尝试使用 Anko Layout 来实现。


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:orientation="vertical">
<EditText android:id="@+id/todo_title" android:layout_width="match_parent" android:layout_height="wrap_content" android:hint="@string/main_edit_hint" />
<Button android:layout_width="match_parent" android:layout_height="wrap_content" android:text="@string/main_button_text" />
</LinearLayout>
复制代码


Anko Layout 写法:


verticalLayout {    setGravity(Gravity.CENTER_VERTICAL)    editText {        hintResource = R.string.main_edit_hint         }.lparams(width = matchParent, height = wrapContent)    button {        textResource = R.string.main_button_text        onClick {            toast("click!")        }    }.lparams(width = matchParent, height = wrapContent)}
复制代码


实际上前文提到过,XML 本质上也是一种 DSL,但是明显使用 Anko Layout 风格更加简单、也更加灵活。


XML 编写后,我们需要 findViewById 找到控件,再对控件进行操作、赋值;Anko Layout 编写过程中,可以在布局中就直接做显示隐藏、赋值操作等,同时这种写法也有类型安全、空安全、代码复用性强的优势。


Anko Layout 由于是直接在 kt 文件中编写控件,那么它相对于 xml 来说,还有一个优势,即:减少了 XML 格式的解析过程,从而实现 CPU 资源和电量的节省。


XML 的执行流程:



Anko Layout 执行流程:



Anko 库实际上是用 kotlin 对相关类做了一层扩展包装,基于这一点,它的局限性也体现在于会增加包大小,在使用之前可以根据项目评估一下是否适合引入 Anko 库。

2.4、创建一个自己的 DSL

Kotlin DSl 的优势这么多,那么如何自定义一个 DSL?


kotlin 的扩展函数、高阶函数、lambda 表达式、中缀调用、invoke 约定和函数小括号省略等特性,使得 Kotlin 编写 DSL 尤为顺畅,我们可以使用这些特性来实现自己的“领域特定语言”。这里给一个简单的示例:


定义 Trip、Department 类


data class Trip(var name: String? = "", var address: String? = "", var departments: List<Department>? = mutableListOf(), var city: List<String>? = mutableListOf(), var culture: String? = "")
复制代码


data class Department(var name: String = "", var nameEn: String = "")
复制代码


定义中间类,主要是为了实现直接 DSL 方式添加 department 的效果


class TripBuilder {        var name: String? = ""        var address: String? = ""        var departments = mutableListOf<Department>()
fun department(block: DepartmentBuilder.() -> Unit) {// 简单的写法departments.add(DepartmentBuilder().apply(block).build())即可// 演示invoke实现 val departmentBuilder = DepartmentBuilder() block.invoke(departmentBuilder) departments.add(departmentBuilder.build()) }
fun build(): Trip = Trip(name, address, departments) }
class DepartmentBuilder { var name: String = "" var nameEn: String = ""
fun build(): Department = Department(name, nameEn)}
复制代码


创建 trip 的 DSL 写法


fun trip(block: TripBuilder.() -> Unit): Trip = TripBuilder().apply(block).build()
复制代码


实现中缀 culture 方法(只为了演示所用,实际上可以直接赋值)


infix fun Trip.culture(culture: String) {    this.culture = culture}
复制代码


最终调用效果:


val trip = trip {    name = "Trip"    address = "上海市长宁区金钟路968号凌空SOHO"    department {        name = "机票"        nameEn = "flight"    }    department {        name = "酒店"       nameEn = "hotel"    }    department {        name = "火车票"        nameEn = "train"    }}trip culture "Customer、Teamwork、Respect、Integrity、Partner"Log.i("result",trip)
复制代码


result 结果:


Trip(name=Trip, address=上海市长宁区金钟路968号凌空SOHO, departments=[Department(name=机票, nameEn=flight), Department(name=酒店, nameEn=hotel), Department(name=火车票, nameEn=train)], culture=Customer、Teamwork、Respect、Integrity、Partner)
复制代码


一个简单的 Kotlin DSL 就这样实现了,通过封装成结构化的 API 达到了直观易懂、最终调用时代码量减少的效果。即使是一个非 kotlin 开发人员也可以理解以上格式的含义,完成“Trip”对象的配置使用。

三、写在最后

1)Kotlin 编写完的 DSL 整体简洁直观,调用代码和读代码的成本都得以降低,在生产项目中可以稳定使用。


2)DSL 是通过简化语言中的元素,降低使用者的负担,使用者需要按照既定的规范进行编写。所以我们需要提供完善使用文档,以保证接入者学习成本降低。


3)在我们编写的 DSL 应用范围越来越大时,已有 DSL 往往满足不了现有的需求,我们仍然需要对 DSL 进行补充,所以在定义自己的 DSL 时需要评估后期开发维护效率,注意其可扩展性。


作者介绍


刘媛,携程金融高级开发工程师,主要负责中文版、国际版支付 Android 端的开发及维护工作。


本文转载自公众号携程技术中心(ID:ctriptech)


原文链接


https://mp.weixin.qq.com/s?__biz=MjM5MDI3MjA5MQ==&mid=2697268865&idx=2&sn=8ef7147cccce782c4279e20fe1aaf765&chksm=8376f1b5b40178a330e388c0a36532131f485b767d6508f3fd5c790d014893edee4ee4bf7c96&scene=27#wechat_redirect


2019-09-24 08:004171

评论

发布
暂无评论
发现更多内容

从工具、工具箱到数字化软件工厂——DevOps 设计理念与工程实践专场 | CIF 精彩看点

CODING DevOps

DevOps 数字化 研发工具 腾讯云 CIF 峰会

史上最全Java高频面试合集,命中率高达95%

Java 程序员 架构 面试 后端

音视频终端引擎优化实践

百度开发者中心

最佳实践 音视频 实践案例 智能视频 行业深度

互斥锁、自旋锁、读写锁...理清它们的区别和应用

行云创新

云计算 编程 开发 应用

东软熙康、百度、京东方,互联网医院的三个典型样本

海比研究院

AlibabaP9力荐!最新出品1297页JDK源码+并发核心原理解析小册

Java 架构 面试 程序人生 编程语言

超十年渗透专家总结出636页渗透测试全笔记,100课时一次讲清

Java 架构 面试 程序人生 编程语言

用Python绘制专业的K线图【含源代码】

恒生LIGHT云社区

手把手教你使用Studio Lite + Digtal car!助力智能汽车场景、轻应用开发更轻松!

SOA开发者

图谱相关技术在风控反作弊中的应用和探索

百度Geek说

后端 软件架构

艾瑞发布《2021年中国企业级 SaaS 行业研究报告》,ONES 入选典型厂商案例

万事ONES

项目管理 SaaS 协同办公

浪潮云洲荣获两项工业自动化及数字化行业年度大奖 inspur浪潮云 昨天

云计算

掘金热榜第一!阿里P8用近十个月整理出来999页Java岗核心笔记限时开源!

Java 架构 面试 程序人生 编程语言

不得不聊一聊英语爱好者的单词杂货铺了

小匚

随笔杂谈 生活记录 英语 大学英语四六级 单词

目睹阿里技术官写的Tomcat架构笔记后,瞬间觉得自己是渣渣

Java 架构 面试 程序人生 编程语言

智能大数据专场,百度智能云带来智能大数据产品架构全景图

百度大脑

人工智能 大数据

如何让文件共享 SDK 支持使用 Uri 上传文件

ZEGO即构

文件存储 分区存储 文件共享

提高工作效率的三种方法

石云升

团队管理 管理 引航计划 内容合集 9月日更

重磅来袭,虚拟化技术分类

hanaper

行云创新:云原生技术助力企业数字化转型

行云创新

技术 云原生 转型 数字化 平台

如何做一场有趣又高效的迭代回顾会议?

万事ONES

Scrum 敏捷 回顾会

拥抱开源,共建生态 - 开源生态与效能提升专场 | CIF 精彩看点

CODING DevOps

DevOps 研发效能 腾讯云 CIF 峰会 开源生态

智能网联汽车行业信息安全现状与威胁

SOA开发者

金九银十不要怕!有了腾讯这本2021年最新Java面试手册,offer手到擒来!

Java 程序员 架构 面试 后端

华为云带你探秘Xtrabackup备份原理和常见问题分析

华为云数据库小助手

GaussDB 华为云数据库 MySQL 数据库 GaussDB(for MySQL)

阿里巴巴架构师十年整理出的JavaSpringBoot核心文档,真是太全了

Java 架构 面试 程序人生 编程语言

四面字节跳动(高级开发岗):分布式+中间件+TCP+JVM+Hashmap

Java 编程 架构 面试 计算机

【新品尝鲜】OCR磅单识别上线邀测,为货运物流提速增效

百度大脑

人工智能 OCR

使用 grpcurl 通过命令行访问 gRPC 服务

AlwaysBeta

golang gRPC

搞不懂云原生

二哥不再迷茫

快手、知乎等平台严厉打击“病媛”炒作行为:自媒体行业不能被流量裹挟

石头IT视角

携程Kotlin DSL开发与实践_文化 & 方法_刘媛_InfoQ精选文章