类,对象,接口,构造函数,函数,属性及其设置器可以具有可见性修饰符。 (Getter总是具有与属性相同的可见性。)Kotlin中有四个可见性修饰符:
private
, protected
, internal
和 public
。如果没有显式修饰符,则使用的默认可见性是public
。
下面请查看不同类型声明范围的说明。
包
函数,属性和类,对象和接口可以在“顶层”上声明,即直接在包中:
// file name: example.kt
package foo
fun baz() {}
class Bar {}
- 如果没有指定任何可见性修饰符,则默认使用
public
,这意味着声明将在任何位置都可见; - 如果将一个声明标记为
private
,那么它只会在包含声明的文件中可见; - 如果将其标记为
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
- 模块中的任何看到声明类的客户端都看到其内部成员;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
}
构造函数
要指定类的主构造函数的可见性,请使用以下语法(请注意,需要添加一个显式constructor
关键字):
class C private constructor(a: Int) { ... }
这里的构造函数是:private
。 默认情况下,所有构造函数都是public
,它们有效地相当于在类可见的地方可见(即internal
类的构造函数只能在同一模块中可见)。
局部声明
局部的变量,函数和类不能有可见性修饰符。
模块
内部可见性修饰符意味着该成员可以使用相同的模块。 更具体地说,一个模块是一组编译的Kotlin文件:
- IntelliJ IDEA模块;
- Maven或Gradle项目;
- 通过一次调用Ant任务编译的一组文件。