Kotlin-48.JavaScript调用Kotlin(Call Kotlin from JavaScript)

官方文档: http://kotlinlang.org/docs/reference/js-to-kotlin-interop.html

在JS平台上, kotlin代码会被Kotlin编译器转换成JavaScript类/函数/属性;
因此在JavaScript代码中可以自由地调用kotlin代码, 然而还有一些细节需要注意!

1.独立JavaScript对象隔离声明(Isolating declarations in a separate JavaScript object)

为了防止损坏全局对象,Kotlin创建一个模块(module)对象,它包含当前模块中所有Kotlin声明;如果kotlin模块名是myModule,那么在JavaScript中可通过myModule对象使用kotlin声明:    // kotlin模块名是myModule    fun foo() = "Hello"    // 在JavaScript中调用, myModule是kotlin模块    alert(myModule.foo());当Kotlin模块(module)编译为JavaScript模块(module)时,不适用于上述情况!在此情况下,Kotlin不会创建的模块对象,而是将kotlin声明作为相应类型的JavaScript模块,对外暴露:    // myModule是kotlin模块,被编译为JavaScript模块    alert(require('myModule').foo());

2.包结构(Package structure)

Kotlin将其包结构暴露给JavaScript,因此除非在根包中定义声明, 否则必须在JavaScript中使用完整限定名,例如:    // kotlin    package my.qualified.packagename    fun foo() = "Hello"    // 在JavaScript中调用    alert(myModule.my.qualified.packagename.foo());

3.@JsName注解(@JsName annotation)

在某些情况下(如为了支持重载),Kotlin编译器会修改生成的JavaScript的函数名/属性名,使用@JsName注解,控制生成JavaScript的函数名/属性名,:    // kotlin模块"kjs"    class Person(val name: String) {        fun hello() {            println("Hello $name!")        }        @JsName("helloWithGreeting")        fun hello(greeting: String) {            println("$greeting $name!")        }    }    // 在JavaScript中    var person = new kjs.Person("Dmitry");  // 引用模块"kjs"    person.hello();                         // 输出"Hello Dmitry!"    person.helloWithGreeting("Servus");     // 输出"Servus Dmitry!"    //如果没有指定@JsName注解,相应函数名会添加从函数签名计算而来的后缀,例如hello_61zpoe$注意: 1.Kotlin编译器不会对external声明使用@JsName注解修饰      2.继承自external类的非external类,被覆盖的函数也不会被@JsName修饰!@JsName参数是一个字符串字面值常量(有效标识符),如果将非标识符字符串传递给@JsName,编译器会报错:    @JsName("new C()")  // 报错, new C()不是字符串字面值常量    external fun newC()

4.在JavaScript中表示Kotlin类型(Representing Kotlin types in JavaScript)

1.Kotlin数字类型(kotlin.Long除外)都映射到JavaScript Number2.kotlin.Char映射到JavaScript Number,表示字符码3.Kotlin在运行时无法区分数字类型(kotlin.Long除外),即以下代码能工作:    fun f() {        val x: Int = 23        val y: Any = x        println(y as Float)    }4.Kotlin保留了kotlin.Int, kotlin.Byte, kotlin.Short, kotlin.Char, kotlin.Long的溢出语义5.JavaScript没有64位整型数, 所以kotlin.Long没有映射到任何JavaScript类型对象, 它由Kotlin类模拟6.kotlin.String 映射到 JavaScript String7.kotlin.Any 映射到 JavaScript Object (即new Object(), {}等)8.kotlin.Array 映射到 JavaScript Array9.Kotlin 集合(即List, Set, Map等)没有映射到任何JavaScript类型10.kotlin.Throwable 映射到 JavaScript Error11.Kotlin 在JavaScript中保留了惰性对象初始化12.Kotlin 在JavaScript中没有实现顶层属性的惰性初始化

简书：http://www.jianshu.com/p/a377d6284f1c
CSDN博客: http://blog.csdn.net/qq_32115439/article/details/75808450
GitHub博客: http://lioil.win/2017/07/22/Kotlin-kotlinInJS.html
Coding博客: http://c.lioil.win/2017/07/22/Kotlin-kotlinInJS.html