Kotlin 官方学习教程之可见性修饰符

可见性修饰符

类，对象，接口，构造函数，属性以及它们的 setter 方法都可以有可见性修饰词。( getter 总是具有与该属性相同的可见性。)。在 Kotlin 中有四种修饰词：private,protected,internal,以及 public 。默认的修饰符是 public。

下面请查看不同类型声明范围的说明。

包

函数，属性和类，对象和接口可以在 “top-level” 声明，例如直接定义在一个包内：

// file name: example.ktpackage foofun baz() {}class Bar {}

• 如果您没有指定任何可见性修饰符，则默认使用 public，这意味着您的声明将在任何位置都可见；

• 如果你声明为 private ，则只在包含声明的文件中可见；

• 如果用 internal 声明，则在同一模块中的任何地方可见；

• protected 在 “top-level” 中不可以使用

例子：

// file name: example.ktpackage fooprivate fun foo() {} // visible inside example.ktpublic 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.