可见性修饰符
类,对象,接口,构造函数,属性以及它们的 setter 方法都可以有可见性修饰词。( getter 总是具有与该属性相同的可见性。)。在 Kotlin 中有四种修饰词:private,protected,internal,以及 public 。默认的修饰符是 public。
下面请查看不同类型声明范围的说明。
包
函数,属性和类,对象和接口可以在 “top-level” 声明,例如直接定义在一个包内:
// file name: example.kt
package foo
fun baz() {}
class Bar {}
如果您没有指定任何可见性修饰符,则默认使用 public,这意味着您的声明将在任何位置都可见;
如果你声明为 private ,则只在包含声明的文件中可见;
如果用 internal 声明,则在同一模块中的任何地方可见;
protected 在 “top-level” 中不可以使用
例子:
// file name: example.kt
package foo
private fun foo() {} // visible inside example.kt
public var bar: Int = 5 // 属性在任何地方可见
private set // setter 方法只在 example.kt 文件内可见
internal val baz = 6 // 在同一个 module 内可见
类和接口
对于在类中声明的成员:
private 只在该类(以及它所有的成员)中可见
protected 和 private 一样,但在子类中也可见
internal 在本模块的所有可以访问到声明区域的均可以访问该类的所有 internal 成员
public 任何地方可见
java 使用者注意:外部类不可以访问内部类的 private 成员。
如果重写 protected 成员但不指定可见性,重写成员的可见性也为 protected。
例子:
open class Outer {
private val a = 1
protected open val b = 2
internal val c = 3
val d = 4 // 默认为 public 型
protected class Nested {
public val e: Int = 5
}
}
class Subclass : Outer() {
// a 是不可见的
// b, c 和d 是可见的
// Nested 和 e 是可见的
override val b = 5 // 'b' 是 protected 型
}
class Unrelated(o: Outer) {
// o.a, o.b 是不可见的
// o.c and o.d 是可见的 (在同一个 module 内)
// Outer.Nested 是不可见的, and Nested::e 也是不可见的
}
构造函数
要指定类的主构造函数的可见性,请使用以下语法(请注意,您需要添加一个显式 constructor 关键字):
class C private constructor(a: Int) { ... }
这里构造函数是 private 。所有的构造函数默认是 public ,实际上只要类是可见的它们就是可见的 (注意 internal 类型的类中的 public 属性只能在同一个模块内才可以访问).
局部变量
局部变量,函数和类不能有可见性修饰符。
模块
internal 修饰符是指成员的可见性是只在同一个模块中才可见的。模块在 Kotlin 中就是一系列的 Kotlin 文件编译在一起:
an IntelliJ IDEA module;
a Maven or Gradle project;
a set of files compiled with one invocation of the Ant task.