【CSDN編者按】去年，Google 宣佈 Kotlin 正式成為 Android 官方開發語言，由此引發了遷移 Kotlin 的一股熱潮。在本文中，作者分享了他在七天內把程式碼從 Scala 移植到 Kotlin 的經過，以及從中吸取的經驗教訓。

以下為譯文：

上週出了幾件事，所以我決定把postgresql-async從Scala移植到Kotlin。雖然現在還有好多缺失的部分，但alpha版已經可以用了在這篇文章中我想分享把程式碼從Scala移植到Kotlin的經過，以及從中吸取的經驗教訓，希望可以幫助其他開發者解決同樣的問題。而且我也在繼續努力，解決剩下的問題。

首先我想解釋一下為什麼要移植？

在Outbrain我轉到了一個新的團隊，得到的任務之一就是負責將各種模組從Scala 2.10升級到2.11。這個任務是可行的，但十分痛苦，因為許多包都要求我們必須給所有JVM模組“打補丁”，就連Java模組都要！

由於所有模組都依賴於ob1k-db，而ob1k-db依賴於postgresql-async，後者又依賴於Scala 2.10和2.11下的不同的包。所以，可能更好的做法是幹掉所有模組中對Scala的依賴……

而且上週，在經歷了一年多的沉默後，終於有一個提交證實了postgres-sql不再提供維護了（https://github.com/mauricio/postgresql-async/commit/5716ac43818b6be0dc4fcc2b2655dde3411cdbe0）。這是壓死駱駝的最後一根稻草。

而且，我們仍然在使用該函式庫的MySQL非同步風格的版本，而且還沒有找到能代替它的東西。

但一個優勢是Scala和Kotlin十分相似，無論是功能還是語法——所以我們很想試試能不能把程式碼移植過去。

怎麼做？

在閱讀下面的技術細節之前請訪問下下面的函式庫，然後請給加個星 ：

https://github.com/jasync-sql/jasync-sql

轉換本身包括兩個主要步驟：

• 自動逐行搜尋替換指令碼內容，節省一些無謂的打字時間；

• 人工稽核程式碼，修改所有編譯錯誤，決定怎樣進行轉換，並改進指令碼。

指令碼

指令碼其實是一段非常簡單無腦的kscript程式碼（https://github.com/holgerbrandl/kscript），感覺都沒必要貼出來。一些程式碼行甚至都沒有替換成合法的語句（比如模式匹配和型別強制轉換的部分）。

我沒有時間也沒有能力使用antlr（http://www.antlr.org/）之類的東西去寫個語法分析器或完整的轉換器，而且我還有一些非常特殊的需求。但你要是有興趣的話可以試試。

話不多說，下面是指令碼的簡化版本：

 1#!/usr/bin/env kscript
 2
 3import java.io.File
 4
 5// usage - one argument a .kt file (Scala file that was only renamed)
 6// or a directory
 7try {
 8  main(args)
 9} catch (e: Exception) {
10  e.printStackTrace()
11}
12
13fun convert(lines: List<String>): List<String> {
14  val methodNoBracsRegex = ".*fun\\s+\\w+\\s+[:=].*".toRegex()
15  val linesWithoutLicense = lines
16//  The below lines just removed license comment
17//       if (lines[0].startsWith("package "))
18//         lines
19//       else
20//         lines.drop(15)
21  val result = mutableListOf<String>()
22  linesWithoutLicense.forEach { lineBeforeConv ->
23    val convertedLine = lineBeforeConv
24        .replace("extends", ":")
25        .replace(" def ", " fun ")
26        .replace("BigInt(", "BigInteger(")
27        .replace("trait", "interface")
28        .replace("[", "<")
29        .replace("]", ">")
30        .replace(" = {", " {")
31        .replace(" new ", " ")
32        .replace(" Future<", " CompletableFuture<")
33        .replace(" Promise<", " CompletableFuture<")
34        .replace(" Array<Byte>(", " ByteArray(")
35        .replace(" Array<Char>(", " CharArray(")
36        .replace("with", ",")
37        .replace("match", "when")
38        .replace("case class", "data class")
39        .replace("case _", "else")
40        .replace("case ", "")
41        .replace("=>", "->")
42        .replace(".asInstanceOf<", " as ") //manually fix >
43        .replace("final ", "")
44        .replace("fun this(", "constructor(")
45        .replace(" Seq<", " List<")
46        .replace(" IndexedSeq<", " List<")
47        .replace("<:", ":")
48    when {
49      convertedLine.startsWith("import ") -> {
50        val importsLines = if (convertedLine.contains("{")) {
51          val before = convertedLine.substringBefore("{")
52          convertedLine.substringAfter("{").substringBefore("}").split(",")
53              .map { "$before${it.trim()}" }
54        } else listOf(convertedLine)
55        importsLines.map { it.replace("_", "*") }.forEach {
56          result.add(it)
57        }
58      }
59      convertedLine.matches(methodNoBracsRegex) -> {
60        if (convertedLine.contains(":"))
61          result.add(convertedLine.replace(":", "():"))
62        else
63          result.add(convertedLine.replace("=", "()="))
64      }
65      else -> result.add(convertedLine)
66    }
67  }
68  return result
69}
70
71fun main(args: Array<String>) {
72  val fileName = args[0]
73  if (fileName.endsWith(".kt")) {
74    workOnFile(fileName)
75  } else {
76    File(fileName).walk().forEach {
77      if (it.name.endsWith(".kt")) {
78        workOnFile(it.path)
79      }
80    }
81  }
82}
83
84fun readFileAsLinesUsingReadLines(fileName: String): List<String> = File(fileName).readLines()
85
86fun workOnFile(fileName: String) {
87  if (!fileName.fileExists) {
88    println("WARN: file not exists $fileName")
89    return
90  }
91  println("working on $fileName")
92  val lines = readFileAsLinesUsingReadLines(fileName)
93  val fileContent = convert(lines).joinToString("\n")
94  File(fileName).writeText(fileContent)
95}

這個指令碼是用kscript編寫的（https://github.com/holgerbrandl/kscript），它接受一個引數：可以是副檔名已經改為.kt的Scala檔案，也可以傳遞目錄，如果是目錄則該指令碼會遞迴轉換目錄中的所有檔案。

這個指令碼會進行一些非常簡單的逐行查詢替換：def替換成fun，trait替換成interface，等等。沒什麼特別的東西。因為我前面說過，兩者語法很相似，這一點起了很大作用。如果轉換成Java則可能會更麻煩。

經驗教訓，以及我做出的決定

我寫這篇文章的目的就是記錄下我做過的事情。一些檔案仍然需要轉換，同時專案中還有其他人，所以這篇文章會有用的。

下面的專案順序不分先後，以後也可能會更新。

Future → CompletableFuture

原來的程式碼大量使用了Scala的Future，所以我需要找個東西來代替。我有許多選擇：

• Netty future——似乎語法很複雜，而且已經過時。

• JavaRX/Guava/其他future庫——需要額外的外部依賴。

• Java 8相容的Future——至少需要依賴Java 8。

• Kotlin deferred——主要用於協程（coroutine），所以功能不太多，也不知道與Java使用者的相容性如何，對於我來說有點難度。

最後決定使用CompletableFuture作為主要的後端庫。我覺得沒必要在Android中使用響應式的relational-sql庫，而且Java 8在Android之外的應用也非常廣泛。

注意，CompletableFuture替換了Scala的Future和Promise。

依賴

由於這個專案類似於驅動程式，所以我儘量減少外部函式庫的依賴，這個決定也影響了其他的決定。

Finalize

貌似在Kotlin中不需要覆蓋finalize方法。

資料結構

有些我已經忘了，但我記得的轉換有以下這些：

• Seq → List

• IndexedSeq → List

• ArrayBuffer → MutableList

位操作

Kotlin對於byte的處理有點奇怪，還不支援所有的操作符。一些類我轉換成了Java，一些仍然保持Kotlin。希望我處理得沒錯，因為我並不十分確定Scala怎樣處理這些操作。歡迎提意見。

擴充套件方法和屬性

我一開始並不太理解，但後來意識到我可以使用擴充套件（extension）讓Kotlin變得跟Scala相似，這一點非常酷。

例如Kotlin的List中有size，而Scala中叫做length。

這些問題都可以用擴充套件解決。

Try

我決定從Scala+Arrow移植一個相似的類使用。

方法定義和呼叫中的大括號

Scala並不強制大括號，所以有時轉換會很痛苦。

Duration → Duration

決定使用java.util.Duration。

執行上下文和隱含引數

我發現這個功能非常混亂，所以我把所有隱含引數都改成了必須。雖然程式碼會變得冗餘，但我覺得這樣更清晰。

我使用common pool作為預設的執行上下文，儘管在ob1k中我們使用的是另一個。不管怎樣，我們把它也改成了顯式傳遞。

測試

原來的庫使用了specs2。一開始我想暫時保留Scala的測試，但似乎這樣做也需要很多工作，因為許多內部程式碼都改變了。測試的移植依然在進行中，主要工作都由貢獻者們進行。

Option

大部分都用nullable的型別替換了，其中用到了一些擴充套件的幫助函式：

https://github.com/jasync-sql/jasync-sql/blob/master/db-async-common/src/main/java/com/github/jasync/sql/db/util/NullableUtils.kt

這裡我發現Kotlin的方法更好，因為Scala有時使用Option，有時卻直接使用null。

相關推薦