包
代码文件以包声明开始:
package foo.bar
fun bza() {}
class Goo {}
//...
代码文件的所有内容(比如类和函数)都被包含在包声明中。因此在上面的例子中, bza()
的全名应该是 foo.bar.bza
,Goo
的全名是 foo.bar.Goo
。
如果没有指定包名,那这个文件的内容就从属于没有名字的 “default” 包。
默认导入
许多包被默认导入到每个Kotlin文件中:
— kotlin.*
— kotlin.annotation.*
— kotlin.collections.*
— kotlin.comparisons.* (since 1.1)
— kotlin.io.*
— kotlin.ranges.*
— kotlin.sequences.*
— kotlin.text.*
一些附加包会根据平台来决定是否默认导入:
— JVM:
—— java.lang.*
—— kotlin.jvm.*
— JS:
—— kotlin.js.*
Imports
除了模块中默认导入的包,每个文件都可以有导入自己需要的包。导入语法可以在 grammar 查看。
我们可以导入一个单独的名字,比如下面这样:
import foo.Bar // Bar 现在可以直接使用了
或者范围内的所有可用的内容 (包,类,对象,等等):
import foo.*/ /foo 中的所有都可以使用
如果命名有冲突,我们可以使用 as
关键字局部重命名解决冲突
import foo.Bar // Bar 可以使用
import bar.Bar as bBar // bBar 代表 'bar.Bar'
import关键字不局限于导入类;您也可以使用它来导入其他声明:
— 顶级函数与属性
— 在对象声明中声明的函数和属性
— 枚举常量
与 Java 不同的是,Koting 没有静态导入的语法,所有的导入都是通过import
关键字声明的。
顶级声明的可见性
如果最顶的声明标注为 private , 那么它是声明文件私有的 (参看 Visibility Modifiers)。