Kotlin 学习之可见性修饰符

可见性修饰符

类，对象，接口，构造函数，属性以及它们的 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 // property is visible everywhere
    private set         // setter is visible only in example.kt

internal val baz = 6    // visible inside the same 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 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 
}

构造函数

通过下面的语法来指定主构造函数(必须显示的使用 constructor 关键字)的可见性：

class C private constructor(a: Int) { ... }

这里构造函数是 private 。所有的构造函数默认是 public ,实际上只要类是可见的它们就是可见的 (注意 internal 类型的类中的 public 属性只能在同一个模块内才可以访问)

局部声明

局部的变量，函数和类是不允许使用修饰词的

模块

internal 修饰符是指成员的可见性是只在同一个模块中才可见的。模块在 Kotlin中就是一系列的 Kotlin 文件编译在一起：
* an IntelliJ IDEA module;
* a Maven project;
* a Gradle source set;
* a set of files compiled with one invocation of the Ant task.