可见性修饰词

类,对象,接口,构造函数,属性以及它们的 setter 方法都可以有可见性修饰词。( getter与对应的属性拥有相同的可见性)。在 Kotlin 中有四种修饰词:private,protected,internal,以及 public 。默认的修饰符是 public
下面将解释不同类型的声明作用域。

函数,属性和类,对象和接口可以在 “top-level” 声明,即可以直接属于包:

  1. // 文件名: example.kt
  2. package foo
  3. fun baz() {}
  4. class bar {}

— 如果没有指明任何可见性修饰词,默认使用 public ,这意味着你的声明在任何地方都可见;

— 如果你声明为 private ,则只在包含声明的文件中可见;

— 如果用 internal 声明,则在同一模块中的任何地方可见;

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

例子:

  1. // 文件名: example.kt
  2. package foo
  3. private fun foo() {} // 在example.kt可见
  4. public var bar: Int = 5 // 属性在认可地方都可见
  5. private set // setter仅在example.kt中可见
  6. internal val baz = 6 // 在同一module中可见

类和接口

当在类中声明成员时:

private 只在该类(以及它的成员)中可见

protectedprivate 一样但在子类中也可见

internal 在本模块的所有可以访问到声明区域的均可以访问该类的所有 internal 成员 ( internal — any client inside this module who sees the declaring class sees its internal members;)

public 任何地方可见 (public — any client who sees the declaring class sees its public members.)

java 使用者注意:外部类不可以访问内部类的 private 成员。

如果你复写了一个protected成员并且没有指定可见性,那么该复写的成员具有protected可见性

例子:

  1. open class Outer {
  2. private val a = 1
  3. protected open val b = 2
  4. internal val c = 3
  5. val d = 4 // 默认是public
  6. protected class Nested {
  7. public val e: Int = 5
  8. }
  9. }
  10. class Subclass : Outer() {
  11. // a不可见
  12. // b,c和d是可见的
  13. // 内部类和e都是可见的
  14. override val b = 5 // 'b' i具有protected可见性
  15. }
  16. class Unrelated(o: Outer) {
  17. // o.a, o.b 不可见
  18. // o.c and o.d 可见 (same module)
  19. // Outer.Nested 不可见, and Nested::e 也不可见
  20. }

构造函数

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

  1. 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.