Kotlin Reference (十一) Visibility Modifiers

most from reference

类，对象，接口，构造函数，函数，属性及setters具有可见性修饰符(getter总是具有和属性一样的可见性)。在kotlin中油4个可视化修饰符：private，protected，internal，public。如果没有显式修饰符，则使用默认可见性public。

包

函数，属性和类，对象和接口可以在顶级上声明，即直接在包中：

// file name: example.kt
package foo

fun baz() {}
class Bar {}

• 如果不指定任何可见性修饰符，默认使用public，这意味着您的声明将在任何地方都可见；
• 如果标记privatge, 它只会在包含该声明的文件内部可见；
• 如果标记internal，它在同一个模块中到处可见；
• 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

类和接口

对于在类中声明的成员：

• private 意味着在这个类内可见（包括其所有成员）;
• protected 与private子类中的可见一样;
• internal 该模块中看到声明类的任何客户端都看到其internal成员;
• public 任何看到声明类的客户看到其public成员。

注意 Java用户：外部类不会在Kotlin中看到其内部类的私有成员。

如果您覆盖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
}

构造函数

要指定类的主构造函数的可见性，请使用以下语法(请注意，您需要添加一个显式构造函数关键字)：

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

这里的构造函数是私有的。默认情况下，所有的构造函数都是public有效，相当于他们在类可见的地方可见(即internal类的构造函数只能在同一模块中可见)。

本地声明

局部变量，函数和类不能有可见性修饰符。

模块

internal可见性意味着该部件是用相同的模块可见的。更具体地说，一个模块是一组编译的Kotlin文件：

IntelliJ IDEA模块;

• 一个Maven项目;
• 一个Gradle源集;
• 一组文件用一次调用编译 蚂蚁任务。