2. 程式人生 > >（四）Kotlin 領域特定語言 DSL

（四）Kotlin 領域特定語言 DSL

阿新 • • 發佈：2018-12-14

文章目錄

一、領域特定語言 DSL的概念

  • 只在特定領域使用的語言;例如：HTML、Gradle、SQL

二、領域特定語言 DSL的特點

  • 它也是計算機程式語言
  • 具有語言表達能力
  • 表達能力比較有限
  • 關注某個特定領域

三、Html DSL

四、Gradle DSL

以下內容引用自 : Kotlin 語言中文站

使用 Gradle

為了用 Gradle 構建 Kotlin，你應該設定好 kotlin-gradle 外掛，將其應用到你的專案中，並且新增 kotlin-stdlib 依賴。這些操作也可以在 IntelliJ IDEA 中通過呼叫 Project action 中的 Tools | Kotlin | Configure Kotlin 自動執行。

外掛和版本

使用 kotlin-gradle-plugin 編譯 Kotlin 原始碼和模組.

要使用的 Kotlin 版本通常定義為 kotlin_version 屬性：

buildscript {
    ext.kotlin_version = '1.3.11'

    repositories {
        mavenCentral()
    }

    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

當通過 Gradle 外掛 DSL 與 Gradle Kotlin DSL 使用 Kotlin Gradle 外掛 1.1.1 及以上版本時，這不是必需的。

針對 JVM

針對 JVM，需要應用 Kotlin 外掛：

apply plugin: "kotlin"

或者，從 Kotlin 1.1.1 起，可以使用 Gradle 外掛 DSL 來應用該外掛：

plugins {
    id "org.jetbrains.kotlin.jvm" version "1.3.11"
}

在這個塊中的 version 必須是字面值，並且不能從其他構建指令碼中應用。
對於 Gradle Kotlin DSL，請按以下方式應用外掛：

plugins {
    kotlin("jvm") version "1.3.11"
}

Kotlin 原始碼可以與同一個資料夾或不同資料夾中的 Java 原始碼混用。預設約定是使用不同的資料夾：

project
    - src
        - main (root)
            - kotlin
            - java

如果不使用預設約定，那麼應該更新相應的 sourceSets 屬性：

sourceSets {
    main.kotlin.srcDirs += 'src/main/myKotlin'
    main.java.srcDirs += 'src/main/myJava'
}

對於 Gradle Kotlin DSL，請改用 java.sourceSets { …… } 配置源集。

針對 JavaScript

當針對 JavaScript 時，須應用不同的外掛：

apply plugin: "kotlin2js"

這個外掛只適用於 Kotlin 檔案，因此建議將 Kotlin 和 Java 檔案分開（如果是同一專案包含 Java 檔案的情況）。與針對 JVM 一樣，如果不使用預設約定，我們需要使用 sourceSets 來指定原始碼資料夾：

sourceSets {
    main.kotlin.srcDirs += 'src/main/myKotlin'
}

除了輸出的 JavaScript 檔案，該外掛預設會建立一個帶二進位制描述符的額外 JS 檔案。 如果你是構建其他 Kotlin 模組可以依賴的可重用庫，那麼該檔案是必需的，並且應該與轉換結果一起分發。 其生成由 kotlinOptions.metaInfo 選項控制：

compileKotlin2Js {
    kotlinOptions.metaInfo = true
}
針對 Android

Android 的 Gradle 模型與普通 Gradle 有點不同，所以如果我們要構建一個用 Kotlin 編寫的 Android 專案，我們需要用 kotlin-android 外掛取代 kotlin 外掛：

buildscript {
    ext.kotlin_version = '1.3.11'

    ……

    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}
apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'

不要忘記配置標準庫依賴關係。

Android Studio

如果使用 Android Studio，那麼需要在 android 下新增以下內容：

android {
  ……

  sourceSets {
    main.java.srcDirs += 'src/main/kotlin'
  }
}

這讓 Android Studio 知道該 kotlin 目錄是原始碼根目錄，所以當專案模型載入到 IDE 中時，它會被正確識別。或者，你可以將 Kotlin 類放在 Java 原始碼目錄中，該目錄通常位於 src/main/java。

配置依賴

除了上面顯示的 kotlin-gradle-plugin 依賴之外，還需要新增 Kotlin 標準庫的依賴：

repositories {
    mavenCentral()
}

dependencies {
    compile "org.jetbrains.kotlin:kotlin-stdlib"
}

如果針對 JavaScript，請使用 compile "org.jetbrains.kotlin:kotlin-stdlib-js" 替代之。

如果是針對 JDK 7 或 JDK 8，那麼可以使用擴充套件版本的 Kotlin 標準庫，其中包含為新版 JDK 增加的額外的擴充套件函式。使用以下依賴之一來取代 kotlin-stdlib ：

compile "org.jetbrains.kotlin:kotlin-stdlib-jdk7"
compile "org.jetbrains.kotlin:kotlin-stdlib-jdk8"

對於 Gradle Kotlin DSL，以下表示法的依賴關係與其等價：

dependencies {
    compile(kotlin("stdlib"))
    // 或者以下之一：
    compile(kotlin("stdlib-jdk7"))
    compile(kotlin("stdlib-jdk8"))
}

在 Kotlin 1.1.x 中，請使用 kotlin-stdlib-jre7 與 kotlin-stdlib-jre8。

如果你的專案中使用 Kotlin 反射或者測試設施，你也需要新增相應的依賴：

compile "org.jetbrains.kotlin:kotlin-reflect"
testCompile "org.jetbrains.kotlin:kotlin-test"
testCompile "org.jetbrains.kotlin:kotlin-test-junit"

或者，對於 Gradle Kotlin DSL：

compile(kotlin("reflect"))
testCompile(kotlin("test"))
testCompile(kotlin("test-junit"))

從 Kotlin 1.1.2 起，使用 org.jetbrains.kotlin group 的依賴項預設使用從已應用的外掛獲得的版本來解析。你可以用完整的依賴關係符號 （如 compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"，或者在 Gradle Kotlin DSL 中用 kotlin("stdlib", kotlinVersion)）手動提供其版本。

註解處理

請參見 Kotlin 註解處理工具（kapt）的描述。

增量編譯

Kotlin 支援 Gradle 中可選的增量編譯。 增量編譯跟蹤構建之間原始檔的改動，因此只有受這些改動影響的檔案才會被編譯。

從 Kotlin 1.1.1 起，預設啟用增量編譯。

有幾種方法來覆蓋預設設定：

  1. 將 kotlin.incremental=true 或者 kotlin.incremental=false 行新增到一個 gradle.properties 或者一個 local.properties 檔案中；

  2. 將 -Pkotlin.incremental=true 或 -Pkotlin.incremental=false 新增到 Gradle 命令列引數。請注意，這樣用法中，該引數必須新增到後續每個子構建，並且任何具有禁用增量編譯的構建將使增量快取失效。

請注意，第一次構建不會是增量的。

Coroutines support

Coroutines support is an experimental feature in Kotlin 1.2, so the Kotlin compiler reports a warning when you use coroutines in your project. To turn off the warning, add the following block to your build.gradle file:

kotlin {
    experimental {
        coroutines 'enable'
    }
}

Or, with Gradle Kotlin DSL:

import org.jetbrains.kotlin.gradle.dsl.Coroutines
// ...

kotlin.experimental.coroutines = Coroutines.ENABLE
Module names

The Kotlin modules that the build produces are named accordingly to the archivesBaseName property of the project. If a project has a broad name like lib or jvm, which is common for subprojects, the Kotlin output files related to the module (*.kotlin_module) might clash with those from third-party modules with the same name. This causes problems when a project is packaged into a single archive (e.g. APK).

To avoid this, consider setting a unique archivesBaseName manually:

archivesBaseName = 'myExampleProject_lib'

With Gradle Kotlin DSL, it is:

setProperty("archivesBaseName", "myExampleProject_lib")
Gradle 構建快取支援（自 1.2.20 起）

Kotlin 外掛支援 Gradle 構建快取（需要 Gradle 4.3 及以上版本；低版本則禁用快取）。

由於註解處理器執行的任意程式碼可能不一定會將任務輸入轉換為輸出、可能訪問與修改 Gradle 未跟蹤的檔案等，因此預設不快取 kapt 註解處理任務。要啟用 kapt 快取，請將以下列幾行新增到構建指令碼中：

kapt {
    useBuildCache = true
}

要禁用所有 Kotlin 任務的快取，請將系統屬性標誌 kotlin.caching.enabled 設定為 false（執行構建帶上引數 -Dkotlin.caching.enabled=false）。

編譯器選項

要指定附加的編譯選項，請使用 Kotlin 編譯任務的 kotlinOptions 屬性。

當針對 JVM 時，對於生產程式碼這些任務稱為 compileKotlin 而對於測試程式碼稱為 compileTestKotlin。對於自定義原始檔集（source set）這些任務稱呼取決於 compile＜Name＞Kotlin 模式。

Android 專案中的任務名稱包含構建變體 名稱，並遵循 compile<BuildVariant>Kotlin 的模式，例如 compileDebugKotlin、 compileReleaseUnitTestKotlin。

當針對 JavaScript 時，這些任務分別稱為 compileKotlin2Js 與 compileTestKotlin2Js，以及對於自定義原始檔集稱為 compile＜Name＞Kotlin2Js。

要配置單個任務，請使用其名稱。示例：

compileKotlin {
    kotlinOptions.suppressWarnings = true
}

compileKotlin {
    kotlinOptions {
        suppressWarnings = true
    }
}

對於 Gradle Kotlin DSL，首先從專案的 tasks 中獲取任務：

import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
// ……

val compileKotlin: KotlinCompile by tasks

compileKotlin.kotlinOptions.suppressWarnings = true

相應地，為 JS 與 Common 目標使用型別 Kotlin2JsCompile 與 KotlinCompileCommon。

也可以在專案中配置所有 Kotlin 編譯任務：

tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile::class.java).all {
    kotlinOptions { …… }
}

對於 Gradle 任務的完整選項列表如下：

JVM、JS 與 JS DCE 的公共屬性
名稱 描述 可能的值 預設值
allWarningsAsErrors 任何警告都報告為錯誤 false
suppressWarnings 不生成警告 false
verbose 啟用詳細日誌輸出 false
freeCompilerArgs 附加編譯器引數的列表 []
JVM 與 JS 的公共屬性
Name Description Possible values Default value
apiVersion 只允許使用來自捆綁庫的指定版本中的宣告 “1.0”、 “1.1”、 “1.2”、 “1.3”、 “1.4 (EXPERIMENTAL)”
languageVersion 提供與指定語言版本原始碼相容性 “1.0”、 “1.1”、 “1.2”、 “1.3”、 “1.4 (EXPERIMENTAL)”
JVM 特有的屬性
名稱 描述 可能的值 預設值
javaParameters 為方法引數生成 Java 1.8 反射的元資料 false
jdkHome 要包含到 classpath 中的 JDK 主目錄路徑，如果與預設 JAVA_HOME 不同的話
jvmTarget 生成的 JVM 位元組碼的目標版本（1.6 或 1.8），預設為 1.6 “1.6”、 “1.8” “1.6”
noJdk 不要在 classpath 中包含 Java 執行時 false
noReflect 不要在 classpath 中包含 Kotlin 反射實現 true
noStdlib 不要在 classpath 中包含 Kotlin 執行時 true
JS 特有的屬性
名稱 描述 可能的值 預設值
friendModulesDisabled 禁用內部宣告匯出 false
main 是否要呼叫 main 函式 “call”、 “noCall” “call”
metaInfo 使用元資料生成 .meta.js 與 .kjsm 檔案。用於建立庫 true
moduleKind 編譯器生成的模組型別 “plain”、 “amd”、 “commonjs”、 “umd” “plain”
noStdlib 不使用捆綁的 Kotlin stdlib true
outputFile 輸出檔案路徑
sourceMap 生成原始碼對映（source map） false
sourceMapEmbedSources 將原始碼嵌入到原始碼對映中 “never”、 “always”、 “inlining”
sourceMapPrefix 原始碼對映中路徑的字首
target 生成指定 ECMA 版本的 JS 檔案 “v5” “v5”
typedArrays 將原生陣列轉換為 JS 帶型別陣列 true
生成文件

要生成 Kotlin 專案的文件，請使用 Dokka； 相關配置說明請參見 Dokka README 。Dokka 支援混合語言專案，並且可以生成多種格式的輸出 ，包括標準 JavaDoc。

OSGi

關於 OSGi 支援請參見 Kotlin OSGi 頁。

使用 Gradle Kotlin DSL

使用 Gradle Kotlin DSL 時，請使用 plugins { …… } 塊應用 Kotlin 外掛。如果使用 apply { plugin(……) } 來應用的話，可能會遇到未解析的到由 Gradle Kotlin DSL 所生成擴充套件的引用問題。為了解決這個問題，可以註釋掉出錯的用法，執行 Gradle 任務 kotlinDslAccessorsSnapshot，然後解除該用法註釋並重新執行構建或者重新將專案匯入到 IDE 中。

上一篇：（三）Kotlin 高階函式

下一篇：（五）協程 Coroutine

相關推薦

（四）Kotlin 領域特定語言 DSL

文章目錄 一、領域特定語言 DSL的概念 二、領域特定語言 DSL的特點 三、Html DSL 四、Gradle DSL 以下內容引用自 : [Kotlin 語言中文站](http://ww

性能測試（四）應用領域

架構 關心 剖析 測試結果 可擴展 服務 style 快速 折線圖 大概說說性能測試的五種應用領域吧，可能純文字內容太多，沒耐心的話，可以跳過不看。。。 ————參考書籍《軟件性能測試過程詳解與案例剖析》 概括來說，可以將性能測試的應用領域劃分為下面五個不同領域：

postgresql從入門到菜鳥（四）pl/pgsql過程語言

之前介紹了一些postgresql資料庫的配置，以及視窗函式的使用。 這一次準備說一些pl/pgsql過程語言方面的東西。 pl/pgsql主要的功能是對sql進行擴充套件，讓sql可以實現，邏輯判斷，迴圈等功能。 首先說說優點，我個人理解使用過程語言最大的優點就是減少了客戶

scala函數語言程式設計系列（四）--- scala函數語言程式設計完全解密

傳值呼叫與傳名呼叫通常，函式的引數是傳值引數; 也就是說，引數的值在傳遞給函式之前確定。其實, 在Scala中, 我們方法或者函式的引數可以是一個表示式, 也就是將一個程式碼邏輯傳遞給了某個方法或者函式./**   * scala 的   *     傳名呼叫(call-by

SODBASE CEP學習（四）：類SQL語言EPL與Storm或jStorm整合

Storm框架原本是設計用來做網際網路短文字處理和一些統計工作的，是一種分散式流式計算框架。在一些場合，特別是在已經用了Storm架構以後，發現又想用EPL語句，Storm和類SQL語言EPL結合也不失為一種方案。對線上規則修改、視窗資料可靠性要求高的地方還有用專用的CE

Kotlin學習日記（十）Kotlin函數語言程式設計相關知識

尾遞迴函式kotlin 支援函數語言程式設計的尾遞迴。這個允許一些演算法可以通過迴圈而不是遞迴解決問題，從而避免了棧溢位。當函式被標記為 tailrec 時，編譯器會優化遞迴，並用高效迅速的迴圈代替它。一種特殊的遞迴呼叫自身後無其他操作是進行了優化的迴圈 tailrec fu

C語言學習（四）在學習C語言時遇到的一些細節方面的問題

strlen與sizeof的區別：  strlen用來求字串的長度用的（不算最後的NULL）而sizeof是用來求指定變數或者變數型別等所佔記憶體大小用的比如strlen（"nihao"）它的結果是5而sizeof(int)它的結果是4也就是說int型佔四個位元組。它與是不是

如何設計一門語言（十）——正則表示式與領域特定語言（DSL）

幾個月前就一直有博友關心DSL的問題，於是我想一想，我在gac.codeplex.com裡面也建立了一些DSL，於是今天就來說一說這個事情。 建立DSL恐怕是很多人第一次設計一門語言的經歷，很少有人一開始上來就設計通用語言的。我自己第一次做這種事情是在高中寫這個傻逼ARPG的時候了。當時做了一個超

雙向循環鏈表（C語言描述）（四）

雙向循環鏈表 還要 ons 函數 保存 hat 加載 dir dict 　　下面以一個電子英漢詞典程序（以下簡稱電子詞典）為例，應用雙向循環鏈表。分離數據結構，可以使邏輯代碼獨立於數據結構操作代碼，程序結構更清晰，代碼更簡潔；電子詞典的增、刪、查、改操作分別對應於鏈表的插入

C語言學習系列（四）C語言基本語法和數據類型

.html 二進制 占用 efault html pac 精度 es2017 %d 一、基本語法 C的令牌（Tokens） 　　C 程序由各種令牌組成，令牌可以是關鍵字、標識符、常量、字符串值，或者是一個符號。 關鍵字（保留字） auto else long swit

C語言入門參考（四）

函數聲明 c語言 block http 返回 以及 height 頭文件 ges 四、解析hello,world C語言是面向過程編程的計算機語言， 主要采取函數調用的方式來進行流程控制。面向過程編程講究模塊化。把需要解決的問題進行分析，尋出解決問題所需要的步

[讀書筆記] R語言實戰 （四） 基本數據管理

mean 圖片 數值 函數 nbsp 一個 img order 分享 1. 創建新的變量 mydata<-data.frame(x1=c(2,2,6,4),x2=c(3,4,2,8)) #方法一 mydata$sumx<-mydata$x1+mydat

Kotlin基礎（四）Lambda編程

構造 引用 元素 允許 其他 create text 顯示 tag Lambda編程 一、Lambda表達式和成員引用 一）Lambda表達式語法 1 //註意與Java8中的區別 2 val sum={ x:Int,y:Int -> x+y } 3

C語言學習（四）

vc++ gin margin 結果 com 語言學 http std oid 面試題中二進制轉換問題，將一個二進制數，從某位開始進行，n位轉換，程序如下所示： 1 /***************************************************

Go語言開發（四）、Go語言面向對象

name value code 對象 struct int() 初始 每一個 method Go語言開發（四）、Go語言面向對象 一、結構體和方法 1、結構體的定義 在結構體中可以為不同項定義不同的數據類型。結構體是由一系列具有相同類型或不同類型的數據構成的數據集合。結構體

C++語言學習（四）——類與對象

clas 進行 自身 ngs 符號表 方法 index clu 每一個 C++語言學習（四）——類與對象 一、構造函數（constructor） 1、構造函數簡介 C++語言中，構造函數是與類名相同的特殊成員函數。在類對象創建時，自動調用構造函數，完成類對象的初始化。類對象

DTL語言學習（四）{% spaceless %}、{% autospace %}和{% verbatim %}標籤

{% spaceless %}標籤 移除html標籤中的空白字元，包括空格，換行鍵，tab鍵等。 首先建立一個測試環境，相信看到看到這裡的都知道怎樣建立一個測試環境了。這裡就不細說了。 我們在html中寫入一下程式碼： <div> <p>

Go語言併發程式設計（四）

同步 Go 程式可以使用通道進行多個 goroutine 間的資料交換，但這僅僅是資料同步中的一種方法。通道內部的實現依然使用了各種鎖，因此優雅程式碼的代價是效能。在某些輕量級的場合，原子訪問（atomic包）、互斥鎖（sync.Mutex）以及等待組（sync.WaitGroup）能最大程度滿足需求。

Go語言學習筆記（四） 流程控制

程式設計語言的流程控制語句，用於設定計算執行的次序，建立程式的邏輯結構。可以說，流程控制語句是整個程式的骨架。從根本上講，流程控制只是為了控制程式語句的執行順序，一般需要與各種條件配合，因此，在各種流程中，會加入條件判斷語句。流程控制語句一般起以下3個作用：   選擇，即根據

【C語言實現串列埠通訊知識點整理（四）】關於執行緒和程序

轉載：https://www.cnblogs.com/fuchongjundream/p/3829508.html 因為在外部檔案中呼叫結構體沒有用extern修飾，導致獲取不到正確的值，一直糾結線上程上。現在大概總結執行緒和程序的特點： 概念 1、程序（process） 狹義定義：