类,对象,接口,构造函数,函数,属性及其setter方法可以被可见性修饰符修饰。(Getter方法总是具有与属性相同的可见性。)Kotlin中有四个可见性修饰符:private,protected,internal和public。如果没有显式修饰符,则使用的默认可见性是public。
下面请看针对不同类型的修饰符声明的作用范围。
包(Packages)
函数、属性和类,对象和接口可以被当作源文件的顶级构成部分,可就是说,可以直接存在于包中,无需其他嵌套(但在Java中,方法必须作为类的一部分存在于源文件中):
// file name: example.kt
package foo
fun baz() {}
class Bar {}
- 如果没有显式指定可见性修饰符,则默认值是
public
,也就是说被public
声明的内容可以在项目中的其他任何地方访问得到。 - 如果以
private
修饰符修饰,被private修饰的内容只能在该源文件中可见。 - 如果以
internal
修饰符修饰,则只能在模块(module)内部可见。 -
protected
修饰符是不能在源文件的直接构成层级部分使用的。
例子如下:
// file name: example.kt
package foo
private fun foo() {} // visible inside example.kt
public var bar: Int = 5 // property is visible everywhere
private set // setter is visible only in example.kt
internal val baz = 6 // visible inside the same module
类和接口(Classes and Interfaces)
对于类中的成员而言:
-
private
修饰符意味着仅在类内部可见(也就是说对该类的所有成员都可见) -
protected
修饰符意味着在类内部和子类内部可见 -
internal
修饰符意味着该模块中,任何可以看到声明类的客户端都看到其被internal
修饰符修饰的成员 -
public
意味着任何看到声明类的客户都看到其公开成员。
Java开发者应注意:在Kotlin中,外部类是不能够看得到内部类的私有成员的。
如果你重写了一个protected
的成员,且没有显式为其指定可见性修饰符,则被重写的成员将默认被protecte
d修饰符修饰。如下:
open class Outer {
private val a = 1
protected open val b = 2
internal val c = 3
val d = 4 // public by default
protected class Nested {
public val e: Int = 5
}
}
class Subclass : Outer() {
// a is not visible
// b, c and d are visible
// Nested and e are visible
override val b = 5 // 'b' is protected
}
class Unrelated(o: Outer) {
// o.a, o.b are not visible
// o.c and o.d are visible (same module)
// Outer.Nested is not visible, and Nested::e is not visible either
}
构造器(Constructors)
如果想为一个类的主构造器指定可见性修饰符,需要使用下述语法(注意需要显式声明constructor
关键字):
class C private constructor(a: Int) { ... }
如此这般,构造器就是私有的。 默认情况下,所有构造器都是public的,意味着在类可见的地方,对应的构造器就是可见的(也就是说,被internal
修饰的类的构造函数只能在同一模块中可见)。
局部声明(Local declarations)
局部变量、局部函数和局部类不能被可见性修饰符修饰。
模块(Module)
被internal
修饰符修饰的成员意味着仅在同一模块内部可见。更确切的说,一个模块指的就是一系列被同时编译的Kotlin文件:
- Intellij IDEA开发工具的一个模块;
- 一个Maven或Gradle工程;
- 调用一次Ant任务编译的一组文件。