Модификаторы видимости

Пакеты

Функции, свойства, классы, объекты и интерфейсы могут быть объявлены на верхнем уровне непосредственно внутри пакета:

// 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 означает, что любой клиент внутри этого модуля, который видит класс-объявитель, видит его internal члены.

• public означает, что любой клиент, который видит класс-объявитель, видит его public члены.

Если вы переопределяете член protected или internal и не указываете видимость явно, переопределяемый член также будет иметь такую же видимость, как и исходный.

Примеры:

open class Outer {
    private val a = 1
    protected open val b = 2
    internal open 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
    override val c = 7   // 'c' is internal
}

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) { ... }

Модули

Модификатор видимости internal означает, что член виден внутри того же модуля. Более конкретно, модуль — это набор файлов Kotlin, скомпилированных вместе, например:

• Модуль в IntelliJ IDEA.

• Проект Maven.

• Набор файлов в Gradle (за исключением того, что test набор файлов может получить доступ к внутренним объявлениям main).

• Набор файлов, скомпилированных с помощью одного вызова задачи <kotlinc> Ant.