Пакеты и импорты

Импорт одной сущности

Импортируйте определенную сущность, чтобы использовать ее без уточнения имени:

// Message is accessible without qualification
import org.example.Message 

fun main() {
    val message = Message("Hello")
    println(message.text)
}

Импорт содержимого области видимости

Импорты со звездочкой, оканчивающиеся на звездочку *, импортируют все именованные сущности из соответствующей области видимости:

// Everything in org.example is accessible
import org.example.* 

fun main() {
    printMessage()
    val message = Message("Hi")
}

Если импортировать сущность и с помощью импорта со звездочкой, и явно, то при разрешении перегрузки приоритет будет у явного импорта.

Разрешение конфликтов имен с помощью псевдонимов

Если две импортированные сущности имеют одинаковое имя, используйте ключевое слово as, чтобы локально переименовать одну из них:

// Message refers to org.example.Message
import org.example.Message

// TestMessage refers to org.test.Message
import org.test.Message as TestMessage

fun main() {
    val a = Message("from example")
    val b = TestMessage("from test")
}

Что можно импортировать

Ключевое слово import используется не только для классов. Можно импортировать любые из следующих сущностей, независимо от того, находятся ли они в пакете, классе, объекте или перечислении:

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

  import org.example.printMessage // Top-level function
  import org.example.VERSION      // Top-level property
  

• Функции и свойства из объявлений объектов:

  import org.example.Config.DEFAULT_TIMEOUT // Property from an object
  import org.example.Config.loadSettings    // Function from an object
  

• Элементы объекта-компаньона, на которые ссылаются через имя внешнего класса:

  import org.example.MyClass.create // Refers to MyClass.Companion.create
  

• Константы перечисления:

  import org.example.Color.RED
  import org.example.Color.GREEN
  

• Вложенные классы:

  import org.example.Outer.Nested