Kotlin 語(yǔ)言中調(diào)用 JavaScript 方法實(shí)例詳解

Kotlin 已被設(shè)計(jì)為能夠與 Java 平臺(tái)輕松互操作。它將 Java 類(lèi)視為 Kotlin 類(lèi)，并且 Java 也將 Kotlin 類(lèi)視為 Java 類(lèi)。但是，JavaScript 是一種動(dòng)態(tài)類(lèi)型語(yǔ)言，這意味著它不會(huì)在編譯期檢查類(lèi)型。你可以通過(guò)動(dòng)態(tài)類(lèi)型在 Kotlin 中自由地與 JavaScript 交流，但是如果你想要 Kotlin 類(lèi)型系統(tǒng)的全部威力 ，你可以為 JavaScript 庫(kù)創(chuàng)建 Kotlin 頭文件。

內(nèi)聯(lián) JavaScript

你可以使用 js("……") 函數(shù)將一些 JavaScript 代碼嵌入到 Kotlin 代碼中。 例如：

fun jsTypeOf(o: Any): String {
 return js("typeof o")
}

js 的參數(shù)必須是字符串常量。因此，以下代碼是不正確的：

fun jsTypeOf(o: Any): String {
 return js(getTypeof() + " o") // 此處報(bào)錯(cuò)
}
fun getTypeof() = "typeof"

external 修飾符

要告訴 Kotlin 某個(gè)聲明是用純 JavaScript 編寫(xiě)的，你應(yīng)該用 external 修飾符來(lái)標(biāo)記它。 當(dāng)編譯器看到這樣的聲明時(shí)，它假定相應(yīng)類(lèi)、函數(shù)或?qū)傩缘膶?shí)現(xiàn)由開(kāi)發(fā)人員提供，因此不會(huì)嘗試從聲明中生成任何 JavaScript 代碼。 這意味著你應(yīng)該省略 external 聲明內(nèi)容的代碼體。例如：

external fun alert(message: Any?): Unit

external class Node {
 val firstChild: Node

 fun append(child: Node): Node

 fun removeChild(child: Node): Node

 // 等等
}
external val window: Window

請(qǐng)注意，嵌套的聲明會(huì)繼承 external 修飾符，即在 Node 類(lèi)中，我們?cè)诔蓡T函數(shù)和屬性之前并不放置 external。

external 修飾符只允許在包級(jí)聲明中使用。 你不能聲明一個(gè)非 external 類(lèi)的 external 成員。

 聲明類(lèi)的（靜態(tài)）成員

在 JavaScript 中，你可以在原型或者類(lèi)本身上定義成員。即：

function MyClass() {
}
MyClass.sharedMember = function() { /* 實(shí)現(xiàn) */ };
MyClass.prototype.ownMember = function() { /* 實(shí)現(xiàn) */ };

Kotlin 中沒(méi)有這樣的語(yǔ)法。然而，在 Kotlin 中我們有伴生（companion）對(duì)象。Kotlin 以特殊的方式處理external 類(lèi)的伴生對(duì)象：替代期待一個(gè)對(duì)象的是，它假定伴生對(duì)象的成員就是該類(lèi)自身的成員。要描述來(lái)自上例中的 MyClass，你可以這樣寫(xiě)：

external class MyClass {
 companion object {
  fun sharedMember()
 }

 fun ownMember()
}

聲明可選參數(shù)

一個(gè)外部函數(shù)可以有可選參數(shù)。 JavaScript 實(shí)現(xiàn)實(shí)際上如何計(jì)算這些參數(shù)的默認(rèn)值，是 Kotlin 所不知道的， 因此在 Kotlin 中不可能使用通常的語(yǔ)法聲明這些參數(shù)。 你應(yīng)該使用以下語(yǔ)法：

external fun myFunWithOptionalArgs(x: Int,
 y: String = definedExternally,
 z: Long = definedExternally)

這意味著你可以使用一個(gè)必需參數(shù)和兩個(gè)可選參數(shù)來(lái)調(diào)用 myFunWithOptionalArgs（它們的默認(rèn)值由一些 JavaScript 代碼算出）。

擴(kuò)展 JavaScript 類(lèi)

你可以輕松擴(kuò)展 JavaScript 類(lèi)，因?yàn)樗鼈兪?Kotlin 類(lèi)。只需定義一個(gè) external 類(lèi)并用非 external 類(lèi)擴(kuò)展它。例如：

external open class HTMLElement : Element() {
 /* 成員 */
}

class CustomElement : HTMLElement() {
 fun foo() {
  alert("bar")
 }
}

有一些限制：

當(dāng)一個(gè)外部基類(lèi)的函數(shù)被簽名重載時(shí)，不能在派生類(lèi)中覆蓋它。

不能覆蓋一個(gè)使用默認(rèn)參數(shù)的函數(shù)。

請(qǐng)注意，你無(wú)法用外部類(lèi)擴(kuò)展非外部類(lèi)。

external 接口

JavaScript 沒(méi)有接口的概念。當(dāng)函數(shù)期望其參數(shù)支持 foo 和 bar 方法時(shí)，只需傳遞實(shí)際具有這些方法的對(duì)象。 對(duì)于靜態(tài)類(lèi)型的 Kotlin，你可以使用接口來(lái)表達(dá)這點(diǎn)，例如：

external interface HasFooAndBar {
 fun foo()

 fun bar()
}

external fun myFunction(p: HasFooAndBar)

外部接口的另一個(gè)使用場(chǎng)景是描述設(shè)置對(duì)象。例如：

external interface JQueryAjaxSettings {
 var async: Boolean

 var cache: Boolean

 var complete: (JQueryXHR, String) -> Unit

 // 等等
}

fun JQueryAjaxSettings(): JQueryAjaxSettings = js("{}")

external class JQuery {
 companion object {
  fun get(settings: JQueryAjaxSettings): JQueryXHR
 }
}

fun sendQuery() {
 JQuery.get(JQueryAjaxSettings().apply {
  complete = { (xhr, data) ->
   window.alert("Request complete")
  }
 })
}

外部接口有一些限制：

它們不能在 is 檢查的右側(cè)使用。
as 轉(zhuǎn)換為外部接口總是成功（并在編譯時(shí)產(chǎn)生警告）。
它們不能作為具體化類(lèi)型參數(shù)傳遞。
它們不能用在類(lèi)的字面值表達(dá)式（即 I::class）中。

感謝閱讀，希望能幫助到大家，謝謝大家對(duì)本站的支持！