Kot
в дейст
Дмитрий Жемеров
Светлана Исакова
---- ---------
MANNING
Ж емеров Дмитрий, Исакова Светлана
Ж ЕМ ЕРО В Д М И Т РИ Й
ИСАКОВА СВЕТЛАНА
Москва, 2018
ББК 32.973.26-018.1
Ж53
Ж 53
Ж ем еров Д., И сакова С.
K otlin в действии. / пер. с англ. К иселев А. Н. - М.: Д М К П ресс, 2018. 402 с.: ил.
ISBN 978-5-97060-497-7
Я зы к K otlin предлагает вы разительны й синтаксис, мощ ную и понятную
систем у типов, великолепную поддерж ку и бесш овную совм естим ость с с у ­
щ ествующ им кодом на Java, богатый выбор библиотек и фреймворков. K otlin
мож ет компилироваться в байт-код Java, поэтому его мож но использовать везде,
где используется Java, включая Android. А благодаря эф ф ективному компиля­
тору и маленькой стандартной библиотеке K otlin практически не привносит
накладных расходов.
Данная книга научит вас пользоваться языком K otlin для создания вы соко­
качественных приложений. Написанная создателями языка - разработчиками
в компании JetBrains, - эта книга охватывает такие темы, как создание пред­
метно-ориентированны х языков, ф ункциональное программирование в JV M ,
совместное использование Java и K otlin и др.
И здание предназначено разработчикам, владеющ им языком Java и ж елаю ­
щим познакомиться и начать эф ф ективно работать с K otlin.
Original English language edition published by Manning Publications USA. Copyright ©
2017 by Manning Publications. Russian-language edition copyright © 2017 by DMK Press.
All rights reserved.
Все права защищены. Любая часть этой книги не может быть воспроизведена в
какой бы то ни было форме и какими бы то ни было средствами без письменного разре­
шения владельцев авторских прав.
Материал, изложенный в данной книге, многократно проверен. Но, поскольку вероят­
ность технических ошибок все равно существует, издательство не может гарантировать
абсолютную точность и правильность приводимых сведений. В связи с этим издатель­
ство не несет ответственности за возможные ошибки, связанные с использованием книги.
ISBN 978-1-61729-329-0 (англ.)
ISBN 978-5-97060-497-7 (рус.)
© 2017 by Manning Publications Со.
© Оформление, перевод на русский язык,
издание, ДМК Пресс, 2018
Оглавление
Предисловие...............................................................................................................12
Вступление..................................................................................................................13
Благодарности............................................................................................................14
Об этой книге..............................................................................................................15
Об авторах..................................................................................................................19
Об изображении на обложке................................................................................... 19
Часть 1. Введение в Kotlin........................................................................................ 21
Глава 1. Kotlin: что это и зачем................................................................................ 22
1.1. Знакомство с Kotlin................................................................................................................. 22
1.2. Основные черты языка Kotlin.............................................................................................. 23
1.2.1. Целевые платформы: серверные приложения, Android и везде,
где запускается Java....................................................................................................... 23
1.2.2. Статическая типизация..................................................................................................24
1.2.3. Функциональное и объектно-ориентированное программирование................25
1.2.4 Бесплатный язык с открытым исходнымкодом........................................................ 27
1.3. Приложения на Kotlin............................................................................................................ 27
1.3.1. Kotlin на сервере............................................................................................................27
1.3.2. Kotlin в Android.............................................................................................................. 29
1.4. Философия Kotlin..................................................................................................................... 30
1.4.1. Прагматичность.............................................................................................................. 31
1.4.2. Лаконичность................................................................................................................... 31
1.4.3. Безопасность................................................................................................................... 32
1.4.4. Совместимость................................................................................................................ 33
1.5. Инструментарий Kotlin.......................................................................................................... 34
1.5.1. Компиляция кода на Kotlin...........................................................................................35
1.5.2. Плагин для Intellij IDEA и Android Studio................................................................. 36
1.5.3. Интерактивная оболочка.............................................................................................. 36
1.5.4. Плагин для Eclipse......................................................................................................... 36
1.5.5. Онлайн-полигон..............................................................................................................36
1.5.6. Конвертер кода из Java в Kotlin..................................................................................37
1.6. Резюме......................................................................................................................................... 37
Глава 2. Основы Kotlin............................................................................................... 39
2.1. Основные элементы: переменные и функции................................................................39
2.1.1. Привет, мир!.................................................................................................................... 40
2.1.2. Функции............................................................................................................................40
2.1.3. Переменные....................................................................................................................42
2.1.4. Простое форматирование строк: шаблоны............................................................. 44
2.2. Классы и свойства...................................................................................................................45
2.2.1 Свойства............................................................................................................................46
2.2.2. Собственные методы доступа.....................................................................................48
6 ❖
Оглавление
2.2.3. Размещение исходного кода на KotLin: пакеты и каталоги..................................49
2.3. Представление и обработка выбора: перечисления и конструкция «w h en »......51
2.3.1. Объявление классов перечислений........................................................................... 51
2.3.2. Использование оператора «when» с классами перечислений............................52
2.3.3. Использование оператора «when» с произвольными объектами...................... 54
2.3.4. Выражение «when» без аргументов.......................................................................... 55
2.3.5. Автоматическое приведение типов: совмещение проверки
и приведения типа..........................................................................................................55
2.3.6. Рефакторинг: замена «if» на «when»......................................................................... 58
2.3.7. Блоки в выражениях «if» и «when»............................................................................ 59
2.4. Итерации: циклы «while» и «for»....................................................................................... 60
2.4.1. Цикл «while»....................................................................................................................60
2.4.2. Итерации по последовательности чисел:
диапазоны и прогрессии.............................................................................................. 61
2.4.3. Итерации по элементам словарей............................................................................. 62
2.4.4. Использование «in» для проверки вхождения в диапазон или коллекцию.... 64
2.5. Исключения в KotLin............................................................................................................... 65
2.5.1. «try», «catch» и «finally»................................................................................................ 66
2.5.2. «try» как выражение......................................................................................................67
2.6. Резюме.........................................................................................................................................68
Глава 3. Определение и вызов функций................................................................ 70
3.1. Создание коллекций в KotLin............................................................................................... 70
3.2. Упрощение вызова функций............................................................................................... 72
3.2.1. Именованные аргументы............................................................................................. 73
3.2.2. Значения параметров по умолчанию........................................................................74
3.2.3. Избавление от статических вспомогательных классов: свойства
и функции верхнего уровня.........................................................................................76
3.3. Добавление методов в сторонние классы: функции-расширения
и свойства-расширения......................................................................................................... 78
3.3.1. Директива импорта и функции-расширения........................................................... 80
3.3.2. Вызов функций-расширений из Java........................................................................ 80
3.3.3. Вспомогательные функции как расширения........................................................... 81
3.3.4. Функции-расширения не переопределяются.......................................................... 82
3.3.5. Свойства-расширения...................................................................................................84
3.4. Работа с коллекциями: переменное число аргументов, инфиксная форма
записи вызова и поддержка в библиотеке..................................................................... 85
3.4.1. Расширение API коллекций Java.................................................................................85
3.4.2. Функции, принимающие произвольное число аргументов..................................86
3.4.3. Работа с парами: инфиксные вызовы и мультидекларации................................. 87
3.5. Работа со строками и регулярными выражениями...................................................... 88
3.5.1. Разбиение строк............................................................................................................. 89
3.5.2. Регулярные выражения и строки в тройных кавычках..........................................89
3.5.3. Многострочные литералы в тройных кавычках...................................................... 91
3.6. Чистим код: локальные функции и расширения............................................................93
3.7. Резю ме.........................................................................................................................................96
Оглавление ❖
7
Глава 4. Классы, объекты и интерфейсы................................................................ 97
4.1. Создание иерархий классов.................................................................................................98
4.1.1. Интерфейсы в Kotlin..................................................................................................... 98
4.1.2. Модификаторы open, final и abstract: по умолчанию final................................. 101
4.1.3. Модификаторы видимости: по умолчанию public................................................103
4.1.4. Внутренние и вложенные классы: по умолчанию вложенные.......................... 105
4.1.5. Запечатанные классы: определение жестко заданных иерархий....................108
4.2. Объявление классов с нетривиальными конструкторами или свойствами.......110
4.2.1. Инициализация классов: основной конструктор и блоки инициализации....110
4.2.2. Вторичные конструкторы: различные способы инициализации
суперкласса................................................................................................................... 113
4.2.3. Реализация свойств, объявленных в интерфейсах...............................................115
4.2.4. Обращение к полю из методов доступа................................................................. 117
4.2.5. Изменение видимости методов доступа................................................................118
4.3. Методы, сгенерированные компилятором: классы данных и делегирование....119
4.3.1. Универсальные методы объектов............................................................................ 120
4.3.2. Классы данных: автоматическая генерация универсальных методов............123
4.3.3. Делегирование в классах. Ключевое слово by...................................................... 124
4.4. Ключевое слово object: совместное объявление класса и его экземпляра.......127
4.4.1. Объявление объекта: простая реализация шаблона «Одиночка».....................127
4.4.2. Объекты-компаньоны: место для фабричных методов и статических
членов класса................................................................................................................130
4.4.3. Объекты-компаньоны как обычные объекты............................
132
4.4.4. Объекты-выражения: другой способ реализации анонимных
внутренних классов..................................................................................................... 135
4.5. Резюме...................................................................................................................................... 136
Глава 5. Лямбда-выражения..................................................................................138
5.1. Лямбда-выражения и ссылки на члены класса........................................................... 138
5.1.1. Введение в лямбда-выражения: фрагменты кода как параметры
функций..........................................................................................................................139
5.1.2. Лямбда-выражения и коллекции............................................................................. 140
5.1.3. Синтаксис лямбда-выражений..................................................................................141
5.1.4. Доступ к переменным из контекста......................................................................... 145
5.1.5. Ссылки на члены класса.............................................................................................148
5.2. Функциональный API для работы с коллекциями.......................................................150
5.2.1. Основы: filter и т а р .....................................................................................................150
5.2.2. Применение предикатов к коллекциям:
функции «all», «any», «count» и «find».................................................................... 152
5.2.3. Группировка значений в списке с функцией groupBy......................................... 154
5.2.4. Обработка элементов вложенных коллекций: функции flatMap и flatten.....154
5.3. Отложенные операции над коллекциями: последовательности............................ 156
5.3.1. Выполнение операций над последовательностями: промежуточная
и завершающая операции......................................................................................... 157
5.3.2. Создание последовательностей............................................................................... 160
5.4. Использование функциональных интерфейсов Java................................................. 161
5.4.1. Передача лямбда-выражения в Java-метод.......................................................... 162
8 ❖
Оглавление
5.4.2. SAM-конструкторы: явное преобразование лямбда-выражений
в функциональные интерфейсы............................................................................... 164
5.5. Лямбда-выражения с получателями: функции «with» и «apply»........................... 166
5.5.1. Функция «with»............................................................................................................ 166
5.5.2. Функция «apply».......................................................................................................... 169
5.6. Резюме...................................................................................................................................... 171
Глава 6. Система типов Kotlin.................................................................................172
6.1. Поддержка значения null................................................................................................... 172
6.1.1. Типы с поддержкой значения null...........................................................................173
6.1.2. Зачем нужны типы.......................................................................................................175
6.1.3. Оператор безопасного вызова:«?.»........................................................................ 177
6.1.4. Оператор «Элвис»:«?:»............................................................................................... 178
6.1.5. Безопасное приведение типов: оператор «as?»................................................... 180
6.1.6. Проверка на null: утверждение «!!»........................................................................ 182
6.1.7. Функция let.................................................................................................................... 184
6.1.8. Свойства с отложенной инициализацией.............................................................. 186
6.1.9. Расширение типов с поддержкой null.................................................................... 188
6.1.10. Типовые параметры с поддержкой null............................................................... 189
6.1.11. Допустимость значения null и Java........................................................................ 190
6.2. Примитивные и другие базовые типы............................................................................195
6.2.1. Примитивные типы: Int, Boolean и другие............................................................. 195
6.2.2. Примитивные типы с поддержкой null: Int?, Boolean? и прочие......................197
6.2.3. Числовые преобразования........................................................................................ 198
6.2.4. Корневые типы Any и Any?........................................................................................ 200
6.2.5. Тип Unit: тип «отсутствующего» значения..............................................................201
6.2.6. Тип Nothing: функция, которая не завершается.................................................... 202
6.3. Массивы и коллекции...........................................................................................................203
6.3.1 Коллекции и допустимость значения null............................................................... 203
6.3.2. Изменяемые и неизменяемые коллекции............................................................. 206
6.3.3. Коллекции Kotlin и язык Java....................................................................................208
6.3.4. Коллекции как платформенные типы..................................................................... 210
6.3.5. Массивы объектов и примитивных типов.............................................................. 213
6.4. Резюме...................................................................................................................................... 215
Часть 2. Непростой Kotlin....................................................................................... 217
Глава 7. Перегрузка операторов и другие соглашения...................................... 218
7.1. Перегрузка арифметических операторов...............................
219
7.1.1. Перегрузка бинарных арифметических операций...............................................219
7.1.2. Перегрузка составных операторов присваивания...............................................222
7.1.3. Перегрузка унарных операторов............................................................................. 224
7.2. Перегрузка операторов сравнения.................................................................................. 225
7.2.1. Операторы равенства: «equals»................................................................................ 225
7.2.2. Операторы отношения: сотрагеТо........................................................................... 227
7.3. Соглашения для коллекций и диапазонов.....................................................................228
7.3.1. Обращение к элементам по индексам: «get» и « set» ......................................... 228
7.3.2. Соглашение «in»........................................................................................................... 230
Оглавление ❖
9
7.3.3. Соглашение rangeTo.....................................................................................................231
7.3.4. Соглашение «iterator» для цикла «for»....................................................................232
7.4. Мультидекларации и функции com ponent....................................................................233
7.4.1. Мультидекларации и циклы...................................................................................... 235
7.5. Повторное использование логики обращения к свойству: делегирование
свойств...................................................................................................................................... 236
7.5.1. Делегирование свойств: основы............................................................................... 237
7.5.2. Использование делегирования свойств: отложенная инициализация
и «by LazyO».................................................................................................................... 238
7.5.3. Реализация делегирования свойств........................................................................ 240
7.5.4. Правила трансляции делегированных свойств..................................................... 244
7.5.5. Сохранение значений свойств в словаре............................................................... 245
7.5.6. Делегирование свойств в фреймворках.................................................................246
7.6. Резю ме...................................................................................................................................... 248
Глава 8. Функции высшего порядка: лямбда-выражения как параметры
и возвращаемые значения.....................................................................................249
8.1. Объявление функций высшего порядка.........................................................................250
8.1.1. Типы функций............................................................................................................... 250
8.1.2. Вызов функций, переданных в аргументах........................................................... 251
8.1.3. Использование типов функций в коде на Java..................................................... 253
8.1.4. Значения по умолчанию и пустые значения для параметров типов
функций..........................................................................................................................254
8.1.5. Возврат функций из функций.................................................................................... 257
8.1.6. Устранение повторяющихся фрагментов с помощью лямбда-выражений....259
8.2. Встраиваемые функции: устранение накладных расходов
лямбда-выражений...............................................................................................................262
8.2.1. Как работает встраивание функций........................................................................ 262
8.2.2. Ограничения встраиваемых функций..................................................................... 264
8.2.3. Встраивание операций с коллекциями...................................................................265
8.2.4. Когда следует объявлять функции встраиваемыми............................................. 267
8.2.5. Использование встраиваемых лямбда-выражений для управления
ресурсами...................................................................................................................... 268
8.3. Порядок выполнения функций высшего порядка.......................................................269
8.3.1. Инструкции return в лямбда-выражениях:
выход из вмещающей функции................................................................................ 270
8.3.2. Возврат из лямбда-выражений:
возврате помощью меток.......................................................................................... 271
8.3.3. Анонимные функции: по умолчанию возврат выполняется локально............ 273
8.4. Резюме...................................................................................................................................... 274
Глава 9. Обобщенные типы....................................................................................276
9.1. Параметры обобщенных типов......................................................................................... 277
9.1.1. Обобщенные функции и свойства............................................................................278
9.1.2. Объявление обобщенных классов...........................................................................279
9.1.3. Ограничения типовых параметров......................................................................... 281
9.1.4. Ограничение поддержки null в типовом параметре......................................... 283
10 ❖
Оглавление
9.2. Обобщенные типы во время выполнения: стирание и овеществление
параметров типов..................................................................................................................284
9.2.1. Обобщенные типы во время выполнения: проверка и приведение типов ....284
9.2.2. Объявление функций с овеществляемыми типовыми параметрами.............287
9.2.3. Замена ссылок на классы овеществляемыми типовыми параметрами......... 290
9.2.4. Ограничения овеществляемых типовых параметров........................................ 291
9.3. Вариантность: обобщенные типы и подтипы............................................................... 292
9.3.1. Зачем нужна вариантность: передача аргумента в функцию............................292
9.3.2. Классы,типы и подтипы..............................................................................................293
9.3.3. Ковариантность: направление отношения тип-подтип сохраняется.............. 296
9.3.4. Контравариантносгь: направление отношения тип-подтип изменяется
на противоположное................................................................................................... 300
9.3.5. Определение вариантности в месте использования: определение
вариантности для вхождений типов........................................................................ 303
9.3.6. Проекция со звездочкой: использование * вместо типового аргумента........ 306
9.4. Резюме...................................................................................................................................... 311
Глава 10. Аннотации и механизм рефлексии...................................................... 313
10.1. Объявление и применение аннотаций.........................................................................314
10.1.1. Применение аннотаций........................................................................................... 314
10.1.2. Целевые элементы аннотаций............................................................................... 315
10.1.3. Использование аннотаций для настройки сериализации JSON......................318
10.1.4. Объявление аннотаций.............................................................................................320
10.1.5. Метааннотации: управление обработкой аннотаций........................................321
10.1.6. Классы как параметры аннотаций......................................................................... 322
10.1.7. Обобщенные классы в параметрах аннотаций.................................................. 323
10.2. Рефлексия: интроспекция объектов Kotlin во время выполнения..................... 325
10.2.1. Механизм рефлексии в KotLin: KClass, KCallable, KFunction и KProperty.....326
10.2.2. Сериализация объектов с использованием механизмарефлексии................330
10.2.3. Настройка сериализации с помощью аннотаций...............................................332
10.2.4. Парсинг формата JSON и десериализация объектов........................................ 336
10.2.5. Заключительный этап десериализации: calLByO и создание объектов
с использованием рефлексии....................................................................................340
10.3. Резюме....................................................................................................................................345
Глава 11. Конструирование DSL............................................................................ 346
11.1. От API к DSL.......................................................................................................................... 346
11.1.1. Понятие предметно-ориентированного языка................................................... 348
11.1.2. Внутренние предметно-ориентированные языки............................................. 349
11.1.3. Структура предметно-ориентированных языков.............................................. 351
11.1.4. Создание разметки HTML с помощью внутреннего DSL.................................. 352
11.2. Создание структурированных API: лямбда-выражения с получателями
в DSL.......................................................................................................................................... 354
11.2.1. Лямбда-выражения с получателями и типы функций-расширений.............. 354
11.2.2. Использование лямбда-выражений с получателями в построителях
разметки HTML............................................................................................................. 358
11.2.3. Построители на Kotlin: поддержка абстракций и многократного
использования.............................................................................................................. 363
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Оглавление ❖
11
11.3. Гибкое вложение блоков с использованием соглашения «invoke».................... 366
11.3.1. Соглашение «invoke»: объекты, вызываемые как функции..............................367
11.3.2. Соглашение «invoke» и типы функций.................................................................. 367
11.3.3. Соглашение «invoke» в предметно-ориентированных языках:
объявление зависимостей в Gradle...........................................................................369
11.4. Предметно-ориентированные языки KotLin на практике.......................................371
11.4.1. Цепочки инфиксных вызовов: «should» в фреймворках тестирования...... 371
11.4.2. Определение расширений для простых типов: обработка дат...................... 374
11.4.3. Члены-расширения: внутренний 0Б1_для SQL................................................... 375
11.4.4. Anko: динамическое создание пользовательских интерфейсов
в Android.........................................................................................................................378
11.5. Резюме....................................................................................................................................380
Приложение А. Сборка проектов на Kotlin.......................................................... 382
А.1. Сборка кода на Kotlin с помощью Gradle......................................................................382
А.1.1. Сборка Kotlin-приложений для Android с помощью Gradle...............................383
А.1.2. Сборка проектов с обработкой аннотаций............................................................384
А.2. Сборка проектов на Kotlin с помощью M aven............................................................ 384
A. З. Сборка кода на Kotlin с помощью Ant........................................................................... 385
Приложение В. Документирование кода на Kotlin.............................................387
B. 1. Документирующие комментарии в Kotlin.................................................................... 387
B. 2. Создание документации с описанием A P I.................................................................. 389
Приложение С. Экосистема Kotlin......................................................................... 390
C. 1. Тестирование......................................................................................................................... 390
С.2. Внедрение зависимостей................................................................................................... 391
С.З. Сериализация JSON...............................................................................................................391
С.4. Клиенты HTTP........................................................................................................................ 391
С.5. Веб-приложения.................................................................................................................... 391
С.6. Доступ к базам данных........................................................................................................ 392
С.7. Утилиты и структуры данных..............................................................................................392
С.8. Настольные приложения..................................................................................................... 393
Предметный указатель...........................................................................................394
Предисловие
Впервые оказавшись в JetBrains весной 2010 года, я был абсолютно уверен, чтомиру не нужен еще один язык программирования общего назначения. Я полагал,
что существующие JVM-языки достаточно хороши, да и кто в здравом уме станет
создать новый язык? Примерно после часа обсуждения проблем разработки круп­
номасштабных программных продуктов мое мнение изменилось и я набросал на
доске первые идеи, которые позже стали частью языка Kotlin. Вскоре после этого я
присоединился к JetBrains для проектирования языка и работы над компилятором.
Сегодня, спустя шесть лет, мы приближаемся к выпуску второй версии. Сейчас
в команде работает более 30 человек, а у языка появились тысячи активных поль­
зователей, и у нас осталось еще множество потрясающих идей, которые с трудом
укладываются в моей голове. Но не волнуйтесь: прежде чем стать частью языка, эти
идеи подвергнутся тщательной проверке. Мы хотим, чтобы в будущем описание
языка Kotlin по-прежнему могло уместиться в одну не слишком большую книгу.
Изучение языка программирования - это захватывающее и часто очень полез­
ное занятие. Если это ваш первый язык, с ним вы откроете целый новый мир про­
граммирования. Если нет, он заставит вас по-другому думать о знакомых вещах и
глубже осознать их на более высоком уровне абстракции. Эта книга предназначе­
на в основном для последней категории читателей, уже знакомых с Java.
Проектирование языка с нуля - это сама по себе сложная задача, но обеспече­
ние взаимодействия с другим языком - это совсем другая история, полная злых
огров и мрачных подземелий. (Если не верите мне - спросите Бьярне Страуструпа (Bjarne Stroustrup), создателя C++). Совместимость с Java (то есть возможность
смешивать код на Java и Kotlin и вызывать один из другого) стала одним из краеу­
гольных кам- ней Kotlin, и эта книга уделяет большое внимание данному аспекту.
Взаимодей- ствие с Java очень важно для постепенного внедрения Kotlin в суще­
ствующие про- екты на Java. Даже создавая проект с нуля, важно учитывать, как
язык вписывается в общую картину платформы со всем многообразием библио­
тек, написанных на Java.
В данный момент, когда я пишу эти строки, разрабатываются две новые плат­
формы: Kotlin уже запускается на виртуальных машинах JavaScript, обеспечивая
поддержку разработки всех уровней веб-приложения, и скоро его можно будет
компилировать прямо в машинный код и запускать без виртуальной машины.
Хотя эта книга ориентирована на JVM, многое из того, что вы узнаете, может быть
использовано в других средах выполнения.
Авторы присоединились к команде Kotlin с самых первых дней, поэтому они
хорошо знакомы с языком и его внутренним устройством. Благодаря опыту вы­
ступления на конференциях и проведению семинаров и курсов о Kotlin, авторы
смогли сформировать хорошие объяснения, предвосхищающие самые распро­
страненные вопросы и возможные подводные камни. Книга объясняет высокоу­
ровневые понятия языка во всех необходимых подробностях.
Надеюсь, вы хорошо проведете время с книгой, изучая наш язык. Как я часто
говорю в сообщениях нашего сообщества: «Хорошего Kotlin!».
Андрей Бреслав
Ведущий разработчик языка Kotlin в JetBrains
Вступление
Идея создания Kotlin зародилась в JetBrains в 2010 году. К тому времени ком­
пания уже была признанным производителем инструментов разработки для
множества языков, включая Java, С#, JavaScript, Python, Ruby и РНР. IntelliJ
IDEA - наш флагманский продукт, интегрированная среда разработки (IDE)
для Java - также включала плагины для Groovy и Scala.
Опыт разработки инструментария для такого разнообразного набора язы­
ков позволил нам получить уникальное понимание процесса проектирования
языков целом и взглянуть на него под другим углом. И все же интегрирован­
ные среды разработки на платформе IntelliJ, включая IntelliJ IDEA, по-преж­
нему разрабатывались на Java. Мы немного завидовали нашим коллегам из
команды .NET, которые вели разработку на C# - современном, мощном, быст­
ро развивающемся языке. Но у нас не было языка, который мы могли бы ис­
пользовать вместо Java.
Какими должны быть требования к такому языку? Первое и самое очевид­
ное - статическая типизация. Мы не знаем другого способа разрабатывать
проекты с миллионами строк кода на протяжении многих лет, не сходя при
этом с ума. Второе - полная совместимость с существующим кодом на Java.
Этот код является чрезвычайно ценным активом компании JetBrains, и мы
не могли себе позволить потерять или обесценить его из-за проблем совме­
стимости. В-третьих, мы не хотели идти на компромиссы с точки зрения ка­
чества инструментария. Производительность разработчиков - самая главная
ценность компании JetBrains, а для её достижения нужен хороший инстру­
ментарий. Наконец, нам был нужен язык, простой в изучении и применении.
Когда мы видим в своей компании неудовлетворенную потребность, мы
знаем, что есть и другие компании, оказавшиеся в подобной ситуации, и что
наше решение найдет много пользователей за пределами JetBrains. Учитывая
это, мы решили начать проект разработки нового языка: Kotlin. Как это часто
бывает, проект занял больше времени, чем мы ожидали, и Kotlin 1.0 вышел
больше чем через пять лет после того, как в репозитории появился первый
фрагмент его реализации; но теперь мы уверены, что язык нашел своих поль­
зователей и будет использоваться в дальнейшем.
Язык Kotlin назван в честь острова Котлин неподалеку от Санкт-Петербурга
в России, где живет большинство разработчиков Kotlin. Выбрав для названия
языка имя острова, мы последовали прецеденту, созданному языками Java и
Ceylon, но решили найти что-то ближе к нашему дому.
По мере приближения к выпуску первой версии языка мы поняли, что нам
не помешала бы книга про Kotlin, написанная людьми, которые участвовали
в принятии проектных решений и могут уверенно объяснить, почему Kotlin
устроен так, а не иначе. Данная книга - результат совместных усилий этих лю­
дей, и мы надеемся, что она поможет вам узнать и понять язык Kotlin. Удачи
вам, и программируйте с удовольствием!
Благодарности
Прежде всего мы хотим поблагодарить Сергея Дмитриева и Максима Шафирова за веру в идею нового языка и решение вложить средства JetBrains в его
разработку. Без них не было бы ни языка, ни этой книги.
Мы хотели бы особо поблагодарить Андрея Бреслава - главного виновника,
что язык спроектирован так, что писать про него одно удовольствие (впрочем,
как и программировать на нем). Несмотря на занятость управлением посто­
янно растущей командой Kotlin, Андрей смог сделать много полезных заме­
чаний, что мы очень высоко ценим. Более того, вы можете быть уверены, что
книга получила одобрение от ведущего разработчика языка в виде предисло­
вия, которое он любезно написал.
Мы благодарны команде издательства Manning, которая помогла нам напи­
сать книгу и сделать ее легко читаемой и хорошо структурированной. В част­
ности, мы хотим поблагодарить редактора-консультанта Дэна Махари (Dan
Maharry), который всегда стремился найти время для обсуждения, несмотря
на наш напряженный график, а также Майкла Стивенса (Michael Stephens),
Хелен Стергиус (Helen Stergius), Кевина Салливана (Kevin Sullivan), Тиффани
Тейлор (Tiffany Taylor), Элизабет Мартин (Elizabeth Martin) и Марию Тюдор
(Marija Tudor). Отзывы наших технических редакторов Брента Уотсона (Brent
Watson) и Игоря Войды (Igor Wojda) оказались просто бесценны, так же как
замечания рецензентов, читавших рукопись в процессе работы: Алессандро
Кампеи (Alessandro Campeis), Амита Дамба (Amit Lamba), Анджело Косты
(Angelo Costa), Бориса Василе (Boris Vasile), Брендана Грейнджера (Brendan
Grainger), Кальвина Фернандеса (Calvin Fernandes), Кристофера Бейли
(Christopher Bailey), Кристофера Борца (Christopher Bortz), Конора Редмонда
(Conor Redmond), Дилана Скотта (Dylan Scott), Филипа Правика (Filip Pravica),
Джейсона Ли (Jason Lee), Джастина Ли (Justin Lee), Кевина Орра (Kevin Orr),
Николаса Франкеля (Nicolas Frankel), Павла Гайды (Pawel Gajda), Рональда Тишлера (Ronald Tischliar) и Тима Лаверса (Tim Laver).
Также благодарим всех, кто отправил свои предложения в рамках МЕАР
(Manning Early Access Program - программы раннего доступа Manning) на фо­
руме книги; ваши комментарии помогли улучшить текст книги.
Мы благодарны всем участникам команды Kotlin, которым приходилось
выслушивать ежедневные заявления вроде: «Еще один раздел закончен!» - на
протяжении всего периода написания этой книги. Мы хотим поблагодарить
наших коллег, которые помогли составить план книги и оставляли отзывы о
её ранних вариантах, особенно Илью Рыженкова, Хади Харири (Hadi Hariri),
Михаила Глухих и Илью Горбунова. Мы также хотим поблагодарить друзей,
которые не только поддерживали нас, но и читали текст книги и оставляли
отзывы о ней (иногда на горнолыжных курортах во время отпуска): Льва Се­
ребрякова, Павла Николаева и Алису Афонину.
Наконец, мы хотели бы поблагодарить наши семьи и котов за то, что они
делают этот мир лучше.
Об этой книге
Книга «Kotlin в действии» расскажет о языке Kotlin и как писать на нем при­
ложения для виртуальной машины Java и Android. Она начинается с обзо­
ра основных особенностей языка Kotlin, постепенно раскрывая наиболее
отличительные аспекты, такие как поддержка создания высокоуровне­
вых абстракций и предметно-ориентированных языков (Domain-Specific
Languages, DSL). Книга уделяет большое внимание интеграции Kotlin с су­
ществующими проектами на языке Java и поможет вам внедрить Kotlin в
текущую рабочую среду.
Книга описывает версию языка Kotlin 1.0. Версия Kotlin 1.1 разрабаты­
валась параллельно с написанием книги, и, когда это было возможно, мы
упоминали об изменениях в версии 1.1. Но поскольку на момент напи­
сания книги новая версия еще не была готова, мы не могли полностью
охватить все нововведения. За более подробной информацией о новых
возможностях и изменениях обращайтесь к документации по адресу:
h ttp s://kotlin
Кому адресована эта книга
Книга «Kotlin в действии» адресована в первую очередь разработчикам
с опытом программирования на языке Java. Kotlin во многом основан на
понятиях и приёмах языка Java, и с помощью этой книги вы быстро ос­
воите его, используя имеющиеся знания. Если вы только начали изучать
Java или владеете другими языками программирования, такими как C#
или JavaScript, вам может понадобиться обратиться к другим источникам
информации, чтобы понять наиболее сложные аспекты взаимодействия
Kotlin с JVM, но вы все равно сможете изучить Kotlin, читая эту книгу. Мы
описываем язык Kotlin в целом, не привязываясь к конкретной предмет­
ной области, поэтому книга должна быть одинаково полезна и для разра­
ботчиков серверных приложений, и для разработчиков на Android, и для
всех, кто создает проекты для JVM.
Как организована эта книга
Книга делится на две части. Часть 1 объясняет, как начать использовать
Kotlin вместе с существующими библиотеками и API:
О глава 1 рассказывает о ключевых целях, ценностях и областях приме­
нения языка и показывает различные способы запуска кода на Kotlin;
О глава 2 демонстрирует важные элементы любой программы на языке
Kotlin, включая управляющие структуры, переменные и функции;
16 ❖
Об этой книге
О в главе 3 подробно рассматриваются объявления функций в Kotlin, а
также вводятся понятия функций-расширений (extension functions)
и свойств-расширений (extension properties);
О глава 4 посвящена объявлению классов и знакомит с понятиями
классов данных (data classes) и объектов-компаньонов (companion
objects);
О глава 5 знакомит с лямбда-выражениями и демонстрирует ряд при­
меров их использования в стандартной библиотеке Kotlin;
О глава 6 описывает систему типов Kotlin, обращая особое внимание
на работу с типами, допускающими значения null, и с коллекция­
ми.
Часть 2 научит вас создавать собственные API и абстракции на языке
Kotlin и охватывает некоторые более продвинутые особенности языка:
О глава 7 рассказывает о соглашениях, придающих особый смысл м е­
тодам и свойствам с определенными именами, и вводит понятие д е­
легируемых свойств (delegated properties);
О глава 8 показывает, как объявлять функции высшего порядка функции, принимающие другие функции или возвращающие
их. Здесь также вводится понятие встраиваемых функций (inline
functions);
глава 9 глубоко погружается в тему обобщенных типов (generics),
начиная с базового синтаксиса и переходя к более продвинутым
темам, таким как овеществляемые типовые параметры (reified type
parameters) и вариантность;
О глава 10 посвящена использованию аннотаций и механизма реф­
лексии (reflection) и организована вокруг JKid - простой библиотеки
сериализации в формат JSON, которая интенсивно использует эти
понятия;
глава 11 вводит понятие предметно-ориентированного языка (DSL),
описывает инструменты Kotlin для их создания и демонстрирует
множество примеров DSL.
В книге есть три приложения. Приложение А объясняет, как выполнять
сборку проектов на Kotlin с помощью Gradle, Maven и Ant. Приложение В
фокусируется на документирующих комментариях и создании докумен­
тации с описанием API модулей. Приложение С является руководством по
экосистеме Kotlin и поиску актуальной информации в Интернете.
Книгу лучше читать последовательно, от начала до конца, но также мож­
но обращаться к отдельным главам, посвященным интересующим вам
конкретным темам, и переходить по перекрестным ссылкам для уточне­
ния незнакомых понятий.
Об этой книге ❖
17
Соглашения об оформлении программного кода
и загружаемые ресурсы
В книге приняты следующие соглашения:
О Курсивом обозначаются новые термины.
О Моноширинным шрифтом выделены фрагменты кода, имена классов и
функций и другие идентификаторы.
О Примеры кода сопровождаются многочисленными примечаниями,
подчеркивающими важные понятия.
Многие листинги кода в книге показаны вместе с его выводом. В таких
случаях строки кода, производящие вывод, начинаются с префикса »> , как
показано ниже:
»> println("H ello World")
Hello World
Некоторые примеры являются полноценными программами, тогда как
другие - лишь фрагменты, демонстрирующие определенные понятия и
могущие содержать сокращения (обозначенные как...) или синтаксические
ошибки (описанные в тексте книги или самих примерах). Выполняемые
примеры можно загрузить в виде zip-архива на сайте издательства www.
mann ing.com /books /kot Iin -in-action.Примеры из книги также выгруже­
ны в онлайн-окружение http: //try.kotlinlang.org.где вы сможете опро­
бовать любой пример, сделав всего несколько щелчков в окне браузера.
Авторы онлайн
Покупка книги «Kotlin в действии» дает право свободного доступа к за­
крытому веб-форуму издательства Manning Publication, где можно вы­
сказать свои замечания о книге, задать технические вопросы и получить
помощь от авторов и других пользователей. Чтобы получить доступ к фо­
руму, перейдите по ссылке WWW.manning.com/books/kotlin-in-action.
На этой странице описывается, как попасть на форум после регистрации,
какая помощь доступна и какие правила поведения действуют на форуме.
Издательство Manning обязуется предоставить читателям площадку
для содержательного диалога не только между читателями, но и между
читателями и авторами. Но авторы не обязаны выделять определённое
количество времени для участия, т. к. их вклад в работу форума является
добровольным (и неоплачиваемым). Мы предлагаем читателям задавать
авторам действительно непростые вопросы, чтобы их интерес не угасал!
Прочие онлайн-ресурсы
Kotlin имеет активное сообщество, поэтому имеющие вопросы или же­
лающие пообщаться с другими пользователями Kotlin могут воспользо­
ваться следующими ресурсами:
18 ❖
Об этой книге
О официальный форум Kotlin - h ttp s: //d is c u s s .k o tlin la n Q .o r g :
О чат Slack - h t t p : / / k o t l i n l a n t p . s l a c k . c o m (вы можете получить при­
глашение ПО ссылке h t t p : / / k o t L i n s l a c k i n .h e r o k u a p p .c o m Л :
О вопросы и ответы с тегом Kotlin на Stack Overflow - h ttp : //s t a c k overflow. c o m / q u e s t i o n s / t a g g e d / k o t l i n :
О Kotlin на форуме Reddit - h ttp : / / w w w .red d it.com /r/K otlin .
Об авторах
Дмитрий Ж емеров работает в компании JetBrains с 2003 года и принимал
участие в разработке многих продуктов, в том числе IntelliJ IDEA, PyCharm
и WebStorm. Был одним из первых участников команды Kotlin, создал на­
чальную версию генератора байт-кода JVM из кода Kotlin и сделал много
презентаций о языке Kotlin на различных встречах по всему миру. Сейчас
возглавляет команду, работающую над плагином Kotlin IntelliJ IDEA.
Светлана Исакова вошла в состав команды Kotlin в 2011 году. Работа­
ла над механизмом вывода типов (type inference) и подсистемой компи­
лятора по разрешению перегруженных имен. Сейчас она - технический
евангелист, рассказывает о Kotlin на конференциях и разрабатывает он­
лайн-курс по языку Kotlin.
Об изображении на обложке
Иллюстрация на обложке книги «Kotlin в действии» называется «Одежда
русской женщины на Валдае в 1764 году». Город Валдай находится в Нов­
городской области, между Москвой и Санкт-Петербургом. Иллюстрация
взята из работы Томаса Джеффериса (Thomas Jefferys) «Коллекция плать­
ев разных народов, древних и современных», опубликованной в Лондоне
между 1757 и 1772 г.. На титульной странице говорится, что это - раскра­
шенная вручную гравюра, обработанная гуммиарабиком для повышения
яркости. Томаса Джеффериса (1719-1771) называли географом короля Ге­
орга III. Он был английским картографом и ведущим поставщиком карт
своего времени. Он гравировал и печатал карты для правительства и дру­
гих официальных органов, выпускал широкий спектр коммерческих карт
и атласов, особенно Северной Америки. Работа картографом пробудила
интерес к местным традиционным нарядам в землях, которые он иссле­
довал и картографировал; эти наряды великолепно представлены в четы­
рехтомном сборнике.
Очарование дальними странами и путешествия для удовольствия были
относительно новым явлением в восемнадцатом веке, и такие коллекции,
как эта, были популярны и показывали туристам и любителям книг о пу­
тешествиях жителей других стран. Разнообразие рисунков в книгах Джеф­
фериса красноречиво говорит об уникальности и индивидуальности на­
родов мира много веков назад. С тех пор стиль одежды сильно изменился,
и разнообразие, характеризующее различные области и страны, исчезло.
Сейчас часто трудно отличить даже жителей одного континента от дру-
20 ❖
Об изображении на обложке
гого. Возможно, с оптимистической точки зрения, мы обменяли культур­
ное и визуальное разнообразие на более разнообразную частную жизнь
или более разнообразную и интересную интеллектуальную и техническую
деятельность.
В наше время, когда трудно отличить одну компьютерную книгу от дру­
гой, издательство Manning с инициативой и находчивостью наделяет кни­
ги обложками, изображающими богатое разнообразие жизненного уклада
народов многовековой давности, давая новую жизнь рисункам Джеффе­
риса.
Часть
Введение в Kotlm
Цель этой части книги - помочь начать продуктивно писать код на язы­
ке Kotlin, используя существующие API. Глава 1 познакомит вас с языком
Kotlin в общих чертах. В главах 2 -4 вы узнаете, как в Kotlin реализованы
основные понятия языка Java - операторы, функции, классы и типы, - и
как Kotlin обогащает их, делая программирование более приятным. Вы
сможете положиться на имеющиеся знания языка Java, а также на вспо­
могательные инструменты, входящие в состав интегрированной среды
разработки, и конвертер кода на Java в код на Kotlin, чтобы быстро начать
писать код. В главе 5 вы узнаете, как лямбда-выражения помогают эффек­
тивно решать некоторые из распространенных задач программирования,
такие как работа с коллекциями. Наконец, в главе 6 вы познакомитесь с
одной из ключевых особенностей Kotlin - поддержкой операций со значе­
ниями n u ll.
Глава
Kotlin: что это и зачем
В этой главе:
общий обзор языка Kotlin;
основные особенности;
возможности разработки для Android и серверных приложе­
ний;
отличие Kotlin от других языков;
написание и выполнение кода на языке Kotlin.
Что же такое Kotlin? Это новый язык программирования для платформы
Java. Kotlin - лаконичный, безопасный и прагматичный язык, совмести­
мый с Java. Его можно использовать практически везде, где применяется
Java: для разработки серверных приложений, приложений для Android и
многого другого. Kotlin прекрасно работает со всеми существующими биб­
лиотекам и фреймворками, написанными на Java, не уступая последнему
в производительности. В этой главе мы подробно рассмотрим основные
черты языка Kotlin.
1.1. Знакомство с Kotlin
Начнем с небольшого примера для демонстрации языка Kotlin. В этом при­
мере определяется класс Person, создается коллекция его экземпляров, вы­
полняется поиск самого старого и выводится результат. Даже в этом малень­
ком фрагменте кода можно заметить множество интересных особенностей
языка Kotlin; мы выделили некоторые из них, чтобы вам проще было отыс­
кать их в книге в будущем. Код пояснен довольно кратко, но не беспокой­
тесь, если что-то останется непонятным. Позже мы подробно всё обсудим.
Желающие опробовать этот пример могут воспользоваться онлайн-по­
лигоном по адресу: h t t p : / / t r y . kot.i.. in . Введите пример, щелкните на
кнопке Run (Запустить), и код будет выполнен.
1.2. Основные черты языка Kotlin ♦> 23
Листинг 1.1. Первое знакомство с Kotlin
data class Person(val name: String,
val age: Int? = n u ll)
<1—Класс«данных»
Тип, допускающийзначениеnull (Int?);
значениепараметрапоумолчанию
О—Функцияверхнегоуровня
fun main(args: Array<String>) {
val persons = listOf(Person("Alice"),
Person("Bob", age = 29))
О—Именованныйаргумент
val oldest = persons.maxBy { it.age ?: 0 }
Лямбда-выражение; оператор«Элвис»
println("The oldest is: Joldest")
О—Строка-шаблон
}
/ / The oldest is: Person(name=Bon, age=29)
I Насть вывода автоматически сгенерирована
методомtoString
Здесь объявляется простой класс данных с двумя свойствами: name и
аде. Свойству аде по умолчанию присваивается значение n u ll (если оно
не задано). При создании списка людей возраст Алисы не указывается,
поэтому он принимает значение n u ll. Затем, чтобы отыскать самого ста­
рого человека в списке, вызывается функция maxBy. Лямбда-выражение,
которое передается функции, принимает один параметр с именем i t по
умолчанию. Оператор «Элвис» (?:) возвращает ноль, если возраст имеет
значение n u ll. Поскольку возраст Алисы не указан, оператор «Элвис» за­
менит его нулем, поэтому Боб получит приз как самый старый человек.
Вам понравилось? Читайте дальше, чтобы узнать больше и стать экспер­
том в языке Kotlin. Мы надеемся, что скоро вы увидите такой код в своих
проектах, а не только в этой книге.
1.2. Основные черты языка Kotlin
Возможно, у вас уже есть некоторое представление о языке Kotlin. Давайте
подробнее рассмотрим его ключевые особенности. Для начала определим
типы приложений, которые можно создавать с его помощью.
1.2.1. Целевые платформы: серверные приложения.
Android и везде, где запускается Java
Основная цель языка Kotlin - предложить более компактную, произво­
дительную и безопасную альтернативу языку lava, пригодную для исполь­
зования везде, где сегодня применяется lava. lava - чрезвычайно популяр­
ный язык, который используется в самых разных окружениях, начиная от
смарт-карт (технология Java Card) до крупнейших вычислительных цент­
ров таких компаний, как Google, Twitter и Linkedln. В большинстве таких
окружений применение Kotlin способно помочь разработчикам достигать
своих целей меньшим объемом кода и избегая многих неприятностей.
24 ❖
Глава 1. Kotlin: что это и зачем
Наиболее типичные области применения Kotlin:
О разработка кода, работающего на стороне сервера (как правило, сер­
верной части веб-приложений);
О создание приложений, работающих на устройствах Android.
Но Kotlin работает также в других областях. Например, код на Kotlin
можно выполнять на устройствах с iOS, используя технологию Intel Mul­
ti-OS Engine (https://software.intel.com/en-us/multi-os-engine).На
Kotlin можно писать и настольные приложения, используя его совместно с
TomadoFX (https: //github.com/edvin/tornadofx) и JavaFX1.
Помимо Java, код на Kotlin можно скомпилировать в код на JavaScript и
выполнять его в браузере. Но на момент написания этой книги поддержка
JavaScript находилась в стадии исследования и прототипирования, поэто­
му она осталась за рамками данной книги. В будущих версиях языка также
рассматривается возможность поддержки других платформ.
Как видите, область применения Kotlin достаточно обширна. Kotlin не
ограничивается одной предметной областью или одним типом проблем,
с которыми сегодня сталкиваются разработчики программного обеспече­
ния. Вместо этого он предлагает всестороннее повышение продуктивно­
сти при решении любых задач, возникающих в процессе разработки. Он
также предоставляет отличный уровень интеграции с библиотеками, соз­
данными для поддержки определенных предметных областей или пара­
дигм программирования. Давайте рассмотрим основные качества Kotlin
как языка программирования.
1.2.2. Статическая типизация
Так же, как Java, Kotlin - статически типизированный язык программи­
рования. Это означает, что тип каждого выражения в программе известен
во время компиляции, и компилятор может проверить, что методы и поля,
к которым вы обращаетесь, действительно существуют в используемых
объектах.
Этим Kotlin отличается от динамически типизированных (dynamically
typed) языков программирования на платформе JVM, таких как Groovy и
JRuby. Такие языки позволяют определять переменные и функции, спо­
собные хранить или возвращать данные любого типа, а ссылки на поля и
методы определяются во время выполнения. Это позволяет писать более
компактный код и дает большую гибкость в создании структур данных.
Но в языках с динамической типизацией есть свои недостатки: например,
опечатки в именах нельзя обнаружить во время компиляции, что влечет
появление ошибок во время выполнения.*
1
«JavaFX: Getting Started with JavaFX», Oracle, h t t p : / / m n g .b z / 5 0 0 y .
1.2. Основные черты языка Kotlin ❖
25
С другой стороны, в отличие от Java, Kotlin не требует явно указывать
тип каждой переменной. В большинстве случаев тип переменной может
быть определен автоматически. Вот самый простой пример:
val х = 1
Вы объявляете переменную, но поскольку она инициализируется цело­
численным значением, Kotlin автоматически определит её тип как I n t.
Способность компилятора определять типы из контекста называется вы­
ведением типа (type inference).
Ниже перечислены некоторые преимущества статической типизации:
О Производительность - вызов методов происходит быстрее, посколь­
ку во время выполнения не нужно выяснять, какой метод должен
быть вызван.
О Надежность - корректность программы проверяется компилятором,
поэтому вероятность ошибок во время выполнения меньше.
о Удобство сопровождения - работать с незнакомым кодом проще, по­
тому что сразу видно, с какими объектами код работает.
о Поддержка инструментов - статическая типизация позволяет уве­
реннее выполнять рефакторинг, обеспечивает точное автодополне­
ние кода и поддержку других возможностей IDE.
Благодаря поддержке выведения типов в Kotlin исчезает излишняя из­
быточность статически типизированного кода, поскольку больше не нуж­
но объявлять типы явно.
Система типов в Kotlin поддерживает много знакомых понятий. Классы,
интерфейсы и обобщенные типы работают практически так же, как в Java,
так что большую часть своих знаний Java вы с успехом сможете применить
на Kotlin. Однако есть кое-что новое.
Наиболее важным нововведением в Kotlin является поддержка типов,
допускающих значения n u ll (nullable types), которая позволяет писать
более надежные программы за счет выявления потенциальных ошибок
обращения к пустому указателю на этапе компиляции. Мы ещё вернемся
к типам, допускающим значение n u ll, далее в этой главе и подробно об­
судим их в главе 6.
Другим новшеством в системе типов Kotlin является поддержка функцио­
нальных типов (function types). Чтобы понять, о чем идет речь, обратимся к
основным идеям функционального программирования и посмотрим, как
они поддерживаются в Kotlin.
1.2.3. Функциональное и объектно-ориентированное
программирование
Как Java-разработчик вы, без сомнения, знакомы с основными понятия­
ми объектно-ориентированного программирования, но функциональное
26 ❖
Глава 1. Kotlin: что это и зачем
программирование может оказаться для вас в новинку. Ниже перечислены
ключевые понятия функционального программирования:
О Функции как полноценные объекты - с функциями (элементами по­
ведения) можно работать как со значениями. Их можно хранить в
переменных, передавать в аргументах или возвращать из других
функций.
О Неизменяемость - программные объекты никогда не изменяются,
что гарантирует неизменность их состояния после создания.
О Отсутствие побочных эффектов - функции всегда возвращают один
и тот же результат для тех же аргументов, не изменяют состояние
других объектов и не взаимодействуют с окружающим миром.
Какие преимущества дает функциональный стиль? Во-первых, лаконич­
ность. Функциональный код может быть более элегантным и компактным,
по сравнению с императивными аналогами, потому что возможность ра­
ботать с функциями как со значениями дает возможность создавать более
мощные абстракции, позволяющие избегать дублирования в коде.
Представьте, что у вас есть два похожих фрагмента кода, решающих ана­
логичную задачу (например, поиск элемента в коллекции), которые отли­
чаются в деталях (способом проверки критериев поиска). Вы легко сможе­
те перенести общую логику в функцию, передавая отличающиеся части в
виде аргументов. Эти аргументы сами будут функциями, но вы сможете
описать их, используя лаконичный синтаксис анонимных функций, назы­
ваемых лямбда-выражениями:
I Функция findPersonf) описывает
0_i оощуюлотку поиска
fun findAlice() = findPerson { it.name == "Alice" }
fun findBobQ = findPerson { it.name == "Bob" }
<•“ 1Блоккодавфигурныхскобкахзадает
I свойстваискомогоэлемента
Второе преимущество функциональной парадигмы - безопасное мно­
гопоточное программирование. Одним из основных источников ошибок в
многопоточных программах является модификация одних и тех же дан­
ных из нескольких потоков без надлежащей синхронизации. Используя
неизменяемые структуры данных и чистые функции, можно не опасаться
никаких изменений и не надо придумывать сложных схем синхрониза­
ции.
Наконец, функциональное программирование облегчает тестирование.
Функции без побочных эффектов можно проверять по отдельности, без
необходимости писать много кода для настройки окружения.
В целом функциональную парадигму можно использовать в любом
языке программирования, включая Java, и многие ее аспекты считаются
хорошим стилем программирования. Но не все языки поддерживают со­
ответствующий синтаксис и библиотеки, упрощающие применение этого
стиля; например, такая поддержка отсутствовала в Java до версии Java 8.
1.3. Приложения на KotLin ❖
27
Язык Kotlin изначально обладает богатым арсеналом возможностей для
поддержки функционального программирования. К ним относятся:
О функциональные типы, позволяющие функциям принимать или воз­
вращать другие функции;
О лямбда-выражения, упрощающие передачу фрагментов кода;
о классы данных, предоставляющие емкий синтаксис для создания не­
изменяемых объектов-значений;
о обширный набор средств в стандартной библиотеке для работы с
объектами и коллекциями в функциональном стиле.
Kotlin позволяет программировать в функциональном стиле, но не тре­
бует этого. Когда нужно, вы можете работать с изменяемыми данными и
писать функции с побочными эффектами без всяких затруднений. Рабо­
тать с фреймворками, основанными на иерархиях классов и интерфейсах,
так же легко, как на языке Java. В программном коде на Kotlin вы можете
совмещать объектно-ориентированный и функциональный подходы, ис­
пользуя для каждой решаемой проблемы наиболее подходящий инстру­
мент.
1.2.4. Бесплатный язык с открытым исходным кодом
Язык Kotlin, включая компилятор, библиотеки и все связанные с ними
инструменты, - это проект с открытым исходным кодом, который может
свободно применяться для любых целей. Он доступен на условиях лицен­
зии Apache 2,разработка ведется открыто в GitHub (http: //github.com/
jetbrains/kotlin),и любой добровольный вклад приветствуется. Также
на выбор есть три IDE с открытым исходным кодом, поддерживающих
разработку приложений на Kotlin: IntelliJ IDEA Community Edition, Android
Studio и Eclipse. (Конечно же, поддержка Kotlin имеется также в IntelliJ
IDEA Ultimate.)
Теперь, когда вы получили некоторое представление о Kotlin, пришла
пора узнать, как использовать его преимущества для конкретных практи­
ческих приложений.
1.3. Приложения на Kotlin
Как мы уже упоминали ранее, основные области применения Kotlin - это
создание серверной части приложений и разработка для Android. Рассмот­
рим эти области по очереди и разберемся, почему Kotlin так хорошо для
них подходят.
1.3.1. Kotlin на сервере
Серверное программирование - довольно широкое понятие. Оно охва­
тывает все следующие типы приложений и многое другое:
28 ❖
Глава 1. Kotlin: что это и зачем
О веб-приложения, возвращающие браузеру страницы HTML;
О серверные части мобильных приложений, открывающие доступ к
своему JSON API по протоколу HTTP;
О микрослужбы, взаимодействующие с другими микрослужбами по­
средством RPC.
Разработчики много лет создавали эти типы приложений на Java и на­
копили обширный набор фреймворков и технологий, облегчающих их со­
здание. Подобные приложения, как правило, не разрабатываются изоли­
рованно и не пишутся с нуля. Почти всегда есть готовая система, которую
нужно расширять, улучшать или заменять, и новый код должен интегри­
роваться с существующими частями системы, которые могли быть напи­
саны много лет назад.
Большим преимуществом Kotlin в подобной среде является его взаи­
модействие с существующим Java-кодом. Kotlin отлично подходит и для
создания новых компонентов, и для переноса кода существующей службы
на Kotlin. Вы не столкнетесь с затруднениями, когда коду на Kotlin понадо­
бится унаследовать Java-классы или отметить специальными аннотация­
ми методы и поля класса. Преимущество же заключается в том, что код
системы станет более компактным, надежным и простым в обслуживании.
В то же время Kotlin предлагает ряд новых приемов для создания таких
систем. Например, его поддержка шаблона «Строитель» (Builder) позволя­
ет создавать произвольные графы объектов, используя очень лаконичный
синтаксис, не отказываясь при этом от полного набора абстракций и ин­
струментов повторного использования кода в языке.
Один из простейших примеров использования этой особенности - биб­
лиотека создания разметки HTML: лаконичное и полностью типобезопас­
ное решение, которое может полностью заменить сторонний язык шабло­
нов. Например:
fun renderPersonList(persons: Collection<Person>) =
createHTML().table {
for (person in persons) { О—Обычныйцикл
Функции, соответствующие
tr {
тегамHTML
td { +person.name }
td { +person.age }
}
}
}
}
Вы легко сможете объединить функции, выводящие теги HTML, с обыч­
ными конструкциями языка Kotlin. Вам больше не нужно изучать отдель­
ный язык шаблонов со своим синтаксисом только затем, чтобы использо­
вать цикл при создании HTML-страницы.
1.3. Приложения на KotLin ❖
29
Другой пример использования ясности Kotlin и лаконичности предмет­
но-ориентированных языков - фреймворки хранения данных. Например,
фреймворк Exposed (https: //github.com/jetbrains/exposed) поддер­
живает простой и понятный предметный язык для описания структуры
базы данных SQL и выполнения запросов прямо из кода на Kotlin с полно­
ценной проверкой типов. Вот маленький пример, показывающий возмож­
ности такого подхода:
object CountryTable : IdTable() {
<1-1 Описаниетаблицывбазе
val name = varcbar("name", 250).uniquelndex()
I данных
val iso = varcbar("iso", 2).uniquelndex()
}
class CountryCid: EntitylD) : Entity(id) { <Ь, Определениекласса, соответствующего
var name: String by CountryTable. name
I сущнопивбазеданных
var iso: String by CountryTable.iso
}
val russia = Country.find {
CountryTable.iso.eq("ru")
} .fir s t( )
Выможетевыполнятьзапросык базе
I данныхначистомKotlin
printIn(russia.name)
Мы рассмотрим эти методы более подробно в разделе 7.5 и в главе 11.
1.3.2. Kotlin в Android
Типичное мобильное приложение значительно отличается от типично­
го корпоративного приложения. Оно гораздо меньше по объему, не так
сильно зависит от интеграции с существующими кодовыми базами и, как
правило, должно быть разработано за короткий срок, при этом поддер­
живая надежную работу на различных устройствах. Kotlin также хорошо
справляется с проектами такого типа.
Языковые особенности Kotlin в сочетании со специальным плагином
для компилятора делают разработку для Android приятным и продуктив­
ным занятием. Часто встречающиеся задачи программирования, такие
как добавление обработчиков событий в элементы управления или связы­
вание элементов интерфейса с полями, можно решить гораздо меньшим
объемом кода, а иногда и совсем без кода (компилятор сгенерирует его за
вас). Библиотека Anko fhttps: //github.com/kotlin/ankoLтоже разрабо­
танная командой Kotlin, сделает вашу работу ещё приятнее за счет Kotlinсовместимых адаптеров для многих стандартных Android API.
Ниже продемонстрирован простой пример использования Anko, чтобы
вы почувствовали, что значит разработка для Android на языке Kotlin. Вы
30 ❖
Глава 1. Kotlin: что это и зачем
можете скопировать этот код в класс-наследник A c tiv ity и получить го­
товое Android-приложение!
verticalLayout {
Созданиепростого
val name = editText()
<Н текстовогополя
button("Say Hello") {
onClick { toast("Hello, ${name.te x t}!") }
}
J
rioщелчкунакнопкевывестивсплывающее
сообщениессодержимымтекстовогополя
<1“ I Лаконичныйсинтаксисподключения
I обработчикасобытийиотображения
всплывающегосообщения
[ругое большое преимущество Kotlin - повышенная надежность при­
ложений. Если у вас есть какой-либо опыт разработки приложений для
Android, вы наверняка знакомы с сообщением «К сожалению, процесс оста­
новлен». Это диалоговое окно появляется, когда приложение встречается с
необработанным исключением, обычно N ullP ointerE xception. Система
типов в Kotlin, с её точным контролем значений n u ll, значительно снижа­
ет риск исключений из-за обращения к пустому указателю. Большую часть
кода, который в Java приводит к исключению N ullP oin terE xception , в
языке Kotlin попросту не удастся скомпилировать, что гарантирует ис­
правление ошибки до того, как приложение попадет к пользователям.
В то же время, поскольку Kotlin полностью совместим с Java 6, его ис­
пользование не создает каких-либо новых опасений в области совмести­
мости. Вы сможете воспользоваться всеми новыми возможностями язы­
ка, а пользователи по-прежнему смогут запускать ваше приложение на
устройствах даже с устаревшей версией Android.
С точки зрения производительности, применение Kotlin также не вле­
чет за собой каких-либо недостатков. Код, сгенерированный компилято­
ром Kotlin, выполняется так же эффективно, как обычный Java-код. Стан­
дартная библиотека Kotlin довольно небольшая, поэтому вы не заметите
существенного увеличения размеров скомпилированного приложения.
А при использовании лямбда-выражений многие функции из стандартной
библиотеки Kotlin просто будут встраивать их в место вызова. Встраива­
ние лямбда-выражений гарантирует, что не будет создано никаких новых
объектов, а приложение не будет работать медленнее из-за дополнитель­
ных пауз сборщика мусора (GC).
Познакомившись с преимуществами Котлин, давайте теперь рассмот­
рим философию Kotlin - основные черты, которые отличают Kotlin от дру­
гих современных языков для платформы JVM.
1.4. Философия Kotlin
Говоря о Kotlin, мы подчеркиваем, что это прагматичный, лаконичный,
безопасный язык, совместимый с Java. Что мы подразумеваем под каждым
из этих понятий? Давайте рассмотрим по порядку.
1.4. Философия Kotlin ❖
31
1.4.1. Прагматичность
Под прагматичностью мы понимаем одну простую вещь: Kotlin является
практичным языком, предназначенным для решения реальных задач. Он
спроектирован с учетом многолетнего опыта создания крупномасштаб­
ных систем, а его характеристики выбирались исходя из задач, которые
чаще всего приходится решать разработчикам. Более того, разработчики
в компании} etBrains и в сообществе несколько лет использовали ранние
версии Kotlin, и полученная от них обратная связь помогла сформировать
итоговую версию языка. Это дает нам основания заявлять, что Kotlin дей­
ствительно помогает решать проблемы в реальных проектах.
Kotlin не является исследовательским языком. Мы не пытаемся создать
ультрасовременный язык программирования и исследовать различные
инновационные идеи. Вместо этого, когда это возможно, мы полагаемся
на особенности и готовые решения в других языках программирования,
оказавшиеся успешными. Это уменьшает сложность языка и упрощает его
изучение за счет того, что многие понятия уже знакомы.
Кроме того, Kotlin не требует применения какого-то конкретного стиля
программирования или парадигмы. Приступая к изучению языка, вы смо­
жете использовать стиль и методы, знакомые вам по работе с Java. Позже
вы постепенно откроете более мощные возможности Kotlin и научитесь
применять их в своем коде, делая его более лаконичным и идиоматичным.
Другой аспект прагматизма Kotlin касается инструментария. Хорошая
среда разработки так же важна для программиста, как и хороший язык;
следовательно, поддержка Kotlin в IDE не является чем-то малозначитель­
ным. Плагин для IntelliJ IDEA с самого начала разрабатывался параллельно
с компилятором, а свойства языка всегда рассматривались через призму
инструментария.
Поддержка в IDE также играет важную роль в изучении возможностей
Kotlin. В большинстве случаев инструменты автоматически обнаруживают
шаблонный код, который можно заменить более лаконичными конструк­
циями, и предлагают его исправить. Изучая особенности языка в исправ­
лениях, предлагаемых инструментами, вы сможете научиться применять
их в своем собственном коде.
1.4.2. Лаконичность
Известно, что разработчики тратят больше времени на чтение сущест­
вующего кода, чем на создание нового. Представьте, что вы в составе ко­
манды участвуете в разработке большого проекта, и вам нужно добавить
новую функцию или исправить ошибку. Каковы ваши первые шаги? Вы
найдете область кода, которую нужно изменить, и только потом сделаете
исправление. Вы должны прочесть много кода, чтобы выяснить, что нужно
сделать. Этот код мог быть недавно написан вашими коллегами, кем-то,
32 ♦> Глава 1. Kotlin: что это и зачем
уже
окружающий
ния.
Чем проще и лаконичнее код, тем быстрее вы поймете, что он делает.
Конечно, хороший дизайн и выразительные имена играют свою роль. Но
выбор языка и лаконичность также имеют большое значение. Язык явля­
ется лаконичным, если его синтаксис явно выражает намерения кода, не
загромождая его вспомогательными конструкциями с деталями реализа­
ции.
Создавая Kotlin, мы старались организовать синтаксис так, чтобы весь
код нес определенный смысл, а не писался просто ради удовлетворения
требований к структуре кода. Большинство операций, стандартных для
Java, таких как определение методов чтения/записи для свойств и при­
сваивание параметров конструктора полям объекта, реализовано в Kotlin
неявно и не захламляет исходного кода.
Другой причиной ненужной избыточности кода является необходи­
мость описания типовых задач, таких как поиск элемента в коллекции.
Как во многих современных языках, в Kotlin есть богатая стандартная биб­
лиотека, позволяющая заменить эти длинные, повторяющиеся участки
кода вызовами библиотечных функций. Поддержка лямбда-выражений в
Kotlin позволяет передавать небольшие блоки кода в библиотечные функ­
ции и инкапсулировать всю общую логику в библиотеке, оставляя в коде
только уникальную логику для решения конкретных задач.
В то же время Kotlin не пытается минимизировать количество симво­
лов в исходном коде. Например, несмотря на то что Kotlin поддерживает
перегрузку операторов, пользователи не могут определять собственных
операторов. Поэтому разработчики библиотек не смогут заменять име­
на методов загадочными последовательностями знаков препинания. Как
правило, слова читать легче, чем знаки препинания, и их проще искать в
документации.
Более лаконичный код требует меньше времени для написания и, что
особенно важно, меньше времени для чтения. Это повышает продуктив­
ность и позволяет разрабатывать программы значительно быстрее.
1.4.3. Безопасность
Называя язык безопасным, мы обычно подразумеваем, что его дизайн
предотвращает появление определенных видов ошибок в программах. Ко­
нечно, это качество не абсолютно: ни один язык не защитит от всех воз­
можных ошибок. Кроме того, за предотвращение ошибок, как правило,
приходится платить. Вы должны сообщить компилятору больше инфор­
мации о планируемых действиях программы, чтобы компилятор мог про­
верить, что код действительно соответствует этим действиям. Вследствие
1.4. Философия Kotlin ❖
33
этого всегда возникает компромисс между приемлемым уровнем безопас­
ности и потерей продуктивности из-за необходимости добавления допол­
нительных аннотаций.
В Kotlin мы попытались достичь более высокого уровня безопасности,
чем в Java, с минимальными накладными расходами. Выполнение кода в
JVM уже дает многие гарантии безопасности, например: защита памяти
избавляет от переполнения буфера и других проблем, связанных с некор­
ректным использованием динамически выделяемой памяти. Будучи ста­
тически типизированным языком для JVM, Kotlin также обеспечивает без­
опасность типов в приложении. Это обходится дешевле, чем в Java: вам не
нужно явно объявлять типы всех сущностей, поскольку во многих случаях
компилятор может вывести тип автоматически.
Но Kotlin идёт ещё дальше: теперь ещё больше ошибок может быть
предотвращено во время компиляции, а не во время выполнения. Важ­
нее всего, что Kotlin пытается избавить программу от исключений
N ullP oin terE xception . Система типов в Kotlin отслеживает значения, ко­
торые могут или и не могут принимать значение n u ll, и запрещает опе­
рации, которые могут привести к возникновению N ullP oin terE xception
во время выполнения. Дополнительные затраты при этом минимальны:
чтобы указать, что значение может принимать значение n u ll, требуется
только один символ - вопросительный знак в конце:
val s: String? = null
val s2: String = ""
Можетсодержатьзначение null
Heможетсодержатьзначенияnull
Кроме того, Kotlin поддерживает множество удобных способов обработ­
ки значений, которые могут содержать n u ll. Это очень помогает в устра­
нении сбоев приложений.
Другой тип исключений, которого помогает избежать Kotlin, - это
C lassC astE xception. Оно возникает во время приведения типа без пред­
варительной проверки возможности такой операции. В Java разработчи­
ки часто не делают такую проверку, потому что имя типа приходится по­
вторять в выражении проверки и в коде приведения типа. Однако в Kotlin
проверка типа и приведение к нему объединены в одну операцию: после
проверки можно обращаться к членам этого типа без дополнительного яв­
ного приведения. Поэтому нет причин не делать проверку и нет никаких
шансов сделать ошибку. Вот как это работает:
i f (value is String)
print ln( value. toUpperCaseQ)
О—Проверкатипа
<j— Вызовметодатипа
1.4.4. Совместимость
В отношении совместимости часто первым возникает вопрос: «Смогу
ли я использовать существующие библиотеки?» Kotlin дает однозначный
34 ❖
Глава 1. Kotlin: что это и зачем
ответ: «Да, безусловно». Независимо от того, какой тип API предлагает
библиотека, вы сможете работать с ними напрямую из Kotlin. Вы сможете
вызывать Java-методы, наследовать Java-классы и реализовывать интер­
фейсы, использовать Java-аннотации в Kotlin-классах и т. д.
В отличие от некоторых других языков для JVM, Kotlin идет еще дальше
по пути совместимости, позволяя также легко вызывать код Kotlin из Java.
Для этого не требуется никаких трюков: классы и методы на Kotlin можно
вызывать как обычные классы и методы на Java. Это дает максимальную
гибкость при смешивании кода Java с кодом Kotlin на любом этапе ваше­
го проекта. Приступая к внедрению Kotlin в свой Java-проект, попробуйте
преобразовать какой-нибудь один класс из Java в Kotlin с помощью кон­
вертера, и остальной код будет продолжать компилироваться и работать
без каких-либо изменений. Этот прием работает независимо от назначе­
ния преобразованного класса.
Ещё одна область, где уделяется большое внимание совместимости, максимальное использование существующих библиотек Java. Напри­
мер, в Kotlin нет своей библиотеки коллекций. Он полностью полагается
на классы стандартной библиотеки Java, расширяя их дополнительными
функциями для большего удобства использования в Kotlin. (Мы рассмо­
трим этот механизм более подробно в разделе 3.3.) Это означает, что вам
никогда не придется обертывать или конвертировать объекты при ис­
пользовании Java API из Kotlin или наоборот. Все богатство возможностей
предоставляется языком Kotlin без дополнительных накладных расходов
во время выполнения.
Инструментарий Kotlin также обеспечивает полную поддержку много­
язычных проектов. Можно скомпилировать произвольную смесь исходных
файлов на Java и Kotlin с любыми зависимостями друг от друга. Поддержка
IDE также распространяется на оба языка, что позволяет:
О свободно перемещаться между исходными файлами на Java и Kotlin;
О отлаживать смешанные проекты, перемещаясь по коду, написанно­
му на разных языках;
О выполнять рефакторинг Java-методов, получая нужные изменения в
коде на Kotlin, и наоборот.
Надеемся, что теперь мы убедили вас дать шанс языку Kotlin. Итак,
как начать пользоваться им? В следующем разделе мы рассмотрим про­
цесс компиляции и выполнения кода на Kotlin из командной строки и с
помощью различных инструментов.
1.5. Инструментарий Kotlin
Как и Java, Kotlin - компилируемый язык. То есть, прежде чем запустить
код на Kotlin, его нужно скомпилировать. Давайте обсудим процесс компи-
1.5. Инструментарий Kotlin ❖
35
ляции, а затем рассмотрим различные инструменты, которые позаботятся
о нём за вас. Более подробную информацию о настройке вашего окруже­
ния вы найдете в разделе «Tutorials» на сайте Kotlin (h ttp s: / /k o tlin i ana.
orq /d ocs /t u t o r ia ls ) .
1.5.1. Компиляция кода на Kotlin
Исходный код на Kotlin обычно хранится в файлах с расширением М .
Компилятор Kotlin анализирует исходный код и генерирует файлы .class
так же, как и компилятор Java. Затем сгенерированные файлы .class упако­
вываются и выполняются с использованием процедуры, стандартной для
данного типа приложения. В простейшем случае скомпилировать код из
командной строки можно с помощью команды k o tlin c , а запустить - ко­
мандой java:
kotlinc сисходный файл или каталог> -include-runtime -d <имя }аг-файла>
java -ja r <имя }аг-файла>
На рис. 1.1 приводится упрощенная схема процесса сборки в Kotlin.
Рис. 1.1. Процесс сборки в Kotlin
Код, скомпилированный с помощью компилятора Kotlin, зависит от биб­
лиотеки среды выполнения Kotlin. Она содержит определения собственных
классов стандартной библиотеки Kotlin, а также расширения, которые
Kotlin добавляет в стандартный Java API. Библиотека среды выполнения
должна распространяться вместе с приложением.
На практике для компиляции кода обычно используются специализиро­
ванные системы сборки, такие как Maven, Gradle или Ant. Kotlin совместим
со всеми ними, и мы обсудим эту тему в приложении А. Все эти системы
сборки поддерживают многоязычные проекты, включающие код на Kotlin
и Java в общую базу кода. Кроме того, Maven и Gradle сами позаботятся
о подключении библиотеки времени выполнения Kotlin как зависимости
вашего приложения.
36 ❖
Глава 1. Kotlin: что это и зачем
1.5.2. Плагин для IriteШj IDEA и Android Studio
Плагин с поддержкой Kotlin для IntelliJ IDEA разрабатывался параллельно
с языком и является наиболее полной средой разработки для языка Kotlin.
Это зрелая и стабильная среда, обладающая полным набором инструментов
для разработки на Kotlin. Плагин Kotlin вошел в состав IntelliJ IDEA, начиная
с версии 15, поэтому дополнительная установка не потребуется. Вы можете
использовать бесплатную среду разработки IntelliJ IDEA Community Edition
с открытым исходным кодом, или IntelliJ IDEA Ultimate. Выберите Kotlin в
диалоге New Project (Новый проект) и можете начинать разработку.
Если вы используете Android Studio, можете установить плагин Kotlin
с помощью диспетчера плагинов. В диалоговом окне Settings (Настрой­
ки) выберите вкладку Plugins (Плагины), затем щелкните на кнопке
Install JetBrains Plugin (Установить плагин JetBrains) и выберите из спис­
ка Kotlin.
1.5.3. Интерактивная оболочка
Для быстрого опробования небольших фрагментов кода на Kotlin мож­
но использовать интерактивную оболочку (так называемый цикл REPL Read Eval Print Loop: чтение ввода, выполнение, вывод результата, по­
втор). В REPL можно вводить код на Kotlin строку за строкой и сразу же
видеть результаты выполнения. Чтобы запустить REPL, выполните коман­
ду kotiinc без аргументов или воспользуйтесь соответствующим пунктом
меню в плагине IntelliJ IDEA.
1.5.4. Плагин для Eclipse
Пользователи Eclipse также имеют возможность программировать на
Kotlin в своей IDE. Плагин Kotlin для Eclipse поддерживает основную функ­
циональность, такую как навигация и автодополнение кода. Плагин до­
ступен в Eclipse Marketplace. Чтобы установить его, выберите пункт меню
Help > Eclipse Marketplace (Справка > Eclipse Marketplace) и найдите Kotlin в
списке.
1.5.5. Онлайн-полигон
Самый простой способ попробовать Kotlin в действии не требует ника­
ких дополнительных установок и настроек. По адресу h t t p : / / t r v .k o t l .
in вы найдете онлайн-полигон, где сможете писать, компилировать и за­
пускать небольшие программы на Kotlin. На полигоне представлены при­
меры кода, демонстрирующие возможности Kotlin (включая все примеры
из этой книги), а также ряд упражнений для изучения Kotlin в интерактив­
ном режиме.
1.6. Резюме ❖
37
1.5.6. Конвертер кода из Java в Kotlin
Освоение нового языка никогда не бывает легким. К счастью, мы созда­
ли утилиту, которая поможет быстрее изучить и овладеть им, опираясь на
знание языка Java. Это - автоматизированный конвертер кода на Java в
код на Kotlin.
В начале изучения конвертер поможет вам запомнить точный синтак­
сис Kotlin. Напишите фрагмент кода на Java, вставьте его в файл с исход­
ным кодом на Kotlin, и конвертер автоматически предложит перевести
этот фрагмент на язык Kotlin. Результат не всегда будет идиоматичным,
но это будет рабочий код, с которым вы сможете продвинуться ближе к
решению своей задачи.
Конвертер также удобно использовать для внедрения Kotlin в существую­
щий Java-проект. Новый класс можно сразу определить на языке Kotlin. Но
если понадобится внести значительные изменения в существующий класс
и у вас появится желание использовать Kotlin, конвертер придет вам на
выручку. Сначала переведите определение класса на язык Kotlin, а затем
сделайте необходимые изменения, используя все преимущества совре­
менного языка.
Использовать конвертер в IntelliJ IDEA очень просто. Достаточно просто
скопировать фрагмент кода на Java и вставить в файл на Kotlin или вы­
брать пункт меню Code —> Convert Java File to Kotlin (Код —> Преобразовать
файл Java в Kotlin), чтобы перевести весь файл на язык Kotlin. Конвертер
также доступен в Eclipse и на онлайн-полигоне.
1.6. Резюме
О Kotlin - статически типизированный язык, поддерживающий авто­
матический вывод типов, что позволяет гарантировать корректность
и производительность, сохраняя при этом исходный код лаконич­
ным.
О Kotlin поддерживает как объектно-ориентированный, так и функцио­
нальный стиль программирования, позволяя создавать высокоуров­
невые абстракции с помощью функций, являющихся полноценными
объектами, и упрощая разработку и тестирование многопоточных
приложений благодаря поддержке неизменяемых значений.
О Язык хорошо подходит для разработки серверных частей приложе­
ний, поддерживает все существующие Java-фреймворки и предо­
ставляет новые инструменты для решения типичных задач, таких
как создание разметки HTML и операции с хранимыми данными.
О Благодаря компактной среде выполнения, специальной поддержке
Android API в компиляторе и богатой библиотеке Kotlin-функций для
38 ❖
Глава 1. Kotlin: что это и зачем
решения основных задач Kotlin отлично подходит для разработки
под Android.
О Это бесплатный язык с открытым исходным кодом, поддерживае­
мый основными IDE и системами сборки.
О Kotlin - прагматичный, безопасный, лаконичный и совместимый
язык, уделяющий большое внимание возможности использо­
вания проверенных решений для популярных задач, предот­
вращающий распространенные ошибки (такие как исключение
N ullP ointerE xception), позволяющий писать компактный, легко
читаемый код и обеспечивающий бесшовную интеграцию с Java.
Глава
Основы Kotlin
В этой главе объясняются:
объявление функций, переменных, классов, перечислений и
свойств;
управляющие структуры;
автоматическое приведение типов;
возбуждение и перехват исключений
В этой главе вы узнаете, как на языке Kotlin объявляются важнейшие эле­
менты любой программы: переменные, функции и классы. Попутно вы
познакомитесь с понятием свойств в Kotlin.
Вы научитесь пользоваться различными управляющими структурами
Kotlin. В основном они похожи на знакомые вам структуры в языке Java,
но имеют ряд важных усовершенствований.
Мы познакомим вас с идеей автоматического приведения типов (smart
casts), когда проверка и приведение типа сочетаются в одной операции.
И наконец, мы поговорим об обработке исключений. К концу этой главы
вы научитесь писать действующий код на языке Kotlin, даже если он будет
не вполне идиоматичным.
2.1. Основные элементы: переменные
и функции
В этом разделе вы познакомитесь с основными элементами, присутствую­
щими в каждой программе на Kotlin: переменными и функциями, и уви­
дите, как Kotlin позволяет опускать объявления типов и поощряет исполь­
зование неизменяемых данных.
40 ❖
Глава 2. Основы Kotlin
2.1.1. Привет, мир!
Начнем с классического примера - программы, которая выводит на
экран текст «Hello, world!» (Привет, мир!). В Kotlin для этого достаточно
всего одной функции:
Листинг 2.1. «Привет, мир!» на языке Kotlin
fun main(args: Array<String>) {
println("Hello, world!")
}
Какие особенности и нюансы синтаксиса демонстрирует этот простой
пример? Взгляните на этот список:
О Объявления функций начинаются с ключевого слова fun. Програм­
мировать на языке Kotlin действительно весело!1
О Тип параметра указывается после его имени. Как вы увидите позже,
это относится и к объявлениям переменных.
О Функцию можно объявить на верхнем уровне в файле - её не обяза­
тельно помещать в класс.
О Массивы - это просто классы. В отличие от Java, в Kotlin нет специаль­
ного синтаксиса для объявления массивов.
О Вместо System, o u t. p r in t In можно писать просто p r in tln . Стан­
дартная библиотека Kotlin включает множество оберток с лаконич­
ным синтаксисом для функций в стандартной библиотеке Java, и
p r in tln - одна из них.
О Точку с запятой в конце строки можно опустить, как и во многих дру­
гих современных языках.
Пока всё идёт хорошо! Позже мы подробнее обсудим некоторые из этих
пунктов. А пока исследуем синтаксис объявления функций.
2.1.2. Функции
Вы уже знаете, как объявить функцию, которая ничего не возвращает.
Но где нужно указывать тип возвращаемого значения для функций, воз­
вращающих результат? Вы наверняка догадались, что это должно быть
где-то после списка параметров:
fun max(a: In t, b: In t): In t {
return i f (a > b) a else b
}
»> println(max(l, 2))
2
1 fun (англ.) - веселый, забавный. - П рим . пер.
2.1. Основные элементы: переменные и функции ❖
41
Объявление функции начинается с ключевого слова fun, за которым
следует ее имя: в данном случае шах. Далее следует список параметров в
круглых скобках. Тип возвращаемого значения указывается после списка
параметров и отделяется от него двоеточием.
На рис. 2.1 изображена базовая структура функции. Обратите внимание,
что в Kotlin оператор i f является выражением, возвращающим значение.
Это похоже на тернарный оператор в Java: (а > Ь) ? а : Ъ.
Имя функции
Параметры
Тип возвращаемого значения
f ------------------------------------------ 'к
fun max(a: Int, b: Int)
return if (а > b) а
}
V
Тело функции
Рис. 2.1. Объявление функции в Kotlin
Выражения и инструкции
В языке Kotlin оператор i f - это выражение, а не инструкция. Разница между выра­
жениями и инструкциями состоит в том, что выражение имеет значение, которое можно
использовать в других выражениях, в то время как инструкции всегда являются элемен­
тами верхнего уровня в охватывающем блоке и не имеют собственного значения. В Java
все управляющие структуры - инструкции. В Kotlin большинство управляющих структур,
кроме циклов (for, do и do/whiie), - выражения. Возможность комбинировать струк­
туры управления с другими выражениями позволяет ёмко выражать многие распростра­
ненные шаблоны, как вы увидите в следующих главах.
С другой стороны, оператор присваивания в Java - это выражение^ в Kotlin - инструк­
ция. Это помогает избежать частого источника ошибок - путаницы между сравнениями
и присваиваниями.
Тела выражений
Функцию на рис. 2.1 можно ещё упростить. Поскольку её тело состоит
из единственного выражения, то им можно заменить всё тело функции,
удалив фигурные скобки и инструкцию retu rn :
fun max(a: Int, b: Int): Int = if (a > b) a else b
Если тело функции заключено в фигурные скобки, мы говорим, что та­
кая функция имеет тело-блок (block body). Функция, возвращающая выра­
жение напрямую, имеет тело-выражение (expression body).
42 ❖
Глава 2. Основы Kotlin
Советдля Intelltl IDEA
Intellil IDEA поддерживает специальные операции преобразования между двумя стилями
функций: Convert to expression body (Преобразовать в тело-выражение) и Convert to block
body (Преобразовать в тело-блок).
Функции с телом-выражением часто встречаются в коде на Kotlin. Такой
стиль применяется не только для простых однострочных функций, но так­
же для функций, вычисляющих единственное более сложное выражение,
таких как i f , when или try . Вы увидите такие функции далее в этой главе,
когда мы будем обсуждать оператор when.
Функцию шах можно упростить ещё больше, опустив тип возвращаемо­
го значения:
fun max(a: In t, b: In t) = i f (a > b) a else b
Как возможны функции без объявления типа возвращаемого значения?
Разве язык Kotlin как статически типизированный не требует знать тип
каждого выражения на этапе компиляции? Действительно, каждая пере­
менная и каждое выражение имеют тип, и каждая функция имеет тип воз­
вращаемого значения. Но для функций с телом-выражением компилятор
может проанализировать выражение и использовать его тип в качестве
типа возвращаемого значения функции, даже когда он не указан явно.
Анализ этого вида обычно называется выведением типа (type inference).
Обратите внимание, что опустить тип возвращаемого значения можно
только в функциях с телом-выражением. В функциях с телом-блоком тип
возвращаемого значения (если оно имеется) должен указываться явно, и
обязательно должна использоваться инструкция return. Это осознанный
выбор. В реальном мире функции часто бывают длинными и могут содер­
жать несколько инструкций return; явно указанный тип возвращаемого
значения и инструкция return помогут быстро понять, что возвращает
функция. Теперь давайте рассмотрим синтаксис объявления переменных.
2.1.3. Переменные
В Java объявление переменной начинается с типа. Такой способ не под­
держивается в Kotlin, поскольку он позволяет пропускать типы во многих
объявлениях переменных. Поэтому в Kotlin объявление начинается с клю­
чевого слова, а тип можно указать (или не указывать) после имени пере­
менной. Объявим две переменные:
val question =
"The Ultimate Question of Life, the Universe, and Everything"
val answer = 42
В этом примере объявления типов отсутствуют, но вы можете добавить
их, если хотите:
2.1. Основные элементы: переменные и функции ❖
43
val answer: In t = 42
Так же, как в функциях с телом-выражением, если тип не указан явно,
компилятор проанализирует инициализирующее выражение и присвоит
его тип переменной. В данном случае инициализирующее выражение 42
имеет тип In t, поэтому переменная получит тот же тип.
Если использовать константу с плавающей точкой, переменная получит
тип Double:
val yearsToCompute = 7.5е6
<3 7.5*104=7500000.0
Подробнее числовые типы рассматриваются в разделе 6.2.
Если в объявлении переменной отсутствует инициализирующее выра­
жение, её тип нужно указать явно:
val answer: Int
answer = 42
Компилятор не сможет определить тип, если не дать ему никакой ин­
формации о значениях, которые могут быть присвоены этой переменной.
Изменяемые и неизменяемые переменные
Есть два ключевых слова для объявления переменной:
О va I (от value) - неизменяемая ссылка. Переменной, объявленной с
ключевым словом v a l, нельзя присвоить значение после инициали­
зации. Такие переменные соответствуют финальным переменным в
Java.
О var (от variable) - изменяемая ссылка. Значение такой переменной
можно изменить. Такое объявление соответствует обычной (не фи­
нальной) переменной в Java.
По умолчанию вы должны стремиться объявлять все переменные в Kotlin
с ключевым словом v a l. Заменяйте его на var только при необходимости.
Использование неизменяемых ссылок и объектов, а также функций без
побочных эффектов приблизит ваш код к функциональному стилю. Мы
немного коснулись его достоинств в главе 1 и еще вернемся к этой теме в
главе 5.
Переменная, объявленная с ключевым словом v a l, должна быть инициа­
лизирована только один раз во время выполнения блока, в котором она
определена. Но её можно инициализировать разными значениями в зави­
симости от некоторых условий, если компилятор сможет гарантировать,
что выполнится только одно из инициализирующих выражений:
val message: String
i f (canPerformOperation()) {
message = "Success"
Ц . . . выполнить операцию
44 ❖
Глава 2. Основы Kotlin
}
else {
message = "Failed"
}
Обратите внимание: несмотря на невозможность изменить ссылку v a l,
объект, на который она указывает, может быть изменяемым. Например,
следующий код является вполне допустимым:
val languages = arrayList0f("3ava")
О- Объявлениенеизменяемойссылки
languages. add(" Kotlin")
о — Изменениеобъекта, накоторыйонауказывает
В главе 6 мы подробнее обсудим изменяемые и неизменяемые объек­
ты.
Хотя ключевое слово var позволяет менять значение переменной, но её
тип фиксирован. Например, следующий код не скомпилируется:
var answer = 42
answer = "no answer"
<3— Ошибка: недолги,............
1
Попытка присвоить строковый литерал вызовет ошибку, потому что его
тип (S trin g) не соответствует ожидаемому (Int). Компилятор определяет
тип переменной только по инициализирующему выражению и не прини­
мает во внимание всех последующих операций присваивания.
Если вам нужно сохранить в переменной значение другого типа, вы
должны преобразовать его вручную или привести к нужному типу. Мы об­
судим преобразование простых типов в разделе 6.2.3.
Теперь, когда вы узнали, как определять переменные, перейдем к зна­
комству с некоторыми приемами, позволяющими ссылаться на значения
этих переменных.
2.1.4. Простое форматирование строк: шаблоны
Вернемся к примеру «Hello, world!» в начале этого раздела. Вот как мож­
но перейти к следующей стадии традиционного упражнения и попривет­
ствовать людей по именам на Kotlin:
Листинг 2.2. Применение строковых шаблонов
fun main(args: Array<String>) {
val name = i f (args.size > 0) args[0] else "Kotlin"
println("Hello, $name!")
Выведет«Hello, Kotlin!»или
«Hello, Bob!», еслипередать
аргументсострокой«Bob»
}
Этот пример демонстрирует применение особенности синтаксиса Kot­
lin, которая называется строковые шаблоны (string templates). Вы объявляе­
те в коде переменную паше, а затем используете её в строковом литерале
2.2. Классы и свойства ❖
45
ниже. Так же, как многие языки сценариев, Kotlin позволяет использовать
в строковых литералах ссылки на локальные переменные, добавляя к ним
в начало символ $. Эта запись равносильна конкатенации строк в Java
(" H ello, " + name + "!"), но она более компактна и столь же эффектив­
на2. И конечно, такие выражения проверяются статически, поэтому при
попытке обратиться к несуществующей переменной код не будет компи­
лироваться.
Чтобы включить в строку символ "$", его нужно его экранировать:
p r in tln (" \$ x " ) выведет $х и не проинтерпретирует х как ссылку на пе­
ременную.
Вы не ограничены простыми именами переменных, но также можете
использовать более сложные выражения. Для этого достаточно заключить
выражение в фигурные скобки:
fun main(args: Array<String>) {
i f (args.size > 0) {
println("Hello, ${args[0]}!")
}
Также можно помещать двойные кавычки внутрь других двойных кавы­
чек, пока они входят в состав выражения:
fun main(args: Array<String>) {
println("Hello, $ {if (args.size > 0) args[0] else "someone"}!")
Позже, в разделе 3.5, мы вернемся к строкам и подробнее поговорим о
том, что можно с ними делать.
Теперь вы знаете, как объявлять переменные и функции. Давайте под­
нимемся на уровень выше и посмотрим на классы. На этот раз вы будете
использовать конвертер кода из Java в Kotlin, который поможет присту­
пить к работе с использованием новых возможностей языка.
2.2. Классы и свойства
Возможно, вы не новичок в объектно-ориентированном программиро­
вании и знакомы с абстракцией под названием класс. Основные понятия
языка Kotlin в этой области будут вам знакомы, но вы обнаружите, что мно­
жество типичных задач можно решить гораздо меньшим объемом кода.
Этот раздел познакомит вас с базовым синтаксисом объявления классов.
Мы рассмотрим эту тему более подробно в главе 4.
Для начала рассмотрим простой JavaBean-класс Person, который пока
имеет только одно свойство, name:
2 Скомпилированный код создает объект String Bui Icier, передавая ему константы и переменные.
46 ❖
Глава 2. Основы Kotlin
Листинг 2.3. Простой Java-класс Person
/* Java */
public class Person {
private fin a l String name;
public Person(String name) {
this.name = name;
}
public String getName() {
return name;
}
}
В Java тело конструктора часто содержит повторяющийся код: он при­
сваивает значения параметров полям с соответствующими именами.
В Kotlin эту логику можно выразить без ненужного шаблонного кода.
В разделе 1.5.6 мы познакомились с конвертером кода из Java в Kotlin:
инструментом, который автоматически заменяет код на Java эквивалент­
ным кодом на Котлин. Давайте посмотрим, как он действует, и переведем
определение класса Person на язык Kotlin.
Листинг 2.4. Класс Person, преобразованный в Kotlin
class Person(val name: String)
Выглядит неплохо, не так ли? Если вам довелось попробовать другой
современный язык для JVM, возможно, вы уже видели нечто подобное.
Классы этого типа (содержащие только данные, без кода) часто называют
объектами-значениями (value objects), и многие языки предлагают крат­
кий синтаксис для их объявления.
Обратите внимание, что в ходе преобразования из Java в Kotlin про­
пал модификатор p u b lic. В Kotlin область видимости p u b lic принята по
умолчанию, поэтому её можно не указывать.
2.2.1. Свойства
Как известно, классы предназначены для объединения данных и кода,
работающего с этими данными, в одно целое. В Java данные хранятся в
полях, обычно с модификатором p r iv a te . Чтобы дать клиентам класса до­
ступ к этим данным, нужно определить методы доступа: чтения и, воз­
можно, записи. Вы видели пример этих методов в классе Person. Метод
записи может содержать дополнительную логику для проверки передан­
ного значения, отправки уведомления об изменении и т. д.
2.2. Классы и свойства ❖
47
В Java сочетание поля и методов доступа часто называют свойством
(property), и многие фреймворки широко используют это понятие. Свой­
ства в языке Kotlin являются полноценной частью языка, полностью заме­
нившей поля и методы доступа. Свойство в классе объявляется так же, как
переменная: с помощью ключевых слов va I и var. Свойство, объявленное
как val, доступно только для чтения, а свойство var можно изменять.
Листинг 2.5. Объявление изменяемого свойства в классе
class Person(
val name: String,
Неизменяемоесвойство: длянегобудутсозданыполеипростойметодчтения
var isMarried: Boolean
Изменяемоесвойство: поле, методычтенияизаписи
)
Обычно, объявляя свойство, вы объявляете соответствующие методы
доступа (метод чтения для свойства, доступного только для чтения, и м е­
тоды чтения/записи для свойства, доступного для записи). По умолчанию
методы доступа имеют хорошо известную реализацию: создается поле
для хранения значения, а методы чтения и записи возвращают и изме­
няют его. Но при желании можно определить собственный метод доступа,
использующий другую логику вычисления или изменения значения свой­
ства.
Краткое объявление класса Person в листинге 2.5 скрывает традицион­
ную реализацию, присутствующую в исходном коде на Java: это класс с
приватными полями, которые инициализированы в конструкторе и до­
ступны через соответствующие методы чтения. Это означает, что данный
класс можно использовать и в Java, и в Kotlin, независимо от того, где он
объявлен. Примеры использования выглядят идентично. Вот как можно
использовать класс Person в коде на Java.
Листинг 2.6. Использование класса Person в Java
/* Java */
»> Person person = new Person("Bob", true);
»> System. out.println(person. getName());
Bob
»> System. out.println(person. isMarried());
true
Обратите внимание, что этот код не зависит от того, на каком языке
определен класс Person - Java или Kotlin. Свойство name, объявленное на
языке Kotlin, доступно Java-коду через метод доступа с именем getName.
В правилах именования методов доступа есть исключение: если имя
свойства начинается с префикса i s , никаких дополнительных префиксов
для образования имени метода чтения не добавляется, а в имени метода
48 ❖
Глава 2. Основы Kotlin
записи is заменяется на set. То есть в Java вы должны вызывать метод
isMarried().
Если перевести код в листинге 2.6 на язык Kotlin, получится следующее.
Листинг 2.7. Использование класса Person в Kotlin
»> val person = Person("Bob", true)
Конструкторвызываетсябезключевогослова«new»
»> println(person.name)
Прямоеобращениек свойству, но
Bob
приэтомвызываетсяметодчтения
»> println(person. isMarried)
true
Теперь можно не вызывать метода чтения, а обращаться к свойству не­
посредственно. Логика та же, но код становится более лаконичным. Мето­
ды записи изменяемых свойств работают точно так ж е: чтобы сообщить о
разводе, в Java требуется выполнить вызов person.setMarried(false), а
в Kotlin достаточно записать person.isMarried = false.
Совет. Синтаксис Kotlin также можно использовать для доступа к свойствам классов, объяв­
ленных в Java. К методам чтения Java-класса можно обращаться как v a l -свойствам Kotlin,
а к парам методов чтения/записи - как к v a r -свойствам. Например, если Java-класс опре­
деляет методы getN am e и setN am e, к ним можно обратиться через свойство name.
Если же он определяет методы i s M a r r i e d и s e t M a rrie d , соответствующее свойство
в Kotlin будет иметь имя is M a r r ie d .
В большинстве случаев свойству соответствует поле, хранящее его зна­
чение. Но если значение можно вычислить на лету - например, на основа­
нии значений других свойств, - это можно выразить с помощью собствен­
ного метода чтения.
2.2.2. Собственные методы доступа
В этом разделе показано, как написать собственную реализацию метода
доступа к свойству. Предположим, что вы определяете класс прямоуголь­
ников, который может сообщить, является ли эта фигура квадратом. Вам
не надо хранить эту информацию в отдельном поле, так как всегда можно
динамически проверить равенство высоты и ширины:
class Rectangle(val height: In t, val width: In t) {
val isSquare: Boolean
get() {
О— Объявлениеметодачтениядлясвойства
return height == width
}
}
2.2. Классы и свойства ❖
49
Свойству i s Square не нужно поле для хранения значения. Ему доста­
точно метода чтения с особой реализацией. Значение свойства вычисля­
ется при каждом обращении к нему.
Обратите внимание, что не обязательно использовать полный синтак­
сис с фигурными скобками; также можно написать g e t( ) = h eig h t ==
width. Это не влияет на способ обращения к свойству:
»> val rectangle = Rectangle(41, 43)
»> printIn(rectangle.isSquare)
false
Если вам нужно обратиться к этому свойству из Java, вызовите метод
isSquare, как прежде.
Вы можете спросить, что лучше: объявить функцию без параметров или
свойство с собственным методом чтения. Оба варианта похожи: нет ни­
какой разницы в реализации или производительности; они отличаются
только оформлением. Но вообще, характеристика (свойство) класса долж­
на быть объявлена свойством.
В главе 4 мы продемонстрируем больше примеров использования клас­
сов и свойств и рассмотрим синтаксис явного объявления конструктора.
А пока, если вам не терпится, можете использовать конвертер из Java в
Kotlin. Теперь, прежде чем перейти к обсуждению других особенностей
языка, кратко обсудим, как код на Kotlin размещается на диске.
2.2.3. Размещение исходного кода на Kotlin:
пакеты и каталоги
Вы знаете, что в Java все классы находятся в пакетах. В Kotlin также су­
ществует понятие пакета, похожее на аналогичное понятие в Java. Каждый
файл Kotlin может иметь инструкцию package в начале, и все объявления
(классы, функции и свойства) в файле будут помещены в этот пакет. Объ­
явления из других файлов в том же пакете можно использовать напрямую,
а объявления из других пакетов нужно импортировать. Так же, как в Java,
инструкции импорта помещаются в начало файла и начинаются с ключе­
вого слова import. Вот пример исходного файла, демонстрирующего син­
таксис объявления пакета и инструкцию импорта.
Листинг 2.8. Объявление класса и функции в пакете
package geometry.shapes
Объявлениепакета
import java.util.Random
ИмпортклассаизстандартнойбиблиотекиJava
class Rectangle(val height: In t, val width: In t) {
val isSquare: Boolean
50 ❖
Глава 2. Основы Kotlin
get() = height == width
}
fun createRandomRectangle(): Rectangle {
val random = Random()
return Rectangle(random.nextInt(), random.nextlnt())
}
Kotlin не делает различия между импортом классов и функций, что по­
зволяет импортировать любые объявления с помощью ключевого слова
import. Функции верхнего уровня можно импортировать по имени.
Листинг 2.9. Импорт функции из другого пакета
package geometry.example
import geometry. shapes. createRandomRectangle О— Импортфункциипоимени
fun main(args: Array<String>) {
print ln(createRandomRectangle().isSquare) О— Оченьредкобудетвыводить«true»
}
Кроме того, можно импортировать все объявления из определенного
пакета, добавив . * после имени пакета. Обратите внимание, что такой
импорт со звездочкой сделает видимыми не только классы, объявленные
в пакете, но и свойства и функции верхнего уровня. Если в листинге 2.9
написать import geom etry. sh a p es. * вместо явного импорта, код тоже
скомпилируется без ошибок.
В Java вы должны располагать классы в структуре файлов и каталогов, со­
ответствующей структуре пакета. Например, если у вас есть пакет shapes с
несколькими классами, вы должны поместить каждый класс в отдельный
файл с соответствующим именем и сохранить эти файлы в каталог с тем
же именем shapes. На рис. 2.2 виден пример организации пакета geometry
и его подпакетов. Предположим, что функция createRandomRectangle на­
ходится в отдельном классе R e c ta n g le lltil.
▼ Й geometry
^ -----пакетgeometry.example
▼ Й exam ple«—
© ъ Mai п
^ -----пакетgeometry.shapes
▼ Й shapes-»—
^
^ — класс Rectangle
(.cj ъ Rectangle
© о Rectanglelltil
Рис. 2.2. В Java иерархия каталогов соответствует иерархии пакетов
Программируя на Kotlin, вы можете поместить несколько классов в один
файл и выбрать любое имя для этого файла. Также Kotlin не накладыва-
2.3. Представление и обработка выбора: перечисления и конструкция «when» ❖
51
ет никаких ограничений на расположение исходных файлов на диске; вы
можете использовать любую структуру каталогов для организации своих
файлов. Например, все содержимое пакета geom etry. shapes можно поме­
стить в файл sh a p es. k t, а сам файл сохранить в папку geometry, не созда­
вая отдельной папки shapes (см. рис. 2.3).
▼ й geometry
Q example.kt
Q shapes, kt -«—
пакетgeometry.example
пакетgeometry.shapes
Рис. 2.3. Структура пакетов не должна соответствовать структуре каталогов
Однако в большинстве случаев хорошим тоном считается следовать
структуре каталогов в Java и организовывать исходные файлы в катало­
гах в соответствии со структурой пакета. Придерживаться этого правила
особенно важно в проектах, где Kotlin смешивается с Java, так как это по­
зволит постепенно выполнить миграцию кода без всяких сюрпризов. Но
не бойтесь помещать несколько классов в один файл, особенно если эти
классы небольшие (а в Kotlin они часто бывают такими).
Теперь вы знаете, как организовывать программы. Давайте продолжим
знакомство с основными понятиями и рассмотрим структуры управления
в Kotlin.
2.3. Представление и обработка выбора:
перечисления и конструкция «when»
В этом разделе мы поговорим о конструкции when. Её можно считать за­
меной конструкции sw itch в Java, но с более широкими возможностями
и более частым применением на практике. Попутно мы покажем пример
объявления перечислений в Kotlin и обсудим концепцию автоматического
приведения типов (smart casts).
2.3.1. Объявление классов перечислений
Добавим воображаемых цветных картинок в эту серьезную книгу и соз­
дадим перечисление цветов.
Листинг 2.10. Объявление простого класса перечисления
enum class Color {
RED, ORANGE, YELLOW, GREEN, BLUE, INDIGO, VIOLET
}
Это тот редкий случай, когда в объявлении на Kotlin используется боль­
ше ключевых слов, чем в Java: enum c la s s против enum в Java. В языке
52 ❖
Глава 2. Основы Kotlin
Kotlin enum - это так называемое «мягкое» ключевое слово (soft keyword):
оно имеет особое значение только перед ключевым словом c la s s , в других
случаях его можно использовать как обычное имя. С другой стороны, клю­
чевое слово c la s s сохраняет свое специальное значение, и вам по-преж­
нему придется объявлять переменные с именами c la z z или aC lass.
Точно как в lava, перечисления - это не просто списки значений: в клас­
сах перечислений можно объявлять свойства и методы. Вот как это рабо­
тает:
Листинг 2.11. Объявление класса перечисления со свойствами
enum class Color(
val r: In t, val g: In t, val b: Int
Значениясвойствопределяются
длякаждойконстанты
) {
Объявлениесвойствконстантперечисления
RED(255, 0, 0), 0RANGE(255, 165, 0),
YELL0W(255, 255, 0), GREEN(0, 255, 0), BLUE(0, 0, 255),
INDIG0(75, 0, 130), VI0LET(238, 130, 238);
Точкасзапятойздесьобязательна
fun rgb() = (г * 256 + g) * 256 + b
Определениеметодаклассаперечисления
}
»> println(Color.BLUE.rgb())
255
Константы перечислений используют тот же синтаксис объявления кон­
структоров и свойств, что и обычные классы. Объявляя константу пере­
числения, необходимо указать значения её свойств. Обратите внимание,
что на этом примере вы видите единственное место в синтаксисе Kotlin,
где требуется использовать точку с запятой: когда в классе перечисления
определяются какие-либо методы, точка с запятой отделяет список кон­
стант от определений методов. Теперь рассмотрим некоторые интересные
приёмы работы с константами перечислений.
2.3.2. Использование оператора «when» с классами
перечислений
Помните, как дети используют мнемонические фразы для запоминания
цветов радуги? Вот одна из них: «Каждый Охотник Желает Знать, Где Си­
дит Фазан!» Представьте, что вам нужно написать функцию, которая воз­
вращает слово из фразы для каждого цвета (но вы не хотите хранить эту
информацию в самом перечислении). В Java для этого можно использо­
вать оператор sw itch. В Kotlin есть аналогичная конструкция: when.
Подобно i f , оператор when - это выражение, возвращающее значение,
поэтому вы можете написать функцию с телом-выражением, которая на­
прямую возвращает выражение when. Когда мы говорили о функциях в
2.3. Представление и обработка выбора: перечисления и конструкция «when» ❖
53
начале главы, мы обещали привести пример многострочной функции с
телом-выражением. Вот этот пример.
Листинг 2.12. Применение when для выбора правильного значения перечисления
fun getMnemonicfcolor: Color) =
<1— Сразувозвращаетвыражение«when»
when (color) {
<'—I Возвращаетсоответствующую
Color.RED -> "Каждый"
проку, еслицветсовпадает
Color.ORANGE -> "Охотник
сконстантойперечисления
Color.YELLOW -> "Желает"
Color.GREEN -> "Знать"
Color.BLUE -> "Где"
Color.INDIGO -> "Сидит"
Color.VIOLET -> "Фазан"
}
»> println(getMnemonic(Color.BLUE))
Где
Код находит ветку, соответствующую заданному значению цвета. В от­
личие от Java, в Kotlin не нужно добавлять в каждую ветку инструкцию
break (отсутствие break часто вызывает ошибки в Java). При наличии со­
впадения выполнится только соответствующая ветка. В одну ветку можно
объединить несколько значений, разделив их запятыми.
Листинг 2.13. Объединение вариантов в одну ветку when
fun getWarmth(color: Color) = when(color) {
Color.RED, Color.ORANGE, Color.YELLOW -> "теплый"
Color.GREEN -> "нейтральный"
Color.BLUE, Color.INDIGO, Color.VIOLET -> "холодный"
}
»> print In (getWarmth(Color.ORANGE))
теплый
В этих примерах использовались полные имена констант с указанием
класса перечисления Color. Вы можете упростить код, импортировав зна­
чения констант.
Листинг 2.14. Импорт констант перечисления для использования без квалификатора
import ch02. colors. Color
import ch02. colors. Color. *
О— Обращениек импортированнымконстантампоименам
О— ИмпортклассаColor, объявленныйвдругомпакете
fun getWarmth(color: Color) = when(color) {
RED, ORANGE, YELLOW -> "теплый"
I Явныйимпортконстантперечисления
<H дляобращенияк нимпоименам
54 ❖
Глава 2. Основы Kotlin
GREEN -> "нейтральный"
BLUE, INDIGO, VIOLET -> "холодный
2.3.3. Использование оператора «when» с произвольными
объектами
Оператор when в Kotlin обладает более широкими возможностями, чем
sw itch в Java. В отличие от sw itch , который требует использовать констан­
ты (константы перечисления, строки или числовые литералы) в определе­
ниях вариантов, оператор when позволяет использовать любые объекты.
Давайте напишем функцию, которая смешивает два цвета, если в резуль­
тате такого смешивания получается цвет из нашей небольшой палитры.
У нас не так много вариантов, и мы легко сможем перечислить их все.
Листинг 2.15. Использование различных объектов в ветках when
Перечислениепарцветов, пригодных
fun mix(cl: Color, c2: Color) =
длясмешивания
when (setOf(cl, c2)) {
setOf(RED, YELLOW) -> ORANGE
<3-1 Аргументомвыражения«when»можетбытьлюбойобъект.
setOf(YELLOW, BLUE) -> GREEN
I Онпроверяетсяусловнымивыражениямиветвей
setOf(BLUE, VIOLET) -> INDIGO
else -> throw Exception("Грязный цвет")
Выполняется, еслинесоответствует
I ниоднойизветвей
}
»> println(mix(BLUE, YELLOW))
GREEN
Если цвета c l и с2 - это RED (красный) и YELLOW (желтый) или наобо­
рот, в результате их смешивания получится ORANGE (оранжевый), и так да­
лее. Для такой проверки необходимо использовать сравнение множеств.
Стандартная библиотека Kotlin включает функцию setO f, которая создает
множество Set с объектами, переданными в аргументах. Множество - это
коллекция, порядок элементов которой не важен; два множества считают­
ся равными, если содержат одинаковые элементы. То есть если множества
setO f ( c l , с2 ) и setO f (RED, YELLOW) равны, значит, c l и с2 - это RED и
YELLOW(или наоборот). А это как раз то, что нужно проверить.
Выражение when последовательно сравнивает аргумент с условиями во
всех ветвях, начиная с верхней, пока не обнаружит совпадение. То есть мно­
жество setO f ( c l , с2 ) сначала сравнивается со множеством setO f (RED,
YELLOW), а затем с другими, друг за другом. Если ни одно из условий не
выполнится, произойдет переход на ветку e ls e .
Возможность использования любых условных выражений в ветвях when
часто позволяет создавать лаконичный и выразительный код. В данном
2.3. Представление и обработка выбора: перечисления и конструкция «when» ❖
55
примере условием является проверка равенства; далее вы увидите, что в
качестве условия можно выбрать любое логическое выражение.
2.3.4. Выражение «when» без аргументов
Вы, наверное, заметили, что код в листинге 2.15 не очень эффективен.
В каждом вызове функция создает несколько множеств S et, которые ис­
пользуются только для сравнения двух пар цветов. Обычно это не вызы­
вает проблем, но если функция вызывается часто, стоит переписать код
таким образом, чтобы при его выполнении не создавался мусор. Это дела­
ется с помощью выражения when без аргументов. Код станет менее чита­
бельным, но это цена, которую часто приходится платить за лучшую про­
изводительность.
Листинг 2.16. Выражение w hen без аргументов
fun mixOptimized(cl: Color, с2: Color) =
when {
О— Выражение«when»безаргумента
(c l == RED && с2 == YELLOW) | |
(c l == YELLOW && c2 == RED) ->
ORANGE
(c l == YELLOW && c2 == BLUE) ||
(c l == BLUE && c2 == YELLOW) ->
GREEN
(c l == BLUE && c2 == VIOLET) ||
(c l == VIOLET && c2 == BLUE) ->
INDIGO
else -> throw Exception("Dirty color")
}
»> println(mixOptimized(BLUE, YELLOW))
GREEN
В выражениях when без аргумента условием выбора ветки может стать
любое логическое выражение. Функция mixOptimized делает то же, что
mix в листинге 2.15, но она не создает дополнительных объектов, за что
приходится расплачиваться читаемостью кода.
Давайте перейдем дальше и рассмотрим примеры использования выра­
жения when с автоматическим приведением типов.
2.3.5. Автоматическое приведение типов: совмещение
проверки и приведения типа
В качестве примера для этого раздела напишем функцию, которая вы­
числяет простые арифметические выражения, такие как (1 + 2 ) + 4. Для
простоты мы реализуем только один тип операций: сложение двух чисел.
Другие арифметические операции (вычитание, умножение и деление)
56 ❖
Глава 2. Основы Kotlin
реализуются аналогично, и вы можете сделать это упражнение самосто­
ятельно.
Сначала определимся, как будем представлять выражения. Их можно
хранить в древовидной структуре, где каждый узел является суммой (Sum)
или числом (Num). Узел Num всегда является листом, в то время как узел
Sum имеет двух потомков: аргументы операции сложения. В листинге 2.17
определяется простая структура классов, используемых для представле­
ния выражений: интерфейс Ехрг и два класса, Num и Sum, которые его реа­
лизуют. Обратите внимание, что в интерфейсе Ехрг нет никаких методов;
он используется как маркерный интерфейс, играющий роль общего типа
для различных видов выражений. Чтобы показать, что класс реализует
некоторый интерфейс, нужно после имени класса добавить двоеточие (:)
и имя интерфейса:
Листинг 2.17. Иерархия классов для представления выражений
interface Ехрг
■Простойклассобъектов-значенийсодним
class Num(val value: In t) : Ехрг
свойствомvalue, реализующийинтерфейсЕхрг
class Sum(val le ft: Ехрг, val right: Ехрг) : Ехрг <j-. АргументамиоперацииSumмогутбыть
любыеэкземплярыЕхрг: Numилидругой
объектSum
Объект Sum хранит ссылки на аргументы l e f t
и r ig h t типа Ехрг; в этом маленьком приме­
ре они могут представлять экземпляры классов
Num или Sum. Для хранения выражения (1 + 2) + 4,
упомянутого выше, требуется создать объект
Sum(Sum(Num(l), Num(2)), Num(4 )).На рис. 2 .4 изо­
бражено его древовидное представление.
Теперь посмотрим, как вычислить значение
выражения. Результатом выражения из примера
должно быть число 7:
»> println (eval(Sum(Sum(Num(l), Num(2)), Num (4))))
7
Рис. 2.4. Представление
выражения
S um (S um (N um (l),
Num (2)), Num (4))
Интерфейс Ехрг имеет две реализации - соответственно, есть два вари­
анта вычисления значения:
О если выражение является числом, возвращается соответствующее
значение;
О если это операция сложения, после вычисления левой и правой час­
тей выражения необходимо вернуть их сумму.
Сначала посмотрим, как такую функцию можно написать обычным для
Java способом, а затем преобразуем её в стиле Kotlin. В Java для проверки
2.3. Представление и обработка выбора: перечисления и конструкция «when» ❖
57
параметров часто используются последовательности операторов i f , по­
этому используем этот подход в коде на Kotlin.
Листинг 2.18. Вычисление выражения с помощью каскада операторов i f
fun eval(e: Expr): In t {
i f (e is Num) {
val n = e as Num О— Явноеприведениек типуNumздесьизлишне
return n.value
}
i f (e is Sum) {
return eval(e. right) + eval(e.left)
О— Переменнаяeужеприведенак нужномутипу!
}
throw IllegalArgumentException("Unknown expression")
»> println(eval(Sum(Sum(Num(l), Num(2)), Num(4))))
7
В Kotlin принадлежность переменной к определенному типу проверя­
ется с помощью оператора is . Если вы программировали на С#, такой
синтаксис должен быть вам знаком. Эта проверка подобна оператору
in sta n c e o f в Java. Но в Java для получения доступа к нужным свойствам и
методам необходимо выполнить явное приведение после проверки опе­
ратором in sta n c e o f. Когда исходная переменная используется несколько раз, приведенное значение часто сохраняют в отдельной переменной.
Компилятор Kotlin сделает эту работу за вас. Если вы проверили перемен­
ную на соответствие определенному типу, приводить её к этому типу уже
не надо; её можно использовать как значение проверенного типа. Компи­
лятор выполнит приведение типа за вас, и мы называем это автоматичес­
ким приведением типа (smart cast).
if (е is Sum) {
После проверки соответствия
return e v a l (e.right) + eval(e.left)
}
переменной е типу Num компиля­
тор будет интерпретировать её как
Рис. 2.5. IDE выделяет переменные,
переменную типа Num. В результате
подвергнутые автоматическому
вы можете обратиться к свойству
приведению типа
valu e класса Num без явного приве­
дения: е . valu e. То же касается свойств r ig h t и l e f t класса Sum: в данном
контексте можно просто писать е . r ig h t и е . l e f t . IDE выделяет фоном
значения, подвергнутые такому приведению типов, поэтому вы легко
поймете, что значение уже было проверено. См. рис. 2.5.
Автоматическое приведение работает, только если переменная не из­
менялась после проверки оператором is . Автоматическое приведение
применяется только к свойствам класса, объявленным с ключевым словом
58 ❖
Глава 2. Основы Kotlin
v a l, как в данном примере, и не имеющим метода записи. В противном
случае нельзя гарантировать, что каждое обращение к объекту будет воз­
вращать одинаковое значение.
Явное приведение к конкретному типу выражается с помощью ключе­
вого слова as:
val n = е as Num
Теперь давайте посмотрим, как можно привести функцию ev a l к более
идиоматичному стилю Kotlin.
2.3.6. Рефакторинг: замена «if» на «when»
Чем оператор i f в Kotlin отличается от оператора i f в Java? Вы уже знае­
те разницу. В начале главы вы видели выражение i f , которое используется
в таком контексте, в котором в Java использовался бы тернарный опера­
тор: i f (а > b) a e ls e Ъ действует так же, как а > b ? а : b в Java. В
Kotlin тернарный оператор отсутствует, поскольку, в отличие от Java, вы­
ражение i f возвращает значение. Это означает, что функцию ev a l можно
переписать, используя синтаксис тела-выражения без оператора return и
фигурных скобок, с выражением i f вместо тела функции.
Листинг 2.19. Использование выражения i f , возвращающего значения
fun eval(e: Expr): In t =
i f (e is Num) {
e.value
} else i f (e is Sum) {
eval(e.right) + eval(e.left)
} else {
throw IllegalArgumentException("Unknown expression")
}
»> println(eval(Sum(Num(l), Num(2))))
3
Фигурные скобки необязательны, если тело функции состоит только из
одного выражения i f . Если одна из веток i f является блоком, её результа­
том будет последнее выражение в блоке.
Давайте улучшим этот код, используя оператор when.
Листинг 2.20. Использование when вместо каскада выражений i f
fun eval(e: Expr): In t =
when (e) {
is Num ->
e.value
О— Ветка«when»проверяеттипаргумента
О— Используетсяавтоматическоеприведениетипов
2.3. Представление и обработка выбора: перечисления и конструкция «when» ♦> 59
is Sum ->
Ветка«when»проверяеттипаргумента
О—Используетсяавтоматическоеприведениетипов
eval(e.right) + eval(e.left)
else ->
throw IllegalArgumentException("Unknown expression")
}
Выражение when не ограничивается проверкой равенства значений,
как вы уже заметили. Здесь мы использовали другую форму ветвления
when, проверяющую тип аргумента when. Так же, как в примере с i f (лис­
тинг 2.19), проверка типа вызывает автоматическое приведение, поэтому
к свойствам Num и Sum можно обращаться без дополнительных преобра­
зовании.
Сравните две последние версии Kotlin-функции ev a l и подумайте, как
заменить последовательности операторов i f в вашем собственном коде.
Для реализации сложной логики в теле ветки можно использовать блочное
выражение. Давайте посмотрим, как это работает.
2.3.7. Блоки в выражениях «if» и «when»
Оба выражения - i f и when - позволяют определять ветви в виде бло­
ков. Результатом такой ветви станет результат последнего выражения в
блоке. Чтобы добавить журналирование в пример функции, достаточно
оформить ветви в виде блоков и возвращать из них желаемое значение,
как и раньше.
Листинг 2.21. Оператор when с составными операциями в ветках
fun evalWithLogging(e: Expr): In t =
when (e) {
is Num -> {
p rin tln (“num: ${e.value}” )
e.value
}
<H Згапоследнеевыражениевблоке, функция
| вернетегозначение, еслиеимеетran Num
is Sum -> {
val le ft = evalWithLogging(e.left)
val right = evalWithLogging(e.right)
p rin tln (“sum: Sleft + Jright” )
le ft + right
}
else -> throw IllegalArgumentException(“Unknown expression” )
Теперь можно заглянуть в журнал и посмотреть, какие записи добавила
функция evalW ithLogging, чтобы понять, как выполнялись вычисления:
»> println(evalWithLogging(Sum(Sum(Num(l), Num(2)), Num(4))))
num: 1
60 ❖
num:
sum:
num:
sum:
7
Глава 2. Основы Kotlin
2
1+2
4
3+4
Правило «последнее выражение в блоке является результатом» действует
всегда, когда используется блок и ожидается результат. Как будет показано
в конце этой главы, то же правило относится к предложениям tr y и catch,
а в главе 5 демонстрируется применение этого правила к лямбда-выраже­
ниям. Но, как упоминалось в разделе 2.2, это правило не выполняется для
обычных функций. Функция может обладать телом-выражением, которое
не может быть блоком, или телом-блоком с оператором return внутри.
Вы уже знаете, как Kotlin выбирает правильное значение из несколь­
ких. Теперь настало время узнать о работе с последовательностями эле­
ментов.
2.4. Итерации: циклы «while» и «for»
Среди всех особенностей языка, обсуждавшихся в этой главе, итерации в
Kotlin больше всего похожи на итерации в Java. Цикл w h ile действует так
же, как в Java, поэтому мы отведем ему совсем немного места в начале
этого раздела. Цикл fo r существует только в одной форме, эквивалент­
ной циклу fo r-ea ch в Java. Он записывается в форме fo r <элемент> in
<элементы>, как в С#. Чаще всего этот цикл используется для обхода эле­
ментов коллекций - как в Java. Мы также рассмотрим другие способы ор­
ганизации итераций.
2.4.1. Цикл «while»
В языке Kotlin есть циклы w h ile и d o-w h ile, и их синтаксис не отличает­
ся от синтаксиса соответствующих циклов в Java:
while (condition) {
/*•••*/
<1 | Телоциклавыполняется, пока
I условиеостаетсяистинным
do {
/*...*/
} while (condition)
I Теловыполняетсяпервыйразбезусловно. Послеэтого
о —Iоновыполняется, покаусловиеостаетсяистинным
Kotlin не добавляет ничего нового в эти простые циклы, поэтому не бу­
дем задерживаться на них, а перейдем к обсуждению вариантов исполь­
зования цикла for.
2.4. Итерации: циклы «while» и «for» ❖
61
2.4.2. Итерации по последовательности чисел:
диапазоны и прогрессии
Как мы только что отметили, в Kotlin нет привычного для Java цикла
fo r, включающего выражения инициализации переменной цикла, её из­
менения на каждом шаге и проверки условия выхода из цикла. Для таких
случаев в Kotlin используется понятие диапазонов (ranges).
Диапазон представляет собой интервал между двумя значениями, обыч­
но числовыми: началом и концом. Диапазоны определяются с помощью
оператора..:
val oneToTen = 1..10
Обратите внимание, что диапазоны в Kotlin - закрытые или включаю­
щие, т. е. второе значение всегда является частью диапазона.
Самое элементарное действие, которое можно делать с диапазонами це­
лых чисел, - выполнить последовательный обход всех значений. Если есть
возможность обойти все значения диапазона, такой диапазон называется
прогрессией.
Давайте используем диапазон целых чисел, чтобы сыграть в Fizz-Buzz.
Эта игра - хороший способ скоротать долгое путешествие на машине и
вспомнить забытые навыки деления. Игроки договариваются о диапазо­
не чисел и затем ходят по очереди, начиная с единицы и заменяя число,
кратное трем, словом fizz, и число, кратное пяти, словом buzz. Если число
кратно и трем, и пяти, оно заменяется парой слов fizz buzz.
Функция в листинге 2.22 выводит правильные ответы для чисел от 1 до
100. Обратите внимание, как проверяются условия в выражении when без
аргументов.
Листинг 2.22. Применение оператора when в реализации игры Fizz-Buzz
fun fizzBuzz(i: In t) = when
i % 15 == 0 -> "FizzBuzz
i % 3 == 0 -> "Fizz "
i % 5 == 0 -> "Buzz "
else -> "Si "
»> for ( i in 1..100) {
print(fizzBuzz(i))
...
}1
1 2 Fizz 4 Buzz Fizz 7 ...
J
Eoini делитсяна15, вернуть «FizzBuzz». ТакжекаквJava,
%-это операторделенияпомодулю(остатокотделениянацело)
О— Еслиi делитсяна3, вернуть«Fizz»
О— Еслиi делитсяна5, вернуть«Buzz»
О- Ветвьelseвозвращаетсамочисло
О—Выполнитьобходдиапазонаот1до100
62 ❖
Глава 2. Основы Kotlin
Предположим, после часа езды вам надоели эти правила и вы решили
немного усложнить их: счет должен выполняться в обратном порядке, на­
чиная со 100, и рассматриваться должны только четные числа.
Листинг 2.23. Итерации по диапазону с шагом
»> for ( i in 100 downTo 1 step 2) {
... print(fizzBuzz(i))
... }
Buzz 98 Fizz 94 92 FizzBuzz 88 ...
Здесь выполняется обход прогрессии с шагом, что позволяет пропускать
некоторые значения. Шаг также может быть отрицательным - в таком слу­
чае обход прогрессии будет выполняться в обратном направлении. Выра­
жение 100 downTo 1 в данном примере - это убывающая прогрессия (с ша­
гом -1 ). Оператор step меняет абсолютное значение шага на 2, не меняя
направления (фактически он устанавливает шаг равным -2).
Как мы уже упоминали ранее, оператор . . всегда создает закрытый диа­
пазон, включающий конечное значение (справа от ..) . Во многих случаях
удобнее использовать полузакрытые диапазоны, не включающие конеч­
ного значения. Создать такой диапазон можно с помощью функции u n t il.
Например, выражение fo r (х in 0 u n t il s i z e ) эквивалентно выраже­
нию fo r (х in 0 .. s i z e - l ) , но выглядит проще. Позже, в разделе 3.4.3,
вы узнаете больше о синтаксисе операторов downTo, step и u n t i l из этих
примеров.
Вы увидели, как диапазоны и прогрессии помогли нам справиться с
усложненными правилами игры Fizz-Buzz. Теперь давайте рассмотрим
другие примеры использования цикла for.
2.4.3. Итерации по элементам словарей
Как отмечалось выше, цикл f o r . . . i n чаще всего используется для обхо­
да элементов коллекций. Этот цикл действует в точности, как в языке Java,
поэтому мы не будем уделять ему много внимания, а просто посмотрим,
как с его помощью организовать обход элементов словаря.
В качестве примера рассмотрим небольшую программу, которая выво­
дит коды символов в двоичном представлении. Эти двоичные представ­
ления хранятся в словаре (такой способ выбран исключительно для ил­
люстрации). Нижеследующий код создает словарь, заполняет двоичными
представлениями некоторых символов и затем выводит его содержимое.
Листинг 2.24. Создание словаря и обход его элементов
val binaryReps = TreeMap<Char, String>() О— СловарьТгееМархранкг ключивпорядкесортировки
for (с in 'А1..' F') {
<1— Обходдиапазонасимволовот АдоF
2.4. Итерации: циклы «while» и «for» ❖
63
val binary = Integer.toBinaryString(c.toInt())
<•“ 1ПреобразуетASCII-кодвдвоичное
binaryReps[c] = binary
I представление
Сохраняетвсловаре
значениесключомвс
}
for ((le tte r, binary) in binaryReps) {
println("$letter = Jbinary")
Обходэлементовсловаря; ключизначение
присваиваютсядвумпеременным
}
Оператор диапазона . . работает не только для чисел, но и для символов.
Здесь он использован для определения диапазона всех символов от А до F
включительно.
Листинг 2.24 демонстрирует, как цикл fo r позволяет распаковать эле­
мент коллекции, участвующей в итерациях (в данном случае это коллекция
пар ключ/значение, то есть словарь). Результат распаковки сохраняется в
двух отдельных переменных: l e t t e r принимает ключ, a binary - значе­
ние. Позже, в разделе 7.4.1, вы узнаете больше о синтаксисе распаковки.
Еще один интересный прием в листинге 2.24 - использование сокра­
щенного синтаксиса для получения и изменения значении в словаре по
ключу. Вместо вызова методов g et и put можно писать map[key], чтобы
прочитать значение, и map[key] = valu e для его изменения. Код
binaryReps[c] = binary
эквивалентен следующему коду на Java:
binaryReps.put(c, binary)
Пример в листинге 2.24 выведет следующие результаты (мы разместили
их в двух колонках вместо одной):
А = 1000001 D = 1000100
В = 1000010 Е = 1000101
С = 1000011 F = 1000110
Тот же синтаксис распаковки при обходе коллекции можно применить,
чтобы сохранить индекс текущего элемента. Это избавит вас от необходи­
мости создавать отдельную переменную для хранения индекса и увеличи­
вать её вручную:
val lis t = arrayListOf("10", "И", "1001")
for ((index, element) in list.w ithlndex()) {
println("$index: Jelement")
}
Код выведет то, что вы ожидаете:
0 : 10
1: И
2 : 1001
<H Обходколлекцииссохранением
I индекса
64 ❖
Глава 2. Основы Kotlin
Тонкости метода w ithlndex мы обсудим в следующей главе.
Вы увидели, как ключевое слово in используется для обхода диапазона
или коллекции. Кроме того, in позволяет проверить вхождение значения
в диапазон или коллекцию.
2.4.4. Использование «in» для проверки вхождения
в диапазон или коллекцию
Для проверки вхождения значения в диапазон можно использовать
оператор in или его противоположность - ! in , проверяющий отсутствие
значения в диапазоне. Вот как можно использовать in для проверки вхож­
дения символа в диапазон.
Листинг 2.25. Проверка вхождения в диапазон с помощью in
fun isLetter(c: Char) = c in ' a' . . 1z1 || c in 'A '..'Z '
fun isNotDigit(c: Char) = c !in '0 '..'9 '
»> println(isLetter('q'))
true
»> println(isN otD igit(1x1))
true
Проверить, является ли символ буквой, очень просто. Под капотом не
происходит ничего замысловатого: оператор проверяет, находится ли код
символа где-то между кодом первой и последней буквы. Но эта логика
скрыта в реализации классов диапазонов в стандартной библиотеке:
с in ' а'. . ' z ’
О— Преобразуетсява<=с&&с<=z
Операторы in и ! in также можно использовать в выражении when.
Листинг 2.26. Использование проверки in в ветках when
fun recognize(c: Char) = when (с) {
I Проверяетвхождениезначения
in '0 '..'9 ' -> " It's a d ig it!"
<H вдиапазонor 0до9
in 'a '.. 'z ', in 'A '..'Z ' -> " It's a le tte r!" <1— Можносовместитьнесколькодиапазонов
else -> "I don't know..1'
}
»> println(recognize('8 '))
It's a d ig it!
Но диапазоны не ограничиваются и символами. Если есть класс, кото­
рый поддерживает сравнение экземпляров (за счет реализации интерфей­
са j ava. la n g . Comparable), вы сможете создавать диапазоны из объектов
2.5. Исключения в Kotlin ❖
65
этого типа, но не можете перечислить всех объектов в таких диапазонах.
Подумайте сами: сможете ли вы, к примеру, перечислить все строки между
«Java» и «Kotlin»? Нет, не сможете. Но вы по-прежнему сможете убедиться
в принадлежности объекта диапазону с помощью оператора in :
»> println("K otlin11 in "iava". . "Scala")
true
To же, что и 'Java' <= 'Kotlin' && 'Kotlin' <= 'Scala
Обратите внимание, что здесь строки сравниваются по алфавиту, пото­
му что именно так класс S trin g реализует интерфейс Comparable.
Та же проверка in будет работать с коллекциями:
»> println("Kotlin" in setOf("Dava", "Scala"))
false
В разделе 7.3.2 вы увидите, как использовать диапазоны и прогрессии
со своими собственными типами данных и что любые объекты можно ис­
пользовать в проверках in.
В этой главе мы рассмотрим еще одну группу Java-инструкций: инструк­
ции для работы с исключениями.
2.5. Исключения в Kotlin
Обработка исключений в Kotlin выполняется так же, как в Java и многих
других языках. Функция может завершиться обычным способом или воз­
будить исключение в случае ошибки. Код, вызывающий функцию, может
перехватить это исключение и обработать его; если этого не сделать, ис­
ключение продолжит свое движение вверх по стеку.
Инструкции для работы с исключениями в Kotlin в своем простейшем
виде похожи на аналогичные инструкции в Java. Способ возбуждения ис­
ключения вряд ли вас удивит:
i f (percentage !in 0..100) {
throw IllegalArgumentException(
"A percentage value must be between 0 and 100: Jpercentage")
}
Как и со всеми другими классами, для создания экземпляра исключения
не требуется использовать ключевое слово new.
В отличие от Java, конструкция throw в Kotlin является выражением и
может использоваться в таком качестве в составе других выражений:
val percentage =
i f (number in 0..100)
number
else
❖
66
Глава 2. Основы Kotlin
throw IllegalArgumentException(
"A percentage value must be between 0 and 100: $number")
3
< —
«throw»- этовыражение
В этом примере, если условие выполнится, программа поведет себя
правильно и инициализирует переменную percentage значением number.
В противном случае будет возбуждено исключение и переменная не будет
инициализирована. Технические детали применения конструкции throw
в составе других выражений мы обсудим в разделе 6.2.6.
2.5.1. «try», «catch» и «finally»
Как и в Java, для обработки исключений используется выражение tr y
с разделами catch и fin a lly . Как это делается, можно увидеть в листин­
ге 2.27 - демонстрируемая функция читает строку из заданного файла,
пытается преобразовать её в число и возвращает число или n u ll, если
строка не является допустимым представлением числа.
Листинг 2.27. Использование t r y как в Java
fun readNumber(reader: BufferedReader): Int? {
try {
val line = reader.readLine()
return Integer.parselnt(line)
o—i Heтребуетсяявноуказывать, какое
I исключениеможетвозбудитьфункция
}
catch (e: NumberFormatException) {
return null
<1“ I Типисключениязаписывается
I справа
}
fin a lly {
reader.close()
<•“ 1Блок«finally»действуеттакже,
I каквJava
}
}
»> val reader = BufferedReader(StringReader("239"))
»> println(readNumber(reader))
239
Самое большое отличие от Java заключается в отсутствии конструкции
throws в сигнатуре функции: в Java вам пришлось бы добавить throws
IOException после объявления функции. Это необходимо, потому что ис­
ключение IOExcept ion является контролируемым. В Java такие исключения
требуется обрабатывать явно. Вы должны объявить все контролируемые
исключения, возбуждаемые функцией, а при вызове из другой функции обрабатывать все её контролируемые исключения или объявить, что эта
другая функция тоже может их возбуждать.
Подобно многим другим современным языкам для JVM, Kotlin не дела­
ет различий между контролируемыми и неконтролируемыми исключе-
2.5. Исключения в Kotlin ❖
67
ниями. Исключения, возбуждаемые функцией, не указываются - можно
обрабатывать или не обрабатывать любые исключения. Такое проектное
решение основано на практике использования контролируемых исключе­
ний в Java. Как показал опыт, правила языка Java часто требуют писать
массу бессмысленного кода для повторного возбуждения или игнориро­
вания исключений, и эти правила не всегда в состоянии защитить вас от
возможных ошибок.
Например, исключение NumberFormatException в листинге 2.27 не яв­
ляется контролируемым. Поэтому компилятор Java не заставит вас пере­
хватывать его, и вы легко сможете столкнуться с этим исключением во
время выполнения. Это неудачное решение, поскольку ввод неправиль­
ных данных - довольно распространенная ситуация, которая должна быть
корректно обработана. В то же время метод B u ffered R ead er.close мо­
жет возбудить контролируемое исключение IOException, которое нужно
обработать. Большинство программ не сможет предпринять каких-либо
осмысленных действий в ответ на неудачную попытку закрыть поток,
и, следовательно, для обработки исключения, возбуждаемого методом
c lo s e , всегда будет использоваться один и тот же код.
А что насчет конструкции tr y -w ith -r e so u r c e s из Java 7? В Kotlin нет
никакого специального синтаксиса для этого; эта конструкция реализо­
вана в виде библиотечной функции. Вы поймете, как это возможно, читая
раздел 8.2.5.
2.5.2. «try» как выражение
Для демонстрации еще одного существенного различия между Java и
Kotlin немного модифицируем пример. Удалим блок fin a lly (вы уже зна­
ете, как он действует) и добавим код, выводящий число, прочитанное из
файла.
Листинг 2.28. Использование try в качестве выражения
fun readNumber(reader: BufferedReader) {
val number = try {
Integer.parselnt(reader.readLine())
} catch (e: NumberFormatException) {
return
}
println(number)
»> val reader = BufferedReader(StringReader("not a number"))
»> readNumber(reader)
^ Ничего
I не выведет
❖
68
Глава 2. Основы Kotlin
Ключевое слово tr y в языке Kotlin наряду с i f и when является выра­
жением, значение которого можно присвоить переменной. В отличие от
i f , тело выражения всегда нужно заключать в фигурные скобки. Как и в
остальных случаях, если тело содержит несколько выражений, итоговым
результатом станет значение последнего выражения.
В листинге 2.28 в блоке catch находится оператор return, поэтому вы­
полнение функции прервется после выполнения блока catch . Если нужно,
чтобы функция продолжила выполнение после выхода из блока catch , он
тоже должен вернуть значение - значение последнего выражения в нем.
Вот как это работает.
Листинг 2.29. Возврат значения из блока catch
fun readNumber(reader: BufferedReader) {
val number = try {
Integer.parselnt(reader.readLine())
} catch (e: NumberFormatException) {
null
}
println(number)
J
Eoimисключениеневозникнет,
будетвозвращеноэтозначение
Еслиисключениевозникнет,
I будетвозвращенозначениеnull
<3~\
>
»> val reader = BufferedReader(StringReader("not a number"))
»> readNumber(reader)
I Возбудитисключение, поэтому
null
<H функциявыведет«null»
Если блок try выполнится нормально, последнее выражение в нём ста­
нет его результатом. Если возникнет исключение, результатом станет по­
следнее выражение в соответствующем блоке catch. Если в листинге 2.29
возникнет исключение NumberFormatException, результатом станет зна­
чение null.
Если вам не терпится, вы уже можете начать писать программы на язы­
ке Kotlin в стиле, похожем на Java. По мере чтения этой книги вы будете
постепенно менять свой привычный образ мышления и учиться исполь­
зовать всю мощь нового языка.
2.6. Резюме
О Объявление функции начинается с ключевого слова fun. Ключевые
слова v a l и var служат для объявления констант и изменяемых пе­
ременных соответственно.
О Строковые шаблоны помогают избежать лишних операций конка­
тенации строк. Добавьте к переменной префикс $ или заключите
2.6. Резюме ❖
69
выражение в ${} - и соответствующее значение будет подставлено
в строку.
О В Kotlin можно очень лаконично описывать классы объектов-значе­
ний.
выражением
О
значение.
О Выражение when - более мощный аналог выражения switch в Java.
о Исчезла необходимость явно выполнять приведение типа после
проверки типа переменной: благодаря механизму автоматического
приведения типов компилятор сделает это за вас.
о Циклы fo r, w h ile и d o-w h ile похожи на свои аналоги в Java, но цикл
fo r стал более удобным, особенно при работе со словарями или кол­
лекциями с индексом.
о Лаконичный синтаксис 1 .. 5 создает диапазон. Диапазоны и прогрес­
сии позволяют использовать единый синтаксис и набор абстракций
для цикла fo r, а с помощью операторов in и ! in можно проверить
принадлежность значения диапазону.
Обработка исключений в Kotlin выполняется почти так же, как в Java,
лишь с той разницей, что Kotlin не требует перечислять контролируе­
мые исключения, которые может возбуждать функция.
Определение и вызов функций
В этой главе:
■ функции для работы с коллекциями, строками и регулярными
выражениями;
■ именованные аргументы, значения параметров по умолчанию
и инфиксный синтаксис вызова;
■ использование Java-библиотек в Kotlin с помощью функ­
ций-расширений и свойств-расширений;
■ структурирование кода с помощью функций верхнего уровня,
а также локальных функций и свойств.
Надеемся, теперь вы чувствуете себя так же комфортно с Kotlin как с Java.
Вы видели, как знакомые понятия из Java транслируются в Kotlin, и как в
Kotlin они часто становятся более лаконичными и читабельными.
В этой главе вы увидите, как Kotlin может улучшить один из ключевых
элементов любой программы: объявление и вызов функций. Также мы рас­
смотрим возможности использования библиотек Java в стиле Kotlin с по­
мощью функций-расширений - это позволяет получить все преимущества
Kotlin в смешанных проектах.
Чтобы сделать обсуждение полезным и менее абстрактным, выберем
нашей предметной областью коллекции, строки и регулярные выражения.
Сначала давайте посмотрим, как создаются коллекции в Kotlin.
3.1. Создание коллекций в Kotlin
Прежде чем вы сможете делать интересные вещи с коллекциями, вам нуж­
но научиться создавать их. В разделе 2.3.3 вы уже сталкивались с одним
способом создания множеств: функцией setO f. В тот раз мы создавали
множество цветов, но сейчас давайте для простоты использовать цифры:
val set = hashSetOf(1, 7, 53)
3.1. Создание коллекций в Kotlin ❖
71
Списки и словари создаются аналогично:
val lis t = arrayListOf(l, 7, 53)
val map = hashMapOf(l to "one", 7 to "seven", 53 to "fifty-three")
Обратите внимание, что to - это не особая конструкция, а обычная
функция. Мы вернемся к ней позже в этой главе.
Сможете ли вы угадать классы объектов, созданных выше? Выполните
следующий код, чтобы все увидеть своими глазами:
»> println(set. javaClass)
class java.util.HashSet
»> println(list.javaClass)
class java.util.ArrayList
»> println(map. javaClass)
class java.util.HashMap
Как можно заметить, Kotlin использует стандартные классы коллекций
из Java. Это хорошая новость для Java-разработчиков: в языке Kotlin нет
собственных классов коллекций. Все, что вы знаете о коллекциях в Java,
верно и тут.
Почему в Kotlin нет своих коллекций? Потому что использование стан­
дартных Java-коллекций значительно упрощает взаимодействие с Java-кодом. Вам не нужно конвертировать коллекции тем или иным способом,
вызывая Java-функции из Kotlin или наоборот.
Хотя коллекции в Kotlin представлены теми же классами, что и в Java, в
Kotlin они обладают гораздо более широкими возможностями. Например,
можно получить последний элемент в списке или наити максимальное
значение в коллекции чисел:
»> val strings = listO f( "firs t", "second", "fourteenth")
»> println(strings.last())
fourteenth
»> val numbers = setOf(1, 14, 2)
»> println(numbers.max())
14
В этой главе мы подробно рассмотрим механизм работы этого примера
и узнаем, откуда берутся новые методы в Java-классах.
В следующих главах, когда речь пойдёт о лямбда-выражениях, вы по­
знакомитесь с ещё более широким кругом возможностей коллекций - но
и там мы будем продолжать использовать те же стандартные Java-классы
коллекций. О том, как представлены классы коллекций Java в системе ти­
пов языка Kotlin, вы узнаете в разделе 6.3.
72 ❖
Глава 3. Определение и вызов функций
Прежде чем обсуждать работу магических функций la s t и шах для рабо­
ты с коллекциями Java, познакомимся с некоторыми новыми понятиями,
связанными с объявлением функций.
3.2. Упрощение вызова функций
Теперь, когда вы знаете, как создать коллекцию элементов, давайте сде­
лаем что-нибудь несложное - например, выведем её содержимое. Не вол­
нуйтесь, если эта задача кажется слишком простой: в процессе её решения
вы встретитесь со множеством важных понятий.
В Java-коллекциях есть реализация по умолчанию для метода to S tr in g ,
но её формат вывода фиксирован и не всегда подходит:
»> val lis t = ListOf(1, 2, 3)
»> p rin tln (lis t)
[1, 2, 3]
ВызовметодаtoStringO
Допустим, нам нужно, чтобы элементы отделялись друг от друга точкой
с запятой, а вся коллекция заключалась в круглые скобки вместо квадрат­
ных: ( 1 ; 2 ; з). Для решения этой проблемы в Java-проектах используются
сторонние библиотеки, такие как Guava и Apache Commons, или переопре­
деляется логика метода внутри проекта. В Kotlin способ решения этой за­
дачи - часть стандартной библиотеки.
В этом разделе мы сами реализуем нужную функцию. Начнем с очевид­
ной реализации, не использующей особенностей Kotlin, которые упрощают
объявление функций, а затем перепишем её в более идиоматичном стиле.
Функция jo in T o S trin g в листинге 3.1 добавляет элементы из коллек­
ции в объект S trin g B u ild e r, вставляя разделитель между ними, префикс
в начало и постфикс в конец.
Листинг 3.1. Начальная реализация jo in T o S trin g
fun <Т> joinToString(
collection: Collection<T>,
separator: String,
prefix: String,
postfix: String
): String {
val result = StringBuilder(prefix)
for ((index, element) in collection.withlndex()) {
i f (index > 0) result.append(separator)
result.append(element)
<•""1 Heнужновставлятьразделитель
I передпервымэлементам
3.2.Упрощение вызова функций ♦> 73
result.append(postfix)
return result.toString()
}
Это - обобщенная функция: она работает с коллекциями, содержащи­
ми элементы любого типа. Синтаксис использования обобщенных типов
похож на Java. (Более подробное обсуждение обобщенных типов станет
темой главы 9.)
Давайте убедимся, что функция работает, как задумано:
»> val lis t = listO f(1, 2, 3)
»> println(joinToString(list,
(1; 2; 3)
",
")"))
Реализация замечательно работает, и нам почти не придётся её м е­
нять. Но давайте задумаемся: как изменить объявление функции, чтобы
сделать её вызов менее многословным? Возможно, есть способ не пере­
давать все четыре аргумента в каждый вызов функции. Посмотрим, как
это сделать.
3.2.1. Именованные аргументы
Первая проблема, которую мы решим, касается читабельности вызовов
функций. Например, взгляните на следующий вызов функции joinToString:
joinToString(collection, " ", " ", ".")
Можете ли вы сказать, каким параметрам соответствуют все эти стро­
ковые значения? Элементы будут разделяться пробелом или точкой? На
эти вопросы трудно ответить, не имея сигнатуры функции перед глазами.
Возможно, вы её помните или ваша IDE сможет помочь вам. Но если вы
смотрите только на код вызова, нельзя сказать ничего определенного.
Эта проблема особенно часто возникает при использовании логических
флагов. В качестве решения некоторые стили оформления Java-кода ре­
комендуют использовать перечисления вместо логического типа. Другие
даже требуют указывать имена параметров прямо в комментариях, как в
следующем примере:
/* Java */
joinToString(collection, /* separator */ " ", /* prefix */ " ",
/* postfix */ ".");
Kotlin предлагает более изящное решение:
joinToString(collection, separator = " ", prefix = " ", postfix =
Вызывая функции, написанные на Kotlin, можно указывать имена не­
которых аргументов. Когда указано имя одного аргумента, то необходимо
74 ❖
Глава 3. Определение и вызов функций
указать имена всех аргументов, следующих за ним, чтобы избежать пута­
ницы.
Совет. IntelliJ IDEA может автоматически обновлять имена аргументов при изменении имен
параметров вызываемой функции. Для этого используйте операции Rename or Change
Signature (Переименовать или изменить сигнатуру) вместо изменения имен вручную.
Внимание. К сожалению, вы не можете использовать именованных аргументов при вызове
методов, написанных на Java, в том числе методов из JDK и фреймворка Android. Поддерж­
ка хранения имен параметров в файлах .class появилась только в версии Java 8, a Kotlin
поддерживает совместимость с Java 6. В результате компилятор не распознает имен пара­
метров в вызове и не сопоставляет их с определением метода.
Именованные аргументы особенно хорошо работают вместе со значе­
ниями по умолчанию, которые мы рассмотрим далее.
3.2.2. Значения параметров по умолчанию
Другая распространенная проблема Java - избыток перегруженных м е­
тодов в некоторых классах. Только взгляните на класс j ava. ta n g . Thread
и его восемь конструкторов fh ttp : / /mng. bz /4KZCJ! Перегрузка может ис­
пользоваться ради обратной совместимости, для удобства пользователей
или по иным причинам, но итог один - дублирование. Имена параметров
и типы повторяются снова и снова, и если вы добропорядочный гражда­
нин, вам придется повторять большую часть документации в каждой пе­
регрузке. С другой стороны, при использовании перегруженной версии, в
которой отсутствуют некоторые параметры, не всегда понятно, какие зна­
чения будут для них использованы.
В Kotlin часто можно избежать перегрузки благодаря возможности ука­
зывать значения параметров по умолчанию в объявлениях функций. Да­
вайте воспользуемся этим приемом, чтобы усовершенствовать функцию
join T oS trin g. В большинстве случаев строки можно разделять запятыми
и не использовать префикса и постфикса. Давайте объявим эти значения
параметрами по умолчанию.
Листинг 3.2. Объявление функции jo in T o S trin g O со значениями параметров
по умолчанию
fun <Т> joinToString(
collection: Collection<T>,
separator: String = ", ",
prefix: String = "",
postfix: String = ""
): String
Параметрысозначениями
поумолчанию
3.2. Упрощение вызова функций ♦> 75
Теперь функцию можно вызвать с аргументами или опустить некоторые
из них:
»> joinToStringCList, ", ",
1, 2, 3
»> joinToStгin g (lis t)
1, 2, 3
»> joinToString(list,
")
1; 2; 3
При использовании обычного синтаксиса вызова аргументы должны
следовать в том же порядке, что и параметры в объявлении функции, а
опускать можно только аргументы в конце. При использовании именован­
ных аргументов можно опустить аргументы из середины списка и указать
только нужные, причем в любом порядке:
»> joinToStringC lis t, suffix = 1 1 prefix = "# ")
# 1, 2, 3;
Обратите внимание, что значения параметров по умолчанию определя­
ются в вызываемой функции, а не в месте вызова. Если изменить значение
по умолчанию и заново скомпилировать класс, содержащий функцию, то
в вызовах, где значение параметра не указано явно, будет использовано
новое значение по умолчанию.
Значения по умолчанию и Java
Поскольку в Java отсутствует понятие «значения параметров по умолчанию», вам при­
дется явно указывать все значения при вызове функции Kotlin со значениями парамет­
ров по умолчанию из Java. Если такие функции приходится часто вызывать из Java и
желательно упростить их вызов из Java-кода, отметьте их аннотацией ©JvmOverioads.
Она требует от компилятора создать перегруженные Java-методы, опуская каждый из
параметров по одному, начиная с последнего.
Например, отметив аннотацией ©DvmOverloads функцию joinToString, вы полу­
чите следующие перегруженные версии:
/* Java */
String joinToString(Collection<T> collection, String separator,
String prefix, String postfix);
String joinToString(Collection<T> collection, String separator,
String prefix);
String joinToString(Collection<T> collection, String separator);
String joinToString(Collection<T> collection);
Каждая версия использует значения по умолчанию для параметров, не указанных в
сигнатуре.
76 ❖
Глава 3. Определение и вызов функций
До сих пор мы трудились над своей вспомогательной функцией, не об­
ращая особого внимания на окружающий контекст. Наверняка она должна
быть методом какого-то класса, не показанного в листинге с примером,
верно? На самом деле в Kotlin это не обязательно.
3.2.3. Избавление от статических вспомогательных классов:
свойства и функции верхнего уровня
Мы знаем, что Java как объектно-ориентированный язык требует поме­
щать весь код в методах классов. Это хорошая идея, но в реальности почти
во всех больших проектах есть много кода, который нельзя однозначно
отнести к одному классу. Иногда операция работает с объектами двух раз­
ных классов, которые играют для неё одинаково важную роль. Иногда есть
один основной объект, но вы не хотите усложнять его API, добавляя опера­
цию как метод экземпляра.
В конечном итоге появляется множество классов, которые не имеют ни
состояния, ни методов экземпляров и используются только как контейне­
ры для кучи статических методов. Идеальный пример - класс C o lle c tio n s
в JDK. Чтобы обнаружить другие примеры в своем коде, ищите классы, ко­
торые содержат в имени слово U til.
В Kotlin не нужно создавать этих бессмысленных классов. Вместо это­
го можно помещать функции непосредственно на верхнем уровне файла
с исходным кодом, за пределами любых классов. Такие функции всё ещё
остаются членами пакета, объявленного в начале файла, и их всё ещё нуж­
но импортировать для использования в других пакетах, но ненужный до­
полнительный уровень вложенности исчезает.
Давайте поместим функцию join T oS trin g прямо в пакет s tr in g s . Соз­
дайте файл join.kt со следующим содержимым.
Листинг 3.3. Объявление jo in T o S trin g как функции верхнего уровня
package strings
fun joinToString(. ..): String { ... }
Как это работает? Вам должно быть известно, что при компиляции файла
будут созданы некоторые классы, поскольку JVM может выполнять только
код в классах. Если вы работаете только с Kotlin, этого знания вам будет до­
статочно. Но если функцию нужно вызвать из Java, вы должны понимать,
что получится в результате компиляции. Чтобы выяснить это, давайте рас­
смотрим Java-код, который будет компилироваться в такой же класс:
/* java */
package strings;
public class DoinKt {
I Соответствуетименифайла
<_l join.kt излистинга3.3
3.2. Упрощение вызова функций ♦> 77
public static String joinToString(...) ( . . . )
}
Как видите, компилятор Kotlin генерирует имя класса, соответствующее
имени файла с функцией. Все функции верхнего уровня в файле компили­
руются в статические методы этого класса. Поэтому вызов такой функции
из Java выглядит так же, как вызов любого другого статического метода:
/* Dava */
import strings.DoinKt;
ЩФЩ
M nKt.joinToString(list, ", ",
Изменение имени класса в файле
Чтобы изменить имя класса с Kotlin-функциями верхнего уровня, нужно добавить в
файл аннотацию @DvmName. Поместите её в начало файла перед именем пакета:
g file :]vmName("StringFunctions")
О—I Аннотациядляобъявления
| именикласса
package strings
fun joinToString(...): String { ..
Теперь функцию можно вызвать так:
/* Java */
import strings.StringFunctions;
StringFunctions.joinToString(list, ", ",
"");
Синтаксис аннотаций мы подробно обсудим в главе 10.
Свойства верхнего уровня
Как и функции, свойства можно объявлять на верхнем уровне файла.
Хранение отдельных фрагментов данных вне класса требуется не так час­
то, но все же бывает полезно.
Например, var-свойство можно использовать для подсчета выполнен­
ных операций:
var opCount = 0
fun performOperation() {
opCount++
II
...
<Н Объявлениесвойства
| верхнегоуровня
< н Изменениезначения
|свойства
}
fun reportOperationCount() {
78 ❖
Глава 3. Определение и вызов функций
print ln( "Operation performed $opCount times")
}
<H Чтениезначения
| свойства
Значение такого свойства будет храниться в статическом поле.
Кроме того, свойства верхнего уровня позволяют определять константы
в коде:
val UNIX_LINE_SEPARATOR = "\n"
По умолчанию к свойствам верхнего уровня, как и любым другим, мож­
но обращаться из Java через методы доступа (методы чтения v a l-свойств
и пары методов чтения/записи var-свойств). Если нужно сделать констан­
ту доступной для Java-кода как поле с модификаторами p u b lic s t a t i c
final, то её использование можно сделать более естественным, добавив
перед ней модификатор co n st (это возможно для свойств простых типов
и типа String):
const val UNIX_LINE_SEPARATOR = "\n"
Это эквивалентно следующему коду на Java:
/* Dava */
public static final String UNIX_LINE_SEPARATOR = "\n";
Мы усовершенствовали начальную версию вспомогательной функции
j oinT oString. А теперь давайте узнаем, как сделать её ещё удобнее.
3.3. Добавление методов в сторонние классы:
функции-расширения и свойства-расширения
Одна из главных особенностей языка Kotlin - простота интеграции с су­
ществующим кодом. Даже проекты, написанные исключительно на язы­
ке Kotlin, строятся на основе Java-библиотек, таких как JDK, фреймворк
Android и другие. И когда код на Kotiin интегрируется в Java-проект, то
приходится иметь дело с существующим кодом, который не был или не
будет переводиться на язык Kotlin. Правда, здорово было бы использовать
все прелести языка Kotlin при работе с этими API без их переписывания?
Как раз для этого и созданы функции-расширения.
По сути, функция-расширение - очень простая штука: это функция, кото­
рая может вызываться как член класса, но определена за его пределами. Для
демонстрации добавим метод получения последнего символа в строке:
package strings
fun String.lastChar(): Char = th is .get(this.length - 1)
Чтобы определить такую функцию, достаточно добавить имя расширяе­
мого класса или интерфейса перед именем функции. Имя класса назы-
3.3.Добавление методов в сторонние классы: функции-расширения и свойства-расширения ❖
79
вается типом-получателем (receiver type); значение, для которого вызы­
вается функция-расширение, называется объектом-получателем (receiver
object). Это проиллюстрировано на рис. 3.1.
Тип-получатель
Объект-получатель
fun String.lastChar(): Char = this.get(this.length - 1)
Рис. 3.1. Тип-получатель - это тип, для которого определяется
расширением объект-получатель - это экземпляр данного типа
Функцию можно вызывать, используя тот же синтаксис, что и для обыч­
ных членов класса:
»> println("Kotlin". lastCharQ)
n
В этом примере класс S trin g - это тип-получатель, а строка "Kotlin" объект-получатель.
В каком-то смысле мы добавили собственный метод в класс S trin g.
Хотя класс S trin g не принадлежит нам и у нас даже может не быть его
исходного кода, в него все равно можно добавить методы, необходимые в
проекте. Не важно даже, написан класс S trin g на java, на Kotlin или другом
JVM-языке (например, Groovy). Если он компилируется в Java-класс, мы
можем добавлять в него свои расширения.
В теле функции-расширения ключевое слово t h is используется так же,
как в обычном методе. И так же, как в обычном методе, его можно опус­
тить:
package strings
fun String. lastCharQ: Char = get(length - 1)
J
Kметодамобъекта-получателя
можнообращатьсябез«this»
В функции-расширении разрешено напрямую обращаться к методам и
свойствам расширяемого класса точно так же, как в методах, определяе­
мых в самом классе. Обратите внимание, что функции-расширения не
позволяют нарушать правила инкапсуляции. В отличие от методов, объяв­
ленных в классе, функции-расширения не имеют доступа к закрытым или
защищенным членам класса.
Далее мы будем использовать термин метод и для членов класса, и для
функций-расширений. Например, мы можем сказать, что в теле функциирасширения можно вызвать любой метод получателя, подразумевая воз­
можность вызова членов класса и функций-расширений. В точке вызова
функции-расширения ничем не отличаются от членов класса, и зачастую
не имеет значения, является ли конкретный метод членом класса или рас­
ширением.
80 ❖
Глава 3. Определение и вызов функций
3.3.1. Директива импорта и функции-расширения
Функция-расширение не становится автоматически доступной всему
проекту; как любой другой класс или функцию, её необходимо импорти­
ровать. Такой порядок вещей помогает избежать случайных конфликтов
имен. Kotlin позволяет импортировать отдельные функции, используя тот
же синтаксис, что и для классов:
import strings.lastChar
val с = "Kotlin".lastChar()
Функцию-расширение также можно импортировать с помощью *:
import strings.*
val с = "Kotlin".lastChar()
Можно поменять имя импортируемого класса или функции, добавив
ключевое слово as:
import strings.lastChar as last
val c = "Kotlin".lastQ
Изменение импортируемых имен полезно, когда в разных пакетах име­
ются функции с одинаковыми именами и их требуется использовать в од­
ном файле. Для обычных классов и функций существует другое решение
данной проблемы: можно использовать полностью квалифицированное
имя класса или функции. Для функций-расширений правила синтаксиса
требуют использовать короткое имя, поэтому ключевое слово as в инструк­
ции импорта остаётся единственным способом разрешения конфликта.
3.3.2. Вызов функций-расширений из Java
Фактически функция-расширение - это самый обычный статический
метод, которому в первом аргументе передается объект-приемник. Её вы­
зов не предполагает создания объектов-адаптеров или других накладных
расходов во время выполнения.
Благодаря этому использовать функции-расширения в Java довольно
просто: нужно лишь вызвать статический метод, передав ему экземпляр
объекта-приемника. По аналогии с функциями верхнего уровня, имя
Java-класса с методом определяется по имени файла, где объявлена функ­
ция-расширение. Предположим, она объявлена в файле StringUtilM :
/* Java */
char с = StringlltilKt. lastChar("Java");
3.5.Добавление методов в сторонние классы: функции-расширения и свойства-расширения ❖
81
Эта функция-расширение объявлена как функция верхнего уровня, поэто­
му будет скомпилирована в статический метод. Вы можете статически им­
портировать метод lastC har в Java, что упростит вызов до lastC har(" Dava").
Этот код читается несколько хуже, чем его Kotlin-версия, но для Java такое
использование идиоматично.
3.3.3. Вспомогательные функции как расширения
Теперь можно написать окончательную версию функции join T oS trin g.
Она будет практически совпадать с той, что имеется в стандартной библио­
теке Kotlin.
Листинг 3.4. Функция jo in T o S trin g как расширение
fun <Т> Collection<T>.joinToString(
separator: String = ", ",
prefix' Strinq = ""
Значенияпоумолчанию
postfix: String = ""
Д«япараметров
): String {
val result = StringBuilder(prefix)
for ((index, element) in this.withlndex())
i f (index > 0) result, append(separator)
result.append(element)
О—I Объявлениефункции-расширения
| длятипаCollections
<H «this»ссылаетсянаобьекг-пиемник:
| коллекциюэлементовтипаT
}
result.append(postfix)
return result.toString()
}
»>
»>
...
(1;
val lis t = listO f(1, 2, 3)
println(list.joinToString(separator =
prefix = "(", postfix = ")"))
2; 3)
",
Мы создали расширение для коллекции элементов и определили значе­
ния по умолчанию для всех аргументов. Теперь join T oS trin g можно вы­
зывать как обычный член класса:
»> val lis t = arrayListOf(1, 2, 3)
»> println(list.joinToString(" "))
123
Поскольку функции-расширения фактически представляют собой син­
таксический сахар, упрощающий вызов статических методов, в качестве
типа-приемника можно указывать не просто класс, а более конкретный
82 ❖
Глава 3. Определение и вызов функций
тип. Допустим, нам понадобилось написать функцию ] oin , которая может
быть вызвана только для коллекции строк.
fun Collection<String>.join(
separator: String = ", ",
prefix: String =
postfix: String = ""
) = joinToString(separator, prefix, postfix)
»> println(listO f("one", "two", "eight").join(" "))
one two eight
Попытка вызвать эту функцию для списка объектов другого типа закон­
чится ошибкой:
>» listO f(1, 2, 8).join()
Error: Type mismatch: inferred type is List<Int> but Collection<String> was expected.
Статическая природа расширений также означает невозможность пере­
определения функций-расширений в подклассах. Чтобы убедиться в этом,
приведем пример.
3.3.4. Функции-расширения не переопределяются
В Kotlin допускается переопределять функции-члены, но нельзя пере­
определить функцию-расширение. Предположим, у нас есть два класса View и его подкласс B utton, - и класс Button переопределяет функцию
c lic k суперкласса.
Листинг 3.5. Переопределение функции-члена класса
open class View {
open fun clickQ = println("View clicked")
class Button: ViewQ {
override fun click() = println("Button clicked")
J
КлассButton
наследуетView
}
Если объявить переменную типа View, в ней можно сохранить значение
типа Button, поскольку Button - подтип View. При вызове обычного ме­
тода, такого как c lic k , будет выполнен метод из класса Button, если он
переопределен в этом классе:
»> val view: View = Button()
»> view.clickQ
Button clicked
3.3.Добавление методов в сторонние классы: функции-расширения и свойства-расширения
83
Но это не работает для функций-расширений, как показано на рис. 3.2.
Рис. 3.2. Функции-расширения объявляются вне класса
Функции-расширения - не часть класса: они объявляются вне его. Не­
смотря на то что вы можете определить функции-расширения с одинако­
выми именами и типами параметров для базового класса и его подклассов,
вызываемая функция все равно будет зависеть от статического типа пере­
менной, а не от типа значения этой переменной во время выполнения.
В следующем примере демонстрируются две функции-расширения
showOf f , объявленные для классов View и Button.
Листинг 3.6. Функции-расширения не переопределяются
fun View.showOff() = println("I'm a view!")
fun Button.showOffQ = println("I'm a button!")
»> val view: View = ButtonQ
»> view. showOff ()
I'm a view!
I Вызываемаяфункция-расширение
<H определяетсястатически
Для вызова метода showOf f переменной типа View компилятор выберет
соответствующее расширение, руководствуясь типом, указанным в объяв­
лении переменной, даже если фактическое значение имеет тип Button.
Если вспомнить, что функции-расширения компилируются в статиче­
ские функции Java, принимающие объект-приемник в первом аргументе,
такое поведение не покажется странным, поскольку Java определяет вы­
зываемую функцию точно так ж е:
/* lava */
»> View view = new Button();
»> ExtensionsKt. showOff (view);
I'm a view!
I ФункцииshowOffобъявлены
< —I вфайлеextensions.kt
Как вы можете видеть, переопределение невозможно для функций-рас­
ширений : Kotlin определяет их статически.
Примечание. Если класс имеет метод с той же сигнатурой, как у функции-расширения, при­
оритет всегда будет отдаваться методу. Имейте это в виду, расширяя API классов: если вы
добавите в класс метод с такой же сигнатурой, как у функции-расширения, которую опреде-
84 ❖
Глава 3. Определение и вызов функций
лил клиент вашего класса, то после перекомпиляции код клиента изменит свою семантику
и начнет ссылаться на новый метод класса.
Мы обсудили, как определять дополнительные методы для внешних
классов. Теперь давайте посмотрим, как сделать то же самое со свойства­
ми.
3.3.5. Свойства-расширения
Свойства-расширения позволяют добавлять в классы функции, к ко­
торым можно обращаться, используя синтаксис свойств, а не функций.
Хотя они называются свойствами, свойства-расширения не могут иметь
состояние из-за отсутствия места для его хранения: нельзя добавить до­
полнительных полей в существующие экземпляры объектов Java. Но более
краткий синтаксис иногда бывает удобен.
В предыдущем разделе мы определили функцию lastC har. Теперь да­
вайте преобразуем её в свойство.
Листинг 3.7. Объявление свойства-расширения
val String.lastChar: Char
get() = get(length - 1)
Как и функции, свойства-расширения похожи на обычные свойства и
отличаются только наличием имени типа-получателя в начале своего
имени. Поскольку отдельного поля для хранения значения не существует,
метод чтения должен определяться всегда и не может иметь реализации
по умолчанию. Инициализаторы не разрешены по той же причине: негде
хранить указанное значение.
Определяя то же самое свойство для класса S trin g B uilder, его можно
объявить как var, потому что содержимое экземпляра S trin g B u ild er мо­
жет меняться.
Листинг 3.8. Объявление изменяемого свойства-расширения
var StringBuilder.lastChar: Char
get() = get(length - 1)
set(value: Char) {
this.setCharAt(length - 1, value)
<1— Методчтениядлясвойства
О— Методзаписидлясвойства
}
К свойствам-расширениям можно обращаться как к обычным свойст­
вам:
»> println("K otlin". lastChar)
n
3.4. Работа с коллекциями: переменное число аргументов, инфиксная форма записи
85
»> val sb = StringBuilder("Kotlin?")
»> sb. lastChar = '! '
»> println(sb)
Kotlin!
Обратите внимание: чтобы обратиться к свойству-расширению
из Java, нужно явно вызывать его метод чтения: S trin gU tilK t .g e tLastOiar("Dava" ).
Мы обсудили понятие расширений в целом. Теперь вернемся к теме кол­
лекций и рассмотрим несколько библиотечных функций, помогающих в ра­
боте с ними, а также особенности языка, проявляющиеся в этих функциях.
3.4. Работа с коллекциями: переменное число
аргументов, инфиксная форма записи вызова
и поддержка в библиотеке
В этом разделе демонстрируются некоторые функции из стандартной биб­
лиотеки Kotlin для работы с коллекциями. Попутно мы опишем несколько
связанных с ними особенностей языка:
О ключевое слово vararg позволяет объявить функцию, принимаю­
щую произвольное количество аргументов;
О инфиксная нотация поможет упростить вызовы функций с одним ар­
гументом;
О мультидекларации (destructuring declarations) позволяют распако­
вать одно составное значение в несколько переменных.
3.4.1. Расширение API коллекций Java
Мы начали эту главу с рассуждения о том, что коллекции в Kotlin - те
же классы, что и в Java, но с расширенным API. Вы видели примеры полу­
чения последнего элемента в списке и поиска максимального значения в
коллекции чисел:
»> val strings: List<String> = listO f( "firs t", "second", "fourteenth")
»> strings.last()
fourteenth
»> val numbers: Collection<Int> = setOf(l, 14, 2)
»> numbers.max()
14
Но нам интересно, как это работает: почему в Kotlin коллекции поддер­
живают так много всяких операций, хотя они - экземпляры библиотечных
86 ❖
Глава 3. Определение и вызов функций
классов Java. Теперь ответ должен быть ясен: функции la s t и max объявле­
ны как функции-расширения!
Функция la s t ничуть не сложнее функции lastC har для класса S trin g,
которую мы обсудили в предыдущем разделе: она представляет собой рас­
ширение класса L ist. Для функции max мы покажем упрощенный вариант
(настоящая библиотечная функция работает не только с числами типа In t,
но и с любыми экземплярами типов, поддерживающих сравнение):
fun <Т> List<T>.last(): Т { /* возвращает последний элемент */ }
fun Collection<Int>.max(): Int { /* отыскивает максимальное значение в коллекции */ }
В стандартной библиотеке Kotlin объявлено много функций-расшире­
ний, но мы не будем перечислять их все. Возможно, вас больше интересу­
ет, как лучше исследовать стандартную библиотеку Kotlin. Вам не нужно
учить её возможности наизусть: в любой момент, когда понадобится чтото сделать с коллекцией или любым другим объектом, механизм автома­
тического завершения кода в IDE покажет вам все функции, доступные для
объекта данного типа. В списке будут как обычные методы, так и функциирасширения; вы сможете выбрать то, что вам нужно. Кроме того, в спра­
вочнике по стандартной библиотеке перечисляются все методы каждого
библиотечного класса: не только члены класса, но и расширения.
В начале главы вы видели функции для создания коллекций. Общая
черта этих функций - способность принимать произвольное число аргу­
ментов. В следующем разделе вы прочтете о синтаксисе объявления таких
функций.
3.4.2. Функции, принимающие произвольное число
аргументов
Вызывая функцию создания списка, вы можете передать ей любое коли­
чество аргументов:
val lis t = listO f(2, 3, 5, 7, И )
В месте объявления этой библиотечной функции вы найдете следующее:
fun listOf<T>(vararg values: T): List<T> ( . . . )
Наверное, вы знакомы с возможностью передачи произвольного ко­
личества аргументов в Java путем упаковки их в массив. В Kotlin эта воз­
можность реализована похожим образом, но синтаксис немного отлича­
ется: вместо трех точек после имени типа Kotlin использует модификатор
vararg перед параметром.
Синтаксис вызова функций в Kotlin и Java также отличается способом
передачи аргументов, уже упакованных в массив. В Java массив передается
непосредственно, a Kotlin требует явно распаковать массив, чтобы каждый
элемент стал отдельным аргументом вызываемой функции. Эта операция
3.4. Работа с коллекциями: переменное число аргументов, инфиксная форма записи.
❖
87
называется вызовом с оператором распаковки (spread operator), а на прак­
тике это просто символ * перед соответствующим аргументом:
fun main(args: Array<String>) {
val lis t = listO f( "args: ", *args)
p rin tln (lis t)
}
На этом примере видно, что оператор распаковки позволяет объеди­
нить в одном вызове значения из массива и несколько фиксированных
значений. Этот способ не поддерживается в Java.
Теперь перейдем к словарям. Обсудим еще один способ улучшения чи­
таемости вызовов функций в Kotlin: инфиксный вызов (infix call).
3.4.3. Работа с парами: инфиксные вызовы
и мультидекларации
Для создания словаря применяется функция mapOf:
val map = mapOf(1 to "one", 7 to "seven", 53 to "fifty-three")
Сейчас самое время познакомиться с объяснением, которое мы обещали
в начале главы. Ключевое слово to в этой строке - не встроенная конструк­
ция, а специальная форма вызова метода, называемая инфиксным вызовом.
В инфиксном вызове имя метода помещается между именем целевого
объекта и параметром, без дополнительных разделителей. Следующие два
вызова эквивалентны:
l.to("one")
1 to "one
О— Вызовфункцииtoобычнымспособом
<•“ 1Вызовфункцииtocсиспользованием
I инфикснойнотации
Инфиксную форму вызова можно применять к обычным методам и к
функциям-расширениям, имеющим один обязательный параметр. Чтобы
разрешить вызовы функции в инфиксной нотации, в её объявление нужно
добавить модификатор infix. Ниже представлена упрощенная версия объ­
явления функции t o :
in fix fun Any.to(other: Any) = Pair(this, other)
Функция to возвращает экземпляр класса Pair (из стандартной библио­
теки Kotlin), который, как нетрудно догадаться, представляет пару из двух
элементов. Настоящие объявления класса Pair и функции to используют
обобщенные типы, но ради простоты изложения мы не будем вдаваться в
эти подробности.
Обратите внимание, что значениями объекта Pair можно инициализи­
ровать сразу две переменные:
val (number, name) = 1 to "one"
88 ❖
Глава 3. Определение и вызов функций
Это называется мультидекларацией (destruc­
turing declaration). На рис. 3.3 показано, как это
работает с парой элементов.
Мультидекларации работают не только с па­
рами. Например, содержимым элемента словаря
можно инициализировать две переменные, key
и value.
Этот прием также можно использовать в
циклах - вы видели его использование для рас­
паковки результатов вызова w ithlndex в реали­
зации функции joinT oString:
for ((index, element) in collection.wittilndex()) {
println("$index: Jelement")
}
(
/----- >\1
1I
/------*
Г \
I
tv*
"Ir
one"
Л
Рис. 3.3. Создание пары
с помощью функции to и
её распаковка с помощью
мультидекларации
В разделе 7.4 будут описаны общие правила деструктуризации выраже­
ний и инициализации нескольких переменных.
Функция to является функцией-расширением. С её помощью можно
создать пару любых элементов, т. е. эта функция расширяет обобщенный
тип-приемник: можно написать 1 to "one", "one" to 1, l i s t to l i s t .
s i z e ( ) и т. д. Давайте посмотрим на объявление функции mapOf:
fun <К, V> mapOf(vararg values: PaircK, V>): Map<K, V>
Подобно lis t O f , функция mapOf принимает переменное количество ар­
гументов, но на этот раз они должны быть парами ключей и значений.
Даже притом, что создание нового словаря может показаться специаль­
ной конструкцией в Kotlin, это самая обычная функция, поддерживающая
краткий синтаксис. Далее мы покажем, как функции-расширения упро­
щают работу со строками и регулярными выражениями.
3.5. Работа со строками и регулярными
выражениями
Строки в Kotlin - это те же объекты, что и в Java. Вы можете передать стро­
ку, созданную в коде на Kotlin, любому Java-методу и использовать любые
методы из стандартной библиотеки Kotlin для обработки строк, получен­
ных из Java-кода. При этом не происходит никаких преобразований и не
создается никаких объектов-оберток.
Но Kotlin делает работу с обычными Java-строками более приятной, до­
бавляя множество полезных функций-расширений. Кроме того, он скры­
вает некоторые методы, вызывающие путаницу, добавляя расширения с
более однозначными именами. В качестве первого примера различий в
API посмотрим, как в Kotlin выполняется разбиение строк.
3.5. Работа со строками и регулярными выражениями ❖
89
3.5.1. Разбиение строк
Вы наверняка знакомы с методом s p l i t класса S trin g. Он известен всем,
но иногда на форуме Stack Overflow (h ttp : / /stackoverflow . coml можно
встретить жалобы на него: «Метод s p l i t в Java не работает с точкой». Мно­
гие заблуждаются, полагая, что вызов "1 2 .3 4 5 -6 .А". s p l i t (" ." ) вернет
массив [1 2 , 345-6, А].Н ов Java он вернет пустой массив! Это происходит
потому, что s p l i t ожидает получить регулярное выражение и разбивает
строку на несколько частей согласно этому выражению. В этом контексте
точка ( . ) - регулярное выражение, соответствующее любому символу.
Kotlin скрывает этот метод, вызывающий путаницу, предоставляя сразу
несколько перегруженных расширений с именем s p l i t и различными ар­
гументами. Перегруженная версия, принимающая регулярное выражение,
требует значения типа Regex, а не S trin g . Это однозначно определяет, как
будет интерпретироваться строка, переданная методу: как обычный текст
или как регулярное выражение.
Вот как можно разделить строку с точкой или тире:
»> print 1п(" 12.345-6. А". s p lit(" \ \ . | - 11.toRegex()))
[12, 345, 6, А]
< н g„u^. щ.ртддчд
| регулярноговыражения
Kotlin использует точно такой же синтаксис регулярных выражений, как
Java. Здесь шаблон соответствует точке (мы экранировали её, чтобы пока­
зать, что имеем в виду саму точку, а не произвольный символ) или тире.
Набор методов для работы с регулярными выражениями тоже аналогичен
набору методов в стандартной библиотеке Java, но он более идиоматичен.
Например, в Kotlin для преобразования строки в регулярное выражение
используется функция-расширение toRegex.
Но для такого простого случая не нужно регулярное выражение. Другая
перегруженная версия s p l i t в Kotlin принимает произвольное число раз­
делителей в виде обычных строк:
»> println("12.345-6.A" .s p lit(" .", "-"))
[12, 345, б, А]
<:1 I Передачанескольких
I разделителей
Обратите внимание, что если передать аргументы символьного типа и
написать " 12.345-6. А"1. s p l i t ( ' . ' ,
' - 1), то получится аналогичный
результат. Этот метод заменяет похожий Java-метод, принимающий толь­
ко один аргумент с символом-разделителем.
3.5.2. Регулярные выражения и строки в тройных кавычках
Рассмотрим еще один пример с двумя различными реализациями: в
первой используется расширение класса S tr in g , а во второй - регулярные
выражения. Наша задача - разбить полный путь к файлу на компоненты:
каталог, имя файла и расширение. Стандартная библиотека Kotlin содер-
90 ❖
Глава 3. Определение и вызов функций
жит функции для получения подстроки перед первым (или после послед­
него) появлением заданного разделителя. Вот как их можно использовать
для решения этой задачи (см. также рис. 3.4).
Последний слеш
Последняяточка
/Users/yole/kotlin-book/chapter.adoc
V
________________ j
л
Каталог
Расширение
Имя файла
(перед последним
(после последней
слешем)
точки)
Рис. 3.4. Разбиение пути файла на компоненты: каталог, имя файла
и расширение с помощью функций substringBeforeLast и substringAfter Last
Листинг 3.9. Использование расширений класса S trin g для работы с путями к файлам
fun parsePathfpatb: String) {
val directory = patb.substringBeforeLa$t(7")
val fullName = path.substringAfterLast(7")
val fileName = fullName.substringBeforeLast(".")
val extension = fullName.substringAfterLast(V)
println("D ir: $directory, name: $fileName, ext: $extension")
>
»> parsePath("/Users/yole/kotlin-book/chapter.adoc")
Dir: /Users/yole/kotlin-book, name: chapter, ext: adoc
Подстрока перед последней косой чертой в пути к файлу path - это ка­
талог, где находится файл, подстрока после последней точки - это расши­
рение файла, а его имя находится между ними.
Kotlin упрощает разбор строк без использования регулярных выраже­
ний (они мощный инструмент, но их бывает трудно понять после написа­
ния). Впрочем, стандартная библиотека Kotlin поможет и тем, кто желает
использовать регулярные выражения. Вот как ту же задачу можно решить
с помощью регулярных выражений:
Листинг 3.10. Использование регулярных выражений для разбора пути к файлу
fun parsePath(path: String) {
val regex = """(.+ )/(.+ )\.(.+ )""".toRegex()
val matchResult = regex.matchEntire(path)
i f (matchResult != null) {
val (directory, filename, extension) = matchResult.destructured
println("D ir: {directory, name: {filename, ext: {extension")
3.5. Работа со строками и регулярными выражениями ❖
91
В этом примере регулярное выражение записано в тройных кавычках.
В такой строке не нужно экранировать символов, включая обратную косую
черту, поэтому литерал точки можно описать как \ . вместо \ \ . в обычных
строковых литералах (см. рис. 3.5).
Последний слеш Последняяточка
■■*(.+)/(.+)\.
Каталог Имя файла Расширение
Рис. 3.5. Регулярное выражение для разделения пути к файлу
на каталог, имя файла и расширение
Это регулярное выражение разбивает путь на три группы, разделенные
символом слеша и точкой. Шаблон . соответствует любому символу, начи­
ная с начала строки, поэтому первой группе ( . + ) соответствует подстро­
ка до последнего слеша. Эта подстрока включает все предыдущие слеши,
потому что они соответствуют шаблону «любой символ». Соответственно,
второй группе соответствует подстрока до последней точки, а третьей оставшаяся часть.
Теперь обсудим реализацию функции parsePath из предыдущего при­
мера. Она создает регулярное выражение и сопоставляет его с путем к
файлу. Если совпадение найдено (результат не null), его свойство destru ctu red присваивается соответствующим переменным. Это тот же
синтаксис мультидеклараций, который был использован в случае инициа­
лизации двух переменных значениями свойств объекта Pair; подробнее
об этом рассказывается в разделе 7.4.
3.5.3. Многострочные литералы в тройных кавычках
Тройные кавычки нужны не только для того, чтобы избавиться от необ­
ходимости экранировать символы. Такой строковый литерал может содер­
жать любые символы, включая переносы строк. Это создает простой спо­
соб встраивания в программу текста, содержащего переносы строк. Для
примера создадим ASCII-рисунок:
val kotlinLogo = '""'I / /
ЛИ
• I/ V...
»> println(kotlinLogo.trimMargin("."))
I //
I//
I/ \
92 ❖
Глава 3. Определение и вызов функций
многострочный литерал включает все символы между тройными кавыч­
ками, в том числе и отступы, использованные для форматирования кода.
Для лучшего представления такой строю! можно обрезать отступ (то есть
левое поле). Для этого добавьте в строку префиксы, отмечающие конец
отступа, а затем вызовите функцию trimMargin, которая удалит префикс
и отступы в каждой строке. В этом примере в качестве такого префикса
используются точки.
Строки в тройных кавычках могут содержать переносы строк, но в них
нельзя использовать специальных символов, таких как \n. С другой сторо­
ны, отпадает необходимость экранировать символ \ , поэтому путь в стиле
Windows " C : \\U s e r s \\y o le \\k o t lin - b o o k " можно записать как """С:\
U s e r s \y o le \k o t lin - b o o k " "".
В многострочных литералах тоже можно использовать шаблоны. По­
скольку многострочные литералы не поддерживают экранированных по­
следовательностей, единственный способ включить в литерал знак дол­
лара - это использовать встроенное выражение. Выглядит это так: v a l
p r ic e =
Одна из областей, где многострочные литералы могут оказаться полез­
ными (кроме игр, использующих ASCII-графику), - это тесты. В тестах час­
то приходится выполнять операцию, создающую многострочный литерал
(например, фрагмент веб-страницы), и сравнивать его с ожидаемым ре­
зультатом. Многострочные литералы позволяют хранить ожидаемые ре­
зультаты в коде тестов. Больше нет необходимости заботиться об экрани­
ровании или загружать текст из внешних файлов - достаточно заключить
ожидаемую разметку HTML или другой результат в тройные кавычки. А
для лучшего форматирования используйте уже упоминавшуюся функцию
trimMargin - еще один пример функции-расширения.
Примечание. Теперь вы знаете, что функции-расширения - это мощное средство наращива­
ния API существующих библиотек и их адаптации к идиомам нового языка - так называе­
мый шаблон «Прокачай мою библиотеку»1. Действительно, большая часть стандартной биб­
лиотеки Kotlin состоит из функций-расширений для стандартных классов Java. Библиотека
Anko (https: / /github.co m /kotiin /anko ),также разработанная компанией JetBrains,
включает функции-расширения, которые делают Android API более дружелюбным по от­
ношению к языку Kotlin. Кроме того, существует множество разработанных сообществом
библиотек с удобными для работы с Kotlin обертками, таких как Spring.
Теперь, когда вы знаете, как Kotlin улучшает API используемых вам биб­
лиотек, давайте снова вернемся к нашему коду. Далее мы рассмотрим но­
вые способы использования функций-расширений, а также обсудим новое
понятие: локальные функции (local functions).
1 Martin Odersky, «Pimp My Library», Artima Developer, October 9,2006, http://mng.bz/860h.
3.6. Чистим код: локальные функции и расширения ♦> 93
3.6. Чистим код: локальные функции
и расширения
Многие разработчики считают, что одно из самых важных качеств хоро­
шего кода - отсутствие дублирования. Есть даже специальное название
этого принципа: «не повторяйся» (Don't Repeat Yourself, DRY). В програм­
мах на Java следовать этому принципу не всегда просто. Во многих случаях
можно разбить большой метод на меньшие фрагменты, а затем повторно
их использовать (для рефакторинга можно использовать операцию Extract
Method (Извлечь метод) в IDE). Но, это делает код более трудным для пони­
мания, потому что в конечном итоге в классе окажется множество мелких
методов без четкой взаимосвязи между ними. Можно пойти ещё дальше
и сгруппировать извлеченные методы во внутреннем классе, сохранив
структуру кода, но такой подход требует значительного объема шаблон­
ного кода.
Kotlin предлагает более чистое решение: функции, извлеченные из ос­
новной функции, можно сделать вложенными. В результате получается
требуемая структура, без лишних синтаксических накладных расходов.
Давайте посмотрим, как использовать локальные функции для реше­
ния такой распространенной проблемы, как дублирование кода. Функция
в листинге 3.11 сохраняет информацию о пользователе в базе данных, и
ей нужно убедится, что объект, представляющий пользователя, содержит
допустимые данные.
Листинг 3.11. Функция с повторяющимся кодом
class User(val id: In t, val name: String, val address: String)
fun savel)ser(user: User) {
i f (user.name.isEmpty()) {
throw IllegalArgumentException(
"Can't save user ${user.id}: empty Name")
}
Дублируется проверка полей
i f (user.address.isEmpty()) {
o —1
throw IllegalArgumentException(
"Can't save user ${user.id}: empty Address")
}
/ / Сохранение информации о пользователе в базе данных
»> saveUser(User(l,
'"'))
java.lang.IllegalArgumentException: Can't save user 1: empty Name
94 ❖
Глава 3. Определение и вызов функций
Объем повторяющегося кода здесь невелик, и вы вряд ли захотите соз­
давать отдельный метод в классе для обработки единственного особо­
го случая проверки. Но, поместив код проверки в локальную функцию,
можно избежать дублирования и сохранить четкую структуру кода (лис­
тинг 3.12).
Листинг 3.12. Извлечение локальной функции для предотвращения дублирования
class User(val id: In t, val name: String, val address: String)
fun savel)ser(user: User) {
fun validate(user: User,
value: String,
fieldName: String) {
i f (value.isEmpty()) {
throw IllegalArgumentException(
"Can't save user ${user.id}: empty $fieldName")
}
}
validate(user, user.name, "Name")
validate(user, user.address, "Address")
Вызов функции для проверки
конкретных полей
/ / Сохранение информации о пользователе в базе данных
}
Такой код выглядит лучше. Логика проверки не дублируется, и если по
мере развития проекта понадобится добавить другие поля в класс User,
то можно легко выполнять дополнительные проверки. Но передача объ­
екта User в функцию проверки выглядит немного некрасиво. Самое ин­
тересное, что в этом нет никакой необходимости, потому что локальные
функции имеют доступ ко всем параметрам и переменным охватывающей
функции. Воспользуемся этим обстоятельством и избавимся от дополни­
тельного параметра User.
Листинг 3.13. Доступ к параметрам внешней функции из локальной функции
class User(val id: In t, val name: String, val address: String)
fun saveUser(user: User) {
fun validate(value: String, fieldName: String) {
i f (value.isEmpty()) {
throw IllegalArgumentException(
Can't save user ${user.id}: " +
<•“ 1 Можно напрямую обращаться к
"empty SfieldName")
I параметрам внешней функции
}
3.6. Чистим код: локальные функции и расширения ❖
95
}
validate(user.name, "Name")
validate(user.address, "Address")
/ / Сохранение информации о пользователе в базе данных
}
Можно ещё улучшить этот пример, если перенести логику проверки в
функцию-расширение класса User.
Листинг 3.14. Перемещение логики в функцию-расширение
class User(val id: In t, val name: String, val address: String)
fun User.validateBeforeSave() {
fun validate(value: String, fieldName: String) {
i f (value.isEmpty()) {
throw IllegalArgumentException(
"Can't save user $id: empty JfieldName") < H К свойствам класса User можно
}
I обращаться напрямую
}
validate(name, "Name")
validate(address, "Address")
}
fun saveUser(user: User) {
user. validateBeforeSave()
<Ь|
/ / Сохранение пользователя в базу данных
>
Извлечение фрагмента кода в функцию-расширение оказывается на
удивление полезным приемом рефакторинга. Даже если класс User - часть
кода вашего проекта, а не библиотечный класс, вы можете посчитать из­
лишним оформлять эту логику в виде метода класса, потому что она ни­
где больше не используется. Если следовать этому подходу, прикладной
интерфейс класса будет содержать только необходимые методы, исполь­
зуемые повсеместно, не разрастется и останется легкодоступным для по­
нимания. С другой стороны, функции, которые обращаются к одному объ­
екту и которым не нужен доступ к приватным данным, могут напрямую
обращаться к нужным свойствам, как показано в листинге 3.14.
Функции-расширения также могут объявляться как локальные функции,
поэтомуможно пойти дальше и сделать функцию U ser. v a l id a te B e f oreSave
локальной функцией в saveUser. Но глубоко вложенные локальные функ-
96 ❖
Глава 3. Определение и вызов функций
ции трудно читать; поэтому в общем случае мы рекомендуем не использо­
вать более одного уровня вложенности.
Узнав, что можно делать с функциями, в следующей главе мы рассмот­
рим действия с классами.
3.7. Резюме
О В языке Kotlin нет собственных классов коллекций; вместо этого он
добавляет новые методы в классы коллекций Java, предоставляя бо­
гатый API.
О Определение значений параметров по умолчанию снижает необхо­
димость перегрузки функций, а синтаксис именованных аргументов
делает вызов функций с несколькими аргументами более читабель­
ным.
О Функции и свойства можно объявлять не только как члены класса, но
и непосредственно на верхнем уровне файла, что позволяет опреде­
лять код с более гибкой структурой.
Функции-расширения и свойства-расширения дают возможность
расширять API любых классов, в том числе классов во внешних биб­
лиотеках, без модификации их исходного кода и без дополнитель­
ных накладных расходов во время выполнения.
О Инфиксная нотация обеспечивает более чистый синтаксис вызова
методов с одним аргументом, похожий на синтаксис операторов.
О Kotlin поддерживает большое количество функций для работы со
строками и с регулярными выражениями.
О Строки в тройных кавычках упрощают запись выражений, которые в
Java потребовали бы использования неуклюжих символов экраниро­
вания и множества операций конкатенации.
О Локальные функции помогают лучше структурировать код и изба­
виться от дублирования.
Глава
и
Классы, объекты и интерфейсы
В этой главе:
■ классы и интерфейсы;
■ нетривиальные свойства и конструкторы;
■ классы данных;
■ делегирование;
■ ключевое слово ob j e c t.
Эта глава позволит вам лучше понять особенности работы с классами в
Kotlin. Во второй главе вы познакомились с базовым синтаксисом объяв­
ления класса, узнали, как объявлять методы и свойства, как использовать
основные конструкторы (разве они не чудо?) и как работать с перечисле­
ниями. Но есть кое-что, чего вы ещё не видели.
Классы и интерфейсы в Kotlin немного отличаются от своих аналогов в
Java: например, интерфейсы могут содержать объявления свойств. В отли­
чие от Java, объявления в Kotlin по умолчанию получают модификаторы
final и public. Кроме того, вложенные классы по умолчанию не становятся
внутренними: они не содержат неявной ссылки на внешний класс.
Что касается конструкторов, то лаконичный синтаксис основного кон­
структора (primary constructor) отлично подходит для большинства слу­
чаев; но существует и более полный синтаксис, позволяющий объявлять
конструкторы с нетривиальной логикой инициализации. Это же относит­
ся к свойствам: краткий синтаксис хорош, но есть и возможность опреде­
лять собственные реализации методов доступа.
Компилятор Kotlin может сам генерировать полезные методы, позво­
ляя избавляться от лишнего кода. Если класс объявляется как класс данных
(data class), компилятор добавит в него несколько стандартных методов.
Также нет необходимости делегировать методы вручную, потому что шаб­
лон делегирования поддерживается в Kotlin на уровне языка.
98 ❖
Глава 4. Классы, объекты и интерфейсы
Эта глава также описывает новое ключевое слово оЪj e c t, которое объяв­
ляет класс и одновременно создает его экземпляр. Это ключевое слово ис­
пользуется для объявления объектов-одиночек (singleton), объектов-компаньонов (companion objects) и объектов-выражений (аналог анонимных
классов в Java). Начнем с разговора о классах и интерфейсах и тонкостях
определения иерархий классов в Kotlin.
4.1. Создание иерархий классов
В этом разделе сравниваются способы создания иерархий классов в Kotlin
и Java. Вы познакомитесь с понятием видимости и модификаторами до­
ступа в Kotlin, которые тоже есть в Java, но отличаются некоторыми умол­
чаниями. Вы также узнаете о новом модификаторе sea led , который огра­
ничивает возможность создания подклассов.
4.1.1. Интерфейсы в Kotlin
Начнем с определения и реализации интерфейсов. Интерфейсы в Kotlin
напоминают Java 8: они могут содержать определения абстрактных и реа­
лизации конкретных методов (подобно методам по умолчанию в Java 8),
но они не могут иметь состояний.
Интерфейсы объявляются в Kotlin с помощью ключевого слова in te r fa c e .
Листинг 4.1. Объявление простого интерфейса
interface Clickable {
fun click()
}
Это объявление интерфейса с единственным абстрактным методом
c lic k . Все конкретные классы, реализующие этот интерфейс, должны реа­
лизовать данный метод, например:
Листинг 4.2. Реализация простого интерфейса
class Button : Clickable {
override fun click() = p rin tln ("I was clicked")
}
»> Button().click()
I was clicked
Вместо ключевых слов extends и implements, используемых в Java, в
языке Kotlin используется двоеточие после имени класса. Как в Java, класс
может реализовать столько интерфейсов, сколько потребуется, но насле­
довать только один класс.
4.1. Создание иерархий классов ❖
99
Модификатор overrid e, похожий на аннотацию ©Override в Java, ис­
пользуется для определения методов и свойств, которые переопределяют
соответствующие методы и свойства суперкласса или интерфейса. В от­
личие от Java, в языке Kotlin применение модификатора overrid e обяза­
тельно. Это избавит вас от случайного переопределения метода, если он
будет добавлен в базовый класс после написания реализации: ваш код не
будет компилироваться, пока вы явно не добавите модификатор o v errid e
в объявление метода или не переименуете его.
Метод интерфейса может иметь реализацию по умолчанию. В отличие
от Java 8, где эти реализации должны объявляться с ключевым словом
d e fa u lt, в языке Kotlin нет специальной аннотации для таких методов:
достаточно просто написать тело метода. Давайте изменим интерфейс
C lick ab le, добавив метод с реализацией по умолчанию.
Листинг 4.3. Определение метода с телом в интерфейсе
interface Clickable {
I Обычноеобъявление
fun click()
< н мяВДа
fun showOff() = p rin tln ("I’m clickable!") <H Методсреализацией
}
I поумолчанию
При реализации этого интерфейса вам придется определить только
реализацию метода c lic k . Вы можете переопределить поведение метода
showOf f - или оставить поведение по умолчанию.
Теперь предположим, что другой интерфейс также определяет метод
showOf f со следующей реализацией.
Листинг 4.4. Другой интерфейс, реализующий тот же метод
interface Focusable {
fun setFocus(b: Boolean) =
p rin tln ("I $ {if (b) "got" else "lo st"} focus.")
fun showOffQ = println("I'm focusable!")
Что случится, если потребуется реализовать оба интерфейса в одном
классе? Оба включают метод showOf f с реализацией по умолчанию; какая
реализация будет выбрана? Ни одна из них. Если вы явно не реализуете
своего метода showOf f , компилятор сообщит об ошибке:
The class 'Button' must
override public open fun showOff() because i t inherits
many implementations of it .
вынуждает вас предоставить собственную
цию.
100 ❖
Глава 4. Классы, объекты и интерфейсы
Листинг 4.5. Вызов метода интерфейса с реализацией по умолчанию
class Button : Clickable, Focusable {
override fun clickQ = p rin tln ("I was clicked")
J
override fun showOffQ {
super<Clickable>.sbowOffQ
super<Focusable>. showOffQ
Bbi должны явно реализовать метод, если
наследуется несколько его реализаций
Ключевое слово «super» с именем супертипа в угловых
скобках определяет родителя, чей метод будет вызван
}
}
Теперь класс Button реализует два интерфейса. В реализации мето­
да showOf f вызываются обе реализации, унаследованные от супертипов.
Для вызова унаследованной реализации используется то же ключевое
слово, что и в Java: super. Но синтаксис выбора конкретной реализации
отличается. Если в Java имя базового типа указывается перед ключевым
словом, как в выражении C lic k a b le . su p er. showOffQ, то в Kotlin имя ба­
зового типа должно указываться в угловых скобках: super<C lickable>.
showOf f С).
Если требуется вызвать лишь одну унаследованную реализацию, это
можно оформить так:
override fun showOff() = super<Clickable>.showOff()
Попробуйте создать экземпляр этого класса и убедиться, что все насле­
дуемые методы доступны для вызова.
fun main(args: Array<String>) {
val button = Button()
button.showOff()
button.setFocus(true)
О— I got focus.
button. click()
О— Iwasclicked.
}
Реализация метода setF ocus объявлена в интерфейсе Focusable и авто­
матически наследуется классом Button.
Реализация интерфейсов с телами методов в Java
Версия Kotlin 1.0 разрабатывалась с прицелом на совместимость с Java 6, которая не
поддерживает реализацию методов по умолчанию в интерфейсах. Поэтому каждый ин­
терфейс с методами по умолчанию компилируется как сочетание обычного интерфейса
и класса с реализацией в виде статического метода. Интерфейс содержит только объ­
явления, а класс - все реализациями методов. Поэтому, если понадобится реализовать
такой интерфейс в Java-классе, вам придется добавить собственные реализации всех
методов, в том числе тех, для которых в Kotlin определено тело метода.
4.1. Создание иерархий классов ❖
101
Теперь, когда вы узнали, как Kotlin позволяет реализовать методы в ин­
терфейсах, посмотрим на вторую часть этой истории: переопределение
членов базовых классов.
4.1.2. Модификаторы open, final и abstract:
по умолчанию final
Как вы знаете, lava позволяет создавать подклассы любого класса и пе­
реопределять любые методы, если они не отмечены ключевым словом
final. Часто это бывает удобно, но иногда может вызывать проблемы.
Проблема с так называемыми хрупкими базовыми классами (fragile base
class) возникает при модификации базового класса, которая может вы­
звать некорректное поведение подклассов (потому что изменившийся код
базового класса больше не соответствует ожиданиям подклассов). Если для
класса не указаны точные правила наследования - какие методы должны
переопределяться и как, - клиенты рискуют переопределить методы та­
ким способом, какого автора базовый класс не предусматривал. Посколь­
ку невозможно проанализировать все подклассы, базовый класс считается
«хрупким» в том смысле, что любое изменение в нем может привести к
неожиданным изменениям поведения в подклассах.
Для решения этой проблемы Joshua Bloch (Джошуа Блох) в своей книге
«Effective Java» (Addison-Wesley, 2008)1, одной из самых известных книг о
стиле программирования на Java, рекомендует «проектировать и докумен­
тировать наследование или запрещать его». Это означает, что все классы
и методы, которые не предназначены для переопределения в подклассах,
должны снабжаться модификатором final.
Kotlin тоже придерживается этой философии. В Java все классы и методы
открыты по умолчанию, а в Kotlin они по умолчанию отмечены модифи­
катором final.
Если вы хотите разрешить наследовать свой класс, объявите его откры­
тым, добавив модификатор open. Вам также понадобится добавить моди­
фикатор open ко всем свойствам и методам, которые могут быть переоп­
ределены.
Листинг4.6. Объявление открытого класса с открытым методом
open class RichButton : Clickable {
fun
disableQ {}
open fun animate() {}
override fun clickQ {}
J
Это открытый класс: другие могут наследовать его
Bra закрытая функция: ее невозможно
переопределить в подклассе
<H Этооткрытаяфункция: ееможно
| переопределитьвподклассе
О— Переопределениеоткрытойфункциитакжеявляетсяоткрытым
1 Блох Д.,Java.Эффективное программирование, ISBN: 978-5-85582-347-9,Лори (2013).-П р и м . ред.
102
❖
Глава 4. Классы, объекты и интерфейсы
Обратите внимание, что если переопределить метод базового класса
или интерфейса, эта версия метода также будет открытой. Чтобы запре­
тить переопределение вашей реализации в подклассах, добавьте в объяв­
ление переопределяющей версии модификатор final.
Листинг 4.7. Запрет переопределения
open class RichButton : Clickable Г
final override fun click() {}
w и
J
i Ключевоеслово«final»здесьнелишнее, потому
««модификатор «override»без«final»означав,
vj— iijoмеуодостанетсяоткрытым
Открытые классы иумное приведение типов
Одно из основных преимуществ классов, закрытых по умолчанию: они позволяют вы­
полнять автоматическое приведение типов в большем количестве сценариев. Как уже
упоминалось в разделе 2.3.5, автоматическое приведение возможно только для пере­
менных, которые нельзя изменить после проверки типа. Для класса это означает, что
автоматическое приведение типа может применяться только к неизменяемым свойствам
с модификатором v a i со стандартным методом доступа. Из этого следует, что свойство
должно быть final - иначе подкласс сможет переопределить свойство и определить
собственный метод доступа, нарушая основное требование автоматического приведе­
ния типов. Поскольку по умолчанию свойства получают модификатор fin a l, автомати­
ческое приведение работает с большинством свойств в вашем коде, что повышает его
выразительность.
Как в Java, в Kotlin класс можно объявить абстрактным, добавив ключе­
вое слово a b stra ct, и создать экземпляр такого класса будет невозможно.
Абстрактный класс обычно содержит абстрактные методы без реализации,
которые должны быть переопределены в подклассах. Абстрактные мето­
ды всегда открыты, поэтому не требуется явно использовать модификатор
open. Вот пример такого класса.
Листинг4.8. Объявление абстрактного класса
abstract class Animated {
<1
abstract fun animate()
open fun stopAnimating() {
}
fun animateTwice() {
}
Этоабстрактныйкласс: нельзя
создатьегоэкземпляр
0~| Этоабстрактнаяфункция: онанеимеетреализации
I идолжнабытьпереопределенавподклассах
Конкретныефункциивабстрактных
классахпоумолчаниюзакрыты, но
ихможновделатьоткрытыми
4.1. Создание иерархий классов ♦
103
В табл. 4.1 перечислены модификаторы доступа, поддерживаемые в
языке Kotlin. Комментарии в таблице также относятся к модификаторам
классов; в интерфейсах ключевые слова final, open и a b stra ct не исполь­
зуются. Все методы в интерфейсе по умолчанию снабжены модификато­
ром open; вы не сможете объявить их закрытыми (final). В отсутствие реа­
лизации метод будет считаться абстрактным, а ключевое слово a b stra ct
можно опустить.
Таблица 4.1. Значение модификаторов доступа в классе
Модификатор
Соответствующий член
Комментарии
final
He может быть переопределен
Применяется кчленам класса по умолчанию
open
Может быть переопределен
Должен указываться явно
abstract
Должен быть переопределен
Используется только в абстрактных классах;
абстрактные методы не могут иметь реализацию
o v e r r id e
Переопределяет метод
суперкласса или интерфейса
По умолчанию переопределяющий метод открыт,
если только не объявлен какfinal
Обсудив модификаторы, управляющие наследованием, перейдем к дру­
гому типу модификаторов: модификаторам видимости.
4.1.3. Модификаторы видимости: по умолчанию public
Модификаторы видимости помогают контролировать доступность объ­
явлений в коде. Ограничивая видимость деталей реализации класса, мож­
но гарантировать возможность их изменения без риска поломки кода, за­
висящего от класса.
По сути, модификаторы видимости в Kotlin похожи на аналогичные
модификаторы в Java. Здесь используются те же ключевые слова: p u b lic,
p ro tected и p r iv a te . Отличается лишь видимость по умолчанию: отсутст­
вие модификатора в объявлении предполагает модификатор p u b lic.
Область видимости в Java по умолчанию ограничивается рамками паке­
та. В Kotlin такой модификатор видимости отсутствует: пакеты использу­
ются только для организации кода в пространства имен, но не для управ­
ления видимостью.
В качестве альтернативы Kotlin предлагает новый модификатор види­
мости in te r n a l, обозначающий «видимость в границах модуля». Модуль это набор файлов, компилируемых вместе. Это может быть модуль IntelliJ
IDEA, проект Eclipse, Maven или Gradle, или набор файлов, компилируемых
заданием Ant.
Преимущество видимости in te r n a l в том, что она обеспечивает настоя­
щую инкапсуляцию деталей реализации модуля. В Java инкапсуляцию лег­
ко нарушить: автору стороннего кода достаточно определить классы в тех
104 ❖
Глава 4. Классы, объекты и интерфейсы
же пакетах, что и в вашем коде, - и он получит доступ к вашим объявлени­
ям из области видимости пакета.
Ещё одно отличие: Kotlin позволяет приметить модификатор p r iv a te
к объявлениям верхнего уровня, в том числе к классам, функциям и свой­
ствам. Такие объявления видны только в файле, где они определены. Это
ещё один полезный способ сокрытия деталей реализации подсистемы.
В табл. 4.2 перечислены все модификаторы видимости.
Таблица 4.2. Модификаторы видимости в Kotlin
Модификатор
Член класса
Объявление верхнегоуровня
public (по умолчанию)
Доступен повсюду
Доступно повсюду
in tern a l
Доступен только в модуле
Доступно в модуле
protected
Доступен в подклассах
—
p rivate
Доступен в классе
Доступно в файле
Рассмотрим пример. Каждая строка в функции giveSpeech при выпол­
нении нарушала бы правила видимости. Она компилируется с ошибкой.
internal open class TalkativeButton : Focusable {
private fun y e ll() = println("Hey!")
protected fun whisper() = println("Let’ s ta lk !")
}
I Ошибка: «публичный» член класса раскрывает
fun TalkativeButton.giveSpeech() {
< н «внутренний»тип-приемник «TalkativeButton»
О
w n is p e rQ
}
Ошибка: функция «yell» недоступна;
о —I Qmii0K3* функция «whisper» недоступна! I в классе «TalkativeButton» она объявлена
I в классе «TalkativeButton» она объявлена с модификатором «private»
с модификатором «protected»
Kotlin запрещает ссылаться из публичной функции giveSpeech на тип
T alkativeB utton с более узкой областью видимости (в данном случае
in te r n a l). Это лишь частный случай общего правила, которое требует,
чтобы все классы в списке базовых и параметризованных типов класса
или в сигнатурах методов имели такую же или более широкую область
видимости, как сам класс или метод. Это правило гарантирует, что у вас
всегда будет доступ ко всем типам, нужным для вызова функции или на­
следования класса.
Чтобы исправить проблему в примере выше, можно объявить функцию
как in te r n a l или сделать класс публичным, убрав модификатор in te r n a l.
Обратите внимание на разницу в поведении модификатора p ro tected
в Java и в Kotlin. В Java член класса с модификатором p ro tec te d доступен
во всем пакете - но Kotlin такого не позволяет. В Kotlin правила видимо­
сти проще: член класса с модификатором p ro tected доступен только в
самом классе и его подклассах. Также заметьте, что функции-расширения
4.1. Создание иерархий классов ❖
105
класса не могут обращаться к его членам с модификаторами p ro tected
или p r iv a te .
Модификаторы видимости Kotlin и Java
Когда код на Kotlin компилируется в байт-код Java, модификаторы p u b lic,
p ro tected и p r iv a te сохраняются. Вы можете использовать такие объявления
Kotlin в коде на Java, как если бы они изначально были объявлены с такой же обла­
стью видимости в Java. Единственное исключение - класс с модификатором p rivate:
он будет скомпилирован с областью видимости пакета (в Java нельзя сделать класс
приватным).
Но что произойдет с модификатором in tern al? В Java отсутствует прямой аналог.
Область видимости пакета - совершенно иное дело: обычно модуль состоит из несколь­
ких пакетов, и разные модули могут содержать объявления из одного пакета. Поэтому
модификатор in te r n a l в байт-коде превратится в public.
Такое соответствие между объявлениями в Kotlin и их аналогами в Java (точнее, их
представлением на уровне байт-кода) объясняет, почему из Java-кода иногда можно вы­
звать что-то, что нельзя вызвать из Kotlin. Например, в Java-коде можно получить доступ
к классу с модификатором in te r n a l или объявлению верхнего уровня из другого мо­
дуля, или получить доступ к защищенному ( p r o te c te d ) члену класса в том же пакете
(как разрешают правила доступа Java).
Но имейте в виду, что компилятор добавляет к именам членов класса с модификатором
in te r n a l специальные суффиксы. Технически такие элементы можно использовать в
коде Java, но это будет выглядеть некрасиво. В Kotlin это помогает избежать неожидан­
ных конфликтов при переопределении, когда наследуемый класс находится в другом
модуле, а также предотвращает случайное использование внутренних классов.
Еще одно отличие в правилах видимости между Kotlin и Java: в Kotlin
внешний класс не видит приватных членов внутренних (вложенных) клас­
сов. Давайте поговорим о внутренних и вложенных классах Kotlin и рас­
смотрим пример в следующей главе.
4.1.4. Внутренние и вложенные классы:
по умолчанию вложенные
И в Java, и в Kotlin можно объявить один класс внутри другого класса.
Это полезно для сокрытия вспомогательного класса или размещения кода
ближе к месту его использования. Разница в том, что в Kotlin вложенные
классы не имеют доступа к экземпляру внешнего класса, если не запро­
сить его явно. Давайте посмотрим на примере, почему это важно.
Представьте, что нам нужно определить видимый элемент (View), со­
стояние которого может быть сериализовано. Сериализовать такой эле­
мент часто очень сложно, но можно скопировать все необходимые дан-
106
❖
Глава 4. Классы, объекты и интерфейсы
ные в другой вспомогательный класс. Для этого мы объявим интерфейс
S ta te, наследующий S e r ia liz a b le . В интерфейсе View имеются методы
getC u rren tS tate и r e sto r e S ta te для сохранения состояния элемента.
Листинг 4.9. Объявление видимого элемента с сериализуемым состоянием
interface State: Serializable
interface View {
fun getCurrentState(): State
fun restoreState(state: State) {}
}
Было бы удобно определить класс, который будет хранить состояние
кнопки в классе Button. Давайте посмотрим, как это можно сделать в Java
(а аналогичный код Kotlin покажем чуть позже).
Листинг 4.10. Реализация интерфейса View в Java с помощью внутреннего класса
/* Java */
public class Button implements View {
©Override
public State getCurrentState() {
return new ButtonState();
}
©Override
public void restoreState(State state) { /*...*/ }
public class ButtonState implements State { /*...*/ }
>
Мы определили класс B uttonState, который реализует интерфейс S ta te
и хранит состояние Button. Теперь в методе getC u rren tS tate создаем но­
вый экземпляр этого класса. В реальном коде мы бы инициализировали
B uttonState со всеми необходимыми данными.
Что не так с этим кодом? Почему при попытке сериализовать состояние
кнопки возникает исключение ja v a . i o . N o tS e ria liz a b le E x c ep tio n : But­
ton? На первый взгляд это может показаться странным: сериализуемая
переменная имеет тип B uttonState, а не Button.
Все станет на свои места, если вспомнить, что когда в Java один класс
объявляется внутри другого, он по умолчанию становится внутренним
классом. В данном случае класс B uttonState будет неявно хранить ссылку
на внешний класс Button. Это объясняет, почему B uttonState не может
4.1. Создание иерархий классов ❖
107
быть сериализован: класс Button не сериализуется, а ссылка на него пре­
пятствует сериализации B uttonState.
Чтобы устранить эту проблему, нужно сделать класс B uttonState ста­
тическим, добавив модификатор s t a t ic . Объявление вложенного класса
статическим удаляет неявную ссылку на внешний класс.
В Kotlin поведение внутренних классов по умолчанию противоположно,
как показано далее.
Листинг 4.11. Реализация интерфейса View в Kotlin с помощью вложенного класса
class Button : View {
override fun getCurrentState(): State = ButtonState()
override fun restoreState(state: State) { /* ...* / }
Этоаналогстатического
вложенногоклассавJava
class ButtonState : State { /* ...* / }
}
В Kotlin вложенный класс без модификаторов — это полный аналог ста­
тического вложенного класса в Java. Чтобы превратить его во внутренний
класс со ссылкой на внешний класс, нужно добавить модификатор inner.
В табл. 4.3 описаны различия между Java и Kotlin, а разница между вложен­
ными и внутренними классами проиллюстрирована на рис. 4.1.
Таблица 4.3. Соответствие между внутренними и вложенными классами в Java и Kotlin
КлассА, объявленный внутри другого класса В
ВKotlin
Вложенный класс (не содержит ссылки на внешний класс)
class А
Внутренний класс (содержит ссылку на внешний класс)
inner class А
class Outer
inner class Inner
thisQOuter ------
Рис.4.1. Во вложенных классах, в отличие от внутренних,
отсутствует ссылка на внешний класс
Синтаксис обращения к внешнему классу из внутреннего в Kotlin также
отличается от Java. Чтобы получить доступ к классу Outer из класса Inner,
нужно написать this@Outer.
class Outer {
inner class Inner {
fun getOuterReference(): Outer = thisgOuter
}
}
108 ♦> Глава 4. Классы, объекты и интерфейсы
Теперь вы знаете разницу между внутренними и вложенными класса­
ми в Java и Kotlin. Давайте рассмотрим еще один случай, когда вложенные
классы могут пригодиться в Kotlin: создание иерархии с ограниченным
числом классов.
4.1.5. Запечатанные классы: определение жестко заданных
иерархий
Вспомните пример иерархии классов для представления выражений из
раздела 2.3.5. Суперкласс Ехрг имеет два подкласса: Num, представляющий
число, и Sum, представляющий сумму двух выражений. Все возможные
подклассы удобно обрабатывать с помощью выражения when. Но при этом
необходимо предусмотреть ветку e ls e , чтобы определить развитие собы­
тий, если не будет выбрана ни одна из других веток:
Листинг 4.12. Реализация выражения как интерфейса
interface Ехрг
class Num(val value: Int) : Ехрг
class Sum(val left: Expr, val right: Expr) : Expr
fun eval(e: Expr): Int =
when (e) {
is Num -> e.value
is Sum -> eval(e.right) + eval(e.left)
else ->
throw IllegalArgumentException("Unknown expression")
}
При вычислении выражения с использованием конструкции when ком­
пилятор Kotlin вынуждает добавить ветку, выполняемую по умолчанию.
В этом примере невозможно вернуть что-либо осмысленное, поэтому ге­
нерируется исключение.
Необходимость добавления ветки, выполняемой по умолчанию, может
вызывать неудобства. Более того, если позднее добавить новый подкласс,
компилятор не поймет, что что-то изменилось. Если забыть добавить но­
вую ветку, будет выбрана ветка по умолчанию, что может привести к труд­
но диагностируемым ошибкам.
Kotlin решает эту проблему с помощью запечатанных (sea led ) классов.
Достаточно добавить модификатор se a le d в объявление суперкласса, и
он ограничит возможность создания подклассов. Все прямые подклассы
должны быть вложены в суперкласс:
4.1. Создание иерархий классов ❖
109
Листинг 4.13. Выражения в виде запечатанных классов
sealed class Expr {
О— Представлениевыраженийзапечатаннымиклассами...
class Num(val value: Int) : Expr()
I ...иперечислитьвсевозможные
class Sum(val left: Expr, val right: Expr) : ExprQ <]_I подклассыввидевложенныхклассов.
}
fun eval(e: Expr): Int =
when (e) {
<
is Expr.Num -> e.value
is Expr.Sum -> eval(e.right) + eval(e.left)
}
Выражение«when»охватываетвсевозможные
варианты, поэтомуветка«else»ненужна.
При обработке всех подклассов запечатанного класса в выражении when
нет необходимости в ветке по умолчанию. Обратите внимание: модифи­
катор se a le d означает, что класс по умолчанию открыт, добавлять моди­
фикатор open не требуется. Поведение запечатанных классов показано на
рис. 4.2.
Рис. 4.2. Запечатанный класс не может иметь наследников, объявленных вне класса
Когда выражение when используется с запечатанными классами, при до­
бавлении нового подкласса выражение when, возвращающее значение, не
скомпилируется, а сообщение об ошибке укажет, какой код нужно изме­
нить.
Внутренне класс Expr получит приватный конструктор, который можно
вызвать только внутри класса. Вы не сможете объявить запечатанный ин­
терфейс. Почему? Если бы такая возможность была, компилятор Kotlin не
смог бы гарантировать, что кто-то не реализует этого интерфейса в коде
на Java.
Примечание. В Kotlin 1.0 модификатор s e a l e d накладывает серьезные ограниче­
ния. Например, все подклассы должны быть вложенными, и подкласс не может быть
классом данных (классы данных описаны далее в этой главе). Kotlin 1.1 ослабляет эти огра­
ничения и позволяет определять подклассы запечатанных классов в любом месте в том же
файле.
Как вы помните, в Kotlin двоеточие используется для перечисления на­
следуемого класса и реализуемых интерфейсов. Давайте внимательнее
посмотрим на объявление подкласса:
110 ❖
Глава 4. Классы, объекты и интерфейсы
class Num(val value: Int) : Expr()
Этот простой пример должен быть понятен во всём, кроме назначения
скобок после имени класса Ехрг. Мы поговорим о них в следующем разде­
ле, который охватывает инициализацию классов в Kotlin.
4.2. Объявление классов с нетривиальными
конструкторами или свойствами
Как известно, в Java-классе можно объявить один или несколько конструк­
торов. Kotlin поддерживает всё то же самое, кроме одного: он различает
основной конструктор (который, как правило, является главным лаконич­
ным средством инициализации класса и объявляется вне тела класса) и
вторичный конструктор (который объявляется в теле класса). Kotlin так­
же позволяет вставлять дополнительную логику инициализации в соот­
ветствующие блоки. Сначала продемонстрируем синтаксис объявления
главного конструктора и блоков инициализации, а затем объясним, как
объявить несколько конструкторов. После этого поговорим о свойствах.
4.2.1. Инициализация классов: основной конструктор
и блоки инициализации
В главе 2 вы узнали, как объявить простой класс:
class l)ser(val nickname: String)
Как правило, все объявления, относящиеся к классу, находятся внутри
фигурных скобок. Вы можете спросить, почему объявление самого класса
не имеет фигурных скобок, а единственное объявление заключено в круг­
лые скобки? Этот блок кода, окруженный круглыми скобками, называется
основным конструктором (primary constructor). Он преследует две цели:
определение параметров конструктора и определение свойств, которые
инициализируются этими параметрами. Давайте разберемся, что здесь
происходит, и посмотрим, как выглядит явный код, который делает то же
самое:
class User constructor(_nickname: String) {
val nickname: String
in it {
nickname = nickname
< н Основнойконструктор
| соднимпараметром
О— Блокинициализации
}
}
В этом примере используются два новых ключевых слова Kotlin: con­
str u c to r и i n i t . С ключевого слова co n stru cto r начинается объявление
основного или вторичного конструктора. Ключевое слово i n i t обозначает
4.2. Объявление классов с нетривиальными конструкторами или свойствами
❖
111
начало блока инициализации. Такие блоки содержат код инициализации,
который выполняется при создании каждого экземпляра класса, и предна­
значены для использования вместе с первичными конструкторами. Блоки
инициализации приходится использовать, поскольку синтаксис первич­
ного конструктора ограничен и он не может содержать кода инициали­
зации. При желании можно объявить несколько блоков инициализации в
одном классе.
Подчеркивание в параметре конструктора _nickname поможет отличить
имя свойства от имени параметра конструктора. Можно использовать
одно имя, но в этом случае, чтобы избежать двусмысленности, присваи­
вание надо будет оформить так, как это делается в Java: t h is .nickname =
nickname.
В этом примере инициализирующий код можно совместить с объявле­
нием свойства nickname, поэтому его не нужно помещать в блок инициа­
лизации. В отсутствие аннотаций и модификаторов видимости основного
конструктора ключевое слово co n stru cto r также можно опустить. После
применения этих изменений получается следующее:
class User(_nickname: String) {
val nickname = nickname
}
J
<И
Основной конструктор
с одним параметром
Свойство инициализируется
I значением параметра
Это ещё один способ объявления того же класса. Обратите внимание,
что к параметрам основного конструктора ещё можно обращаться при
установке значений свойств в блоках инициализации.
В двух предыдущих примерах свойство объявлялось с ключевым словом
v a l в теле класса. Если свойство инициализируется соответствующим па­
раметром конструктора, код можно упростить, поставив ключевое слово
v a l перед параметром. Такое определение параметра заменит объявление
свойства в теле класса:
class User(val nickname: String)
J
ш Ь означает, что для параметра должно
быть создано соответствующее свойство
Все вышеперечисленные объявления класса User эквивалентны, но по­
следнее имеет самый лаконичный синтаксис.
Параметрам конструктора и параметрам функций можно назначать
значения по умолчанию:
class User(val nickname: String,
val isSubscribed: Boolean = true)
I Значение по умолчанию для
< H параметра конструктора
Чтобы создать экземпляр класса, нужно вызвать конструктор напрямую,
без ключевого слова new.
»> val alice = User("Alice")
»> println(alice.isSubscribed)
<•“ 1 Использует значение параметра isSubscribed
I по умолчанию, равное «true»
112 ❖
Глава 4. Классы, объекты и интерфейсы
true
»> val bob = User( "Bob", false) <H Значения параметров можно
»> println(bob. isSubscribed)
| передавать в порядке определения
false
»> val carol = User("Carol", isSubscribed = false) < H Можно явно указывать имена
» > print ln(carol. isSubscribed)
I некоторых аргументов конструктора
false
Похоже, что Алиса подписалась на рассылку автоматически, в то время
как Боб внимательно прочел условия и поменял значение параметра по
умолчанию.
Примечание. Если все параметры конструктора будут иметь значения по умолчанию, ком­
пилятор сгенерирует дополнительный конструктор без параметров, использующий все зна­
чения по умолчанию. Это упрощает использование в КоШп библиотек, которые создают
экземпляры классов с помощью конструкторов без параметров.
Если класс имеет суперкласс, основной конструктор также должен ини­
циализировать свойства, унаследованные от суперкласса. Сделать это
можно, перечислив параметры конструктора суперкласса после имени его
типа в списке базовых классов:
open class User(val nickname: String) { ... }
class TwitterUser(nickname: String) : User(nickname) { ... }
Если вообще не объявить никакого конструктора, компилятор добавит
конструктор по умолчанию, который ничего не делает:
open class Button
< Н Будет сгенерирован конструктор
| по умолчанию без аргументов
Если вы захотите унаследовать класс B u tto n в другом классе, не объ­
являя своих конструкторов, вы должны будете явно вызвать конструктор
суперкласса, даже если тот не имеет параметров:
class RadioButton: Button()
Вот зачем нужны пустые круглые скобки после имени суперкласса. Об­
ратите внимание на отличие от интерфейсов: интерфейсы не имеют кон­
структора, поэтому при реализации интерфейса никогда не приходится
добавлять круглые скобки после его имени в списке супертипов.
Если вы хотите получить гарантии того, что никакой другой код не смо­
жет создавать экземпляров вашего класса, сделайте конструктор приват­
ным с помощью ключевого слова p riv a te:
Конструктор этого
J
класса приватный
class Secretive private constructor) {}
4.2. Объявление классов с нетривиальными конструкторами или свойствами ❖
113
Поскольку класс S e c r e tiv e имеет только приватный конструктор, код
снаружи класса не сможет создать его экземпляра. Ниже мы поговорим
об объектах-компаньонах, которые способны вызывать такие конструк­
торы.
Альтернатива приватным конструкторам
ВJava можно использовать конструктор с модификатором p riv a te, чтобы запретить
создание экземпляров класса - подобные классы служат контейнерами статических
вспомогательных методов или реализуют шаблон «Одиночка» (Singleton). В Kotlin для
этих же целей используются встроенные механизмы языка. Вкачестве статических вспо­
могательных методов используются функции верхнего уровня (которые вы видели в
разделе 3.2.3). Для создания «одиночки» используется объявление объекта, которое вы
увидите в разделе 4.4.1.
В большинстве сценариев конструктор класса выглядит очень просто: он
либо не имеет параметров, либо присваивает их значения соответствую­
щим свойствам. Вот почему в языке Kotlin такой лаконичный синтаксис
определения основных конструкторов: он отлично подходит для боль­
шинства случаев. Но в жизни всё бывает сложнее, поэтому Kotlin позволяет
определить столько конструкторов, сколько потребуется. Давайте посмот­
рим, как это работает.
4.2.2. Вторичные конструкторы: различные способы
инициализации суперкласса
В целом классы с несколькими конструкторами встречаются в Kotlin
значительно реже, чем в Java. В большинстве ситуаций, когда в Java нужны
перегруженные версии конструктора, в языке Котлин можно воспользо­
ваться значениями параметров по умолчанию и синтаксисом именован­
ных аргументов.
Совет. Не объявляйте несколько дополнительных конструкторов только для определения
значений аргументов по умолчанию. Вместо этого указывайте значения по умолчанию на­
прямую.
Но иногда бывает нужно несколько конструкторов. Наиболее частая
ситуация: необходимо расширить класс фреймворка, поддерживающий
несколько конструкторов для инициализации класса различными спосо­
бами. Представьте класс View, объявленный в Java, который имеет два кон­
структора (разработчики для Android без труда узнают это определение).
Вот как выглядит аналогичное объявление в Kotlin:
114 ❖
Глава 4. Классы, объекты и интерфейсы
open class View {
constructor(ctx: Context) {
/ / некоторый код
Вторичныеконструкторы
constructor(ctx: Context, a ttr: AttributeSet) {
/ / некоторый код
Этот класс не имеет основного конструктора (это видно по отсутствию
круглых скобок после имени в определении класса), зато у него два вто­
ричных конструктора. Вторичный конструктор объявляется с помощью
ключевого слова co n stru cto r. Вы можете объявить столько вторичных
конструкторов, сколько нужно.
Чтобы расширить этот класс, объявите те же конструкторы:
class MyButton : View {
constructor(ctx: Context)
: super(ctx) {
// ...
}
Вызов конструкторов суперкласса
constructor(ctx: Context, a ttr: AttributeSet)
: super(ctx, a ttr) {
//
...
}
}
Здесь определяются два конструктора, каждый из которых вызывает
соответствующий конструктор суперкласса с помощью ключевого слова
s u p e r ( ) . Это проиллюстрировано на рис. 4.3, стрелка указывает, какому
конструктору делегируется выполнение.
Рис. 4.3. Вызов различных конструкторов суперкласса
Как в Java, в Kotlin есть возможность вызвать один конструктор класса из
другого с помощью ключевого слова t h is Q . Вот как это работает:
class MyButton : View {
constructor(ctx: Context): tbis(ctx, MY STYLE)
//
...
t
•
щ
< H Делегирует выполнение другому
I конструктору класса
4.2. Объявление классов с нетривиальными конструкторами или свойствами ❖
115
}
constructor(ctx: Context, a ttr: AttributeSet): super(ctx, a ttr) {
// ...
}
}
Мы изменили класс объекта MyButton так, что один его конструктор де­
легирует выполнение другому конструктору этого же класса (с помощью
t h is ), передавая значение параметра по умолчанию, как показано на
рис. 4.4. Второй конструктор по-прежнему вызывает super( ).
выполнение
Рис. 4.4. Делегирование выполнения конструктору того же класса
Если класс не имеет основного конструктора, каждый вторичный кон­
структор должен либо инициализировать базовый класс, либо делегиро­
вать выполнение другому конструктору. Согласно предыдущим рисункам,
каждый вторичный конструктор должен начинать цепочку вызовов, окан­
чивающуюся в конструкторе базового класса.
Совместимость с Java - основная причина применения вторичных кон­
структоров. Но возможна ещё одна ситуация: когда требуется предоста­
вить несколько способов создания экземпляров класса с разными списка­
ми параметров. Мы рассмотрим такой пример в разделе 4.4.2.
Мы обсудили порядок определения нетривиальных конструкторов. Те­
перь давайте обратим внимание на нетривиальные свойства.
4.2.3. Реализация свойств, объявленных в интерфейсах
Интерфейсы в Kotlin могут включать объявления абстрактных свойств.
Вот пример определения интерфейса с таким объявлением:
interface User {
val nickname: String
}
Классы, реализующие интерфейс User, должны предоставить способ по­
лучить значение свойства nickname. Интерфейс не определяет, как будет
доступно значение - как поле или через метод доступа. Поскольку сам ин­
терфейс не имеет состояния, то только реализующие его классы смогут
хранить соответствующее значение.
116 ♦> Глава 4. Классы, объекты и интерфейсы
Давайте рассмотрим несколько возможных реализаций этого интер­
фейса: P rivateU ser, хранящий только имя, S u b scrib in gllser, который
хранит адрес электронной почты для регистрации, и Facebookllser, гото­
вый поделиться своим идентификатором в Facebook.
Каждый из этих классов реализует абстрактное свойство интерфейса
по-своему.
Листинг 4.14. Реализация свойства интерфейса
class PrivateUser(override val nickname: String) : User <H Свойствоосновного
| конструктора
class SubscribingUser(val email: String) : User {
override val nickname: String
get() = email.substringBefore('g') ) <H Собственныйметод
}
| чтения
class FacebookUser(val accountld: In t) : User {
override val nickname = getFacebookName(accountld)
\
O—i Инициализация
| свойства
»> println(PrivateUser("test§kotlinlang.org").nickname)
testgkotlinlang.org
»> println(SubscribingUser("testgkotlinlang.org") .nickname)
test
Для описания класса P rivateU ser можно использовать лаконичный
синтаксис объявления свойства непосредственно в основном конструкто­
ре. Ключевое слово o v errid e перед ним означает, что это свойство реали­
зует абстрактное свойство интерфейса User.
В классе SubscribingU ser свойство nickname реализуется с помощью
метода доступа. У этого свойства отсутствует поле для хранения значе­
ния - есть только метод чтения, определяющий имя по адресу электрон­
ной почты.
В классе FacebookUser значение присваивают свойству nickname в коде
инициализации. Для доступа к нему используют функцию getFacebookName, которая вернёт имя пользователя Facebook по заданному идентифи­
катору (предполагается, что он определен где-то в другом месте). Вызов
такой функции — дорогостоящая операция: она должна подключаться к
Facebook для получения данных. Вот почему она вызывается лишь один
раз, на этапе инициализации.
Обратите внимание на различные реализации свойства nickname в клас­
сах SubscribingU ser и FacebookUser. Хотя они выглядят похоже, в первом
случае определен собственный метод чтения, возвращающий su b strin g Before, а во втором для свойства в классе FacebookUser предусмотрено
4.2. Объявление классов с нетривиальными конструкторами или свойствами ♦> 117
поле, которое хранит значение, вычисленное во время инициализации
класса.
Кроме абстрактных свойств, интерфейс может содержать свойства с м е­
тодами чтения и записи — при условии, что они не обращаются к полю в
памяти (такое поле потребовало бы хранения состояния в интерфейсе, что
невозможно). Рассмотрим пример:
interface User {
val email: String
val nickname: String
get() = email.substringBefore('g')
Свойствонеимеетполядляхранения
значения: результатвычисляетсяпри
каждойпопыткедоступа
}
Этот интерфейс определяет абстрактное свойство e m a il, а также свой­
ство nickname с методом доступа. Первое свойство должно быть переопре­
делено в подклассах, а второе может быть унаследовано.
В отличие от свойств, реализованных в интерфейсах, свойства, реализо­
ванные в классах, имеют полный доступ к полям, хранящим их значения.
Давайте посмотрим, как обращаться к ним из методов доступа.
4.2.4. Обращение к полю из методов доступа
Вы уже видели несколько примеров двух видов свойств: одни просто
хранят значения, а другие имеют собственные методы доступа, вычисляю­
щие значения при каждом обращении. Теперь посмотрим, как комбини­
ровать эти два вида, и реализуем свойство, хранящее значение и обладаю­
щее дополнительной логикой, выполняющейся при чтении и изменении.
Для этого нам потребуются поле для хранения значения и методы доступа.
Представим, что нам нужно организовать журналирование любых изме­
нений в данных, хранящихся в свойстве. Для этого объявим изменяемое
поле и выполним дополнительный код при каждом обращении к нему.
Листинг 4.15 [оступ к полю из метода записи
•
I*
class User(val name: String) {
var address: String = "unspecified"
set(value: String) {
printIn("""
Address was changed for $name:
"$field" -> "$ v a lu e ".trim ln d e n tQ )
fie ld = value
<H Изменение
}
I значенияполя
<H Чтениезначения
| изполя
»> val user = User("Alice")
»> user.address = "Elsenheimerstrasse 47, 80687 Muenchen"
118 ❖
Глава 4. Классы, объекты и интерфейсы
Address was changed for Alice:
"unspecified" -> "Elsenheimerstrasse 47, 80687 Muenchen".
Изменить значение свойства можно как обычно: выполнив присваива­
ние u ser , address = "новое значение", которое за кулисами вызовет
метод записи. В этом примере мы переопределили метод записи, чтобы
добавить логику журналирования (для простоты мы просто выводим со­
общение).
В теле метода записи для доступа к значению поля используется
специальный идентификатор field. В методе чтения можно только прочи­
тать значение, а в методе записи - прочитать и изменить.
Обратите внимание, что для изменяемого свойства можно переопреде­
лить только один из методов доступа. Реализация метода чтения в лис­
тинге 4.15 тривиальна и просто возвращает значение поля, так что его не
нужно переопределять.
Вы можете спросить: в чем разница между свойствами, имеющими и
не имеющими поля для хранения значений? Способ обращения к свой­
ству не зависит от наличия у него отдельного поля. Компилятор сгене­
рирует такое поле для свойства, если вы будете явно ссылаться на него
или использовать реализацию методов доступа по умолчанию. Если вы
определите собственные методы доступа, не использующие идентифика­
тора field (в методе чтения, если свойство объявлено как v a l, или в обоих
методах, если это изменяемое свойство), тогда отдельное поле не будет
сгенерировано.
Иногда нет необходимости менять стандартную реализацию методов
доступа, но требуется изменить их видимость. Давайте узнаем, как это
сделать.
4.2.5. Изменение видимости методов доступа
По умолчанию методы доступа имеют ту же видимость, что и свойство.
Но вы можете изменить её, добавив модификатор видимости перед клю­
чевыми словами g e t и s e t. Рассмотрим этот приём на примере.
Листинг 4.16. Объявление свойства с приватным методом записи
class LengthCounter {
var counter: In t = 0
private set
fun addWord(word: String) {
counter += word.length
}
}
<H Значениеэтогосвойстванельзя
I изменитьвнекласса
4.3. Методы, сгенерированные компилятором: классы данных и делегирование ❖
119
Этот класс вычисляет общую длину слов, добавляемых в него. Свойство,
хранящее общую длину, объявлено как p u b lic, потому что является ча­
стью API класса, доступного клиентам. Но мы должны гарантировать, что
оно будет изменяться только внутри класса, потому что в противном слу­
чае внешний код сможет изменить его и сохранить неверное значение.
Поэтому мы позволяем компилятору сгенерировать метод чтения с види­
мостью по умолчанию и изменяем видимость метода записи на p r iv a te .
Вот как можно использовать этот класс:
»> val lengthCounter = LengthCounter()
»> lengthCounter. addWord("Hi!")
»> println( lengtiiCounter. counter)
3
Создаем экземпляр LengthCounter и добавляем в него слово "Hi!" дли­
ной в 3 символа. Теперь свойство counter хранит значение 3.
Еще о свойствах
Далее в этой книге мы продолжим обсуждение свойств. Ниже представлен небольшой
указатель:
• Модификатор lateinit перед свойством, которое не может принимать значения
null, обеспечивает инициализацию свойства после вызова конструктора, что часто
используют некоторые фреймворки.Эта особенность рассматривается в главе 6.
• Свойства с отложенной инициализацией - часть более общего класса делегиро­
в а н н ы х свойст в (delegated properties), о которых рассказывается в главе 7.
• Для совместимости с Java-фреймворками можно использовать аннотации, имити­
рующие особенности Java в языке Kotlin. Например, аннотация <§DvmFieid перед
свойством открывает доступ к полю с модификатором public без методов досту­
па. Подробнее об аннотациях рассказывается в главе 10.
• Модификатор const делает работу с аннотациями удобнее, потому что позволяет
использовать свойство простого типа или типа String в качестве аргумента анно­
тации. Подробнее - в главе 10.
На этом мы завершим обсуждение нетривиальных конструкторов и
свойств в Kotlin. Далее вы узнаете, как понятие классов данных (data classes)
помогает сделать классы объектов-значений более дружелюбными.
4.3. Методы, сгенерированные компилятором:
классы данных и делегирование
Платформа lava определяет методы, которые должны присутствовать во
многих классах и обычно реализуются платформой автоматически - на-
120 ❖
Глава 4. Классы, объекты и интерфейсы
пример, eq u als, hashCode и to S tr in g . К счастью, Java IDE могут генериро­
вать эти методы самостоятельно, часто избавляя от необходимости писать
их вручную. Но в таком случае код вашего проекта будет полон повторяю­
щихся шаблонных фрагментов. Компилятор Kotlin помогает решить эту
проблему: он может автоматически генерировать код за кулисами, не за­
громождая файлов с исходным кодом.
Вы уже знаете, как этот механизм работает в отношении тривиальных
конструкторов и методов доступа к свойствам. Давайте рассмотрим при­
меры, когда компилятор Kotlin генерирует типичные методы для простых
классов данных и значительно упрощает делегирование.
4.3.1. Универсальные методы объектов
Как в Java, все классы в Kotlin имеют несколько методов, которые иногда
приходится переопределять: eq u als, hashCode и to S tr in g . Давайте по­
смотрим, что это за методы и как Kotlin помогает автоматически сгенери­
ровать их реализации. В качестве отправной точки возьмем простой класс
C lien t, который хранит имя клиента и почтовый индекс.
Листинг 4.17. Первоначальное определение класса Client
class Client(val name: String, val postalCode: Int)
Взглянем на строковое представление его экземпляров.
Строковое представление: метод toStringO
Все классы в Kotlin, как в Java, позволяют получить строковое представ­
ление объектов. В основном эта функция используется для отладки и жур­
налирования, но её можно применить и в других контекстах. По умолча­
нию строковое представление объекта выглядит как Client@ 5e9f 23Ъ4 - не
очень информативно. Чтобы изменить его, необходимо переопределить
метод to S tr in g .
Листинг 4.18. Реализация метода toStringO в классе Client
class Client(val name: String, val postalCode: Int) {
override fun toStringO = "Client(name=$name, postalCode=$postalCode)"
}
Вот как теперь выглядит строковое представление экземпляра:
»> val clientl = Client("Alice", 342562)
»> println(clientl)
Client(name=Alice, postalCode=342562)
He правда ли, так гораздо содержательнее?
4.3. Методы, сгенерированные компилятором: классы данных и делегирование ❖
121
Равенство объектов: метод e q u a l s ( )
Все вычисления, связанные с классом C lien t, происходят вне его. Этот
класс просто хранит данные, он должен быть простым и понятным. Одна­
ко у вас могут быть свои требования к поведению этого класса. К примеру,
вы хотите, чтобы объекты считались равными, если содержат одни и те же
11
»> val c lie n tl = Client("Alice", 342562)
»> val client2 = Client("Alice", 342562)
»> p rin tln (c lie n tl == client2)
false
ВKotlinоператор==проверяетравенство
объектов, анессылок. Онкомпилируетсяв
вызовметода«equals»
Как видите, объекты не равны. Это значит, что для класса C lie n t нужно
переопределить метод eq u als.
Оператор == и проверка на равенство
Для сравнения простых и ссылочных типов в Java можно использовать оператор ==.
Когда он применяется к простым типам, сравниваются значения, а для ссылочных типов
сравниваются указатели. В результате в Java появились широко распространенная прак­
тика всегда вызывать метод equals и распространенная проблема: это часто забывают
сделать.
В Kotlin оператор == представляет способ сравнения двух объектов по умолчанию: он
сравнивает их, вызывая за кулисами метод e q u a ls.То есть, если вы переопределили
метод equals в своем классе, можете спокойно сравнить экземпляры с помощью опе­
ратора ==.Для сравнения ссылок можно использовать оператор ===, который работает
точно как оператор == в Java, выполняя сравнение указателей.
Посмотрим, как изменится класс C lien t.
Листинг 4.19. Реализация метода equalsQ в классе Client
«Any»- этоаналогjavaJang.Object:
class Client(val name: String, val postalCode: In t) {
cвсехклассоввKotlin. Знак
суперклаkсс
override fun equals(other: Any?): Boolean {
вопросав«Апу?»означает, чтоаргумент
«other»можетиметьзначениеnull
i f (other == null || other !is Client)
return false
Убедиться, что«other*
имееттипClient
return name == other.name &&
Вернутьрезультат
postalCode == other.postalCode
ср
а
вн
е
н
и
я
св
о
й
ств
}
override fun toStringQ = “Client(name=$name, postalCode=$postalCode)”
}
Напомним, что оператор i s является аналогом in sta n c e o f в Java и про­
веряет, имеет ли значение слева тип, указанный справа. Подобно операто­
ру ! in , который возвращает инвертированный результат проверки in (об
122
❖
Глава 4. Классы, объекты и интерфейсы
этом мы рассказывали в разделе 2.4.4), оператор ! i s выражает отрицание
проверки is . Такие операторы делают код более читабельным. В главе 6
мы обсудим типы, которые могут принимать значение n u ll, и расскажем,
почему выражение oth er == n u ll 11 oth er ! i s C lien t можно упростить
до oth er ! i s C lien t.
Модификатор overrid e, ставший в Kotlin обязательным, защищает от
ошибочного объявления fun e q u a ls(o th e r : C lie n t), которое добавит но­
вый метод equals вместо переопределения имеющегося. После переопре­
деления метода equals можно ожидать, что экземпляры с одинаковыми
значениями свойств будут равны. Действительно, операция сравнения
c l i e n t l == c l ie n t 2 в предыдущем примере теперь возвращает true. Но
если вы захотите проделать с этими объектами некоторые более сложные опе­
рации, ничего не получится. Это частый вопрос на собеседовании: что не так
и в чем проблема? Вероятно, вы ответите, что проблема в отсутствии метода
hashCode. Это действительно так, и сейчас мы обсудим, почему это важно.
Контейнеры, применяющие хэш-функции: метод h a sh C o d e( )
Вместе с eq u als всегда должен переопределяться метод hashCode. В этом
разделе мы объясним, почему.
Давайте создадим множество с одним элементом: клиентом по имени
Alice. Затем создадим новый экземпляр, содержащий такие же данные, и
проверим, присутствует ли он в этом множестве. Вы, наверное, ожидаете,
что проверка вернет tru e, потому что свойства экземпляров равны, но на
самом деле она вернет f a ls e .
»> val processed = hashSetOf(Client(”Alice", 342562))
»> println(processed.contains(Client("Alice", 342562)))
false
Причина в том, что в классе C lie n t отсутствует метод hashCode. Сле­
довательно, нарушается основной контракт метода hashCode: если два
объекта равны, они должны иметь одинаковый хэш-код. Множество из
примера является экземпляром HashSet. Сравнение значений в HashSet
оптимизировано: сначала сравниваются их хэш-коды, и только если они
равны, сравниваются фактические значения. Хэш-коды двух экземпляров
класса C lien t в предыдущем примере не совпадают, поэтому множество
решает, что не содержит второго объекта, хотя метод equals будет воз­
вращать tru e. Следовательно, если правило не соблюдается, HashSet не
сможет корректно работать с такими объектами.
Чтобы исправить проблему, добавим реализацию метода hashCode.
Листинг 4.20. Реализация метода hashCodeO в классе Client
class Client(val name: String, val postalCode: In t) {
4.3. Методы, сгенерированные компилятором: классы данных и делегирование ❖
123
« I »
override fun hashCode(): In t = name.hashCode() * 31 + postalCode
}
Теперь у нас есть класс, который всегда будет работать правильно, - но
обратите внимание, сколько кода пришлось для этого написать! К счастью,
компилятор Kotlin может помочь, создав все эти методы автоматически.
Давайте посмотрим, как можно это сделать.
4.3.2. Классы данных: автоматическая генерация
универсальных методов
Чтобы класс стал максимально удобным для хранения данных, следу­
ет переопределить следующие методы: to S tr in g , eq u als и hashCode. Как
правило, эти методы имеют тривиальную реализацию, и IDE (такие как
IntelliJ IDEA) способны создавать их автоматически и проверять, что их
реализация корректна и последовательна.
Самое замечательное, что в Kotlin вам не придется создавать всех этих
методов. Добавьте в объявление класса модификатор data - и все необхо­
димые методы появятся автоматически.
Листинг 4.21. Класс C lie n t как класс данных
data class Client(val name: String, val postalCode: In t)
Как просто, не правда ли? Теперь у вас есть класс, переопределяющий
стандартные Java-методы:
О e q u a ls для сравнения экземпляров;
О hashCode для использования экземпляров в качестве ключей в кон­
тейнерах на основе хэш-функций, таких как HashMap;
О to S tr in g для создания строкового представления, показывающего
все поля в порядке их объявления.
Методы eq u als и hashCode учитывают все свойства, объявленные в ос­
новном конструкторе. Сгенерированный метод eq u als проверяет равен­
ство значений всех свойств. Метод hashCode возвращает значение, зави­
сящее от хэш-кодов всех свойств. Обратите внимание, что свойства, не
объявленные в основном конструкторе, не принимают участия в провер­
ках равенства и вычислении хэш-кода.
И это только часть полезных методов, которые автоматически создают­
ся для класса данных. В следующим разделе описан ещё один, а в разде­
ле 7.4 вы познакомитесь с оставшимися.
Классы данных и неизменяемые значения: метод с о р у ( )
Обратите внимание: даже притом, что свойства класса данных не обя­
зательно должны объявляться с модификатором v a l (можно использовать
124 ❖
Глава 4. Классы, объекты и интерфейсы
var), мы настоятельно рекомендуется использовать свойства, доступные
только для чтения, чтобы сделать экземпляры класса неизменяемыми. Это
необходимо, чтобы экземпляры можно было использовать в качестве клю­
чей в HashMap или аналогичном контейнере - иначе контейнер может ока­
заться в некорректном состоянии, если объект, используемый в качестве
ключа, изменится после добавления в контейнер. Кроме того, неизменяе­
мые объекты существенно упрощают понимание кода, особенно много­
поточного: после создания объект останется в исходном состоянии, и вам
не придется беспокоиться о других потоках, способных изменить объект,
пока ваш код будет с ним работать.
Чтобы ещё упростить использование классов данных в качестве неизме­
няемых объектов, компилятор Kotlin генерирует для них метод, который
позволяет копировать экземпляры, изменяя значения некоторых свойств.
Как правило, создание копии - хорошая альтернатива модификации эк­
земпляра на месте: копия имеет собственный жизненный цикл и не влия­
ет на код, ссылающийся на исходный экземпляр. Вот как выглядел бы м е­
тод копирования, реализуй вы его без компилятора:
class Client(val паше: String, val postalCode: In t) {
•
I t
fun copy(name: String = this.name,
postalCode: In t = this.postalCode) =
Client(name, postalCode)
}
А так его можно использовать:
>» val bob = Client(“Bob", 973293)
»> println(bob.copy(postalCode = 382555))
Client(name=Bob, postalCode=382555)
классы
нее в использовании. Теперь давайте поговорим о другой особенности
Kotlin, которая позволяет избавиться от шаблонного кода, сгенерирован­
ного IDE в делегировании.
4.3.3. Делегирование в классах. Ключевое слово
Частая проблема при проектировании крупных объектно-ориентиро­
ванных систем - нестабильность из-за наследования реализации. Когда
вы наследуете класс и переопределяете некоторые его методы, ваш код
становится зависимым от деталей реализации наследуемого класса. Если
система продолжает развиваться - меняется реализация базового клас­
са или в него добавляют новые методы, - прежние предположения о его
поведении могут оказаться неверными, и ваш код перестанет вести себя
корректно.
4.3. Методы, сгенерированные компилятором: классы данных и делегирование ❖
125
Эта проблема нашла свое отражение в дизайне языка Kotlin - все классы
по умолчанию получают модификатор final. Это гарантирует, что вы смо­
жете наследовать только те классы, для которых такая возможность преду­
смотрена. Работая над таким классом, вы будете видеть, что он открыт, и
учитывать совместимость любых изменений с производными классами.
Но часто бывает нужно добавить поведение в другой класс, даже если он
не предназначен для наследования. Для этого применяется шаблон «Де­
коратор». Он создает новый класс с тем же интерфейсом, что у оригиналь­
ного класса, и сохраняет экземпляр оригинального класса в поле нового
класса. Методы, поведение которых должно остаться неизменным, просто
передают вызовы оригинальному экземпляру класса.
Недостаток такого подхода - большой объем шаблонного кода (его так
много, что некоторые IDE, такие как IntelliJ IDEA, поддерживают специ­
альную возможность создания такого кода за вас). Например, вот сколько
кода понадобится декоратору, чтобы реализовать простой интерфейс C ol­
le c tio n - даже притом, что он не изменяет поведения исходного класса.
class DelegatingCollection<T> : Collection<T> {
private val innerList = arrayListO£<T>()
override val size: In t get() = innerList.size
override fun isEmpty(): Boolean = innerList.isEmpty()
override fun contains(element: T): Boolean = innerList.contains(element)
override fun ite ra to r(): Iterator<T> = innerList.ite ra to r()
override fun containsAll(elements: Collection<T>): Boolean =
innerList.containsAll(elements)
К счастью, при использовании Kotlin писать столько кода не нужно, по­
тому что он предоставляет полноценную поддержку делегирования на
уровне языка. Всякий раз, реализуя интерфейс, вы можете делегировать
реализацию другому объекту, добавив ключевое слово by. Вот как выгля­
дит предыдущий пример с использованием этой особенности:
class DelegatingCollection<T>(
innerList: Collection<T> = ArrayList<T>()
) : Collection<T> by innerList {}
Все реализации методов в классе исчезли. Компилятор сам сгенерирует
их, и фактическая реализация будет похожа на ту, что вы видели в примере
с D eleg a tin g C o llectio n . Поскольку такой код содержит мало интересно­
го, нет смысла писать его вручную, если компилятор может делать всё то
же самое автоматически.
Теперь, если вам понадобится изменить поведение некоторых мето­
дов, вы сможете переопределить их и вместо сгенерированных методов
вызывать ваш код. Вы можете пропустить методы, реализация которых
126 <♦ Глава 4. Классы, объекты и интерфейсы
по умолчанию устраивает вас, делегируя выполнение декорируемому
экземпляру.
Давайте посмотрим, как применить эту технику для реализации коллек­
ции, которая подсчитывает количество попыток добавления элементов в
неё. Например, если вам нужно избавляться от дублирующихся элементов,
такая коллекция позволит вам измерить, насколько эффективно вы это
делаете, сравнивая количество попыток добавления элемента с размером
коллекции.
Листинг 4.22. Делегирование
class CountingSet<T>(
val innerSet: MutableCollection<T> = HashSet<T>()
) : MutableCollection<T> by innerSet {
<H Делегированиереализации
I MutableCollectionобъектувполеinnerSet
var objectsAdded = 0
override fun add(element: T): Boolean {
objectsAdded++
return innerSet.add(element)
}
Собственнаяреализация
вместоделегирования
override fun addAll(c: Collection<T>): Boolean {
objectsAdded += c.size
return innerSet.addAlI(c)
>
>
»> val cset = CountingSet<Int>()
»> cset.addAll(listO f(l, 1, 2))
»> println("${cset.objectsAdded} objects were added, ${cset.size} remain")
3 objects were added, 2 remain
Как видите, здесь переопределяются методы add и addAlI, которые уве­
личивают значение счетчика, а реализация остальных методов интерфей­
са M utableC ollection делегируется декорируемому контейнеру.
Самое важное, что этот прием не создает зависимости от особенностей
реализации основной коллекции. Например, нет необходимости беспо­
коиться, как коллекция реализует метод addAl I - путем вызова метода
add в цикле или используя другую реализацию, оптимизированную для
конкретного случая. Когда клиентский код обращается к вашему классу,
вы полностью контролируете происходящее, можете опираться на доку­
ментацию API декорируемой коллекции для реализации своих операций
и рассчитывать, что всё продолжит работать.
4.4. Ключевое слово object: совместное объявление класса и его экземпляра ❖
127
Мы закончили обсуждение способности компилятора Kotlin генериро­
вать полезные методы для классов. Давайте перейдем к заключительной
части в повествовании о классах Kotlin: к ключевому слову ob j e c t и раз­
личным ситуациям, когда оно вступает в игру.
4.4. Ключевое слово object: совместное
объявление класса и его экземпляра
Ключевое слово ob j e c t используется в языке Kotlin в разных случаях, ко­
торые объединены общей идеей: это ключевое слово одновременно объ­
являет класс и создает его экземпляр (другими словами, объект). Рассмот­
рим различные ситуации, когда оно используется:
О объявление объекта как способ реализации шаблона «Одиночка»;
О реализация объекта-компаньона, содержащего лишь фабричные м е­
тоды, а также методы, связанные с классом, но не требующие обра­
щения к его экземпляру. К членам такого объекта можно обращаться
просто по имени класса;
О запись объекта-выражения, которое используется вместо анонимно­
го внутреннего класса Java.
Теперь обсудим все это подробнее.
4.4.1. Объявление объекта: простая реализация
шаблона «Одиночка»
Часто в объектно-ориентированных системах встречается класс, кото­
рый должен существовать только в одном экземпляре. В Java это реализу­
ется с помощью шаблона «Одиночка»: вы определяете класс с приватным
конструктором и статическим полем, содержащим единственный сущест­
вующий экземпляр этого класса.
Kotlin обеспечивает поддержку такого решения на уровне языка, пред­
лагая синтаксис объявления объекта. Объявление объекта сочетает в себе
объявление класса и единственного экземпляра этого класса. Например,
можно объявить объект, который представляет фонд заработной платы
организации. Наверняка у вас нет нескольких фондов, поэтому использо­
вание одного объекта представляется разумным:
object Payroll {
val allEmployees = arrayListOf<Person>()
fun calculateSalary() {
for (person in allEmployees) {
• « I
}
128 ❖
Глава 4. Классы, объекты и интерфейсы
Объявление объекта начинается с ключевого слова ob j e c t и фактически
определяет класс с переменной этого класса в одном выражении.
По аналогии с классом объявление объекта может содержать определе­
ния свойств, методов, блоков инициализации и т. д. Единственное, что не
допускается, - конструкторы, основные или вторичные. В отличие от эк­
земпляров обычных классов, объявления объектов создаются непосред­
ственно в точке определения, а не через вызов конструктора из других
мест в коде. Следовательно, определять конструктор в объявлении объекта
не имеет смысла.
Как и обычные переменные, объявления объектов позволяют вызывать ме­
тоды и обращаться к свойствам с помощью имени объекта слева от символа .:
Payroll.allEmployees.add(Person(...))
Payroll.calculateSalary()
Объявления объектов также могут наследовать классы и интерфейсы.
Это бывает полезно, когда используемый фреймворк требует реализации
интерфейса, но в вашей реализации нет нужного состояния. Например,
рассмотрим интерфейс java.u til.C om p arator в lava. Экземпляр Com­
parator принимает два объекта и возвращает целое число, указывающее,
какой из объектов больше. Такой компаратор никогда не хранит данных,
поэтому для каждого конкретного способа сравнения объектов достаточ­
но одного компаратора. Это идеальный случай для использования объяв­
ления объекта.
В качестве конкретного примера давайте реализуем компаратор, срав­
нивающий пути к файлам без учета регистра.
Листинг 4.23. Реализация интерфейса Comparator с помощью объявления объекта
object CaselnsensitiveFileComparator : Comparator<File> {
override fun compare(filel: File, file 2 : File): In t {
return filel.path.compareTo(file2.path,
ignoreCase = true)
}
}
»> println(CaseInsensitiveFileComparator.compare(
... FileC'/User"), File("/user")))
0
Объект-одиночку можно использовать в любом контексте, где использу­
ется обычный объект (экземпляр класса), - например, передать этот объ­
ект в качестве аргумента функции, принимающей экземпляр Comparator:
4.4. Ключевое слово object: совместное объявление класса и его экземпляра ❖
129
»> val file s = listO f(F ile ("/Z "), F ile("/a"))
»> println(files.sortedWitb(CaseInsensitiveFileComparator))
[/a, /Z]
Объекты-одиночки и внедрение зависимостей
Как и шаблон «Одиночка», объявления объектов не всегда пригодны для использования
в больших программных системах. Они прекрасно подходят для небольших модулей с
малым количеством зависимостей или вообще без них, но не для крупных компонентов,
взаимодействующих с другими частями системы. Основная причина - в отсутствии конт­
роля над созданием объектов и невозможности управлять параметрами конструкторов.
Это означает, что в модульных тестах или в разных конфигурациях системы нет воз­
можности заменить реализацию объекта или других классов, зависящих от него. Если
вам нужна такая функциональность, наряду с обычными классами Kotlin вы должны
использовать библиотеку для внедрения зависимостей (например, Guice,h t t p s : / /
g i t h u b . c o m /g o o g le /g u ic e ). как в Java.
Объекты также можно объявлять в классах. Такие объекты существуют
в единственном числе - у вас не будет отдельного объекта для каждого эк­
земпляра содержащего его класса. Например, логично разместить компа­
ратор, сравнивающий объекты определенного класса, внутри этого класса.
Листинг 4.24. Реализация интерфейса Comparator как вложенного объекта
data class Person(val name: String) {
object NameComparator : Comparator<Person> {
override fun compare(pl: Person, p2: Person): In t =
p i.name.compareTo(p2.name)
}
}
»> val persons = listOf(Person("Bob"), Person("Alice"))
»> println(persons. sortedWith( Person. NameComparator))
[Person(name=Alice), Person(name=Bob)]
Объекты-одиночки Kotlin в Java
Объявление объекта в Kotlin компилируется в класс со статическим полем, хранящим
его единственный экземпляр, который всегда называется INSTANCE. Реализуя шаблон
«Одиночка» в Java, вы наверняка сделали бы то же самое вручную. Поэтому, чтобы исполь­
зовать объект Kotlin из Java-кода, нужно обращаться к статическому полю экземпляра:
/* Java * /
CaselnsensitiveFileComparator.INSTANCE.compare(filel, file 2 );
ВЭТОМпримере поле INSTANCE имеет ТИПCaselnsensitiveFileCom parator.
130 ❖
Глава 4. Классы, объекты и интерфейсы
А сейчас рассмотрим особую категорию объектов, хранящихся внутри
класса: о б ъ е к т ы - к о м п а н ь о н ы .
4.4.2. Объекты-компаньоны: место для фабричных
методов и статических членов класса
Классы в Kotlin не могут иметь статических членов; ключевое слово
s t a t ic , имеющееся в Java, не является частью языка Kotlin. В качестве за­
мены Kotlin используются функции уровня пакета (которые во многих си­
туациях могут заменить статические методы Java) и объявления объектов
(которые заменяют статические методы Java в других случаях, наряду со
статическими полями). В большинстве случаев рекомендуется использо­
вать функции верхнего уровня. Но, как видно на рис. 4.5, такие функции
не имеют доступа к приватным членам класса. Поэтому, чтобы написать
функцию, которую можно вызывать без экземпляра класса, но с доступом
к внутреннему устройству класса, вы можете сделать её членом объявле­
ния объекта внутри класса. Примером такой функции может служить фаб­
ричный метод.
Может
вызвал»foo
iHeможет
вызвать foo
I
Рис. 4.5. Функции верхнего уровня не имеют доступа
к приватным членам класса
Один из объектов в классе можно отметить специальным ключевым
словом: companion. Сделав это, вы сможете обращаться к методам и свой­
ствам такого объекта непосредственно через имя содержащего его класса,
без явного указания имени объекта. В итоге синтаксис выглядит почти так
же, как вызов статического метода в Java. Вот простой пример такого син­
таксиса:
class А {
companion object {
fun bar() {
println("Companion object called")
}
}
}
»> A.barQ
Companion object called
4.4. Ключевое слово object: совместное объявление класса и его экземпляра ❖
131
Помните, мы обещали показать хороший пример вызова приватного
конструктора? Это объект-компаньон. Он имеет доступ ко всем приватным
членам класса и идеально подходит для реализации шаблона «Фабрика».
Давайте рассмотрим пример с объявлением двух конструкторов, а затем
изменим его, чтобы он использовал фабричные методы в объекте-компаньоне. За основу возьмем листинг 4.14 с классами FacebookUser и
SubscribingUser. Ранее эти сущности представляли разные классы, реа­
лизующие общий интерфейс User. Теперь мы решили использовать толь­
ко один класс, но разные способы его создания.
Листинг 4.25. Определение класса с несколькими вторичными конструкторами
class User {
val nickname: String
constructor(email: String) {
nickname = email.substringBefore('@')
}
Вторичные конструкторы
constructor(facebookAccountId: In t) {
<H
nickname = getFacebookName(facebookAccountld)
}
Альтернативный способ реализации той же логики, который может
быть полезен по многим причинам, — использовать фабричные методы
для создания экземпляров класса. Экземпляр User создается вызовом
фабричного метода, а не с помощью различных конструкторов.
Листинг 4.26. Замещение вторичных конструкторов фабричными методами
class User private constructor(val nickname: String) { 0 ~ i Основной конструктор
I объявлен приватным
companion object {
<j_.
fun newSubscribingUser(email: String) =
Объявление
объекта-компаньона
User(email.substringB efore())
fun newFacebookUser(accountId: In t) = <H Фабричный метод создает нового пользователя
User(getFacebookName(accountId))
I на основе идентификатора в Facebook
}
}
Вы можете вызвать объект-компаньон через имя класса:
»> val subscribingUser = User.newSubscribingUser("bob@gmail.com")
»> val facebookUser = User.newFacebookUser(4)
»> println(subscribingUser.nickname)
bob
132 ❖
Глава 4. Классы, объекты и интерфейсы
Фабричные методы очень полезны. Как показано в примере, им можно
давать говорящие имена. Кроме того, фабричный метод может возвращать
подклассы того класса, в котором объявлен метод (как в данном примере,
где SubscribingU ser и FacebookUser - классы). Также можно запретить
создание новых объектов, когда это нужно. Например, можно проверять
соответствие адреса электронной почты уникальному экземпляру User и
возвращать существующий экземпляр, а не создавать новый, если адрес
электронной почты уже присутствует в кэше. Но если такие классы пона­
добится расширять, то использование нескольких конструкторов может
оказаться лучшим решением, поскольку объекты-компаньоны не могут
переопределяться в подклассах.
4.4.3. Объекты-компаньоны как обычные объекты
Объект-компаньон - это обычный объект, объявленный в классе. Он
может иметь имя, реализовать интерфейс или обладать функциями-рас­
ширениями и свойствами-расширениями. В этом разделе мы рассмотрим
ещё один пример.
Предположим, вы работаете над веб-службой для расчета заработной
платы предприятия и вам нужно сериализовать и десериализовать объек­
ты в формате JSON. Можно поместить логику сериализации в объект-ком­
паньон.
Листинг 4.27. Объявление именованного объекта-компаньона
class Person(val name: String) {
companion object Loader {
fun froirOSON(jsonText: String): Person = ...
}
}
»> person = Person.Loader.from]S0N("(name: 'Dmitry'}1')
» > per son. name
Dmitry
» > person2 = Person.fronOSON("(name: 'B rent'}”)
» > person2.name
Brent
Для вызова метода fromJSON
можно использовать оба
подхода
В большинстве случаев можно ссылаться на объект-компаньон через
имя содержащего его класса, поэтому не нужно беспокоиться о выбо­
ре имени для него самого, если нет необходимости (как в листинге 4.27:
companion obj ect Loader). Если имя объекта-компаньона не указано, по
умолчанию выбирается имя Companion. Вы увидите некоторые примеры
использования этого имени ниже, когда мы будет говорить о расширении
объектов-компаньонов.
4.4. Ключевое слово object: совместное объявление класса и его экземпляра ❖
133
Объекты-компаньоны и статические члены в Kotlin
Объект-компаньон класса компилируется так же, как обычный объект: статическое поле
класса ссылается на собственный экземпляр. Если объект не имеет имени, к нему можно
обратиться из Java-кода через ссылку Companion:
/* Java */
Person.Companion.fromDS0N(" ..." ) ;
Если у объекта есть имя, вместо Companion нужно использовать его.
Но вам может понадобиться работать с Java-кодом, который требует, чтобы методы
вашего класса были статическими. Для этого добавьте перед соответствующим методом
аннотацию §DvmStatic. Если понадобится объявить статическое поле, используйте ан­
нотацию gDvmField перед свойством верхнего уровня или свойством, объявленным в
объекте. Эти аннотации нужны только для совместимости и, строго говоря, не являются
частью ядра языка. Мы подробно рассмотрим их в главе 10.
Также обратите внимание, что Kotlin можете обращаться к статическим методам и по­
лям, объявленным в Java-классах, используя тот же синтаксис, что в Java.
Реализация интерфейсов в объектах-компаньонах
Как любые другие объявления объектов, объекты-компаньоны могут
реализовать интерфейсы. Как вы скоро узнаете, имя содержащего объект
класса можно использовать непосредственно, в качестве экземпляра объ­
екта, реализующего интерфейс.
Предположим, в вашей системе много типов объектов, включая Person.
Вы хотели бы обеспечить единый способ создания объектов всех типов.
Допустим, у вас есть интерфейс DSONFactory для объектов, которые можно
десериализовать из формата DSON, и все объекты в вашей системе должны
создаваться с помощью этой фабрики. Реализуйте этот интерфейс в классе
Person.
Листинг 4.28. Реализация интерфейса в объекте-компаньоне
interface JS0NFactory<T> {
fun fromDSON(jsonText: String): T
}
class Person(val name: String) {
companion object : JSONFactory<Person> {
override fun fromDSON(jsonText: String): Person = .
}
}
Объект-компаньон,
реализующий интерфейс
134 ❖
Глава 4. Классы, объекты и интерфейсы
Далее, если у вас есть функция, использующая абстрактную фабрику для
загрузки сущностей, передайте ей объект Person.
fun loadFrom]SON<T>(factory: DSONFactory<T>): T {
}
loadFromJSON(Person)
J
Передача объекта-компаньона
в функцию
Обратите внимание, что класс Person используется как экземпляр
DSONFactory.
Расширение объектов-компаньонов
Как вы видели в разделе 3.3, функции-расширения позволяют опреде­
лять, какие методы могут вызываться для экземпляров классов, опреде­
ленных в другом месте в коде. Но что, если понадобится создать функ­
цию, которую можно вызывать для самого класса так же, как методы
объектов-компаньонов или статические методы в Java? Если у класса
есть объект-компаньон, это можно сделать путем определения функциирасширения для него. Говоря более конкретно, если у класса С есть объ­
ект-компаньон и вы определили функцию-расширение fume для объекта
С. Companion, её можно вызвать как С. f unc.
К примеру, требуется обеспечить четкое разделение обязанностей в ва­
шем классе Person. Сам класс будет частью модуля основной бизнес-ло­
гики, но вы не хотите связывать этот модуль с каким-либо конкретным
форматом данных. Вследствие этого функция десериализации должна
быть определена в модуле, отвечающем за взаимодействие между клиен­
том и сервером. Добиться этого можно с помощью функции-расширения.
Обратите внимание, как имя по умолчанию (Companion) используется для
ссылки на объект-компаньон, который объявлен без имени:
Листинг 4.29. Определение функции-расширения для объекта-компаньона
/ / модуль реализации бизнес-логики
class Person(val firstName: String, val lastName: String) {
companion object {
}
}
/ / модуль реализации взаимодействий между клиентом и сервером
fun Person.Companion.fromDS0N(json: String): Person {
}
val p = Person.from]S0N(json)
4.4. Ключевое слово object: совместное объявление класса и его экземпляра ❖
135
Функцию fromDSON можно вызывать, как если бы она была определена
как метод объекта-компаньона, но на самом деле она определена вне его,
как функция-расширение. Как всегда бывает с функциями-расширения­
ми, она выглядит как член класса, но не является им. Но учтите, что в ва­
шем классе нужно объявить объект-компаньон, пусть даже пустой, чтобы
иметь возможность создать расширение для него.
Вы видели, как полезны объекты-компаньоны. Теперь давайте перей­
дем к следующей особенности языка Kotlin, реализуемой с помощью того
же ключевого слова o b ject: объектам-выражениям.
4.4.4. Объекты-выражения: другой способ реализации
анонимных внутренних классов
Ключевое слово obj e c t можно использовать не только для объявления
именованных объектов-одиночек, но и для создания анонимных объектов.
Анонимные объекты заменяют анонимные внутренние классы в lava. На­
пример, вот как перевести обычный пример использования анонимных
внутренних классов в Java - реализацию обработчика событий - на язык
Kotlin:
Листинг 4.30. Реализация обработчика событий с помощью анонимного объекта
window.addMouseListener(
J
object : MouseAdapter() {
override fun mouseClicked(e: MouseEvent) {
II ...
)
Объявление анонимного объекта,
наследующего MouseAdapter
Переопределение методов
MouseAdapter
override fun mouseEntered(e: MouseEvent) {
//
...
}
}
)
Синтаксис ничем не отличается от объявления объекта, за исключением
указания его имени (здесь оно отсутствует). Объект-выражение объявля­
ет класс и создает экземпляр этого класса, но не присваивает имени ни
классу, ни экземпляру. Как правило, в этом нет необходимости, поскольку
объект используется в качестве параметра вызова функции. Если объекту
потребуется дать имя, его можно сохранить в переменной:
val listener = object : MouseAdapter() {
override fun mouseClicked(e: MouseEvent) ( . . . )
override fun mouseEntered(e: MouseEvent) ( . . . )
)
136 ❖
Глава 4. Классы, объекты и интерфейсы
В отличие от анонимных внутренних классов Java, которые могут насле­
довать только один класс или реализовать только один интерфейс, ано­
нимный объект Kotlin может реализовывать несколько интерфейсов или
вовсе ни одного.
Примечание. В отличие от объявления объекта, анонимные объекты - не «одиночки». При
каждом выполнении объекта-выражения создается новый экземпляр объекта.
Как анонимные классы в Java, код в объекте-выражении может обра­
щаться к переменным в функциях, где он был создан. Но, в отличие от Java,
это не ограничено переменными с модификатором final; объект-выраже­
ние может также изменять значения переменных. Например, посмотрим,
как с помощью обработчика событий подсчитать количество щелчков
мышью в окне.
Листинг 4.31. Доступ к локальным переменным из анонимного объекта
fun countClicks(window: Window) {
var clickCount = 0
0 ~ | Объявление локальной
I переменной
window.addMouseListener(obj ect : MouseAdapterQ {
override fun mouseClicked(e: MouseEvent) {
clickCount++
0~i
}
Изменение значения
| переменной
})
П ...
Примечание. Объекты-выражения полезны, когда в анонимном объекте нужно переопре­
делить несколько методов. Если же требуется реализовать только один метод интерфейса
(такого как Runnable), то можно рассчитывать на поддержку в Kotlin преобразований для
интерфейсов с одним абстрактным методом (SAM conversion) - преобразование литерала
функции в реализацию интерфейса с одним абстрактным методом - и написать свою реа­
лизацию в виде литерала функции (лямбда-выражения). Мы обсудим лямбда-выражения и
SAM-преобразования более подробно в главе 5.
Мы закончили обсуждение классов, интерфейсов и объектов. В следую­
щей главе перейдем к одному из самых интересных разделов языка Kotlin:
лямбда-выражениям и функциональному программированию.
4.5. Резюме
О Интерфейсы в Kotlin похожи на интерфейсы в Java, но могут вклю­
чать свойства и реализации методов по умолчанию (это доступно в
Java только с версии 8).
4.5. Резюме ❖
137
О Всем объявлениям по умолчанию присваиваются модификаторы
final и p u b lic.
О Модификатор open отменяет действие модификатора final.
О Объявления с модификатором in te r n a l видны только в том же мо­
дуле.
О Вложенные классы по умолчанию не становятся внутренними. Что­
бы сохранить ссылку на внешний класс, используйте модификатор
inner.
О У запечатанного класса с модификатором se a le d подклассы могут
определяться только внутри него (Kotlin 1.1 позволяет располагать
такие объявления в любом месте в том же файле).
О Блоки инициализации и вторичные конструкторы дают дополни­
тельную гибкость инициализации экземпляров классов.
О Идентификатор field используется в методах доступа для ссылки на
соответствующее поле, хранящее значение.
О Для классов данных компилятор автоматически генерирует методы
eq u als, hashCode, to S tr in g , сору и др.
О Поддержка делегирования позволяет избавиться от множества деле­
гирующих методов в вашем коде.
О Объявление объекта - это способ создания «одиночки» в Kotlin.
О Объекты-компаньоны (наряду с функциями и свойствами верхнего
уровня) используются вместо статических методов и полей Java.
О Объекты-компаньоны, как и другие объекты, могут реализовать ин­
терфейсы; у них могут быть функции- и свойства-расширения.
О Объекты-выражения в Kotlin заменяют анонимные внутренние
классы в lava. Вдобавок они могут реализовать несколько интерфей­
сов и изменять значения переменных в области видимости, где были
созданы.
Лямбда-выражения
В этой главе:
■ лямбда-выражения и ссылки на члены класса;
■ работа с коллекциями в функциональном стиле;
■ последовательности: откладывание операций с коллекциями;
■ функциональные интерфейсы Java в Kotlin;
■ использование лямбда-выражений с получателями.
Лямбда-выражения - это небольшие фрагменты кода, которые можно пе­
редавать другим функциям. Благодаря поддержке лямбда-выражений вы
легко сможете выделить общий код в библиотечные функции, и стандарт­
ная библиотека Kotlin активно этим пользуется. Чаще всего лямбда-выра­
жения применяются для работы с коллекциями, и в этой главе приведено
множество примеров замены типичных шаблонов обработки коллекций
на лямбда-выражения, которые передаются функциям стандартной биб­
лиотеки. Вы также увидите, как использовать лямбда-выражения с Javaбиблиотеками - даже с теми, которые не были изначально спроектиро­
ваны для работы с ними. Наконец, мы рассмотрим лямбда-выражения с
получателями - особый вид лямбда-выражений, тело которых выполняет­
ся в другом контексте, нежели окружающий код.
5.1. Лямбда-выражения и ссылки
на члены класса
Появление лямбда-выражений в Java 8 стало одним из самых долгождан­
ных изменений в языке. Почему это так важно? В этом разделе вы узнаете,
почему лямбда-выражения так полезны и как синтаксис лямбда-выраже­
ний выглядит в Kotlin.
5.1.Лямбда-выражения и ссылки на члены класса
❖
139
5.1.1. Введение в лямбда-выражения:
фрагменты кода как параметры функций
Очень часто приходится решать задачу передачи и хранения некоторого
поведения в коде. Например, нередко требуется выразить такие идеи, как
«Когда произойдет событие, запустить этот обработчик» или «Применить
эту операцию ко всем элементам в структуре данных». В старых версиях
Java такие задачи решались с помощью анонимных внутренних классов.
Это вполне действенный прием, но он требует громоздких синтаксиче­
ских конструкций.
Функциональное программирование предлагает другой подход к реше­
нию этой проблемы: возможность использования функций в качестве зна­
чений. Вместо объявления класса и передачи его экземпляра в функцию
можно передать функцию непосредственно. С лямбда-выражениями код
становится более компактным. Вам даже не нужно объявлять функцию вместо этого можно просто передать блок кода в параметре функции.
Рассмотрим пример. Представьте, что нам нужно определить реак­
цию на нажатие кнопки. Мы добавляем обработчик, который отвечает
за обработку события щелчка и реализует соответствующий интерфейс
O nC lickL istener с единственным методом onC lick.
Листинг 5.1. Реализация обработчика событий с помощью анонимного
внутреннего класса
/* Java */
button.setOnClickListener(new OnClickListener() {
gOverride
public void onClick(View view) {
/* действия по щелчку */
}
});
Избыточность, сопутствующая объявлению анонимного внутреннего
класса, при многократном повторении начинает раздражать. Способ, по­
зволяющий выразить только то, должно быть сделано при нажатии, по­
могает избавиться от лишнего кода. В Kotlin, как и в Java 8, с этой целью
можно использовать лямбда-выражение.
Листинг 5.2. Реализация обработчика событий с помощью лямбда-выражения
button.setOnClickListener { /* действия по щелчку */ }
Этот код на Kotlin делает то же самое, что анонимный класс в Java, но
он лаконичнее и читабельнее. Мы обсудим особенности данного приме­
ра ниже.
140 ❖
Глава 5. Лямбда-выражения
Вы увидели, как лямбда-выражения могут использоваться вместо ано­
нимных объектов с единственным методом. Давайте рассмотрим еще
одну классическую область применения лямбда-выражений - операции с
коллекциями.
5.1.2. Лямбда-выражения и коллекции
Один из главных принципов хорошего стиля программирования - избе­
гать любого дублирования кода. Большинство задач, которые мы решаем,
работая с коллекциями, следует одному из хорошо известных шаблонов,
а значит, код, реализующий эти шаблоны, должен размещаться в библио­
теке. Но без лямбда-выражений сложно создать хорошую и удобную биб­
лиотеку для работы с коллекциями. Конечно, если вы писали свой код на
Java до версии 8, у вас, скорее всего, выработалась привычка делать все
самостоятельно. С приходом Kotlin эта привычка больше не нужна!
Рассмотрим пример. Здесь мы будем использовать класс Person, кото­
рый хранит информацию о человеке: его имя и возраст.
data class Person(val name: String, val age: In t)
Предположим, что нужно найти самого старого человека в представлен­
ном списке людей. Те, кто не имеют опыта работы с лямбда-выражениями,
наверняка поспешат выполнить поиск вручную: добавят две промежуточ­
ные переменные - одну для хранения максимального возраста и другую
для хранения найденного имени человека этого возраста, - а затем выпол­
нят перебор списка, обновляя эти переменные.
Листинг 5.3. Поиск в коллекции вручную
fun findTheOldest(people: List<Person>) {
var maxAge = 0
О— Хранитмаксимальныйвозраст
var theOldest: Person? = null
О— Хранитсамогостарогочеловека
for (person in people) {
i f (person, age > maxAge) {
О- | Еслиследующийстаршепредыдущего,
maxAge - person. age
| максимальныйвозрастизменится
theOldest = person
}
}
println(theOldest)
}
»> val people = listOf(Person("Alice", 29), Person("Bob", 31))
»> f indTheOldest (people)
Person(name=Bob, age=31)
При наличии опыта такие циклы можно строчить довольно быстро. Но
здесь слишком много кода и легко допустить ошибку: например, ошибить­
ся в сравнении и найти минимальный элемент вместо максимального.
5.1.Лямбда-выражения и ссылки на члены класса
141
Kotlin предлагает способ лучше: воспользоваться библиотечными функ­
циями, как показано далее.
Листинг 5.4. Поиск в коллекции с помощью лямбда-выражения
»> val people = listOf(Person("Alice", 29), Personf'Bob", 31))
»> println(people.maxBy { it.age })
Найдетэлементколлекциисмаксимальным
Person(name=Bob, age=31)
значениемсвойствааде
Функцию max By можно вызвать для любой коллекции. Она принима­
ет один аргумент: функцию, определяющую значения, которые должны
сравниваться во время поиска наибольшего элемента. Код в фигурных
скобках - { i t . age } - это лямбда-выражение, реализующее требуемую
логику. В качестве аргумента оно получает элемент коллекции (доступный
по ссылке i t ) и возвращает значение для сравнения. В данном примере
элемент коллекции - это объект Person, а значение для сравнения - воз­
раст, хранящийся в свойстве аде.
Если лямбда-выражение делегирует свою работу функции или свойству,
его можно заменить ссылкой на метод.
Листинг 5.5. Поиск с использованием ссылки на член
people.maxBy(Person::age)
Этот код делает то же самое, что и код в листинге 5.3. Подробности будут
раскрыты в разделе 5.1.5.
Большинство действий, которые обычно производятся с коллекциями
в Java до версии 8, лучше выразить с помощью библиотечных функций,
принимающих лямбда-выражения или ссылки на члены класса. Код по­
лучится короче и проще для понимания. Чтобы помочь вам освоить этот
прием, рассмотрим синтаксис лямбда-выражений.
5.1.3. Синтаксис лямбда-выражений
Как уже упоминалось, лямбда-выражение представляет небольшой
фрагмент поведения, которое можно передать как значение. Его можно
объявить отдельно и сохранить в переменной.
Параметры
Тело
Но чаще оно объявляется непосредственно при
передаче в функцию. Рисунок 5.1 демонстрирует
{ х: Int, у: Int -> X + у }
синтаксис объявления лямбда-выражения.
Лямбда-выражения в Kotlin всегда окружены
фигурными скобками. Обратите внимание на от­
Всегда в фигурных скобках
сутствие круглых скобок вокруг аргументов. Спи­
Рис. 5.1. Синтаксис
сок аргументов отделяется от тела лямбда-выра­
лямбда-выражений
жения стрелкой.
142 ❖
Глава 5. Лямбда-выражения
Лямбда-выражение можно сохранить в переменной, а затем обращаться
к ней как к обычной функции (вызывая с соответствующими аргумента­
ми):
»> val sum = { х: In t, у: In t -> х + у }
»> println(sum(l, 2))
<И Вызовлямбда-выражения,
3
I хранящегосявпеременной
При желании лямбда-выражение можно вызывать напрямую:
»> { print 1п(42) }()
42
Но такой синтаксис неудобно читать, и он не имеет особого смысла (эк­
вивалентно непосредственному выполнению тела лямбда-выражения).
Если нужно заключить фрагмент кода в блок, используйте библиотечную
функцию run, которая выполнит переданное ей лямбда-выражение:
»> run { print ln(42) }
42
О— Выполняеткодлямбда-выражения
В разделе 8.2 вы узнаете, почему такие выражения не требуют наклад­
ных расходов во время выполнения и почему они так же эффективны, как
встроенные конструкции языка. А пока давайте вернемся к листингу 5.4,
где выполняется поиск самого старого человека в списке:
»> val people = listOf(Person("Alice", 29), Person("Bob", 31))
»> println(people.maxBy { it.age })
Person(name=Bob, age=31)
Если переписать этот код без всяких синтаксических сокращений, полу­
чится следующее:
people.maxBy({ р: Person -> p.age })
Суть его понятна: фрагмент кода в фигурных скобках - это лямбда-вы­
ражение, которое передается функции в качестве аргумента. Лямбда-вы­
ражение принимает единственный аргумент типа Person и возвращает
возраст.
Но этот код избыточен. Во-первых, в нем слишком много знаков препи­
нания, что затрудняет чтение. Во-вторых, тип легко вывести из контекста,
поэтому его можно опустить. И наконец, в данном случае не обязательно
присваивать имя аргументу лямбда-выражения.
Приступим к усовершенствованию, начав с круглых скобок. Синтаксис
языка Kotlin позволяет вынести лямбда-выражение за круглые скобки,
если оно является последним аргументом вызываемой функции. В этом
примере лямбда-выражение - единственный аргумент, поэтому его мож­
но поместить после круглых скобок:
5.1.Лямбда-выражения и ссылки на члены класса
❖
143
people.maxBy() { р: Person -> p.age }
Когда лямбда-выражение является единственным аргументом функ­
ции, также можно избавиться от пустых круглых скобок:
people.maxBy { р: Person -> p.age }
Все три синтаксические формы означают одно и то же, но последняя самая читабельная. Повторим: если лямбда-выражение - единственный
аргумент, его определенно стоит писать без круглых скобок. Если есть не­
сколько аргументов, то можно подчеркнуть, что лямбда-выражение явля­
ется аргументом, оставив его внутри круглых скобок, или же поместить
его за ними - допустимы оба варианта. Если требуется передать несколько
лямбда-выражений, вы сможете вынести за скобки только одно - послед­
нее, - поэтому обычно лучше передавать их, используя обычный синтаксис.
Чтобы узнать, как эти варианты выглядят в более сложных вызовах, вер­
немся к функции joinToString, часто применявшейся в главе 3. Она так­
же определена в стандартной библиотеке Kotlin, но версия в стандартной
библиотеке принимает функцию в дополнительном параметре. Эта функ­
ция может использоваться для преобразования элемента в строку иным
способом, чем при помощи вызова toString. Вот как можно воспользо­
ваться ею, чтобы напечатать только имена.
Листинг 5.6. Передача лямбда-выражения в именованном аргументе
»> val people = listO f( Person("Alice", 29), Person("Bob", 31))
»> val names = people.joinToString(separator = " ",
transform = { p: Person -> p.name })
»> println(names)
Alice Bob
А вот как можно переписать этот вызов, поместив лямбда-выражение
за скобками.
Листинг 5.7. Передача лямбда-выражения за скобками
people.joinToString(" ") { р: Person -> p.name }
В листинге 5.6 лямбда-выражение передается в именованном аргумен­
те, чтобы прояснить цель лямбда-выражения. Листинг 5.7 короче, но тем,
кто не знаком с вызываемой функцией, будет сложнее понять, для чего
используется лямбда-выражение.
Советдля пользователей InteUil IDEA. Преобразовать одну синтаксическую форму в дру­
гую можно с помощью действий Move lambda expression out of parentheses (Вынес­
ти лямбда-выражение за скобки) и Move lambda expression into parentheses (Внести
лямбда-выражение внутрь скобок).
144 ❖
Глава 5. Лямбда-выражения
Ещё упростим синтаксис, избавившись от типа параметра.
Листинг 5.8. Удаление типа параметра
people.maxBy { р: Person -> p.age }
Типпараметрауказанявно
people.тахВу { р -> p.age }
Типпараметравыводитсяизконтекста
Так же, как в случае с локальными переменными, если тип параметра
лямбда-выражения можно вывести, его не нужно указывать явно. В функ­
ции тахВу тип параметра всегда совпадает с типом элемента коллекции.
Компилятор знает, что функция тахВу вызывается для коллекции элемен­
тов типа Person, поэтому может понять, что параметр лямбда-выражения
тоже будет иметь тип Person.
Бывают случаи, когда компилятор не в состоянии вывести тип парамет­
ра лямбда-выражения, но мы не будем обсуждать их здесь. Вот простое
правило: всегда опускайте тип, но если компилятор пожалуется, укажите
его.
Вы можете указать типы только для некоторых аргументов, оставив для
других только имена. Это может понадобиться, если компилятор не в со­
стоянии определить один из типов или когда явное указание типа улучша­
ет читабельность.
Последнее упрощение, которое можно сделать в этом примере, - заме­
на имени параметра именем по умолчанию: i t . Это имя доступно, если в
контексте ожидается лямбда-выражение только с одним аргументом и его
тип можно вывести автоматически.
Листинг 5.9. Использование имени параметра по умолчанию
people. maxBy { it . аде }
<1—«it» - автоматическисгенерированноеимяпараметра
Имя по умолчанию создается только тогда, когда имя аргумента не ука­
зано явно.
Примечание. Соглашение об имени по умолчанию i t помогает сократить объем кода, но
им не следует злоупотреблять. В частности, в случае вложенных лямбда-выражений лучше
объявлять параметры каждого лямбда-выражения явно - иначе будет трудно понять, к ка­
кому значению относится i t . Также полезно объявлять параметры явно, если значение или
тип параметра трудно понять из контекста.
Если лямбда-выражение хранится в переменной, то компилятор не
имеет контекста, из которого можно вывести тип параметра. Поэтому его
следует указать явно:
»> val getAge = { р: Person -> p.age }
»> people.maxBy(getAge)
5.1.Лямбда-выражения и ссылки на члены класса
❖
145
До сих пор вы видели примеры лямбда-выражений, состоящих из од­
ного выражения или инструкции. Но лямбда-выражения могут содержать
несколько выражений! В таком случае их результат - последнее выраже­
ние:
»> val sum = { х: In t, у: In t ->
p rin tln (“Computing the sum of $x and $ y ...”)
x+у
...
}
»> println(sum(l, 2))
Computing the sum of 1 and 2 ...
3
Далее поговорим о понятии, которое часто идет бок о бок с лямбда-вы­
ражениями: захват переменных из контекста.
5.1.4. Доступ к переменным из контекста
Как известно, когда анонимный внутренний класс объявляется внут­
ри функции, он может ссылаться на параметры и локальные перемен­
ные этой функции. В лямбда-выражениях можно делать то же самое. Если
лямбда-выражение определено в функции, оно может обращаться к её
параметрам и локальным переменным, объявленным перед лямбда-вы­
ражением.
Для демонстрации возьмем функцию f orEach из стандартной библио­
теки. Это одна из главных функций для работы с коллекциями, и она вы­
полняет заданное лямбда-выражение для каждого элемента в коллекции.
Функция f orEach лаконичнее обычного цикла fo r , но это её единственное
преимущество, поэтому не нужно спешить преобразовывать все циклы в
лямбда-выражения.
Следующий листинг принимает список сообщений и выводит каждое с
заданным префиксом.
Листинг 5.10. Использование параметров функции в лямбда-выражении
fun printMessagesWithPrefix(messages: Collection<String>, prefix: String) {
messages. f orEach {
<H Принимаетвкачествеаргументалямбда-выражение,
println("$prefix S it1') < н
| определяющее, чтоделатьскаждымэлементом
}
Обращениек параметру
}
I «prefix»излямбда-выражения
»> val errors = listO f("403 Forbidden", "404 Not Found")
»> printMessagesWithPrefix(errors, "Error:")
Error: 403 Forbidden
Error: 404 Not Found
146 ❖
Глава 5. Лямбда-выражения
Одно важное отличие Kotlin от Java состоит в том, что Kotlin не огра­
ничивается доступом только к финальным переменным. Вы можете из­
менять переменные внутри лямбда-выражений. Следующий листинг под­
считывает количество клиентских и серверных ошибок в данном наборе
кодов ответа.
Листинг 5.11. Изменение локальных переменных внутри лямбда-выражения
fun printProblemCounts(responses: Collection<String>) {
var clientErrors = 0
Объявлениепеременных, к которым
var serverErrors = 0
будетобращатьсялямбда-выражение
responses.forEach {
if (i t .startsWitb("4")) {
clientErrors++
И
зм
е
н
е
н
и
е
перем
енны
х
вн
утр
и
} else i f (it.startsW ith("5"))
лямбда-выражения
serverErrors++
}
}
println("$clientErrors client errors, SserverErrors server errors")
»> val responses = listO f("200 OK", "418 I'm a teapot",
"500 Internal Server Error")
»> printProbIemCounts(responses)
1 client errors, 1 server errors
Kotlin, в отличие от Java, позволяет обращаться к обычным, не финаль­
ным переменным (без модификатора final) и даже изменять их внутри
лямбда-выражения. Про внешние переменные prefix, c lie n tE r r o r s и
serverE rrors в этих примерах, к которым обращается лямбда-выраже­
ние, говорят, что они захватываются лямбда-выражением.
Обратите внимание, что по умолчанию время жизни локальной пере­
менной ограничено временем жизни функции, в которой она объявлена.
Но если она захвачена лямбда-выражением, использующий её код может
быть сохранен и выполнен позже. Вы можете спросить: как это работа­
ет? Когда захватывается финальная переменная, её значение сохраняется
вместе с использующим её кодом лямбда-выражения. Значения обычных
переменных заключаются в специальную обертку, которая позволяет м е­
нять переменную, а ссылка на обертку сохраняется вместе с лямбда-выра­
жением.
Важно отметить, что если лямбда-выражение используется в качестве
обработчика событий или просто выполняется асинхронно, модификация
локальных переменных произойдет только при выполнении лямбда-вы-
5.1. Лямбда-выражения и ссылки на члены класса
❖
147
ражения. Например, следующий код демонстрирует неправильный способ
подсчета нажатий кнопки:
fun tryToCountButtonClicks(button: Button): In t {
var clicks = 0
button.onClick { clicks++ }
return clicks
}
Эта функция всегда будет возвращать 0. Даже если обработчик onC lick
будет изменять значение переменной c lic k s , вы не увидите изменений,
поскольку обработчик onC lick будет вызываться после выхода из функ­
ции. Для правильной работы количество нажатий необходимо сохранять
не в локальную переменную, а в месте, доступном за пределами функ­
ции, - например, в свойстве класса.
Мы обсудили синтаксис объявления лямбда-выражений и как они за­
хватывают переменные. Теперь поговорим о ссылках на члены класса,
с помощью которых легко можно передавать ссылки на существующие
функции.
Захват изменяемых переменных: детали реализации
Java позволяет захватывать только финальные переменные. Если вы хотите захватить
изменяемую переменную, то можете использовать один из следующих приемов: либо
создать экземпляр класса-обертки, хранящего ссылку, которая может быть изменена.
Если вы примените эту технику в Kotlin, код будет выглядеть следующим образом:
Класс, имитирующийзахват
изменяемойпеременной
»> val counter = Ref (0)
I Формальнозахватываетсянеизменяемая
»> val inc = { counter. value++ } <H переменная, нореальноезначениесохраняется
вполеиможетбытьизменено
J
В реальном коде такие обертки вам не понадобятся. Вместо этого можно менять зна­
чение переменной напрямую.
var counter = 0
val inc = { counter++ }
Как это работает? Собственно, первый пример объясняет, что происходит при работе
второго примера. Всякий раз при захвате финальной переменной (va l) её значение
копируется, точно как в Java. При захвате изменяемой переменной (var) её значение
сохраняется как экземпляр класса Ref. Переменная Ref - финальная и может быть
захвачена, в то время как фактическое значение хранится в поле и может быть изменено
внутри лямбда-выражения.
148 ❖
Глава 5. Лямбда-выражения
5.1.5. Ссылки на члены класса
Теперь вы знаете, как лямбда-выражения позволяют передать блок кода
в вызов функции. Но что, если код, который нужно передать, уже опреде­
лен как функция? Конечно, можно передать лямбда-выражение, вызыва­
ющее эту функцию, но это избыточное решение. Можно ли передать функ­
цию напрямую?
В Kotlin, как и в lava 8, это можно сделать, преобразовав функцию в зна­
чение с помощью оператора ::.
Класс
Член
val getAge = Person::age
Это выражение называется ссылкой на член
Person::age
класса (member reference) и обеспечивает корот­
кий синтаксис создания значения функции, вы­
Отделяются двойным двоеточием
зывающего ровно один метод или обращающе­
Рис.
5.2.
Синтаксис
гося к свойству. Двойное двоеточие отделяет имя
ссылки
на
член
класса
класса от имени члена класса, на который нужно
сослаться (метод или свойство), как показано на рис. 5.2.
Это более краткая форма записи следующего лямбда-выражения:
val getAge = { person: Person -> person.age }
Обратите внимание: независимо от того, на что указывает ссылка - на
функцию или свойство, - вы не должны ставить круглые скобки после
имени члена класса при создании ссылки.
Ссылка на член класса - того же типа, что и лямбда-выражение, вызываю­
щее эту функцию, поэтому их можно взаимно заменять:
people.maxBy(Person::age)
Также можно создать ссылку на функцию верхнего уровня (и не являю­
щуюся членом класса):
fun salute() = println("Salute!")
»> run(: :salute)
О— Ссылканафункциюверхнегоуровня
Salute!
В этом случае имя класса не указывается и ссылка начинается с ::. Ссыл­
ка на функцию :: s a lu te передается как аргумент библиотечной функции
run, которая вызывает соответствующую функцию.
Иногда удобно использовать ссылку на функцию вместо лямбда-выра­
жения, делегирующего свою работу функции, принимающей несколько
параметров:
val action = { person: Person, message: String -> <H Эюлямбда-выражениеделегирует
sendEmail(person, message)
I работуфункции sendEmail
}
I Вместонегоможноиспользовать
val nextAction = :: sendEmail <j_I ссылкунафункцию
5.1.Лямбда-выражения и ссылки на члены класса
❖
149
Вы можете сохранить или отложить операцию создания экземпляра
класса с помощью ссылки на конструктор. Чтобы сформировать ссылку на
конструктор, нужно указать имя класса после двойного двоеточия:
data class Person(val name: String, val age: In t)
»> val createPerson = :: Person
»> val p = createPerson("Alice", 29)
»> println(p)
Person(name=Alice, age=29)
<•"1 Операциясозданияэкземпляра
I Personсохраняетсявпеременную
Обратите внимание, что ссылку можно получить и на функцию-расши­
рение:
fun Person.isAdult() = age >= 21
val predicate = Person: : isAdult
Хотя функция isA d u lt не является членом класса Person, её можно вы­
зывать через ссылку, точно как при обращении через метод экземпляра:
p erso n . isA d u lt.
Связанные ссылки
ВKotlin 1.0 всегда требуется передавать экземпляр класса при обращении к его методу
или свойству по ссылке. В Kotlin 1.1 планируется добавить поддержку связанных ссылок,
позволяющих использовать специальный синтаксис для захвата ссылки на метод кон­
кретного экземпляра класса:
»> val р = Person(“Dmitry” , 34)
»> val personsAgeFunction = Person::age
»> print In (personsAgeFunction (p))
»> val dmitrysAgeFunction = p: :age
»> println(dmitrysAgeFunction())
34
I Связаннаяссылка,доступная
<H вKotlin 1.1
Обратите внимание, что функция personsAgeFunction принимает один аргумент
(и возвращает возраст конкретного человека), тогда как dmitrysAgeFunction - это
функция без аргументов (возвращает возраст конкретного человека). До Kotlin 1.1
вместо использования связанной ссылки на метод р : : аде нужно было написать
лямбда-выражение { р.аде }.
В следующем разделе мы познакомимся со множеством библиотечных
функций, которые отлично работают с лямбда-выражениями, а также
ссылками на члены класса.
150 ❖
Глава 5. Лямбда-выражения
5.2. Функциональный API для работы
с коллекциями
Функциональный стиль дает много преимуществ при работе с коллекция­
ми. В стандартной библиотеке есть функции для решения большинства
задач, позволяющие упростить ваш код. В этом разделе мы познакомимся
с некоторыми функциями для работы с коллекциями из стандартной биб­
лиотеки Kotlin. Начнем с самых основных, таких как filte r и тар, и узна­
ем, на каких идеях они основаны. Мы также расскажем о других полезных
функциях и обьясним, как не злоупотреблять ими и писать ясный и по­
нятный код.
Обратите внимание, что ни одна из этих функций не была придумана
разработчиками языка Kotlin. Эти или похожие функции доступны во всех
языках с поддержкой лямбда-выражений, включая С#, Groovy и Scala. Если
вы уже знакомы с этими понятиями, можете быстро просмотреть следую­
щие примеры и пропустить объяснения.
5.2.1. Основы: filter и т а р
Функции filte r и тар - основа работы с коллекциями. С их помощью
можно выразить многие операции по сбору данных.
Для каждой функции мы покажем один пример с цифрами и один с ис­
пользованием знакомого вам класса Person:
data class Person(val name: String, val age: In t)
Функция filte r выполняет обход коллекции, отбирая только те элемен­
ты, для которых лямбда-выражение вернет tru e:
»> val lis t = listO f(1, 2, 3, 4)
»> p rin tln (lis t.filte r { i t % 2 == 0 })
[2, 4]
<— Останутсятолькочетныечисла
В результате получится новая коллекция, содержащая только элементы,
удовлетворяющие предикату, как показано на рис. 5.3.
Исходная коллекция
Итоговая коллекция
filter
-
© © © ©
-
{ it % 2 == 0 }
Рис. 5.3. Функция filter отбирает только элементы,
удовлетворяющие предикату
С помощью filte r можно найти в списке всех людей старше 30:
»> val people = listOf(Person("Alice", 29), Person("Bob", 31))
»> println(people.filter { it.age > 30 })
[Person(name=Bob, age=31)]
5.2. Функциональный API для работы с коллекциями ❖
151
Функция filte r сможет удалить из коллекции ненужные элементы, но
не сможет изменить их. Для преобразования элементов вам понадобится
функция тар.
Функция тар применяет заданную функцию к каждому элементу кол­
лекции, объединяя результаты в новую коллекцию. Например, вот как
можно преобразовать список чисел в список их квадратов:
»> val list = listOf(1, 2, 3, 4)
»> println(list.map { it * it })
[1, 4, 9, 16]
В результате получится новая коллекция, содержащая такое же количест­
во элементов, но каждый элемент будет преобразован согласно заданному
предикату (см. рис. 5.4).
Итоговая коллекция
Исходная коллекция
тар
•••
{ it * it }
Рис. 5.4. Функция т а р применяет лямбда-выражение
к каждому элементу коллекции
Чтобы просто вывести список имен, можно преобразовать исходный
список, используя функцию тар:
»> val people = listOf(Person("Alice", 29), Person("Bob", 31))
»> println(people.map { it.name })
[Alice, Bob]
Обратите внимание, что этот пример можно элегантно переписать, ис­
пользуя ссылку на член класса:
people.map(Person::name)
Вызовы функций можно объединять в цепочки. Например, давайте вы­
ведем имена всех, кто старше 30:
»> people.filter { it.age > 30 }.map(Person::name)
[Bob]
Теперь допустим, что вам нужны имена самых взрослых людей в груп­
пе. Как это сделать? Можно найти максимальный возраст в группе и вер­
нуть список всех с тем же возрастом. Такой код легко написать с помощью
лямбда-выражений:
people.filter { it.age == people.maxBy(Person::age).age }
Но обратите внимание: этот код повторяет процесс поиска максималь­
ного возраста для каждого человека - следовательно, если в коллекции
хранится список из 100 человек, поиск максимального возраста будет вы­
полнен 100 раз!
152 ❖
Глава 5. Лямбда-выражения
Следующее решение не имеет этого недостатка и рассчитывает макси­
мальный возраст только один раз:
val maxAge = people.maxBy(Person::age).age
p e o p le .f ilte r { it.a g e == maxAge }
He повторяйте расчетов без необходимости! Код с лямбда-выражением,
который кажется простым, иногда может скрывать сложность используе­
мых им операций. Всегда думайте о том, что происходит в коде, который
вы пишете.
К словарям также можно применить функции отбора и преобразования:
> » val numbers = mapOf(0 to "zero", 1 to "one")
» > println(numbers.mapValues { it.value.tol)pperC ase() })
{0=ZERO, 1=0NE}
Обратите внимание: существуют отдельные функции для обработки
ключей и значений. Функции filterK eys и mapKeys отбирают и преобра­
зуют ключи словаря соответственно, тогда как filterV a lu es и mapValues
отбирают и преобразуют значения.
5.2.2. Применение предикатов к коллекциям:
функции «all», «any», «count» и «find»
Ещё одна распространенная задача - проверка всех элементов коллек­
ции на соответствие определенному условию (или, например, проверка
наличия хотя бы одного такого элемента). В Kotlin эта задача решается с
помощью функций a l l и any. Функция count проверяет, сколько элемен­
тов удовлетворяет предикату, а функция find возвращает первый подходя­
щий элемент.
Чтобы продемонстрировать работу этих функций, определим предикат
canBeInClub27, возвращающий tru e, если возраст человека 27 лет или
меньше:
val canBeInClub27 = { р: Person -> p.age <= 27 }
Если вас интересует, все ли элементы удовлетворяют этому предикату,
воспользуйтесь функцией a ll:
» > val people = listO f(Person("A lice", 27), Person("Bob", 31))
» > p rin tln (p e o p le . all(canBeInClub27))
fa lse
Когда нужно найти хотя бы один подходящий элемент, используйте
функцию any.
» > p rin tln (p e o p le . any(canBeInClub27))
tru e
5.2. Функциональный API для работы с коллекциями ❖
153
Обратите внимание, что выражение ! a 11 («не все») с условием можно
заменить выражением any с противоположным условием, и наоборот.
Чтобы сделать код более понятным, выбирайте функцию, не требующую
знака отрицания перед ней:
»> val lis t = listO f (1, 2, 3)
»> p rin tin g lis t, a ll { i t == 3 })
true
»> print ln( lis t, any { i t != 3 })
true
I Символотрицания! труднозаметить, поэтому
<|J вданномслучаелучшеиспользовать«апу»
I Условиевэтойаргументепоменялось
o - l напротивоположное
Первая проверка гарантирует, что не все элементы равны 3. То есть она
проверяет наличие хотя бы одного элемента, не равного 3, - именно это
проверяется с помощью выражения any во второй строке.
Если требуется узнать, сколько элементов удовлетворяет предикату, ис­
пользуйте count:
»> val people = listOf(Person("Alice", 27), Person("Bob", 31))
»> println(people.count(canBeInClub27))
1
Выбор правильной функции: count или size
Можно легко забыть о методе co u n t и реализовать подсчет с помощью фильтрации
коллекции и получения её размера:
»> println(people. filter(canBeInClub27). size)
1
Но в этом случае для хранения всех элементов, удовлетворяющих предикату, будет
создана промежуточная коллекция. Сдругой стороны, метод count только подсчитывает
количество подходящих элементов, а не сами элементы, поэтому он более эффективен.
Всегда пытайтесь подобрать операцию, наиболее подходящую вашим потребностям.
Чтобы найти элемент, удовлетворяющий предикату, используйте функ­
цию find:
»> val people = listOf(Person("Alice", 27), Person("Bob", 31))
»> println(people. find(canBeInClub27))
Person(name=Alice, age=27)
Она возвращает первый найденный элемент, если их несколько, или
n u ll, если ни один не удовлетворяет предикату. Синоним функции find firstO rN ull, которую также можно использовать, если она лучше выража­
ет вашу идею.
154 ❖
Глава 5. Лямбда-выражения
5.2.3. Группировка значений в списке с функцией groupBy
Представьте, что вам нужно разделить элементы коллекции на разные
группы по некоторому критерию - например, разбить список людей на
группы по возрасту. Было бы удобно передать этот критерий непосред­
ственно в качестве параметра. Функция groupBy может сделать это для вас:
»> val people = listOf(Person("Alice", 31),
Person("Bob\ 29), Person("Carol", 31))
»> println(people.groupBy { it.age })
Результатом этой операции будет словарь с ключами, определяющими
признак для группировки (в данном случае возраст), - см. рис. 5.5.
Исходная коллекция
Итоговая коллекция
Alice, 31
groupBy
Bob, 29
{ it.age >
Carol, 31
Рис. 5.5. Результат применения функции groupBy
Данный пример даст следующий результат:
{29=[Person(name=Bob, age=29)],
31=[Person(name=Alice, age=31), Person(name=Carol, age=31)]}
Каждая группа сохраняется в виде списка, поэтому результат будет
иметь тип M apdnt, List<Person>>. Вы можете изменять этот словарь, ис­
пользуя функции mapKeys и mapValues.
В качестве другого примера посмотрим, как группировать строки по
первому символу, используя ссылку на метод:
>» val lis t = listO f("а ", "ab", "b")
»> println(list.groupBy(String::fir s t) )
{a=[a, ab], b=[b]}
Обратите внимание, что функция first является не членом класса
S trin g , а функцией-расширением. Тем не менее к ней можно обращаться
через ссылку на метод.
5.2.4. Обработка элементов вложенных коллекций:
функции flatMap и flatten
Теперь оставим людей в покое и переключимся на книги. Предположим,
у нас есть хранилище книг, представленных классом Book:
class Book(val title : String, val authors: List<String>)
Каждая книга написана одним или несколькими авторами. Вот как мож­
но найти множество всех авторов в библиотеке:
5.2. Функциональный API для работы с коллекциями ❖
books. flatMap { it.authors }.toSet()
155
О— Множество всех авторов книг в коллекции «books»
Функция flatMap сначала преобразует (или отображает - тар) каждый
элемент в коллекцию, согласно функции, переданной в аргументе, а затем
собирает (или уплощает - flattens) несколько списков в один. Пример со
строками хорошо иллюстрирует эту идею (см. рис. 5.6):
»> val strings = listOf("abc", "def")
»> println(strings.flatMap { it.to L is t() })
[a, b, c, d, e, f ]
отображение
0
Если применить функцию to L is t к строке, она
превратит её в список символов. Если использовать
функцию тар вместе с функцией to L is t, получит­
ся список списков символов, как во втором ряду на
рис. 5.6. Функция flatMap делает следующий шаг и
возвращает список из всех элементов.
Вернемся к авторам:
0
0 0 0
0
уплощение
’
0
0
0
d 0
0
Рис. 5.6. Результат
применения функции
flatMap
»> val books = listOf(Book("Thursday Next", listOf("Dasper Fforde")),
Book("Mort", listOf("Terry Pratchett")),
Book("Good Omens", listOf("Terry Pratchett",
"Neil Gaiman")))
»> println(books.flatMap { it.authors }.toSet())
[Dasper Fforde, Terry Pratchett, Neil Gaiman]
Каждая книга может быть написана несколькими авторами, список ко­
торых хранится в свойстве book. authors. Функция flatMap объединяет ав­
торов всех книг в один плоский список. Функция to S e t удаляет дубликаты
из получившейся коллекции: так, в этом примере Терри Пратчетт (Terry
Pratchett) появится в выводе программы только один раз.
Вспомните о функции flatMap, когда нужно будет объединить коллек­
цию коллекций элементов. Но если потребуется просто плоская коллек­
ция, без преобразований, используйте функцию fla tte n : l is tO f L i s t s .
fla tte n Q .
Мы показали только некоторые функции для работы с коллекциями,
имеющиеся в стандартной библиотеке Kotlin, - кроме них, есть множество
других. Мы не будем рассматривать их все из-за нехватки места, а также
потому, что показывать длинный список функций скучно. Вообще, при
написании кода, работающего с коллекциями, мы советуем думать о том,
как действие может быть выражено в виде общего преобразования, и ис­
кать библиотечную функцию, выполняющую такое преобразование. Впол­
не вероятно, что вы найдете такую функцию и сможете использовать её
для решения вашей проблемы гораздо быстрее, чем если будете писать её
вручную.
156 ❖
Глава 5. Лямбда-выражения
Теперь давайте внимательно исследуем производительность кода, объ­
единяющего несколько операций над коллекциями. В следующем разделе
вы увидите различные способы реализации подобных операций.
5.3. Отложенные операции над коллекциями:
последовательности
В предыдущем разделе вы видели несколько примеров составления цепо­
чек из вызовов функций для работы с коллекциями - таких как тар и fi I t er.
Эти функции немедленно создают промежуточные коллекции, т. е. резуль­
тат, полученный на каждом промежуточном шаге, сразу же сохраняется во
временном списке. Последовательности (sequences) дают альтернативный
способ реализации таких вычислений, позволяющий избежать создания
временных промежуточных объектов.
Рассмотрим пример.
people.map(Person::name).filter { it.startsWith("A") }
Справочник по стандартной библиотеке Kotlin говорит, что filte r и map
возвращают список. Это значит, что данная цепочка вызовов создаст два
списка: один - для хранения результатов функции filte r и другой - для
результатов функции тар. Это не проблема, если в исходном списке всего
пара элементов, но в случае со списком из миллиона элементов это может
существенно снизить эффективность операции.
Для повышения эффективности нужно реализовать операцию с приме­
нением последовательностей вместо коллекций:
J
Преобразуетисходнуюколлекцию
впоследовательность
.map(Person:: пате)
.filte r { i t .startsWith("А") }
.toList()
Последовательностьреализует
тотжеAPI, чтоиколлекции
<Н ПреобразованиеполучившейсяпоI следовательностиобратновсписок
Эта операция вернет тот же результат, что и предыдущий пример: спи­
сок имен, начинающихся с буквы А. Но второй пример не создает проме­
жуточных коллекций для хранения элементов, а следовательно, для боль­
шого количества элементов производительность будет заметно лучше.
Точка входа для выполнения отложенных операций в Kotlin - интерфейс
Sequence. Он представляет собой простую последовательность элементов,
которые могут перечисляться один за другим. Интерфейс Sequence опре­
деляет только один метод - ite r a to r , который используется для получе­
ния значений последовательности.
Особенность интерфейса Sequence - способ реализации операций. Эле­
менты последовательности вычисляются «лениво». Благодаря этому по-
5.3. Отложенные операции над коллекциями: последовательности ❖
157
следовательности можно использовать для эффективного выполнения
цепочек операций над элементами, не создавая коллекций для хранения
промежуточных результатов.
Любую коллекцию можно преобразовать в последовательность, вызвав
функцию-расширение asSequence. Обратное преобразование выполняет­
ся вызовом функции to L is t.
Зачем нужно преобразовывать последовательность обратно в коллек­
цию? Не проще ли всегда использовать последовательности вместо кол­
лекций, раз они настолько лучше? Иногда они действительно удобнее.
Если нужно выполнить только обход элементов, можно использовать по­
следовательность напрямую. Но если потребуется использовать другие
методы (например, доступ к элементам по индексу), последовательность
нужно преобразовать в список.
Примечание. Как правило, последовательности применяются всякий раз, когда требуется
выполнить цепочку операций над большой коллекцией. Вразделе 8.2 мы обсудим, почему
немедленные операции над обычными коллекциями так эффективны в Kotlin, несмотря на
создание промежуточных коллекций. Но когда коллекция содержит большое количество
элементов и промежуточная перестановка элементов требует много затрат, предпочтитель­
нее использовать отложенные вычисления.
Поскольку операции над последовательностями выполняются в отло­
женной манере («лениво»), для их фактического выполнения нужно либо
перебрать элементы последовательности, либо преобразовать её в коллек­
цию. Причины этого - в следующем разделе.
5.3.1. Выполнение операций над последовательностями:
промежуточная и завершающая операции
Операции над последовательностями делятся на две категории: проме­
жуточные и завершающие. Промежуточная операция возвращает другую
последовательность, которая знает, как преобразовать элементы исход­
ной последовательности. Завершающая операция возвращает результат,
который может быть коллекцией, элементом, числом или любым другим
объектом, полученным в ходе преобразований исходной коллекции (см.
рис. 5.7).
Промежуточные операции
sequence.шар { ... }.filter { ... }.toList()
Завершающая операция
Рис. 5.7. Промежуточные и завершающая операции над последовательностями
158 ❖
Глава 5. Лямбда-выражения
Выполнение промежуточных операций всегда откладывается. Взгляни­
те на пример, в котором отсутствует завершающая операция:
»> listO f(1, 2, 3, 4).asSequence()
.map { print("map($it) "); i t * i t }
.filte r { p rin t("filte r($ it) "); i t % 2 == 0 }
Этот код ничего не выведет в консоль. Это значит, что преобразования
тар и filte r отложены и будут применены, только когда потребуется вер­
нуть результат (т. е. во время выполнения завершающей операции):
»> listO f(1, 2, 3, 4).asSequence()
.map { print("map($it) "); i t * i t }
.filte r { p rin t("filte r($ it)
i t % 2 == 0 }
.toList()
map(l) f ilt e r ( l) map(2) filte r(4 ) map(3) filte r(9 ) map(4) filte r(1 6 )
Завершающая операция заставляет выполниться все отложенные вы­
числения.
Еще одна важная деталь, которую нужно отметить в этом примере, - по­
рядок выполнения вычислений. При реализации «в лоб» к каждому эле­
менту сначала применяется функция тар, а затем вызывается функция
filte r для каждого элемента получившейся последовательности. Так функ­
ции тар и filte r работают с коллекциями, но не с последовательностями.
Для последовательности все операции применяются к каждому элементу
поочередно: сначала обрабатывается первый элемент (преобразуется, а
затем фильтруется), затем второй и т. д.
Такой подход означает, что некоторые элементы могут вовсе не подверг­
нуться преобразованию, если результат будет вычислен прежде, чем до
них дойдет очередь. Давайте посмотрим пример с операциями find и тар.
Сначала вычислим квадрат числа, а затем найдем первый элемент боль­
ше 3:
»> p rin tln (lis tO f(l, 2, 3, 4).asSequence()
.map { i t * i t }.fin d { i t > 3
Если те же операции применить к коллекции вместо последовательно­
сти, сначала выполнится функция тар, которая преобразует каждый эле­
мент исходной коллекции в квадрат. А затем, на втором шаге, в проме­
жуточной коллекции будет найден элемент, удовлетворяющий предикату.
Отложенные вычисления позволяют пропустить обработку некоторых
элементов. Рисунок 5.8 иллюстрирует разницу между немедленным (при
работе с коллекциями) и отложенным (при работе с последовательностя­
ми) выполнениями этих операций.
5.3. Отложенные операции над коллекциями: последовательности ❖
Немедленное выполнение
Отложенное выполнение
®©®©
© @ ® ©
159
-
шар
000
find
>Ц[0
[0
Результат
Результат
Рис. 5.8. Немедленный способ выполнит каждую операцию
для всей коллекции; отложенный будет обрабатывать элементы один за другим
В первом случае, когда при работе с коллекциями исходный список пре­
вращается в другой список, преобразование применяется к каждому эле­
менту, в том числе к 3 и 4. После этого выполняется поиск первого элемен­
та, удовлетворяющего предикату: квадрата числа 2.
Во втором случае вызов find обрабатывает элементы по одному. Из ис­
ходной последовательности извлекается число, преобразуется с помощью
тар, а затем проверяется на соответствие предикату в find. По достижении
числа 2 обнаружится, что его квадрат больше 3 и оно будет возвращено как
результат операции find. Программе не придется проверять 3 и 4, посколь­
ку результат будет до того, как до них дойдет очередь.
Порядок выполнения операций над коллекцией также влияет на произ­
водительность. Представьте, что у нас есть коллекция людей, и мы хотим
вывести их имена, но только если они меньше определенной длины. Для
этого нам потребуется отобразить каждый объект P e r s o n в имя человека,
а затем выбрать достаточно короткие имена. В этом случае операции тар и
f i l t e r можно применить в любом порядке. Оба подхода дают одинаковый
результат, но отличаются количеством преобразований (см. рис. 5.9).
®®©®
(А)®©®
• • •
шар
..
filter
а D'
®
* *
filter
®
••
шар
»
»
•
Рис. 5.9. Применение функции filter первой помогает
уменьшить число необходимых преобразований
»> val people = listOf(Person("Alice", 29), Person("Bob", 31),
... Person("Cbarles", 31), Person("Dan", 21))
»> print ln(people.asSequence().map( Person: :name)
<1— Сначала«тар», затем«fiber»
160
❖
Глава 5. Лямбда-выражения
... .filte r { it.length < 4 }.to L is t())
[Bob, Dan]
»> println(people.asSequence().filte r { i t .name.length < 4 }
... .map(Person: :name).toList())
О— «тар» выполнится после«filter»
[Bob, Dan]
Если map выполнится первой, будет преобразован каждый элемент. Если
же сначала применить filte r , неподходящие элементы отфильтруются
раньше и не будут преобразованы.
Потоки и последовательности
Знакомые с потоками (streams) в Java 8 без труда узнают их в последовательностях.
KotLin предлагает собственную версию этой идеи, потому что потоки Java 8 недоступны
на платформах, основанных на старых версиях Java (таких как Android). Если вы ориен­
тируетесь на Java 8, потоки дадут вам одно большое преимущество, которое в настоящее
время не реализовано для коллекций и последовательностей в Kotlin, - возможность
запуска потоковой операции (например, тар или filte r ) параллельно на нескольких
процессорах. Вы можете выбирать между потоками и последовательностями в зависи­
мости от версии Java и ваших особых требований.
5.3.2. Создание последовательностей
В предыдущих примерах для создания последовательностей использо­
вался один и тот же способ: вызывалась функция asSequence() коллек­
ции. Однако последовательность также можно создать вызовом функции
generateSequence. Она вычисляет следующий элемент последовательно­
сти на основании предыдущего. Например, вот как можно использовать
generateSequence для подсчета суммы всех натуральных чисел до 100.
Листинг 5.12. Создание и использование последовательности натуральных чисел
»> val naturalNumbers = generateSequence(0) { i t + 1 }
»> val numbersTol00 = naturalNumbers.takeWhile { i t <= 100 }
»> print ln(numbersTol00.sum()) < н Все отложенные операции выполнятся
5050
| при обращении к «sum»
Обратите внимание, что naturalNumbers и numbersTolOG в данном при­
мере - последовательности с отложенным выполнением операций. Реаль­
ные числа в этих последовательностях не будут вычислены до вызова за­
вершающей операции (в данном случае sum).
Другой распространенный вариант использования - это последователь­
ность родителей. Если у элемента есть родитель того же типа (например,
человек или Java-файл), вас могут заинтересовать свойства всех его пред-
5.4. Использование функциональных интерфейсов Java ❖
161
ков в последовательности. Следующий пример проверяет, находится ли
файл в скрытом каталоге, создав последовательность родительских ката­
логов и проверив соответствующий атрибут у каждого каталога.
Листинг 5.13. Создание и применение последовательности родительских каталогов
fun File.isInsideHiddenDirectoryO =
generateSequence(ttiis) { it.parentFile }.any { it.isHidden }
»> val file = File("/Users/svtk/.HiddenOir/a.txt")
»> println(file.isInsideHiddenDirectoryO)
true
Еще раз напомним, что вы создаете последовательность, предоставляя
первый элемент и способ получения каждого последующего элемента. За­
менив any на find, вы получите желаемый каталог. Обратите внимание, что
последовательности позволяют остановить обход родителей, как только
нужный каталог будет найден.
Мы подробно обсудили распространенные случаи применения
лямбда-выражений для упрощения манипуляций с коллекциями. Теперь
затронем не менее важную тему: использование лямбда-выражений с су­
ществующим Java API.
5.4. Использование функциональных
интерфейсов Java
Использовать лямбда-выражения с библиотеками Kotlin приятно, но боль­
шая часть API, с которыми вам доведется работать, написана на Java, а не
на Kotlin. Замечательно, что лямбда-выражения Kotlin полностью совмес­
тимы с Java API. В этом разделе вы точно узнаете, как это работает.
В начале главы вы видели пример передачи лямбда-выражения в
Java-метод:
Передача лямбда-выражения
button. setOnClickListener { /* actions on click */ } о —I в качестве аргумента
Класс Button позволяет подключить новый обработчик с помощью мето­
да setO n C lick L isten er, принимающего аргумент типа O nC lickListener:
/* Dava */
public class Button {
public void setOnClickListener(OnClickListener I) { ... }
}
В интерфейсе O nC lickL istener объявлен только один метод - onClick:
/* Dava */
public interface OnClickListener {
162
❖
Глава 5. Лямбда-выражения
void onClick(View v);
}
В Java (до версии 8) вы должны создать новый экземпляр анонимного
класса и передать его методу s e t O n C l i c k L i s t e n e r :
button.setOnClickListener(new OnClickListener() {
gOverride
public void onClick(View v) {
В Kotlin вместо этого можно передать лямбда-выражение:
button.setOnClickListener { view -> ... }
Лямбда-выражение, реализующее интерфейс O nC lickL istener, прини­
мает один параметр типа View, как и метод onC lick. Это соответствие по­
казано на рис. 5.10.
public interface OnClickListener {
void onClick(View v) ;
►
{ view -> ... }
}
Рис. 5.10. Параметры лямбда-выражения соответствуют параметрам метода
Это возможно потому, что интерфейс O nC lickL istener имеет только
один абстрактный метод. Такие интерфейсы называются функциональ­
ными интерфейсами, или SAM-интерфейсами (Single Abstract Method - с
единственным абстрактным методом). В Java API полным-полно функцио­
нальных интерфейсов (таких как Runnable и C allab le), и методов для ра­
боты с ними. Kotlin позволяет использовать лямбда-выражения в вызовах
методов Java, принимающих в качестве параметров функциональные ин­
терфейсы, что гарантирует чистоту и идиоматичность кода на Kotlin.
Примечание. В отличие от Java, в Kotlin есть настоящие типы функций. Поэтому функции
в Kotlin, принимающие лямбда-выражения, должны использовать в качестве параметров
типы функций, а не типы функциональных интерфейсов. Kotlin не поддерживает автома­
тического преобразования лямбда-выражений в объекты, реализующие интерфейсы. Мы
обсудим использование типов функций в объявлениях функций в разделе 8.1.
Давайте посмотрим, что происходит, когда методу, ожидающему аргумен­
та с типом функционального интерфейса, передается лямбда-выражение.
5.4.1. Передача лямбда-выражения в Java-метод
Вы можете передать лямбда-выражение в любой метод Java, принимаю­
щий функциональный интерфейс. К примеру, рассмотрим следующий м е­
тод, принимающий параметр типа Runnable:
5.4. Использование функциональных интерфейсов Java
1бз
/* Java */
void postponeComputation(int delay, Runnable computation);
В Kotlin можно вызвать этот метод, передав в аргументе лямбда-вы­
ражение. Компилятор автоматически преобразует его в экземпляр
Runnable:
postponeComputation(1000) { println(42) }
Обратите внимание: говоря «экземпляр Runnable», мы имеем в виду
«экземпляр анонимного класса, реализующего интерфейс Runnable».
Компилятор создаст его за вас, а в качестве тела единственного абстракт­
ного метода (run в данном случае) использует лямбда-выражение.
Тот же эффект можно получить, создав анонимный объект, явно реали­
зующий интерфейс Runnable:
postponeComputation(1000, object : Runnable {
override fun run() {
println(42)
<^~\ Передача объекта-выражения в качестве
I реализации функционального интерфейса
}
})
Но есть одно отличие: при явном объявлении объекта в каждом вызо­
ве создается новый экземпляр. С лямбда-выражениями ситуация иная:
если лямбда-выражение не захватывает переменных из функции, где оно
определено, соответствующий экземпляр анонимного класса повторно
используется между вызовами:
J B программе будет создан только один
экземпляр интерфейса Runnable
Ниже приводится эквивалентная реализация с явным объявлением объ­
екта, которая сохраняет экземпляр Runnable в переменную и использует
её в каждом вызове:
Компилируется в глобальную переменную;
val runnable = Runnable { println(42) }
в программе существует только один экземпляр
fun handleComputation() {
postponeComputation(1000, runnable)
}
В каждый вызов метода handleComputation
будет передаваться один и тот же экземпляр
Когда лямбда-выражение захватывает переменные из окружающего
контекста, становится невозможно повторно использовать один и тот же
экземпляр в каждом вызове. В этом случае компилятор создает новый
объект для каждого вызова, сохраняя в нем значения захваченных пере­
менных. Например, каждый вызов следующей функции использует новый
экземпляр Runnable, хранящий значение id в своем поле:
J Лямбда-выражение захватывает
переменную «id»
postponeComputation(1000) { p rin tln (id ) } < Н Для каждого вызова handleComputation
}
I создается новый экземпляр Runnable
164
♦> Глава 5. Лямбда-выражения
Подробности реализации лямбда-выражений
ВKotlin 1.0 каждое лямбда-выражение компилируется в анонимный класс, если только
не является встраиваемым. Поддержку генерации байт-кода Java 8 планируется доба­
вить в более поздних версиях Kotlin. Как только она будет реализована, компилятору не
придется создавать отдельные файлы .class для каждого лямбда-выражения.
Если лямбда-выражение захватывает переменные, в анонимном классе будет преду­
смотрено поле для каждой захваченной переменной, и новый экземпляр этого класса
будет создаваться при каждом вызове. В противном случае будет создан один экзем­
пляр. Название класса формируется путем добавления суффикса к имени функции, в
которой объявлено лямбда-выражение: например, HandieComputation$i.
Вот что вы увидите, декомпилировав код предыдущего лямбда-выражения:
class HandleComputation$l(val id: String) : Runnable {
override fun run() {
p rin tln (id )
За кулисами вместо лямбда}
выражения будет создан экземпляр
}
специального
класса
fun handleComputation(id: String) {
postponeComputation(1000, HandleComputation$l(id))
}
Как видите, компилятор генерирует поле и параметр конструктора для каждой захва­
ченной переменной.
Обратите внимание, что наше обсуждение создания анонимного клас­
са и его экземпляра для лямбда-выражения актуально лишь для Java-м е­
тодов, принимающих функциональные интерфейсы, и неприменимо для
работы с коллекциями с использованием методов-расширений Kotlin.
Если передать лямбда-выражение в функцию на Kotlin, отмеченную клю­
чевым словом in lin e , анонимный класс не будет создан. Большинство
библиотечных функций отмечено ключевым словом in lin e . Подробности
реализации этого ключевого слова ищите в разделе 8.2.
Как видите, в большинстве случаев преобразование лямбда-выражения
в экземпляр функционального интерфейса происходит автоматически,
без каких-либо усилий с вашей стороны. Но иногда необходимо явно вы­
полнить преобразование. Давайте узнаем, как это сделать.
5.4.2. SAM-конструкторы: явное преобразование
лямбда-выражений в функциональные интерфейсы
SAM-конструктор - это функция, сгенерированная компилятором, ко­
торая позволяет явно выполнить преобразование лямбда-выражения в
5.4. Использование функциональных интерфейсов Java ❖
165
экземпляр функционального интерфейса. Его можно использовать в кон­
текстах, где компилятор не применяет преобразования автоматически. На­
пример, если есть метод, который возвращает экземпляр функционально­
го интерфейса, вы не сможете вернуть лямбда-выражение напрямую: его
нужно завернуть в вызов SAM-конструктора. Вот простая демонстрация.
Листинг 5.14. Применение SAM-конструкгора к возвращаемому значению
fun createAUDoneRunnable(): Runnable {
return Runnable { p rin tln ("A ll done!") }
}
»> createAUDoneRunnable().run()
A ll done!
Имя SAM-конструктора совпадает с именем соответствующего функ­
ционального интерфейса. SAM-конструктор принимает один аргумент лямбда-выражение, которое будет использовано как тело единственного
абстрактного метода в функциональном интерфейсе, - и возвращает эк­
земпляр класса, реализующего данный интерфейс.
Помимо создания возвращаемых значений, SAM-конструкторы ис­
пользуются, чтобы сохранить в переменной экземпляр функционального
интерфейса, созданный из лямбда-выражения. Предположим, вы хотите
использовать один обработчик событий для нескольких кнопок, как в сле­
дующем листинге (в Android-приложении этот код может быть частью м е­
тода A c t iv it y . onCreate).
Листинг 5.15. Использование SAM-консгруктора для повторного использования
обработчика событий
val listener = OnClickListener { view ->
val text = when (view.id) {
R.id.buttonl -> "First button"
R.id.button2 -> "Second button"
else -> "Unknown button"
}
toast(text)
< н Поле view.idиспользуется,чтобы
I понять, какая кнопка была нажата
О— Выводит значение поля «text»
}
buttonl.setOnClickListener(listener)
button2.setOnClickListener(listener)
Экземпляр в переменной listener проверяет, какая кнопка породи­
ла событие, и ведет себя соответственно. Можно определить обработ­
чик событий, используя объявление объекта, реализующего интерфейс
OnClickListener, но SAM-конструктор - более лаконичный вариант.
166 ❖
Глава 5. Лямбда-выражения
Лямбда-выражения и добавление/удаление обработчиков событий
Обратите внимание, что в лямбда-выражении, в отличие от анонимного объекта, нет
ссылки th is : не существует способа сослаться на анонимный экземпляр класса, в ко­
торый преобразуется лямбда-выражение. Сточки зрения компилятора лямбда-выраже­
ние - это блок кода, а не объект, и вы не можете относиться к нему как к объекту. Ссылка
th is в лямбда-выражении относится к окружающему классу.
Если обработчик события должен отменить свою подписку на события во время об­
работки, вы не сможете воспользоваться для этого лямбда-выражением. Вместо этого
используйте для реализации обработчика анонимный объект. В анонимном объекте
ключевое слово th is ссылается на экземпляр этого объекта, и вы можете передать его
API для удаления обработчика.
Также, хотя SAM-преобразование в вызовах методов, как правило, про­
исходит автоматически, иногда компилятор не может выбрать правиль­
ную перегруженную версию при передаче лямбда-выражения в аргументе
перегруженному методу. В таких случаях явное применение SAM-кон­
структора - хороший способ устранения ошибки компиляции.
Чтобы завершить обсуждение синтаксиса лямбда-выражений и их при­
менения, рассмотрим лямбда-выражения с получателями и то, как они
используются для определения удобных библиотечных функций, которые
выглядят как встроенные конструкции языка.
5.5. Лямбда-выражения с получателями:
функции «with» и «apply»
Этот раздел посвящен w ith и apply - очень удобным функциям из стан­
дартной библиотеки Kotlin, которым можно найти массу применений, да­
же не зная, как они объявлены. Позже, в разделе 11.2.1, вы увидите, как объ­
являть аналогичные функции для собственных нужд. А пока информация
в этом разделе поможет вам познакомиться с уникальной особенностью
лямбда-выражений в Kotlin, недоступной в Java: возможностью вызова
методов другого объекта в теле лямбда-выражений без дополнительных
квалификаторов. Такие конструкции называются лямбда-выражениями с
получателями. Для начала познакомимся с функцией w ith, которая ис­
пользует лямбда-выражение с получателем.
5.5.1. Функция «with»
Во многих языках есть специальные инструкции, помогающие выпол­
нить несколько операций над одним и тем же объектом, не повторяя его
имени. В Kotlin есть похожая возможность, но она реализована как библи­
отечная функция w ith, а не как специальная языковая конструкция.
5.5. Лямбда-выражения с получателями: функции «with» и «apply» ❖
167
Чтобы понять, где это может пригодиться, рассмотрим следующий при­
мер, для которого потом выполним рефакторинг с использованием функ­
ции w ith.
Листинг 5.16. Генерация алфавита
fun alphabetQ: String {
val result = StringBuilderQ
for (le tte r in 'A'. . ' Z') {
result.append(letter)
}
result.append("\nNow I know the alphabet!")
return result.toStringQ
}
»> println(alphabet())
ABCDEFGHIDKLMNOPQRSTUVWXYZ
Now I know the alphabet!
В этом примере вызывается несколько методов объекта в переменной
r e s u lt, и его имя повторяется при каждом вызове. Это не слишком плохо,
но что, если используемое выражение будет больше или будет повторяться
чаще?
Вот как можно переписать код с помощью функции w ith.
Листинг 5.17. Использование функции w ith для генерации алфавита
fun alphabet(): String {
val stringBuilder = StringBuilderQ
I Определяетсяполучатель, методы
return with(stringBuilder) {
<ь-1 которогобудутвызываться
for (le tte r in 'A'..'Z') {
I Вызовметодаполучателя
this.append(letter)
<H спомощьюссылки«this»
}
append(" \nNow I know the alphabet!") О— Вызовметодабезссылки«this»
this.toString()
<H Возвратзначения
}
I излямбда-выражения
}
Структура w ith выглядит как особая конструкция, но это лишь функ­
ция, которая принимает два аргумента - в данном случае объект
str in g B u ild e r и лямбда-выражение. Здесь используется соглашение о
передаче лямбда-выражения за круглыми скобками, поэтому весь вызов
выглядит как встроенная конструкция языка. То же самое можно было бы
записатьKaKwith(stringBuilder, {
} ), но такой код труднее читать.
Функция w ith преобразует первый аргумент в получатель лямбда-выра­
жения во втором аргументе. Вы можете явно обращаться к этому получа­
телю через ссылку t h is . С другой стороны, можно опустить ссылку t h is и
168
❖
Глава 5. Лямбда-выражения
обращаться к методам или свойствам текущего объекта без дополнитель­
ных квалификаторов.
В листинге 5.17 ссылка t h is указывает на экземпляр strin g B u ild er,
переданный в первом аргументе. К методам str in g B u ild e r можно обра­
щаться явно, через ссылку t h is , как в выражении t h i s . append( l e t t e r ) ,
или напрямую, как в выражении append( "\nNow..."
Лямбда-выражения с получателем и функции-расширения
Мы уже видели похожую идею со ссылкой th is ,указывающей на получатель функции.
Втеле функции-расширения ссылка th is указывает на экземпляр типа, который расши­
ряет функция, и её можно опускать, обращаясь к членам получателя напрямую.
Обратите внимание, что функция-расширение - это в некотором смысле функция с
получателем. Можете воспользоваться следующей аналогией:
Обычная функция
Обычное лямбда-выражение
Функция-расширение
Лямбда-выражение с получателем
Лямбда-выражение - это способ определения поведения, похожий на обычную функ­
цию. Лямбда-выражение с получателем - это способ определения поведения, аналогич­
ный функции-расширению.
А теперь реорганизуем функцию alphabet и избавимся от дополнитель­
ной переменной stringBuilder.
Листинг 5.18. Применение функции with и тела-выражения
для генерации алфавита
fun alphabet() = with(StringBuilder()) {
for (le tte r in 'A'. . 'Z') {
append(letter)
}
append(11\nNow I know the alphabet!")
toString()
}
Теперь эта функция возвращает только выражение, поэтому она была
переписана с использованием синтаксиса тела-выражения. Мы создали
новый экземпляр S trin g B u ild er и напрямую передали его в аргументе,
а теперь используем его без явной ссылки t h is внутри лямбда-выраже­
ния.
5.5. Лямбда-выражения с получателями: функции «with» и «apply» ❖
169
Конфлиюующие имена методов
Что произойдет, если в объекте, переданном в функцию w ith, есть метод с таким же
именем, как в классе, в котором применяется функция with? Вэтом случае для указания
на метод можно явно использовать ссылку th is .
Представьте, что функция alphabet - метод класса OuterCiass. Если понадо­
бится обратиться к методу toString внешнего класса вместо объявленного в классе
StringBuilder, это можно сделать с помощью следующего синтаксиса:
thisgOuterClass.toString()
Функция w ith возвращает результат выполнения лямбда-выражения результат последнего выражения в теле лямбда-функции. Но иногда нуж­
но, чтобы результатом вызова стал сам объект-получатель, а не резуль­
тат выполнения лямбда-выражения. Здесь вам пригодится библиотечная
функция apply.
5.5.2. Функция «apply»
Функция apply работает почти так же, как w ith, - разница лишь в том,
что apply всегда возвращает объект, переданный в аргументе (другими
словами, объект-получатель). Давайте ещё раз реорганизуем функцию
alphabet, применив на этот раз функцию apply.
Листинг 5.19. Использование функции apply для генерации алфавита
fun alphabet() = StringBuilder().apply {
for (le tte r in 'A '. . ' I ' ) {
append(letter)
}
append("\nNow I know the alphabet!")
}.toString()
Функция apply объявлена как функция-расширение. Её получателем
становится получатель лямбда-выражения, переданного в аргументе. Ре­
зультатом вызова apply станет экземпляр S trin gB u ild er, поэтому нужно
вызвать в конце метод to S tr in g , чтобы превратить его в строку S trin g.
Один из многих случаев, где это может пригодиться, - создание экземп­
ляра, у которого нужно сразу инициализировать некоторые свойства.
В Java это обычно выполняется с помощью отдельного объекта B uilder,
а в Kotlin можно использовать функцию apply с любым объектом без ка­
кой-либо специальной поддержки со стороны библиотеки, где этот объект
определен.
170 ❖
Глава 5. Лямбда-выражения
Чтобы увидеть, как работает функция apply в таких случаях, рассмот­
рим пример, создающий Android-компонент TextView с некоторыми из­
мененными атрибутами.
Листинг 5.20. Применение функции apply для инициализации экземпляра TextView
fun createViewWithCustomAttributes(context: Context) =
TextView(context).apply {
text = "Sample Text"
textSize = 20.0
setPadding(10, 0, 0, 0)
Функция apply позволяет использовать компактный синтаксис те­
ла-выражения. Здесь мы создаем новый экземпляр TextView и немед­
ленно передаем его функции apply. В лямбда-выражении, переданном в
функцию apply, экземпляр TextView становится получателем, благодаря
чему появляется возможность вызывать его методы и менять свойства.
После выполнения лямбда-выражения функция apply вернет уже ини­
циализированный экземпляр - это и станет результатом вызова функции
createViewW ithCustom Attributes.
Функции w ith и apply - наиболее типичные примеры использования
лямбда-выражений с получателями. Более конкретные функции тоже мо­
гут использовать этот шаблон. Например, функцию append можно упрос­
тить с помощью стандартной библиотечной функции b u ild S tr in g , кото­
рая позаботится о создании экземпляра S trin g B u ild er и вызовет метод
to S tr in g . Она ожидает получить лямбда-выражение с получателем, а по­
лучателем всегда будет экземпляр S trin gB u ild er.
Листинг 5.21. Использование функции buildString для генерации алфавита
fun alphabetQ = buildString {
for (le tte r in 'A'. . 'Z') {
append(letter)
}
append("\nNow I know the alphabet!")
}
Функция b u ild S tr in g - элегантное решение задачи создания строки с
помощью класса S trin gB u ild er.
Еще более интересные примеры вы увидите в главе 11, когда мы начнем
обсуждать предметно-ориентированные языки (Domain Specific Languages,
DSL). Лямбда-выражения с получателями прекрасно подходят для созда­
ния DSL; мы покажем, как применить их для этой цели и как определить
собственные функции, вызывающие лямбда-выражения с получателями.
5.6. Резюме ❖
171
5.6. Резюме
О Лямбда-выражения позволяют передавать фрагменты кода в функ­
ции.
О Kotlin дает возможность передавать лямбда-выражения в функции
за скобками и ссылаться на единственный аргумент лямбда-выра­
жения как на i t .
О Код внутри лямбда-выражения может читать и изменять локальные
переменные функции, в которой оно вызывается.
О Есть возможность ссылаться на методы, конструкторы и свойства,
добавляя к их именам префикс :: и передавая такие ссылки в функ­
ции вместо лямбда-выражений.
О Большинство операций над коллекциями могут выполняться без ор­
ганизации итераций вручную, с помощью функций filte r , map, a l l ,
any и т. д.
О Последовательности позволяют объединить несколько операций с
коллекцией, не создавая дополнительных коллекций для хранения
промежуточных результатов.
О Лямбда-выражения можно передавать в методы, принимающие в
параметрах функциональные интерфейсы Java (интерфейсы с одним
абстрактным методом, также известные как SAM-интерфейсы).
О Лямбда-выражения с получателем - это особый вид аноним­
ных функций, которые могут непосредственно вызывать методы
специального объекта-получателя.
О Функция стандартной библиотеки w ith позволяет вызвать несколько
методов одного объекта, не повторяя имени ссылки на него. Функ­
ция apply позволяет создать и инициализировать любой объект в
стиле шаблона «Строитель».
Система типов Kotlin
В этой главе:
■ типы с поддержкой пустых значений и работа с nul I ;
■ простые типы и их соответствие типам Java;
■ коллекции в Kotlin и их связь с Java.
На данный момент вы познакомились с большей частью синтаксиса Kotlin,
вышли за рамки написания Kotlin-кода, эквивалентного коду на Java, и го­
товы воспользоваться некоторыми особенностями Kotlin, которые повы­
сят вашу эффективность и сделают код более компактным и читаемым.
Давайте немного сбавим темп и подробнее рассмотрим одну из самых
важных частей языка Kotlin: его систему типов. В сравнении с Java систе­
ма типов в Kotlin имеет особенности, необходимые для повышения на­
дежности кода, такие как типы с поддержкой пустого значения и коллекции,
доступные только для чтения. Система типов в Kotlin также избавлена от
некоторых особенностей системы типов в Java, которые оказались ненуж­
ными или проблематичными (например, поддержка специального син­
таксиса для массивов). Давайте углубимся в детали.
6.1. Поддержка значения null
Поддержка значения n u ll - это особенность системы типов Kotlin, кото­
рая помогает избежать исключения N ullP ointerE xception. Как пользо­
ватель программ вы наверняка видели такие сообщения: «Ап error has
occurred: java.lang.NullPointerException» (Произошла ошибка: java.lang.
NullPointerException) без каких-либо дополнительных подробностей.
Другой вариант - сообщение вида: «Unfortunately, the application X has
stopped» (К сожалению, приложение X перестало работать), которое часто
скрывает истинную причину - исключение N ullP oin terE xception . Такие
ошибки сильно портят жизнь пользователям и разработчикам.
6.1. Поддержка значения null ❖
173
Многие современные языки, в том числе Kotlin, преобразуют такие
ошибки времени выполнения в ошибки времени компиляции. Поддержи­
вая значение n u ll как часть системы типов, компилятор может обнару­
жить множество потенциальных ошибок во время компиляции, уменьшая
вероятность появления исключений во время выполнения.
В этом разделе мы обсудим типы Kotlin, поддерживающие n u ll: как в
Kotlin отмечаются элементы, способные принимать значение n u ll, и ка­
кие инструменты он предоставляет для работы с такими значениями. Так­
же мы рассмотрим нюансы смешения кода Kotlin и Java с точки зрения
допустимости значения n u ll.
6.1.1. Типы с поддержкой значения null
Первое и самое важное различие между системами типов в Kotlin и
Java - это явная поддержка в Kotlin типов, допускающих значение n u ll. Что
это значит? То, что есть способ указать, каким переменным или свойствам
в программе разрешено иметь значение n u ll. Если переменная может
иметь значение n u ll, вызов её метода небезопасен, поскольку есть риск
получить исключение N ullP oin terE xception . Kotlin запрещает такие вы­
зовы, предотвращая этим множество потенциальных ошибок. Чтобы уви­
деть, как это работает на практике, рассмотрим следующую функцию на
Java:
/* lava */
in t strLen(String s) {
return s.lengthQ;
}
Безопасна ли эта функция? Если вызвать функцию с аргументом n u ll,
она возбудит исключение N ullP oin terE xception . Стоит ли добавить в
функцию проверку на n u ll? Это зависит от предполагаемого использова­
ния функции.
Попробуем переписать её на языке Kotlin. Первый вопрос, на который
мы должны ответить: может ли функция вызываться с аргументом n u ll?
Мы имеем в виду не только непосредственную передачу n u ll, как в вызове
str L e n (n u ll), но и передачу любой переменной или другого выражения,
которое во время выполнения может иметь значение n u ll.
Если такая возможность не предполагается, тогда функцию можно объ­
явить так:
fun strLen(s: String) = s.length
Вызов strLen с аргументом, который может иметь значение n u ll, не
допускается и будет расценен как ошибка компиляции:
»> strLen(null)
ERROR: Null can not be a value of a non-null type String
174 ❖
Глава 6. Система типов Kotlin
Тип параметра объявлен как S trin g , а в Kotlin это означает, что он всег­
да должен содержать экземпляр S trin g . Компилятор не позволит пере­
дать аргумент, способный содержать значение n u ll. Это гарантирует, что
функция strLen никогда не вызовет исключение, N ull P oin ter Except ion
во время выполнения.
Чтобы разрешить вызов этой функции с любыми аргументами, в том
числе и n u ll, мы должны указать это явно, добавив вопросительный знак
после имени типа:
fun strLenSafe(s: String?) = ...
Вопросительный знак можно добавить
ИЛИ
Туре?
Туре
null
после любого типа, чтобы указать, что пеРис. 6.1. Если тип допускает,
ременные этого типа могут хранить значепеременная может хранить null
ние n u ll: S trin g?, In t?, MyCustomType? и
т. д. (см. рис. 6.1).
Повторим еще раз: тип без знака вопроса означает, что переменные
этого типа не могут хранить значения n u ll. То есть все обычные типы по
умолчанию не поддерживают n u ll, если не указать это явно.
Как только у вас появится значение типа с поддержкой значения
n u ll, вы сразу обнаружите, что набор допустимых операций с этим зна­
чением заметно сузился. Например, вы больше не сможете вызывать
его методы:
» fun strLenSafe(s: String?) = s.lengthQ
ERROR: only safe (?.) or non-null asserted ( ! ! . ) calls are allowed
on a nullable receiver of type kotlin.String?
Вы также не сможете присвоить такое значение переменной, тип кото­
рой не поддерживает nul I :
»> val х: String? = null
»> var у: String = x
ERROR: Type mismatch: inferred type is String? but String was expected
Вы не сможете передать значение типа с поддержкой n u ll в функцию,
параметр который никогда не может быть n u ll:
»> strLen(x)
ERROR: Type mismatch: inferred type is String? but String was expected
Так что же с этим делать? Самое главное - сравнить его с n u ll. Как толь­
ко вы выполните это сравнение, компилятор запомнит его результат и
будет считать, что переменная не может иметь значения n u ll в области
действия, где было произведено вышеупомянутое сравнение. Например,
такой код вполне допустим.
6.1. Поддержка значения null ❖
Листинг 6.1.
175
Работа со значением null с помощью проверки if
fun strLenSafe(s: String?): In t =
i f (s != null) s.length else 0
»> val х: String? = null
»> println(strLenSafe(x))
0
»> println( strLenSafe("abc"))
3
<H Последобавленияпроверкина
I null кодначалкомпилироваться
Если бы проверка i f была единственным инструментом для работы
со значениями n u ll, ваш код довольно быстро превратился бы в много­
этажные наслоения таких проверок. К счастью, Kotlin предоставляет ещё
несколько инструментов, помогающих справиться со значением n u ll в
более лаконичной манере. Но, прежде чем приступить к их изучению, по­
говорим немного о смысле допустимости значения n u ll и о том, какие
бывают типы переменных.
6.1.2. Зачем нужны типы
Начнем с самых общих вопросов: что такое типы и зачем они перемен­
ным? Статья в Википедии о типах ( h t t p s : / / r u . w i k i p e d i a . o r g / w i k i /
Тип данных) дает очень хороший ответ на первый вопрос: «Тип данных множество значении и операции на этих значениях».
Попробуем применить это определение к некоторым из типов Java, на­
чиная с типа double. Как известно, тип double представляет 64-разрядное число с плавающей точкой. Над этими значениями можно выполнять
стандартные математические операции. Все эти функции в равной сте­
пени применимы к любому значению типа double. Поэтому если в про­
грамме есть переменная типа double, можно быть уверенным, что любая
операция, разрешенная компилятором, будет успешно выполнена со зна­
чением данного типа.
Теперь проведем аналогию с переменной типа S trin g . В Java такая пере­
менная может хранить значение одного из двух видов: экземпляр класса
S trin g или n u ll. Эти виды значений совершенно непохожи друг на друга:
даже Java-оператор in sta n c e o f скажет вам, что n u ll - это не S trin g . Опе­
рации, допустимые для значении этих видов, тоже совершенно различны:
настоящий экземпляр S trin g позволяет вызывать любые строковые мето­
ды, в то время как к значению n u ll может применяться лишь ограничен­
ный набор операций.
Это означает, что система типов в Java не справляется со своей задачей.
Хотя переменная объявлена с типом S trin g , мы не сможем узнать, какие
операции допустимы, не выполнив дополнительную проверку. Часто та­
кие проверки опускаются, поскольку из общего потока данных в програм-
176
❖
Глава 6. Система типов Kotlin
ме известно, что значение не может быть n u ll в некоторой точке. Но иног­
да вы можете ошибиться - и тогда ваша программа аварийно завершит
работу с исключением N ullP oin terE xception .
ругие способы борьбы с NullPointerException
В Java есть инструменты, способные помочь решить проблему N ullP oin­
terException. Например, некоторые разработчики используют аннотации (например,
©Nullable и ©NotNuii), чтобы указать на допустимость или недопустимость значе­
ния n u ll. Существуют инструменты (например, встроенный анализ кода в IntelLiJ IDEA),
способные использовать эти аннотации для обнаружения места, где может возникнуть
NuiiPointerException.HoTaKne инструменты не являются частьюстандартного про­
цесса компиляции вJava, поэтому их постоянное применение трудно гарантировать.Так­
же трудно снабдить аннотациями всю кодовую базу, включая библиотеки, используемые
в проекте, чтобы можно было обнаружить все возможные места возникновения ошибок.
Наш собственный опыте JetBrains показывает,что даже широкое применение аннотаций,
определяющих допустимость n u ll, не решает проблему N ullP ointerE xception
полностью.
Другой подход к решению этой проблемы заключается в запрете использования зна­
чения n u ll и в применении особых оберток (таких как тип Optional, появившийся в
Java 8) для представления значений, которые могут быть или не быть определены. Этот
подход имеет несколько недостатков: код становится более громоздким, дополнитель­
ные обертки отрицательно сказываются на производительности, и они не применяют­
ся последовательно во всей экосистеме. Даже если вы используете Optional везде в
своем коде, вам все равно придется иметь дело со значением n u ll, возвращаемым из
методов JDK, фреймворка Android и других сторонних библиотек
Типы Kotlin с поддержкой n u ll предоставляют комплексное решение
этой проблемы. Разграничение типов на поддерживающие и не поддер­
живающие nul I дает четкое понимание того, какие операции можно вы­
полнять со значениями, а какие операции могут привести к исключению
во время выполнения и поэтому запрещены.
Примечание. Экземпляры типов - с поддержкой или без поддержки n u ll - во время
выполнения суть одни и те же.Тип с поддержкой значения n u ll - это не обертка вокруг
обычного типа. Все проверки выполняются во время компиляции. Это означает, что типы с
поддержкой n u ll в Kotlin не расходуют дополнительных системных ресурсов во время
выполнения.
Теперь посмотрим, как работать с типами, поддерживающими n u ll, и
почему работа с ними не раздражает. Начнем со специального оператора
безопасного доступа к значениям, которые содержат n u ll.
6.1. Поддержка значения null ❖
177
6.1.3. Оператор безопасного вызова:«?.»
Один из самых полезных инструментов в арсенале КоШп - это оператор
безопасного вызова: ?. Он сочетает в одной операции проверку на n u ll и
вызов метода. Например, выражение s ? . tol)pperCase( ) эквивалентно сле­
дующему, более громоздкому: i f ( s != n u ll) s . toUpperCase() e ls e n u ll.
Другими словами, если значение, метод которого вы пытаетесь вызвать,
не является n u ll, то вызов будет выполнен обычным образом. Если значе­
ние равно n u ll, вызов игнорируется, и в качестве результата возвращает­
ся n u ll. Работа оператора показана на рис. 6.2.
Рис. 6.2. Оператор безопасного вызова выполняет методы
лишь для значений, отличных от null
Обратите внимание, что результатом такого вызова может быть n u ll.
Хотя метод S tr in g . toUpperCase возвращает значение типа S trin g , выра­
жение s ? . tol)pperCase( ) для s с поддержкой n u ll получит тип String?:
fun printAUCaps(s: String?) {
val allCaps: String? = s?.toUpperCase()
println(allCaps)
}
»> printAUCaps("abc")
ABC
»> printAUCaps(null)
null
Оператор безопасного вызова также можно использовать не только для
вызова методов, но и для доступа к свойствам. В следующем примере по­
казан простой класс Kotlin со свойством, способным принимать значение
n u ll, и продемонстрировано использование оператора безопасного вызо­
ва для доступа к этому свойству.
Листинг 6.2. Применение оператора безопасного вызова для доступа к свойствам,
способным принимать значение null
class Employee(val name: String, val manager: Employee?)
fun managerName(employee: Employee): String? = employee.manager?.name
»> val ceo = Employee("Da Boss", null)
»> val developer = Employee("Bob Smith", ceo)
178 ❖
Глава 6. Система типов КоШп
» > println(managerName(developer))
Da Boss
» > println(managerName(ceo))
n u ll
Если в программе есть иерархия объектов, различные свойства которых
способны принимать значение n u ll, бывает удобно использовать несколь­
ко безопасных вызовов в одном выражении. Представьте, что вы храните
информацию о человеке, его компании и адресе компании, используя раз­
личные классы. И компания, и её адрес могут быть опущены. С помощью
оператора ?. можно в одном вызове без дополнительных проверок опре­
делить, из какой страны этот человек.
Листинг 6.3. Объединение нескольких операторов безопасного вызова
class Address(val streetA ddress: S tring, val zipCode: In t,
val c ity : S tring, val country: S tring)
class Company(val name: S tring, val address: Address?)
class Person(val name: S tring, val company: Company?)
fun Person.countryName(): String {
val country = this.com pany?.address?.country
return i f (country != n u ll) country else "Unknown"
< 1—I Объединение нескольких
I операторов безопасного вызова
>
» > val person = Person("Dmitry", n u ll)
» > p rin tln (p e rso n . countryName())
Unknown
Последовательность вызовов с проверками на n u ll в Java - обычное
явление, и сейчас вы увидели, как Kotlin делает её компактнее. Но в лис­
тинге 6.3 есть ненужные повторения: мы сравниваем результат с n u ll и
возвращаем само значение либо что-то ещё, если оно равно n u ll. Давайте
посмотрим, поможет ли Kotlin избавиться от этого повторения.
6.1.4. Оператор «Элвис»:«?:»
В языке Kotlin есть удобный оператор для замены n u ll значениями по
умолчанию. Он называется оператор «Элвис» (или оператор объединения
со значением null, если вы предпочитаете официальные названия). Выгля­
дит он так: ?: (если наклонить голову влево, можно увидеть изображение
Элвиса). Вот как он используется:
fun foo(s: String?) {
val t : String = s ?: ""
}
<H ^слиф ХрлНИТпицц
I вернуть пустую строку
6.1. Поддержка значения null ❖
179
Оператор принимает два значения и возвращает первое, если оно не
равно n u ll, а в противном случае - второе. На рис. 6.3 показано, как это
работает.
Рис. 6.3. Оператор «Элвис» подставляет конкретное значение вместо null
Оператор «Элвис» часто используется вместе с оператором безопасного
вызова, чтобы вернуть значение, отличное от n u ll, когда объект, метод
которого вызывается, сам может вернуть n u ll. Вот как можно применить
этот шаблон, чтобы упростить код в листинге 6.1.
Листинг 6.4. Применение оператора «Элвис» для работы с null
fun strLenSafe(s: String?): In t = s?.length ?: 0
»> println(strLenSafe("abc"))
3
»> println(strLenSafe(null))
0
Функцию countryName из листинга 6.3 тоже можно уместить в одну
строку:
fun Person.countryName() =
company?.address?.country ?: "Unknown"
Особенно удобным оператор «Элвис» делает то обстоятельство, что
такие операции, как retu rn и throw, действуют как выражения и, следо­
вательно, могут находиться справа от оператора. То есть если значение
слева окажется равным n u ll, функция немедленно вернет управление
или возбудит исключение. Это полезно для проверки предусловий в
функции.
Давайте посмотрим, как применить этот оператор, чтобы реализовать
функцию печати почтовой наклейки с адресом компании человека, кото­
рого мы упоминали выше. В листинге 6.5 повторяются объявления всех
классов, но в Kotlin они настолько лаконичны, что это не представляет не­
удобств.
Листинг 6.5. Использование оператора throw с оператором «Элвис»
class Address(val streetAddress: String, val zipCode: In t,
180 ❖
Глава 6. Система типов Kotlin
val city: String, val country: String)
class Company(val name: String, val address: Address?)
class Person(val name: String, val company: Company?)
fun printShippingLabel(person: Person) {
val address = person, company?, address
I Вызоветисключениев
?: throw IllegalArgumentException("No address")
<H отсутствиеадреса
with (address) {
<*“ 1Переменная«address»
println(streetAddress)
| хранитнепустоезначение
println("$zipCode Scity, Scountry")
}
}
»> val address = Address("Elsestr. 47", 80687, "Munich", "Germany")
»> val jetbrains = Company("DetBrains", address)
»> val person = Person("Dmitry", jetbrains)
»> printShippingLabel(person)
Elsestr. 47
80687 Munich, Germany
»> printShippingLabel(Person("Alexey", n u ll))
java.lang.IllegalArgumentException: No address
Если все правильно, функция printShippingL abel напечатает на­
клейку. Если адрес отсутствует, она не просто сгенерирует исключение
N ullP ointerE xception с номером строки, но вернет осмысленное сообще­
ние об ошибке. Если адрес присутствует, текст наклейки будет состоять из
адреса, почтового индекса, города и страны. Обратите внимание, как здесь
используется функция w ith, которую мы видели в предыдущей главе: она
помогает избежать повторения переменной address четыре раза подряд.
Теперь, когда вы знаете, как Kotlin выполняет проверки на null, давайте
поговорим о безопасной версии оператора instanceof в Kotlin: операторе
безопасного приведения, который часто появляется вместе с безопасными
вызовами и оператором «Элвис».
6.1.5. Безопасное приведение типов: оператор «as?»
В главе 2 вы уже видели оператор as, используемый в Kotlin для приве­
дения типов. Как и в lava, оператор as возбудит ClassCastException, если
значение нельзя привести к указанному типу. Конечно, можно совместить
его с проверкой is, чтобы убедиться, что значение имеет правильный тип.
Но разве в таком безопасном и лаконичном языке, как Kotlin, нет лучшего
решения? Безусловно, есть.
6.1. Поддержка значения null ❖
181
Рис. 6.4. Оператор безопасного приведения пытается привести значение
к заданному типу и возвращает null, если фактический тип отличается от ожидаемого
Оператор as? пытается привести значение указанного типа и возвра­
щает n u ll, если значение нельзя привести к указанному типу, как показа­
но на рис. 6.4.
Оператор безопасного приведения часто используется в сочетании с
оператором «Элвис». Например, это может пригодиться для реализации
метода eq u als.
Листинг 6.6. Использование оператора безопасного приведения для реализации
метода equals
class Person(val firstName: String, val lastName: String) {
override fun equals(o: Any?): Boolean {
val otherPerson = о as? Person ?: return false
<H Проверит™ и вернет false,
если указанный ™ недопустим
return otherPerson.firstName == firstName && < И После безопасного приведения
otherPerson.lastName == lastName
I типа переменная otherPerson
преобразуется к типу Person
}
override fun hashCode(): In t =
firstName.hashCode() * 37 + lastName.hashCodeQ
»> val pi = Person("Dmitry", "Demerov")
»> val p2 = Person("Dmitry", "Demerov")
» > p r in tin g == p2)
tr u e
»> println(pl.equals(42))
false
Оператор:= вызывает
I метод «equals»
Этот шаблон позволяет легко убедиться, что параметр обладает пра­
вильным типом, выполнить его приведение, вернуть false, если значение
имеет несовместимый тип, - и все в одном выражении. Автоматическое
приведение типов также применимо в данном контексте: после провер­
ки типа и отсеивания значения null компилятор знает, что переменная
otherPerson имеет тип Person, и позволяет использовать её соответствую­
щим образом.
Операторы безопасного вызова, безопасного приведения и оператор
«Элвис» очень удобны и часто встречаются в коде на Kotlin. Но иногда бы-
182 ❖
Глава 6. Система типов Kotlin
вает нужно просто сообщить компилятору, что значение на самом деле не
может быть равно n u ll. Давайте посмотрим, как можно это сделать.
6.1.6. Проверка на null: утверждение «!!»
Данное утверждение - самый простой и незатейливый способ, который
Kotlin предоставляет для работы со значением n u ll. Оно записывается как
двойной восклицательный знак и преобразует любое значение к типу, не
поддерживающему значения n u ll. Если значение равно n u ll, во время
выполнения возникнет исключение. Логика работы утверждения показа­
на на рис. 6.5.
Рис. 6.5. Используя утверждение, что значение не равно null,
можно явно возбудить исключение, если значение окажется равным null
Вот простой пример функции, использующей утверждение для преобра­
зования аргумента из типа с поддержкой n u ll в тип без поддержки n u ll.
Листинг 6.7. Использование утверждения о невозможности значения n u ll
fun ignoreNulls(s: String?) {
val sNotNull: String = s!!
println(sNotNull.length)
}
»> ignoreNulls(null)
Exception in thread "main" k o tlin .KotlinNullPointerException
at < ...>.ignoreNulls(07_NotnullAssertions.kt:2)
Что произойдет, если передать этой функции значение n u ll в аргумен­
те s? У Kotlin не останется выбора: во время выполнения он возбудит ис­
ключение (особый вид исключения N ullP ointerE xception). Но обратите
внимание, что исключение ссылается на строку с утверждением, а не на
инструкцию вызова. По сути, вы говорите компилятору: «Я знаю, что зна­
чение не равно n u ll, и я готов получить исключение, если выяснится, что
я ошибаюсь».
Примечание. Вы можете заметить, что двойной восклицательный знак выглядит грубова­
то - как будто вы кричите на компилятор. Так и было задумано. Разработчики языка Kotlin
пытаются подтолкнуть вас в сторону лучших решений, без заявлений, которые не могут быть
проверены компилятором.
6.1. Поддержка значения null ❖
183
Но бывают ситуации, когда такие утверждения (что значение не равно
n u ll) оптимально решают проблему: когда вы делаете проверку на n u ll в
одной функции и используете это значение в другой, компилятор не мо­
жет понять, что такое использование безопасно. Если вы уверены, что про­
верка всегда выполняется в другой функции, у вас может появиться жела­
ние отказаться от её повторения перед использованием значения. В таком
случае вы можете применить утверждение, заявив, что значение не может
быть равно n u ll.
На практике это происходит с классами обработчиков, определяемых во
многих фреймворках для создания пользовательских интерфейсов - на­
пример, таких как Swing. Класс-обработчик имеет отдельные методы для
обновления состояния (его включения или отключения) и выполнения
действия. Проверки, выполненные в методе update, гарантируют, что ме­
тод execu te не будет вызван в отсутствие необходимых условий, но ком­
пилятор не способен понять это.
Давайте рассмотрим пример реализации обработчика в Swing с исполь­
зованием утверждения !!. Объект класса CopyRowAction должен скопиро­
вать значение из строки, выбранной в списке, в буфер обмена. Мы опустим
все ненужные детали, оставив только код, проверяющий факт выбора стро­
ки (т. е. что действие может быть выполнено) и получающий выбранную
строку. Интерфейс Action API предполагает, что метод actionPerform ed
можно вызвать, только если метод isE nabled вернет tru e.
Листинг 6.8. Использование утверждения !! в обработчике Swing
class CopyRowAction(val lis t: HList<String>) : AbstractAction() {
override fun isEnabled(): Boolean =
list.selectedValue != null
override fun actionPerformed(e: ActionEvent)
val value = list.selectedValue!!
/ / copy value to clipboard
Метод actionPerformed будет вызван,
только если isEnabled вернет «true»
}
}
Обратите внимание: если вы не хотите использовать утверждение !!
в этой ситуации,то можете написать v a l valu e = lis t .s e le c t e d V a lu e ?:
return, чтобы получить значение, отличное от n u ll. Если l i s t .
selected V a lu e вернет n u ll, это приведет к досрочному выходу из функ­
ции и valu e никогда не получит значения n u ll. Хотя проверка на n u ll с
помощью оператора «Элвис» здесь лишняя, она может оказаться хорошей
страховкой, если в будущем метод isE nabled усложнится.
Ещё один нюанс, который стоит держать в уме: когда вы используете
утверждение !! и в результате получаете исключение, трассировка стека
184 ❖
Глава 6. Система типов Kotlin
покажет только номер строки, в которой оно возникло, а не конкретное
выражение. Чтобы выяснить, какое значение оказалось равно n u ll, лучше
избегать использования нескольких утверждений !! в одной строке:
person. company!!. address!!. country
о — Heпишитетакогокода!
Если вы получите исключение в этой строке, то не сможете сказать, ка­
кое поле получило значение n u ll: company или address.
До сих пор мы в основном обсуждали, как обращаться к значениям ти­
пов с поддержкой значения n u ll. Но что делать, если требуется передать
аргумент, который может оказаться значением n u ll, в функцию, которая
ожидает значения, не равного n u ll? Компилятор не позволит сделать это
без проверки, поскольку это небезопасно. В языке Kotlin нет специального
механизма для этого случая, но в стандартной библиотеке есть одна функ­
ция, которая может вам помочь: она называется le t .
6.1.7. Функция Let
Функция l e t облегчает работу с выражениями, допускающими значе­
ние n u ll. Вместе с оператором безопасного вызова она позволяет вычис­
лить выражение, проверить результат на n u ll и сохранить его в перемен­
ной - и все это в одном коротком выражении.
Чаще всего она используется для передачи аргумента, который может
оказаться равным n u ll, в функцию, которая ожидает параметра, не равно­
го n u ll. Допустим, функция sendEmailTo принимает один параметр типа
S trin g и отправляет электронное письмо на этот адрес. Эта функция на­
писана на Kotlin и требует параметра, который не равен n u ll:
fun sendEmailTo(email: String) { / * . . . * / }
Вы не сможете передать в эту функцию значение типа с поддержкой
n u ll:
»> val email: String? = ...
»> sendEmailTo(email)
ERROR: Type mismatch: inferred type is String? but String was expected
Вы должны явно проверить, что значение не равно n u ll:
if (email != null) sendEmailTo(email)
Но можно пойти другим путем: применить функцию le t , объединив её
с оператором безопасного вызова. Функция l e t просто превращает объ­
ект вызова в параметр лямбда-выражения. Объединяя её с синтаксисом
безопасного вызова, вы фактически преобразуете объект из типа с под­
держкой n u ll в тип без поддержки n u ll (см. рис. 6.6).
6.1. Поддержка значения null ❖
185
Рис. 6.6. Безопасный вызов функции let выполнит лямбда-выражение,
только если выражение не равно null
Функция l e t будет вызвана, только если значение адреса электрон­
ной почты не равно n u ll, поэтому его можно использовать как аргумент
лямбда-выражения, не равный n u ll:
email?.let { email -> sendEmailTo(email) }
С использованием краткого синтаксиса - с автоматически создан­
ным именем i t - результат станет ещё лаконичнее: e m a il? .le t
{
sendE m ailT o(it) }. Ниже показан полноценный пример, демонстри­
рующий этот шаблон.
Листинг 6.9. Применение функции le t для вызова функции, не принимающей n u ll
fun sendEmailTo(email: String) {
println("Sending email to $email")
}
»> var email: String? = "yole@example.com
»> email?.let { sendEmailTo(it) }
Sending email to yole@example.com
»> email = null
»> email?.let { sendEmailTo(it) }
Обратите внимание, что нотация l e t особенно удобна, когда нужно ис­
пользовать значение большого выражения, не равного n u ll. В этом случае
вам не придется создавать отдельную переменную. Сравните следующий
фрагмент с явной проверкой:
val person: Person? = getTheBestPersonInTheWorld()
if (person != null) sendEmailTo(person.email)
с аналогичной реализацией без дополнительной переменной:
getTheBestPersonInTheWorld()?.let { sendEmailTo(it.email) }
Эта функция всегда возвращает n u ll, поэтому лямбда-выражение ни­
когда не будет выполнено.
fun getTheBestPersonlnTheWorldQ: Person? = null
186 ❖
Глава 6. Система типов Kotlin
Чтобы проверить несколько значений на n u ll, можно использовать
вложенные вызовы le t . Но в большинстве случаев такой код становится
слишком трудным для понимания. Обычно для проверки сразу всех выра­
жений проще использовать простой оператор i f .
Еще одна распространенная ситуация - непустые свойства, которые
тем не менее невозможно инициализировать в конструкторе значением,
отличным от n u ll. Давайте посмотрим, как Kotlin помогает справиться с
этой ситуацией.
6.1.8. Свойства с отложенной инициализацией
Многие фреймворки инициализируют объекты в специальных методах,
которые вызываются после создания экземпляра. Например, в Android
инициализация осуществляется в методе onCreate. JUnit требует поме­
щать логику инициализации в методы с аннотацией ©Before.
Но вы не можете оставить свойства, не поддерживающего значения
n u ll, без инициализации в конструкторе, присваивая ему значение толь­
ко в специальном методе. Kotlin требует инициализации всех свойств в
конструкторе, и если свойство не может иметь значения n u ll, вы обязаны
указать значение для инициализации. Если нет возможности предоста­
вить такое значение, приходится использовать тип с поддержкой n u ll. Но
в этом случае при каждом обращении к свойству придется использовать
проверку на n u ll или утверждение !!.
Листинг 6.10. Применение утверждений !! для доступа к полю с поддержкой n u ll
class MyService {
fun performAction(): String = "foo"
}
class MyTest {
private var myService: MyService? = null <3—i Объявление свойства с типом, поддерживающим
I null, чтобы инициализировать его значением nuU
^Before fun setUp() {
myService = MyServiceQ
<H Настоящее значение
}
I присваивается в методе setup
@Test fun testAction() {
Assert.assertEquals("foo",
myService!! .performAction())
}
<•"1 Из-за такого объявления
I приходится использовать!! или ?
}
Это неудобно, особенно когда приходится обращаться к свойству мно­
го раз. Чтобы решить эту проблему, можно объявить, что поле myService
6.1. Поддержка значения null ❖
187
поддерживает отложенную инициализацию. Это делается с помощью мо­
дификатора l a t e in it .
Листинг 6.11. Применение свойства с «ленивой» инициализацией
class MyService {
fun performAction(): String = "foo
}
class MyTest {
private la te in it var myService: MyService
^Before fun setl)p() {
myService = MyService()
}
<H объявлениесвойствастипом, не
I поддерживающимnull, безинициализации
Инициализациявметоде
setupтакаяже, какраньше
@Test fun testAction() {
Assert.assertEquals("foo",
myService.performAction())
}
Обратите внимание, что поля с отложенной инициализацией всегда
объявляются как var, потому что их значения изменяются за пределами
конструктора, в то время как свойства v a l компилируются в финальные
поля, которые должны инициализироваться в конструкторе. Поля с отло­
женной инициализацией больше не требуется инициализировать в кон­
структоре, даже если их типы поддерживают n u ll. Попытка обратиться
к такому свойству прежде, чем оно будет инициализировано, возбудит
исключение «lateinit property myService has not been initialized» (свойство
myService с модификатором lateinit не было инициализировано). Оно чет­
ко сообщит, что произошло, и понять его гораздо легче, чем обычное ис­
ключение N ullP ointerE xception.
Примечание. Свойства с модификатором la t e in it широко используются для внедре­
ния зависимостей. Значения таких свойств устанавливаются извне специализированным
фреймворком. Для совместимости с широким спектром фреймворков Java язык Kotlin ге­
нерирует поле с такой же видимостью, как и свойство с модификатором la te in it. Если
свойство объявлено как pub lic, поле тоже получит модификатор public.
Теперь посмотрим, как можно расширить набор инструментов Kotlin
для работы с n u ll, определяя функции-расширения для типов с поддерж­
кой n u ll.
188 ❖
Глава 6. Система типов Kotlin
6.1.9. Расширение типов с поддержкой null
Определение функций-расширений для типов с поддержкой n u ll - ещё
один мощный способ справляться с n u ll. Вместо того чтобы проверять пе­
ременную на неравенство n u ll перед вызовом метода, можно разрешить
вызовы функций, где в роли получателя выступает n u ll, и иметь дело с
n u ll в этой функции. Это возможно только для функций-расширений обычные вызовы методов класса направляются экземпляру класса и, сле­
довательно, не могут быть выполнены, если экземпляр равен n u ll.
В качестве примера рассмотрим функции isEmpty и isB lank, опреде­
ленные как расширения класса S trin g в стандартной библиотеке Kotlin.
Первая проверяет, пуста ли строка (т. е. строка""), а вторая проверяет, что
она пуста или состоит только из символов пробела. Обычно эти функции
используются, чтобы убедиться, что строка не тривиальна, и затем сделать
с ней что-то осмысленное. Вам может показаться, что было бы полезно
обрабатывать значения n u ll также, как пустые строки или строки, состоя­
щие из пробелов. И это действительно возможно: функции isEmptyOrNull
и isBlankO rNull могут вызываться с получателем типа S trin g?.
Листинг 6.12. Вызов функции-расширения с получателем,тип которого
поддерживает n u ll
fun verifyUserInput(input: String?) {
i f (input.isNullOrBlankO) {
println("Please f i l l in the required fields")
<1“ I He требуется использовать
I оператора безопасного вызова
}
}
Если вызвать
isNulLOifilank c null
в качестве получателя,
»> veri f yUserInput (" ")
зто не приведет
Please f i l l in the required fields
к
исключению
»> verifyUserlnput(null)
<3-*
Please f i l l in the required fields
Значение с типом, Расширение
поддерживающим для типа с
null
поддержкой null
С
NГ
Л
input.isNullOrBlank()
Функцию-расширение, объявленную допускаю­
Безопасный вызов не требуется!
щей использование n u ll в качестве получателя,
Рис. 6.7. Расширения
можно вызывать без оператора безопасного вы­ для типов с поддержкой
null могут вызываться
зова (см. рис. 6.7). Функция сама обработает воз­
без
синтаксиса
можные значения n u ll.
безопасного вызова
Функция isNullO rBlank выполняет явную проверку на n u ll, возвращая значение tru e, а иначе вызывает isB lank, кото­
рую можно применять только к строкам, которые не могут быть n u ll:
J Расширение для типа
fun String?.isNullOrBlankQ: Boolean
String с поддержкой null
this == null || this.isBlankQ
Во втором обращении к «this» применяется
автоматическое приведение типов
6.1. Поддержка значения null ♦> 189
Когда функция-расширение объявляется для типа с поддержкой n u ll
(имя которого оканчивается на ?), это означает, что её можно вызывать для
значений n u ll; в этом случае ссылка t h is в теле функции может оказаться
равной nul I, поэтому её следует проверять явно. В Java ссылка t h is никогда
не может быть n u ll, поскольку она ссылается на экземпляр класса, которо­
му принадлежит метод. В Kotlin это изменилось: в функции-расширении
для типа с поддержкой n u ll ссылка t h is может оказаться равной n u ll.
Обратите внимание, что ранее рассмотренная функция l e t тоже может
быть вызвана для получателя n u ll, но сама функция не будет выполнять
никаких проверок. Если попытаться вызвать её для типа с поддержкой
n u ll без оператора безопасного вызова, аргумент лямбда-выражения
тоже будет поддерживать n u ll:
»> val person: Person? =
J Небезопасный вызов, поэтому «it»
может оказаться равным null
»> person.let { sendEmailTo(it) }
ERROR: Type mismatch: inferred type is Person? but Person was expected
Следовательно, если вы хотите проверять аргументы на неравенство
значению n u ll с помощью функции l e t , вы должны использовать опе­
ратор безопасного вызова ? ., как было показано выше: p e r s o n ? .le t {
sendE m ailT o(it) }.
Примечание. Создавая собственную функцию-расширение, вам стоит задуматься о том,
нужно ли определять её как расширение типа с поддержкой n u ll. По умолчанию имеет
смысл определять как расширение типа без поддержки n u ll. Вы можете спокойно изме­
нить её позже (существующий код не сломается), если выяснится, что функция в основном
используется для значений, которые могут быть равны n u ll, и может адекватно обработать
такие значения.
В этом разделе вы увидели кое-что неожиданное. Разыменование пе­
ременной без дополнительной проверки, как в s.isN u llO rB la n k (), не
означает, что переменная не может хранить значения n u ll: используемая
функция может расширять тип, допускающий такие значения. Далее да­
вайте обсудим другой случай, который тоже может вас удивить: параметр
типа может поддерживать значение n u ll даже без вопросительного знака
в конце.
6.1.10. Типовые параметры с поддержкой null
По умолчанию все типовые параметры функций и классов в Kotlin ав­
томатически поддерживают n u ll. Любой тип, в том числе с поддержкой
n u ll, может быть использован как типовой параметр - в этом случае объ­
явления, использующие типовые параметры, должны предусматривать
поддержку n u ll, даже если имя параметра Т не оканчивается вопроси­
тельным знаком. Рассмотрим следующий пример.
190 ❖
Глава 6. Система типов Kotlin
Листинг 6.13. Работа с параметром типа, допускающим значение n u l l
fun <Т> printHashCode(t: Т) {
printing?.bashCode())
}
»> printHashCode(null)
null
< Н Обязательно должен использоваться безопасный
I вызов, поскольку Ф может хранить null
< Н Параметр«Т» опреде*
I ляется как тип «Алу?»
Для вызова функции printH ashC ode в листинге 6.13 компилятор опре­
делит параметр Т как тип Any? с поддержкой n u ll. Соответственно, па­
раметр t может оказаться равным n u ll даже притом, что в имени типа Т
отсутствует вопросительный знак.
Чтобы запретить параметру принимать значение n u ll, необходимо
определить соответствующую верхнюю границу. Это не позволит пере­
дать nul I в качестве аргумента.
Листинг 6.14. Объявление верхней границы, не допускающей n u ll, для параметра типа
fun <Т: Any> printHashCode(t: Т) {
print ln (t .hasbCode())
<Э“ | Теперь «Т» не
I поддерживает null
}
»> printHashCode(null)
Error: Type parameter bound for T
»> printHashCode(42)
42
< Ъ | Этот код не (компилируется:
is not satisfied
I нельзя передать null,
посколькуЗГОзапрещено
Про обобщенные типы в Kotlin мы еще поговорим в главе 9, и особенно
детально - в разделе 9.1.4.
Обратите внимание, что типовые параметры - это единственное исклю­
чение из правила «вопросительный знак в конце имени типа разрешает
значение n u ll, а типы с именами без знака вопроса не допускают n u ll» .
В следующем разделе демонстрируется другой частный случай допусти­
мости значения n u ll: типы, пришедшие из кода Java.
6.1.11. Допустимость значения null и Java
Выше мы рассмотрели инструменты для работы с n u ll в мире Kotlin.
Но Kotlin гордится своей совместимостью с Java, а мы знаем, что систе­
ма типов в Java не поддерживает управления допустимостью значений
n u ll. Что же происходит, когда вы объединяете Kotlin и Java? Сохранится
ли безопасность или же вам потребуется проверять каждое значение на
n u ll? И есть ли лучшее решение? Давайте выясним это.
6.1. Поддержка значения null ❖
191
Во-первых, как уже упоминалось, код на Java может содержать инфор­
мацию о допустимости значений n u ll, выраженную с помощью аннота­
ций. Если эта информация присутствует в коде, Kotlin воспользуется ею. То
есть объявление © Nullable S trin g в Java будет представлено в Kotlin как
S trin g?, а объявление ©NotNull S trin g - как S trin g (см. рис. 6.8).
©Nullable
+
Type
=
Type?
©NotNull
+
Type
=
Type
'
Т
7
Java
Kotlin
Рис. 6.8. Типы Java, отмеченные аннотациями, представлены в Kotlin как типы,
поддерживающие или не поддерживающие значение null
Kotlin распознает множество разных аннотаций, описывающих до­
пустимость значения n u ll, в том числе аннотации из стандарта JSR-305
(javax.annotation), из Android (android.support.annotation) и те, что
поддерживаются инструментами компании JetBrains (org. jetbrains.
annotations). Интересно, а что происходит, когда аннотация отсутствует?
В этом случае тип Java становится платформенным типом в Kotlin.
Платформенные типы
Платформенный тип - это тип, для которого Kotlin не может найти
информацию о допустимости n u ll. С ним можно работать как с типом,
допускающим n u ll, или как с типом, не допускающим n u ll (см. рис. 6.9).
Type
4
Type?
J
-
Java
ИЛИ
4._____
Type
J
7
Kotlin
Рис. 6.9. Типы Java представлены в Kotlin как платформенные типы,
которые могут поддерживать или не поддерживать значение null
Это означает, что, точно как в Java, вы несете полную ответственность
за операции с этим типом. Компилятор разрешит вам делать всё. Он также
не станет напоминать об избыточных безопасных операциях над такими
значениями (как он делает обычно, встречая безопасные операции над
значениями, которые не могут быть n u l l ) . Если известно, что значение
может быть равно n u ll, вы можете сравнить его с n u ll перед использова­
нием. Если известно, что оно не может быть равно n u ll, вы сможете ис­
пользовать его напрямую. Но, как и в Java, если вы ошибетесь, то получите
исключение N u llP oin terE xcep tion во время использования.
Предположим, что класс Person объявлен в Java.
192
❖
Глава 6. Система типов Kotlin
Листинг 6.15. Java-класс без аннотаций, определяющих допустимость null
/* Java */
public class Person {
private fin a l String name;
public Person(String name) {
this.name = name;
}
public String getNameQ {
return name;
}
>
Может ли метод getName вернуть значение null? Компилятор Kotlin ни­
чего не знает о допустимости null для типа String в данном случае, по­
этому вам придется справиться с этим самостоятельно. Если вы уверены,
что имя не будет равно null, можете разыменовать его в обычном порядке
(как в Java) без дополнительных проверок, но будьте готовы столкнуться с
исключением.
Листинг 6.16. Обращение к Java-классу без дополнительных проверок на null
fun yellAt(person: Person) {
print ln(person .name.tollpperCase() + " !!!" )
}
< H Получатель метода toUpperCaseO - поле
I р е гя ш ш е - равен null, поэтому будет
возбуждено исключение
»> yellAt(Person(null))
java.lang.IllegalArgumentException: Parameter specified as non-null
is null: method toUpperCase, parameter Sreceiver
Обратите внимание, что вместо обычного исключения Null Pointer Ex­
ception вы получите более подробное сообщение об ошибке: что метод
toUpperCase не может вызываться для получателя, равного null.
На самом деле для общедоступных функций Kotlin компилятор гене­
рирует проверки для каждого параметра (и для получателя в том числе),
который не должен принимать значения n u ll. Поэтому попытка вызвать
такую функцию с неверными аргументами сразу закончится исключени­
ем. Обратите внимание, что проверка значения выполняется сразу же при
вызове функции, а не во время использования параметра. Это гаранти­
рует обнаружение некорректных вызовов на ранних стадиях и избавляет
от непонятных исключений, возникающих после того, как значение n u ll
прошло через несколько функций в разных слоях кода.
6.1. Поддержка значения null ❖
193
Другой вариант - интерпретация типа значения, возвращаемого мето­
дом g e t Name О , как допускающего значение n u ll, и обращение к нему с
помощью безопасных вызовов.
Листинг 6.17. Обращение к классу Java с проверками на null
fun yellAtSafe(person: Person) {
println((person.name ?: "Anyone").toUpperCase() + " !!!" )
}
»> yellAtSafe(Person(null))
ANYONE!!!
В этом примере значения n u ll обрабатываются должным образом, и во
время выполнения никаких исключений не возникнет.
Будьте осторожны при работе с Java API. Большинство библиотек не ис­
пользует аннотаций, поэтому, если вы будете интерпретировать все типы
как не поддерживающие n u ll, это может привести к ошибкам. Во избежа­
ние ошибок читайте документацию с описанием методов Java, которые
используете (а если нужно, то и их реализацию), выясните, когда они могут
возвращать n u ll, и добавьте проверку для таких методов.
Зачем нужны платформенные типы?
Разве не безопаснее для Kotlin считать, что все значения, поступающие из Java, могут
оказаться равными n u ll? Такое возможно, но требует большого количества лишних
проверок на n u ll для значений, которые на самом деле никогда не могут быть n u ll, но
компилятор Kotlin не имеет информации для того, чтобы это понять.
Особенно плохой была бы ситуация с обобщенными типами - например, каждая
коллекция A rrayList<S tring>, приходящая из Java, превращалась бы в Kotlin в
ArrayList<String?>?. В результате вам пришлось бы выполнять проверку на n u ll
при каждом обращении или применить приведение типа, что повлияло бы на безопас­
ность. Написание таких проверок очень раздражает, поэтому создатели Kotlin пришли
к прагматичному решению: позволить разработчикам самим брать на себя ответствен­
ность за правильность обработки значений, поступающих из Java.
Вы не можете объявить переменную платформенного типа в Kotlin - эти
типы могут прийти только из кода на Java. Но вы можете встретить их в
сообщениях об ошибках или в IDE:
»> val i: In t = person.name
ERROR: Type mismatch: inferred type is String! but In t was expected
С помощью нотации S tr in g ! компилятор Kotlin обозначает платфор­
менные типы, пришедшие из кода на Java. Вы не можете использовать это-
194 ❖
Глава 6. Система типов Kotlin
го синтаксиса в своем коде, и чаще всего этот восклицательный знак не
связан с источником проблемы, поэтому его можно игнорировать. Он про­
сто подчеркивает, что допустимость значения n u ll не была установлена.
Как мы уже сказали, платформенные типы можно интерпретировать
как угодно - как допускающие или как не допускающие n u ll, - поэтому
следующие объявления допустимы:
Получатель
метода
toUpperCaseQ
поле
perm
nam
e
J
равен null, поэтому будет возбуждено исключение».
» > val s: String? = person.name
» > val s i: String = person.name
Ml
или как не допускающее
Как и при вызове методов, в этом случае вы должны быть уверены, что
понимаете, где может появиться n u ll. При попытке присвоить пришед­
шее из Java значение n u ll переменной Kotlin, которая не может хранить
n u ll, вы понимаете, где получите исключение в месте вызова.
Мы обсудили, как типы Java выглядят с точки зрения Kotlin. Теперь да­
вайте поговорим о некоторых подводных камнях создания смешанных
иерархий Kotlin и Java.
Наследование
Переопределяя Java-метод в коде на Kotlin, вы можете выбрать, будут ли
параметры и возвращаемое значение поддерживать n u ll или нет. К при­
меру, давайте взглянем на интерфейс S trin gP rocessor в Java.
Листинг 6.18. Java-интерфейс с параметром типа String
/* Java */
interface StringProcessor {
void process(String value);
}
Компилятор Kotlin допускает следующие реализации.
Листинг 6.19. Реализация Java-интерфейса с поддержкой и без поддержки n u ll
class StringPrinter : StringProcessor {
override fun process(value: String) {
println(value)
}
}
class NullableStringPrinter : StringProcessor {
override fun process(value: String?) {
i f (value != n u ll) {
println(value)
6.2. Примитивные и другие базовые типы ❖
195
Обратите внимание, что при реализации методов классов или интер­
фейсов Java важно правильно понимать, когда можно получить null. По­
скольку методы могут быть вызваны из кода не на Kotlin, компилятор сге­
нерирует проверки, что значение не может быть равно null, для каждого
параметра, объявление которого запрещает присваивание nul I. Если Javaкод передаст в метод значение n u ll, то сработает проверка, и вы получите
исключение, даже если ваша реализация вообще не обращается к значе­
нию параметра.
Давайте подведем итоги нашей дискуссии о допустимости значений
n u ll. Мы обсудили типы с поддержкой и без поддержки n u ll, а также спо­
собы работы с ними: операторы безопасности (безопасный вызов ? ., опе­
ратор «Элвис» ?: и оператор безопасного приведения as?), а также опе­
ратор небезопасного разыменования (утверждение !!). Вы увидели, как
библиотечная функция l e t может выполнить лаконичную проверку на
n u l l и как функции-расширения для типов с поддержкой n u ll помогают
переместить проверку на n u l l в функцию. Мы также обсудили платфор­
менные типы, представляющие типы Java в Kotlin.
Теперь, рассмотрев тему допустимости значений n u ll, поговорим о
представлении простых типов в Kotlin. Знание особенностей поддержки
n u ll имеет большое значение для понимания того, как Kotlin работает с
классами-обёртками Java.
6.2. Примитивные и другие базовые типы
В данном разделе описываются основные типы, используемые в програм­
мах: In t, Boolean, Any и другие. В отличие от Java, язык Kotlin не делит
типы на простые и обертки. Вскоре вы узнаете причину этого дизайн-ре­
шения и то, какие механизмы работают за кулисами, и также увидите со­
ответствие между типами Kotlin и такими типами Java, как Obj e c t и Void.
6.2.1. Примитивные типы: Int, Boolean и другие
Как известно, Java различает примитивные и ссылочные типы. Пере­
менная примитивного типа (например, in t) непосредственно содержит
свое значение. Переменная ссылочного типа (например, S trin g) содержит
ссылку на область памяти, где хранится объект.
Значения примитивных типов можно хранить и передавать более эф­
фективно, но такие значения не имеют методов, и их нельзя сохранять
в коллекциях. Java предоставляет специальные типы-обертки (такие как
j ava. la n g . In teger), которые инкапсулируют примитивные типы в ситуа-
196
❖
Глава 6. Система типов Kotlin
циях, когда требуется объект. То есть, чтобы определить коллекцию целых
чисел, вместо C o lle c tio n < in t> следует написать C o llectio n < In teg er> .
Kotlin не различает примитивных типов и типов-оберток. Вы всегда ис­
пользуете один и тот же тип (например, I n t):
val i: In t = 1
val lis t: List<Int> = listO f(1, 2, 3)
Это удобно. Более того, такой подход позволяет вызывать методы на
значениях числовых типов. Для примера рассмотрим нижеследующий
фрагмент - в нём используется функция co erceln из стандартной библио­
теки, ограничивающая значение указанным диапазоном:
fun stiowProgress(progress: In t) {
val percent = progress.coerceln(0, 100)
println("We're ${percent}% done!")
}
»> showProgress(146)
We're 100% done!
Если примитивные и ссылочные типы совпадают, значит ли это, что
Kotlin представляет все числа как объекты? Будет ли это крайне неэффек­
тивно? Действительно, будет, поэтому Kotlin так не делает.
Во время выполнения числовые типы представлены наиболее эффек­
тивным способом. В большинстве случаев - для переменных, свойств, па­
раметров и возвращаемых значений - тип Int в Kotlin компилируется в
примитивный тип int из Java. Единственный случай, когда это невозмож­
но, - обобщенные классы, например коллекции. Примитивный тип, ука­
занный в качестве аргумента типа обобщенного класса, компилируется в
соответствующий тип-обертку в Java. Поэтому если в качестве аргумента
типа коллекции указан Int, то коллекция будет хранить экземпляры соот­
ветствующего типа-обертки ] ava.lang.Integer.
Ниже приводится полный список типов, соответствующих примитив­
ным типам Java:
О
О
О
О
целочисленные типы - Byte, Short, Int, Long;
числовые типы с плавающей точкой - Float, Double;
символьный тип - Char;
логический тип - Boolean.
Такие Kotlin-типы, как In t, за кулисами могут компилироваться в соот­
ветствующие примитивные типы Java, поскольку значения обоих типов
не могут хранить ссылку на n u ll. Обратное преобразование работает ана­
логично: при использовании Java-объявлений в Kotlin примитивные типы
становятся типами, не допускающими n u ll (а не платформенными типа-
6.2. Примитивные и другие базовые типы ❖
197
ми), поскольку они не могут содержать значения n u ll. Теперь рассмотрим
те же типы, но уже допускающие значение n u ll.
6.2.2. Примитивные типы с поддержкой null: Int?, Boolean?
и прочие
Kotlin-типы с поддержкой null не могут быть представлены в Java как
примитивные типы, поскольку в Java значение null может храниться тол ько в переменных ссылочных типов. Это означает, что всякий раз, когда в
коде на Kotlin используется версия простого типа, допускающая значение
null, она компилируется в соответствующий тип-обертку.
Чтобы увидеть такие типы в действии, давайте вернемся к примеру в
начале этой книги и вспомним объявление класса Person. Класс описы­
вает человека, чье имя всегда известно и чей возраст может быть указан
или нет. Добавим функцию, которая проверяет, является ли один человек
старше другого.
Листинг 6.20. Работа с простыми типами, допускающими значение n u ll
data class Person(val name: String,
val age: Int? = null) {
fun isOlderThan(other: Person): Boolean? {
i f (age == null || other.age == null)
return null
return age > other.age
}
}
»> println(Person("Sam", 35).isOlderThan(Person("Amy", 42)))
false
»> println(Person("Sam", 35).is0lderThan(Person("Dane")))
null
Обратите внимание, что здесь применяются обычные правила работы
со значением n u ll. Нельзя просто взять и сравнить два значения типа
Int?, поскольку одно из них может оказаться n u ll. Вместо этого вам нуж­
но убедиться, что оба значения не равны n u ll, и после этого компилятор
позволит работать с ними как обычно.
Значение свойства аде, объявленного в классе Person, хранится как
java. la n g . In teg er. Но эта деталь имеет значение только тогда, когда вы
работаете с этим классом в Java. Чтобы выбрать правильный тип в Kotlin,
нужно понять только то, допустимо ли присваивать значение n u ll пере­
менной или свойству.
198 ❖
Глава 6. Система типов Kotlin
Как уже упоминалось, обобщенные классы - это ещё одна ситуация,
когда на сцену выходят оберточные типы. Если в качестве аргумента типа
указан простой тип, Kotlin будет использовать обертку для данного типа.
Например, следующее объявление создаст список значений типа In teg er,
даже если вы не указывали, что тип допускает значение n u ll, и не исполь­
зовали самого значения n u ll:
val listO flnts = lis tO f(l, 2, 3)
Это происходит из-за способа реализации обобщенных классов в вир­
туальной машине Java. JVM не поддерживает использования примитив­
ных типов в качестве аргументов типа, поэтому обобщенные классы (как
в Java, так и в Kotlin) всегда должны использовать типы-обертки. Следо­
вательно, когда требуется обеспечить эффективное хранение больших
коллекций простых типов, то приходится использовать сторонние библи­
отеки (такие как Trove4J, h t t p : / / t r o v e . s t a r l i g h t - s y s t e m s . comi. поддер­
живающие такие коллекции, или хранить их в массивах. Мы подробно об­
судим массивы в конце этой главы.
А теперь посмотрим, как преобразовывать значения между различны­
ми простыми типами.
6.2.3. Числовые преобразования
Одно важное отличие Kotlin от Java - способ обработки числовых пре­
образований. Kotlin не выполняет автоматического преобразования чисел
из одного типа в другой, даже когда другой тип охватывает более широкий
диапазон значений. Например, в Kotlin следующий код не будет компили­
роваться:
val i = 1
val I: Long = i
Ошибка: несоответствие типов
Вместо этого нужно применить явное преобразование:
val i = 1
val I: Long = i.toLong()
Функции преобразования определены для каждого простого типа (кро­
ме Boolean): toByte( ), toShort( ), toChar( ) и т. д. Функции поддержива­
ют преобразование в обоих направлениях: расширение меньшего типа к
большему, как Int.toLong( ), и усечение большего типа до меньшего, как
Long.toInt().
Kotlin делает преобразование явным, чтобы избежать неприятных не­
ожиданностей, особенно при сравнении обернутых значений. Метод
equa I s для двух обернутых значений проверяет тип обертки, а не только
хранящееся в ней значение. Так, выражение new I n te g e r (4 2 ). equals(new
6.2. Примитивные и другие базовые типы ❖ 199
L ong(42)) в lava вернет f a ls e . Если бы Kotlin поддерживал неявные пре­
образования, вы могли бы написать что-то вроде этого:
val х = 1
О— Переменная типа Int
val lis t = listO f(lL , 2L, 3L)
О— Список значений типа Long
х in *-ls t
< h Если бы Kotlin поддерживал неявные преобразования
I типов, эта выражение вернуло бы false
Вопреки всем ожиданиям эта функция вернула бы f a ls e . Поэтому стро­
ка х in l i s t в этом примере не скомпилируется. Kotlin требует явного
преобразования типов, поэтому сравнивать можно только значения од­
ного типа:
»> val х = 1
»> println(x.toLong() in listO f(1L, 2L, 3L))
true
Если вы одновременно используете различные числовые типы в коде и
хотите избежать неожиданного поведения - явно преобразуйте перемен­
ные.
Литералы примитивных типов
Вдополнение к обычным десятичным числам Kotlin поддерживает следующие спосо­
бы записи числовых литералов в исходном коде:
• Литералы типа Long обозначаются суффиксом l : 123L.
• Влитералахтипа Double используется стандартное представление чисел с плаваю­
щей точкой: 0 .1 2 ,2 .0 ,1 .2е10,1.2 е-10.
• Литералы типа float обозначаются суффиксом F или f : 123.4 f,. 456F, ie 3 f.
• Литералы шестнадцатеричных чисел обозначаются префиксом 0х или 0Х (напри­
мер, 0xCAFEBABE ИЛИ 0xbcdL).
• Двоичные литералы обозначаются префиксом 0Ь или 0В (например, 0Ь000000101).
Обратите внимание, что символ подчеркивания в числовых литералах начал поддер­
живаться только с версии Kotlin 1.1.
Для символьных литералов в основном используется тот же синтаксис, что и в Java.
Символ записывается в одиночных кавычках, а если нужно,то можно использовать экра­
нирование. Вот примеры допустимых символьных литералов в Kotlin: '1 ', ' \ t ' (символ
табуляции),' \u00091 (символ табуляции представлен как экранированная последова­
тельность Юникода).
Обратите внимание, что при записи числового литерала обычно не
нужно использовать функции преобразования. Допускается использовать
специальный синтаксис для явного обозначения типа константы, 42 L или
4 2 .0 f . Но даже если его не использовать, компилятор автоматически при­
менит к числовому литералу необходимое преобразование для инициа-
200 ❖
Глава 6. Система типов Kotlin
лизации переменной известного типа или передачи его в качестве аргу­
мента функции. Кроме того, арифметические операторы перегружены для
всех соответствующих числовых типов. Например, следующий код работа­
ет правильно без каких-либо явных преобразований:
fun foo(l: Long) = p rin tln (l)
Значение константы
получит корректный тип
»> val I = b + 1L
< Оператор+ работает
с аргументами типа Byte и Long
»> foo(42)
< н Компилятор интерпретирует 42
42
I как значение типа Long
J
Обратите внимание, что при переполнении арифметические операторы
в Kotlin действуют так же, как в Java, - Kotlin не привносит накладных рас­
ходов для проверки переполнения.
Преобразование строк
Стандартная библиотека Kotlin включает набор функций-расширений для преобразо­
вания арок в проаыетипы (toInt,toByte,toBoolean ит.д.):
»> println("42".toInt())
42
Каждая из этих функций пытается проанализировать содержимое строки на соответст­
вие нужному типу и вызывает NumberFormatException, если анализ завершается
неудачей.
Прежде чем перейти к другим типам, отметим еще три специальных
типа: Any, Unit и Nothing.
6.2.4. Корневые типы Any и Any?
Подобно тому, как тип ОЪj e c t является корнем иерархии классов в Java,
тип Any - это супертип всех типов в Kotlin, не поддерживающих n u ll. Но в
Java тип Obj e c t - это супертип для всех ссылочных типов, а примитивные
типы не являются частью его иерархии. Это означает, что когда требуется
экземпляр O bject, то для представления значений примитивных типов
нужно использовать типы-обертки, такие как j ava. la n g . In teg er. В Kotlin
тип Any - супертип для всех типов, в том числе для примитивных, таких
как In t.
Так же как в Java, присваивание примитивного значения переменной
типа Any вызывает автоматическую упаковку значения:
val answer. Any = 42
< Н Значение 42 будет упаковано,
I поскольку тип Any-ссылочный
6.2. Примитивные идругие базовые типы ❖ 201
Обратите внимание, что тип Any не поддерживает значения n u ll, поэто­
му переменная типа Any не может хранить n u ll. Если нужна переменная,
способная хранить любое допустимое значение в Kotlin, в том числе n u ll,
используйте тип Any?.
На уровне реализации тип Any соответствует типу ja v a .la n g .O b jec t.
Тип O bject, используемый в параметрах и возвращаемых значениях м е­
тодов Java, рассматривается в Kotlin как тип Any. (Точнее, он рассматри­
вается как платформенный тип, поскольку допустимость значения n u ll
неизвестна.) Если функция Kotlin использует тип Any, в байт-коде этот тип
компилируется в Java-тип Obj e c t.
Как было показано в главе 4, все классы в Kotlin имеют три метода:
to S tr in g , equals и hashCode. Эти методы наследуются от класса Any. Дру­
гие методы, объявленные в классе ja v a .la n g .O b je c t (например, w ait и
n o tify ), недоступны в классе Any, но их можно вызвать, если вручную при­
вести значение к типу j ava. la n g . Obj e c t.
6.2.5. Тип Unit: тип «отсутствующего» значения
Тип Unit играет в Kotlin ту же роль, что и void в Java. Он может исполь­
зоваться в качестве типа возвращаемого значения функции, которая не
возвращает ничего интересного:
fun f(): Unit { ... }
Синтаксически это определение равноценно следующему, где отсут­
ствует объявление типа тела функции:
fun f( ) { . . . }
О—IЯвное объявление типа
| Unit опущено
В большинстве случаев вы не заметите разницы между типами Uni t и
void. Если ваша Kotlin-функция объявлена как возвращающая тип Unit и
она не переопределяет обобщенную функцию, она будет скомпилирована
в старую добрую функцию void. Если вы переопределяете её в Java, то пе­
реопределяющая функция просто должна возвращать void.
Тогда чем тип Unit в Kotlin отличается от типа void в Java? В отличие от
void, тип Unit - это полноценный тип, который может использоваться как
аргумент типа. Существует только один экземпляр данного типа - он тоже
называется Unit и возвращается неявно. Это полезно при переопределе­
нии функции с обобщенным параметром, чтобы заставить её возвращать
значение типа Uni t :
interface Processor<T> {
fun process(): T
}
class NoResultProcessor : Processor<Unit> {
202
❖
Глава 6. Система типов Kotlin
override fun process() {
/ / сделать что-то
■*
< H Возвращает значение типа Unit,
| но в объявлении это не указано
Не требуется писать
I инструкцию return
Сигнатура интерфейса требует, чтобы функция p rocess возвращала
значение, а поскольку тип Unit не имеет значения, вернуть его из метода
не проблема. Но вам не нужно явно писать инструкцию return в функции
N oR esultProcessor .p ro cess, потому что return Unit неявно добавляется
компилятором.
Сравните это с Java, где ни одно из решений проблемы указания от­
сутствия аргумента типа не выглядит так элегантно, как в Kotlin. Один из
вариантов - использовать отдельные интерфейсы (такие как C a lla b le и
Runnable) для представления элементов, возвращающих и не возвращаю­
щих значения. Другой заключается в использовании специального типа
ja v a . lang.V oid в качестве параметра типа. Если вы выбрали второй ва­
риант, вам всё равно нужно добавить инструкцию return n u ll для воз­
вращения единственно возможного значения этого типа, поскольку если
тип возвращаемого значения не void, то вы всегда должны использовать
оператор return.
Вас может удивить, почему мы выбрали другое имя для U nit и не на­
звали его Void. Имя Unit традиционно используется в функциональных
языках и означает «единственный экземпляр», а это именно то, что отли­
чает тип Unit в Kotlin от void в Java. Мы могли бы использовать обычное
имя Void, но в Kotlin есть тип Nothing, выполняющий совершенно другую
функцию. Наличие двух типов с именами Void и Nothing («пустота» и «ни­
что») сбивало бы с толку, поскольку значения этих слов очень похожи. Так
что же это за тип - Nothing? Давайте выясним.
6 .2 .6 .Тип Nothing: функция, которая не завершается
Для некоторых функций в Kotlin понятие возвращаемого значения прос­
то не имеет смысла, поскольку они никогда не возвращают управления.
Например, во многих библиотеках для тестирования есть функция f a i l ,
которая генерирует исключение с указанным сообщением и заставляет те­
кущий тест завершиться неудачей. Функция с бесконечным циклом также
никогда не завершится.
При анализе кода, вызывающего такую функцию, полезно знать, что
она не возвращает управления. Чтобы выразить это, в Kotlin используется
специальный тип возвращаемого значения Nothing:
fun fail(message: String): Nothing {
throw IllegalStateException(message)
}
6.3. Массивы и коллекции ❖
203
»> fa il("E rro r occurred")
java.lang.IllegalStateException: Error occurred
Тип Nothing не имеет значений, поэтому его имеет смысл использовать
только в качестве типа возвращаемого значения функции или аргумента
типа для обозначения типа возвращаемого значения обобщенной функ­
ции. Во всех остальных случаях объявление переменной, в которой нельзя
сохранить значение, не имеет смысла.
Обратите внимание, что функции, возвращающие Nothing, могут ис­
пользоваться справа от оператора «Элвис» для проверки предусловий:
val address = company.address ?: fail("No address")
println(address.city)
Этот пример показывает, почему наличие Nothing в системе типов
крайне полезно. Компилятор знает, что функция с таким типом не вер­
нет управления, и использует эту информацию при анализе кода вызова
функции. В предыдущем примере компилятор сообщит, что тип поля ad­
d ress не допускает значений n u ll - потому что ветка, где значение равно
n u ll, всегда возбуждает исключение.
Мы закончили обсуждение основных типов в Kotlin: примитивных ти­
пов, Any, Unit и Nothing. Теперь рассмотрим типы коллекций и чем они
отличаются от своих аналогов в Java.
6.3. Массивы и коллекции
Вы увидели примеры использования различных API для работы с коллек­
циями и знаете, что Kotlin использует библиотеку коллекций Java и допол­
няет её новыми возможностями через функции-расширения. Но впере­
ди - рассказ о поддержке коллекций в языке Kotlin и соответствии между
коллекциями в Java и Kotlin. Пришло время узнать подробности.
6.3.1. Коллекции и допустимость значения null
Ранее в этой главе мы обсудили типы с поддержкой n u ll, но при этом
лишь вкратце затронули допустимость n u ll для аргументов типов. Но для
согласованной системы типов это ключевой пункт: не менее важно знать,
может ли коллекция хранить значения n u ll, чем знать, может ли перемен­
ная хранить nul I . К счастью, Kotlin позволяет указать допустимость nul I в
аргументах типов. Как имя типа переменной может заканчиваться симво­
лом ?, свидетельствующим о допустимости значения n u ll, так и аргумент
типа может быть помечен таким образом. Чтобы понять суть, рассмотрим
функцию, которая читает строки из файла и пытается представить каждую
строку как число.
204 ❖
Глава 6. Система типов Kotlin
Листинг 6.21. Создание коллекции, которая может хранить значения n u ll
readNumbers(reader: BufferedReader): List<Int?> {
val result = ArrayList<Int?>()
< н Создание списка значений
for (line in reader. lineSequence()) {
I типа Int с поддержкой null
try {
val number = line.toInt()4
result.add(number)
O - i Добавление в список целочисленного
I значения (не равного null)
>
catch(e: NumberFormatException)
result.add(null)
0 -| Добавление значения null в список, поскольку текущая
I строка не может быть преобразована в число
}
}
return result
Список типа L ist< In t?> может хранить значения типа In t? - другими
словами, In t или n u ll. Если строка может быть преобразована в число,
мы добавляем в список r e s u lt целое число, а в противном случае - n u ll.
Заметьте, что начиная с Kotlin 1.1 этот пример можно сократить, исполь­
зуя функцию S tr in g . toIntO rN ull, - она возвращает n u ll, если строковое
значение не может быть преобразовано в число.
Обратите внимание, что допустимость значения n u ll для самой пере­
менной отличается от допустимости значения n u ll для типа, который ис­
пользуется в качестве аргумента типа. Разница между списком, поддержи­
вающим элементы типа In t и n u ll, и списком элементов In t, который сам
может оказаться пустой ссылкой n u ll, показана на рис. 6.10.
Отдельные элементы
списка MOiyr хранить null
Int
Сам список может быть
представлен пустой ссылкой
null
Int
Int
null
null
Рис. 6.10. Помните, для каких объектов допускается значение null -
для элементов или для самой коллекции
В первом случае сам список не может оказаться пустой ссылкой, но его
элементы могут хранить n u ll. Переменная второго типа может содержать
значение n u ll вместо ссылки на экземпляр списка, но элементы в списке
гарантированно не будут хранить n u ll.
В другом контексте вы можете захотеть объявить переменную, содержа­
щую пустую ссылку на список с элементами, которые могут иметь значе-
6.3. Массивы и коллекции ❖
205
ния n u ll. В Kotlin такой тип записывается с двумя вопросительными зна­
ками: L ist<Int?>?. При этом вам придется выполнять проверки на n u ll
два раза: и при использовании значения переменной, и при использова­
нии значения каждого элемента в списке.
Чтобы понять, как работать со списком элементов, способных хранить
n u ll, напишем функцию для сложения всех корректных чисел и подсчета
некорректных чисел отдельно.
Листинг 6.22. Работа с коллекцией, которая может хранить значения n u ll
fun addValidNumbers(numbers: List<Int?>) {
var sumOfValidNumbers = 0
var invalidNumbers = 0
| Чтение из списка значения, которое
for (number in numbers) {
о —I может оказаться равным null
i f (number != null) {
<H Проверка значения
sumOfValidNumbers += number
I на null
} else {
invalidNumbers++
}
}
println("Sum of valid numbers: SsumOfValidNumbers")
println("Invalid numbers: $invalidNumbers")
}
»> val reader = BufferedReader(StringReader("l\nabc\n42"))
»> val numbers = readNumbers(reader)
»> addValidNumbers(numbers)
Sum of valid numbers: 43
Invalid numbers: 1
Здесь нет ничего особенного. Обращаясь к элементу списка, вы получа­
ете значение типа In t? , и прежде чем использовать его в арифметических
операциях, его необходимо проверить на n u ll.
Обработка коллекции значений, которые могут быть равны n u ll, и по­
следующая фильтрация таких элементов - очень распространенная опе­
рация. Поэтому для её выполнения в Kotlin есть стандартная функция
filterN otN u ll. Вот как использовать её для упрощения предыдущего при­
мера.
Листинг 6.23. Применение функции filterNotNull к коллекции, которая может
хранить значения n u ll
fun addValidNumbers(numbers: List<Int?>) {
val validNumbers = numbers.filterNotNull()
println("Sum of valid numbers: ${validNumbers.sum()}")
206 ❖
Глава 6. Система типов Kotlin
println("Invalid numbers: ${numbers.size - validNumbers.size}")
Конечно, фильтрация тоже влияет на тип коллекции. Коллекция v a lid Numbers имеет тип L ist< In t> , потому что фильтрация гарантирует, что
коллекция не будет содержать значений n u ll.
Теперь, зная, как Kotlin различает коллекции, которые могут или не мо­
гут содержать элементы n u ll, рассмотрим другие важные отличия языка
Kotlin: коллекции с доступом только для чтения и изменяемые коллекции.
6.3.2. Изменяемые и неизменяемые коллекции
Важная черта, отличающая коллекции в Kotlin от коллекций в Java, - раз­
деление интерфейсов, открывающих доступ к данным в коллекции только
для чтения и для изменения. Это разделение начинается с базового ин­
терфейса коллекций - k o t lin . c o lle c t io n s . C o lle c tio n . С помощью это­
го интерфейса можно выполнить обход элементов коллекции, узнать её
размер, проверить наличие определенного элемента и выполнить другие
операции чтения данных из коллекции. Но в этом интерфейсе отсутству­
ют методы добавления или удаления элементов.
Чтобы получить возможность изменения данных в коллекции, исполь­
зуйте интерфейс k o tlin .c o lle c tio n s .M u ta b le C o lle c tio n . Он наследует
интерфейс k o t lin . c o lle c t io n s . C o lle c tio n , добавляя к нему методы для
добавления и удаления элементов, очистки коллекции и т. д. На рис. 6.11
показаны основные методы, присутствующие в этих двух интерфейсах.
Рис. 6.11. Интерфейс MutableCollection наследует Collection
и добавляет методы для изменения содержимого коллекции
Как правило, вы везде должны использовать интерфейсы с доступом
только для чтения. Применяйте изменяемые варианты, только если соби­
раетесь изменять коллекцию.
Такое разделение интерфейсов позволяет быстрее понять, что происхо­
дит с данными в программе. Если функция принимает параметр типа C ol­
le c tio n , но не M utableC ollection, можно быть уверенным, что она не из­
меняет коллекцию и будет только читать данные из нее. Но если функция
требует передачи аргумента M utableC ollection, можно предположить,
что она собирается изменять данные. Если у вас есть коллекция, которая
хранит внутреннее состояние вашего компонента, то вам может понадо­
биться сделать копию этой коллекции перед передачей в такую функцию
(этот шаблон обычно называют защитным копированием).
6.3. Массивы и коллекции ♦> 207
Например, в следующем примере видно, что функция copyElements бу­
дет изменять целевую коллекцию, но не исходную.
Листинг 6.24. Применение интерфейсов для чтения и изменения значений коллекции
fun <Т> copyElements(source: Collection<T>,
target: MutableCollection<T>) {
for (item in source) {
target.add(item)
J
}
}
»>
»>
»>
»>
[1,
LJmiui по всем элементам
исходной коллекции
<1""] Добавление элементов в
I изменяемую целевую коллекцию
val source: Collection<Int> = arrayList0f(3, 5, 7)
val target: MutableCollection<Int> = arrayListOf(l)
copyElements(source, target)
println(target)
3, 5, 7]
Вы не сможете передать в аргументе ta r g e t переменную с типом кол­
лекции, доступной только для чтения, даже если она ссылается на изменяе­
мую коллекцию:
»> val source: Collection<Int> = arrayList0f(3, 5, 7)
»> val target: Collection<Int> = arrayListOf(l)
»> copyElements(source, target)
Error: Type mismatch: inferred type is Collection<Int>
but MutableCollection<Int> was expected
J
Ошибочный аргумент
«target»
Самое главное, что нужно помнить при работе с интерфейсами коллек­
ций, доступных только для чтения, - они необязательно неизменяемыЧЕсли
вы работаете с переменной-коллекцией, интерфейс которой дает доступ
только для чтения, она может оказаться лишь одной из нескольких ссылок
на одну и ту же коллекцию. Другие ссылки могут иметь тип изменяемого
интерфейса, как показано на рис. 6.12.
Рис. 6.12. Две разные ссылки: одна - с доступом только для чтения и другая,
разрешающая изменение, - указывают на одну и ту же коллекцию
Вызывая код, хранящий другую ссылку на вашу коллекцию, или запуская
••
его параллельно, вы все еще можете столкнуться с ситуацией, когда коллек­
ция меняется под воздействием другого кода, пока вы работаете с ней. Это
1
Позже планируется добавить неизменяемые коллекции в стандартную библиотеку Kotlin.
208 ❖
Глава 6. Система типов Kotlin
приводит к появлению исключения ConcurrentM odificationException и
другим проблемам. Поэтому важно понимать, что коллекции с доступом
только для чтения не всегда потокобезопасны. Если вы работаете с данны­
ми в многопоточной среде, убедитесь, что ваш код правильно синхрони­
зирует доступ к данным или использует структуры данных, поддерживаю­
щие одновременный доступ.
Так как же происходит разделение на коллекции только для чтения и
коллекции с доступом для чтения/записи? Разве мы не говорили ранее,
что коллекции в Kotlin ничем не отличаются от коллекций в Java? Нет ли
здесь противоречия? Давайте выясним, что происходит на самом деле.
6.3.3. Коллекции Kotlin и язык Java
Действительно, любая коллекция в Kotlin - экземпляр соответствующе­
го интерфейса коллекции Java. При переходе между Kotlin и Java никакого
преобразования не происходит, и нет необходимости ни в создании обер­
ток, ни в копировании данных. Но для каждого интерфейса Java-коллекций
в Kotlin существуют два представления: только для чтения и для чтения/
записи, как можно видеть на рис. 6.13.
Интерфейсы с доступом
только для чтения
П Интерфейсы с доступом
для чтения/записи
I I Классы Java
□
Рис. 6.13. Иерархия интерфейсов коллекций Kotlin. Java-классы ArrayList и HashSet
наследуют интерфейсы изменяемых коллекций в Kotlin
Все интерфейсы коллекций на рис. 6.13 объявлены в Kotlin. Базовая
структура интерфейсов для чтения и изменения коллекций в Kotlin вы­
строена параллельно иерархии интерфейсов Java-коллекций в пакете
j ava .u t i l . Кроме того, каждый интерфейс, меняющий коллекцию, насле­
дует соответствующий интерфейс только для чтения. Интерфейсы кол­
лекций с доступом для чтения/записи непосредственно соответствуют
Java-интерфейсам в пакете j a v a .u t il, тогда как интерфейсы только для
чтения лишены любых методов, которые могли бы изменить коллекцию.
6.3. Массивы и коллекции
209
Для демонстрации того, как стандартные классы Java выглядят с точ­
ки зрения Kotlin, на рис. 6.13 также показаны коллекции j a v a .u t i l .
A rrayL ist и ja v a .u til.H a s h S e t. Язык Kotlin рассматривает их так,
словно они наследуют интерфейсы M utableL ist и Mutable S et соответ­
ственно. Здесь не представлены другие реализации из Java-библиотеки
(L in k ed L ist, S o rted S et и т. д.), но с точки зрения Kotlin они имеют схо­
жие супертипы. Таким образом, вы получаете не только совместимость,
но так же четкое разделение интерфейсов с доступом только для чтения
и для чтения/записи.
В дополнение к коллекциям в Kotlin есть класс Мар (который не на­
следует ни C o lle c tio n , ни Ite r a b le ) в двух различных вариантах: Мар и
MutableMap. В табл. 6.1 показаны функции, которые можно использовать
для создания коллекций различных типов.
Таблица 6.1. Функции для создания коллекций
**>:•*.***
Тип
коллекции
Изменяемая коллекция
List
listO f
m utableListOf, arrayListOf
Set
setOf
mutableSetOf, hasbSetOf, linkedSetO f, sortedSetOf
Map
mapOf
mutableMapOf, hasbMapOf, LinkedMapOf, sortedMapOf
Обратите внимание, что функции setO f О и mapOf О возвращают эк­
земпляры классов из стандартной библиотеки Java (по крайней мере, в
Kotlin 1.0), которые на самом деле изменяемы2. Но не стоит полагаться на
это: вполне возможно, что в будущих версиях Kotlin функции setO f и mapOf
будут использовать по-настоящему неизменяемые реализации классов.
Когда нужно вызвать метод Java и передать ему коллекцию, это мож­
но сделать непосредственно, без каких-либо промежуточных шагов. На­
пример, если у вас есть метод Java, принимающий экземпляр j ava. u t i l .
C o lle c tio n , вы можете передать в нем любой объект C o lle c tio n или
M utableC ollection.
Это сильно влияет на изменяемость коллекций. Поскольку в Java нет
различий между коллекциями только для чтения и для чтения/записи,
Java-код сможет изменить коллекцию, даже если в Kotlin она объявлена как
доступная только для чтения. Компилятор Kotlin не в состоянии полно­
стью проанализировать, что происходит с коллекцией на стороне Java-кода, и не имеет никакой возможности отклонить передачу коллекции, до­
ступной только для чтения, в модифицирующий её код на Java. Например,
следующие два фрагмента образуют компилируемую многоязыковую
программу Java/Kotlin:
Обертывание коллекций типом C o llectio n .unmodifiable приводит к накладным расходам, поэтому
не используется.
210 ❖
Глава 6. Система типов Kotlin
/* ]ava * /
/ / CollectionUtils.java
public class CollectionUtils {
public static List<String> uppercaseAll(List<String> items) {
for (in t i = 0; i < items.size(); i++) {
items.s e t(i, items.g e t(i).toUpperCase());
}
return items;
}
>
/ / Kotlin
Объявлениепараметра
/ / collections.kt
I какдоступноготолько
fun printlnllppercase( lis t: List<String>) { < н длячтения
i ВызовJava-функции, котоprintln(CollectionUtils.uppercaseAll(list))
<jJ раяизменяетколлекцию
p rin tln (lis t.firs tO )
«-■ Показывает,что
}
I коллекцияизменилась
»> val lis t = listO f("a", "b", "с")
»> printlnUppercase(list)
[А, В, С]
A
Поэтому, если вы пишете функцию Kotlin, которая принимает коллек­
цию и передает её Java-коду, только вы отвечаете за объявление правильно­
го типа параметра в зависимости от того, изменяет вызываемый Java-код
коллекцию или нет.
Обратите внимание, что этот нюанс также касается коллекций, элемен­
ты которых не могут содержать n u ll. Если передать такую коллекцию в
Java-метод, он вполне может поместить в неё значение n u ll - Kotlin не
может запретить или просто обнаружить такую ситуацию без ущерба для
производительности. Поэтому, передавая коллекции в Java-код, который
может изменить их, принимайте меры предосторожности - тогда типы
Kotlin правильно отразят все возможности изменения коллекции.
Теперь внимательнее посмотрим, как Kotlin работает с коллекциями,
объявленными в Java-коде.
6.3.4. Коллекции как платформенные типы
Вернувшись к обсуждению значения n u ll в начале этой главы, вы на­
верняка вспомните, что типы, объявленные в Java-коде, рассматривают­
ся в Kotlin как платформенные типы. Для платформенных типов Kotlin
не имеет информации о поддержке значения n u ll, поэтому компилятор
позволяет обращаться с ними как с поддерживающими или не поддержи­
вающими n u ll. Таким же образом типы переменных и коллекций, объяв­
ленные в Java, в языке Kotlin рассматриваются как платформенные типы.
6.3. Массивы и коллекции
❖
211
Коллекция платформенного типа фактически представляет собой коллек­
цию с неизвестным статусом изменяемости - код на Kotlin может считать
её доступной для чтения/записи или только для чтения. Обычно это не­
важно, поскольку все операции, которые вы можете захотеть выполнить,
просто работают.
Разница становится важной при переопределении или реализации м е­
тода Java, в сигнатуре которого есть тип коллекции. Как и в случае с под­
держкой n u ll для платформенных типов, здесь только вы решаете, какой
тип Kotlin использовать для представления типа Java в переопределяемом
или реализуемом методе.
В этом случае вам нужно принять несколько решений, каждое из кото­
рых отразится на типе параметра в Kotlin:
О Может ли сама коллекция оказаться пустой ссылкой n u ll?
О Может ли хотя бы один из ее элементов оказаться значением n u ll?
О Будет ли ваш метод изменять коллекцию?
Чтобы понять разницу, рассмотрим следующие случаи. В первом при­
мере интерфейс Java представляет объект, обрабатывающий текст в файле.
Листинг 6.25. Интерфейс Java с коллекцией в качестве параметра
/* Dava */
interface FileContentProcessor {
void processContents(File path,
byte[] binaryContents,
List<String> textContents);
}
В Kotlin-реализации этого интерфейса нужно принять во внимание сле­
дующие соображения:
О Ссылка на список может оказаться пустой, поскольку существуют
двоичные файлы, которые нельзя представить в виде текста.
О Элементы в списке не могут хранить n u ll, поскольку строки в файле
никогда не имеют значения n u ll.
О Список доступен только для чтения, поскольку представляет неизме­
няемое содержимое файла.
Вот как выглядит реализация:
Листинг 6.26. Реализация интерфейса FileContentProcessor в Kotlin
class Filelndexer : FileContentProcessor {
override fun processContents(path: File,
binaryContents: ByteArray?,
❖
212
Глава 6. Система типов Kotlin
textContents: List<String>?) {
// ...
}
}
Сравните её с другим интерфейсом. Здесь реализация интерфейса
предусматривает преобразование некоторых данных из текстовой формы
в список объектов (с добавлением новых объектов в выходной список), со­
общает об ошибках, обнаруженных при анализе, и добавляет текст сооб­
щений в отдельный список.
Листинг 6.27. Другой интерфейс Java с коллекцией в качестве параметра
/* Java */
interface DataParser<T> {
void parseData(String input,
List<T> output,
List<String> errors);
}
Здесь нужно учесть другие соображения:
О Список L ist< S trin g> не может быть пустой ссылкой, поскольку вы­
зывающий код всегда должен получать сообщения об ошибках.
О Среди элементов списка может оказаться значение n u ll, поскольку
не все элементы в выходном списке будут иметь связанные с ними
сообщения об ошибках.
О Список L ist< S trin g> будет изменяемым, поскольку реализация
должна добавлять в него элементы.
Вот как можно реализовать такой интерфейс в Kotlin.
Листинг 6.28. Реализация интерфейса DataParser на языке Kotlin
class PersonParser : DataParser<Person> {
override fun parseData(input: String,
output: MutableList<Person>,
errors: MutableList<String?>) {
II . . .
}
}
Обратите внимание, как один и тот же Java-тип L ist< S trin g> пред­
ставлен в Kotlin двумя различными типами: L ist< S trin g> ? (список строк,
который может быть представлен пустой ссылкой) в одном случае и
6.3. Массивы и коллекции ❖
213
M utableL ist< S t г ing?> (изменяемый список строк с возможностью хране­
ния n u ll) в другом. Чтобы сделать правильный выбор, нужно точно знать
контракт, которому должен следовать интерфейс или класс Java. Обычно
это легко понять из назначения вашей реализации.
Теперь, когда мы разобрались с коллекциями, пришло время взгля­
нуть на массивы. Как уже говорилось, по умолчанию стоит предпочи­
тать коллекции, а не массивы. Но поскольку многие интерфейсы Java
API по-прежнему используют массивы, то полезно знать, как работать с
ними в Kotlin.
6.3.5. Массивы объектов и примитивных типов
Поскольку массив - это часть сигнатуры Java-функции main, то синтак­
сис объявления массивов в Kotlin встречается в каждом примере. Напом­
ним, как он выглядит:
Листинг 6.29. Использование массивов
fun main(args: Array<String>) {
for ( i in args.indices) {
println("Argument Si is: ${args[i]}")
}
J
Использование свойства-расширения
array.indices для обхода диапазона индексов
Обращение к элементу
I по индексу arrayjindex]
}
Массив в Kotlin - это класс с параметром типа, где тип элемента опреде­
ляется аргументом типа.
Создать массив в Kotlin можно следующими способами:
О Функция arrayOf создает массив с элементами, соответствующими
аргументам функции.
О Функция arrayO fN ulls создает массив заданного размера, где все
элементы равны n u ll. Конечно, эту функцию можно использовать
лишь для создания массивов, допускающих хранение n u ll в элемен­
тах.
О Конструктор класса Array принимает размер массива и лямбда-вы­
ражение, после чего инициализирует каждый элемент с помощью
этого лямбда-выражения. Так можно инициализировать массив,
который не поддерживает значения n u ll в элементах, не передавая
всех элементов непосредственно.
В качестве простого примера воспользуемся функцией Array и созда­
дим массив строк от "а" до "z".
Листинг 6.30. Создание массива строк
»> val letters = Array<String>(26) { i -> ('а' + i).toS tring() }
214 ❖
Глава 6. Система типов Kotlin
»> println( le tte rs. j oinToString(""))
abcdefghijklmnopqrstuvwxyz
Лямбда-выражение принимает индекс элемента массива и возвраща­
ет значение, которое будет помещено в массив с этим индексом. Здесь
значение вычисляется путем сложения индекса с кодом символа " а " и
преобразованием результата в строку. Тип элемента массива показан для
ясности - в реальном коде его можно опустить, поскольку компилятор
определит его самостоятельно.
Одна из самых распространенных причин создания массивов в Kotlin необходимость вызова метода Java, принимающего массив, или функции
Kotlin с параметром типа vararg. Чаще всего в таких случаях данные уже
хранятся в коллекции, и вам просто нужно преобразовать их в массив.
Сделать это можно с помощью метода toTypedArray.
Листинг 6.31. Передача коллекции в метод, принимающий vararg
»> val strings = listO f("a", "b", "с")
»> println( “%s/%s/%s” . f ormat(*strings. toTypedArray()))
a/b/c
Дляпередачимассивавметод,
<H ожидающийvararg, применяется
I операторразвертывания(*)
Как и с другими типами, аргумент типа в типе массива всегда становит­
ся ссылочным типом. Поэтому объявление Array<Int>, например, превра­
тится в массив оберток для целых чисел (Java-тип java. lang. Integer []).
Если вам нужно создать массив значений примитивного типа без обер­
ток, используйте один из специализированных классов для представления
массивов примитивных типов.
Для этой цели в Kotlin есть ряд отдельных классов, по одному для каждо­
го примитивного типа. Например, класс, соответствующий массиву значе­
ний типа Int, называется IntArray. Также существуют классы ByteArray,
CharArray, CharArray и другие. Все эти типы компилируются в обычные
массивы примитивных Java-типов, таких как int[], byte[], char[] и т. д.
Следовательно, значения в таких массивах не заворачиваются в объекты и
хранятся наиболее эффективным способом.
Создать массив примитивного типа можно следующими способами:
О Конструктор типа принимает параметр s iz e и возвращает массив,
инициализированный значениями по умолчанию для данного типа
(обычно нулями).
О Фабричная функция (intArrayOf - для массива IntArray и анало­
гичные для остальных типов) принимает переменное число аргу­
ментов и создает массив из этих аргументов.
О Другой конструктор принимает значение размера и лямбда-выраже­
ние для инициализации каждого элемента.
6.4. Резюме ❖
215
Вот как можно воспользоваться первыми двумя способами для создания
массива целых чисел, состоящего из пяти нулей:
val fiveZeros = IntArray(5)
val fiveZerosToo = intArrayOf(0, 0, 0, 0, 0)
А вот как использовать конструктор, принимающий лямбда-выражение:
»> val squares = IntArray(5) { i -> (i+1) * (i+1) }
»> println( squares. j oinToString())
1, 4, 9, 16, 25
Кроме того, существующие массив или коллекцию, хранящие обёрт­
ки для значений примитивного типа, можно преобразовать в массив
примитивного типа с помощью соответствующей функции - например,
toIntA rray.
Теперь посмотрим, что можно сделать с массивами. Кроме основных
операций (получения длины массива, чтения и изменения элементов),
стандартная библиотека Kotlin поддерживает для массивов тот же набор
функций-расширений, что и для коллекций. Все функции, которые вы ви­
дели в главе 5 (filte r , map и т. д.), тоже применимы к массивам, включая
массивы примитивных типов. (Заметим, что эти функции возвращают
списки, а не массивы.)
Давайте посмотрим, как переписать листинг 6.29, используя функцию
forEachlndexed и лямбда-выражение, которое вызывается для каждого
элемента массива и получает два аргумента: индекс элемента и сам эле­
мент.
Листинг 6.32. Применение функции forEachlndexed к массиву
fun main(args: Array<String>) {
args.forEachlndexed { index, element ->
p rin tln (“Argument $index is: Selement”)
}
}
Теперь вы знаете, как использовать массивы в своих программах. Рабо­
тать с ними в Kotlin так же просто, как с коллекциями.
6.4. Резюме
О Управление поддержкой n u ll в языке Kotlin помогает выявить воз­
можные исключения N ull P oin ter Except ion на этапе компиляции.
О Для работы со значением n u ll в Kotlin есть специальные инстру­
менты: оператор безопасного вызова (? .), оператор «Элвис» (?:),
утверждение, что значение не равно n u ll (!!), и функция le t .
216 ❖
Глава 6. Система типов Kotlin
О Оператор as? позволяет привести значения к типу и обрабатывать
случаи, когда оно имеет несовместимый тип.
О Типы, пришедшие из Java, интерпретируются в Kotlin как платфор­
менные типы, что позволяет разработчику относиться к ним как к
типам с поддержкой или без поддержки n u ll.
О Типы, представляющие обычные числа (например, In t), выглядят и
классы, но обычно компилируются
простые типы Java.
О Простые типы с поддержкой n u ll (такие как In t?) соответствуют
оберткам простых типов в Java (таким как j ava. la n g . In teger).
Тип Any - это супертип всех других типов и аналог типа Obj e c t в Java
А тип U nit - аналог void.
О Тип Nothing используется в качестве типа возвращаемого значения
для функций, которые в обычном режиме не завершаются.
О Для представления коллекций Kotlin использует стандартные клас­
сы Java, но делит их на доступные только для чтения и для чтения/
записи.
О При наследовании Java-классов и реализации Java-интерфейсов в
Kotlin нужно обращать пристальное внимание на возможность из­
менения и допустимость значения n u ll.
О Класс Array в Kotlin выглядит как обычный обобщенный класс, но
компилируется в Java-массив.
О Массивы простых типов представлены специальными классами, та­
кими как intA rray.
Часть
Непростой Kotun
Теперь вы должны иметь достаточно полное представление о приемах ис­
пользования существующих API из Kotlin. В этой части книги вы узнаете,
как создавать свои API на Kotlin. Имейте в виду, что эта тема касается не
только разработчиков библиотек: всякий раз, когда вам в вашей програм­
ме потребуются два взаимодействующих класса, как минимум один из
них должен будет предоставить свой API другому.
В главе 7 вы познакомитесь с соглашениями, которые используются в
Kotlin при реализации перегруженных операторов, и с другими абстрак­
циями, такими как делегированные свойства. В главе 8 во всех деталях
рассматриваются лямбда-выражения; в ней вы увидите, как объявлять
свои функции, принимающие лямбда-выражения в параметрах. Затем вы
познакомитесь с особенностями реализации в Kotlin более продвинутых
понятий Java, таких как обобщенные типы (глава 9), и научитесь приме­
нять аннотации и механизм рефлексии (глава 10). Также в главе 10 вы
рассмотрите довольно большой проект на языке Kotlin: JKid - библиотеку
сериализации/десериализации формата JSON. И в заключение, в главе 11,
мы увидим один из самых драгоценных бриллиантов в короне Kotlin: его
поддержку создания предметно-ориентированных языков.
Глава
Перегрузка операторов и другие
соглашения
В этой главе объясняются:
перегрузка операторов;
соглашения: функции со специальными именами для под­
держки различных операций;
делегирование свойств.
Как известно, некоторые особенности языка Java тесно связаны с опре­
деленными классами в стандартной библиотеке. Например, объекты, реа­
лизующие интерфейс ja v a . la n g . Ite r a b le , можно использовать в циклах
fo r, а объекты, реализующие интерфейс j ava. la n g . A utoC loseable, мож­
но использовать в инструкциях tr y -w ith -r e so u r c e s.
В Kotlin есть похожие особенности: некоторые конструкции языка вы­
зывают функции, определяемые в вашем коде. Но в Kotlin они связаны не
с определенными типами, а с функциями, имеющими специальные име­
на. Например, если ваш класс определяет метод со специальным именем
p lu s, то к экземплярам этого класса может применяться оператор +. Такой
подход в Kotlin называется соглашеншши. В этой главе мы познакомимся с
разными соглашениями, принятыми в языке Kotlin, и посмотрим, как они
используются на практике.
Вместо опоры на типы, как это принято в Java, в Kotlin действует прин­
цип следования соглашениям, потому что это позволяет разработчикам
адаптировать существующие Java-классы к требованиям возможностей
языка Kotlin. Множество интерфейсов, реализованных Java-классами,
фиксировано, и Kotlin не может изменять существующих классов, что­
бы добавить в них реализацию дополнительных интерфейсов. С другой
стороны, благодаря механизму функций-расширений есть возможность
7.1. Перегрузка арифметических операторов ❖
219
добавлять новые методы в классы. Вы можете определить любой метод,
описываемый соглашениями, как расширение и тем самым адаптировать
любой существующий Java-класс без изменения его кода.
В этой главе в роли примера будет простой класс P oint, представляю­
щий точку на экране. Подобные классы доступны в большинстве фреймворков, предназначенных для разработки пользовательского интерфейса,
и вы легко сможете перенести изменения, продемонстрированные ниже,
в свое программное окружение:
data class Point(val х: In t, val у: In t)
Начнем с определения арифметических операторов в классе Point.
7.1. Перегрузка арифметических операторов
Арифметические операторы - самый простой пример использования со­
глашений в Kotlin. В Java полный набор арифметических операций под­
держивается только для примитивных типов, а кроме того, оператор
можно использовать со значениями типа S trin g . Но эти операции могли
бы стать удобным подспорьем в других случаях. Например, при работе с
числами типа B ig ln teg er намного элегантнее использовать + для сложе­
ния, чем явно вызывать метод add. Для добавления элемента в коллекцию
удобно было использовать оператор +=. Kotlin позволяет реализовать это,
и в данном разделе мы покажем, как.
7.1.1. Перегрузка бинарных арифметических операций
Для начала реализуем операцию сложения двух точек. Она вычисляет
суммы координат X и Y точки. Вот как выглядит эта реализация.
Листинг 7.1. Определение оператора p lu s
data class Point(val x: In t, val y: In t) {
operator fun plus(other: Point): Point {
return Point(x + other.x, у + other.у)
}
J
Определениефункциисименем«plus»,
реализующейоператор
0~| Складываеткоординатыивозвращает
| новуюточку
}
»> val pi = Point(10, 20)
»> val р2 = Point(30, 40)
»> print ln(pl + р2)
Point(x=40, у=60)
| Вызовфункции«plus»путем
<|J использованияоператора+
Обратите внимание на ключевое слово operator в объявлении функ­
ции p lu s. Все функции, реализующие перегрузку операторов, обязательно
должны отмечаться этим ключевым словом. Оно явно сообщает, что вы
220 ❖
Глава 7. Перегрузка операторов и другие соглашения
намереваетесь использовать эту функцию в соответствии с соглашениями
и неслучайно выбрали такое имя.
а + Ь
После объявления функции p lu s с модифика­
тором operator становится возможно складывать
Рис. 7.1. Оператор +
транслируется в вызов
объекты, используя оператор +. За кулисами на
функции
plus
место этого оператора компилятор будет вставлять
вызов функции p lu s, как показано на рис. 7.1.
Объявить оператор можно не только как функцию-член, но также как
функцию-расширение.
Листинг 7.2. Определение оператора в виде функции-расширения
operator fun Point.plus(other: Point): Point {
return Point(x + other.x, у + other.у)
}
При этом реализация осталась прежней. В следующих примерах мы
будем использовать синтаксис функций-расширений - это более распро­
страненный шаблон реализации соглашений для классов во внешних биб­
лиотеках, и этот синтаксис с успехом можно применять и для своих клас­
сов.
Определение и использование перегруженных операторов в Kotlin вы­
глядят проще, чем в других языках, потому что в нём отсутствует возмож­
ность определять свои, нестандартные операторы. Kotlin ограничивает
набор операторов, доступных для перегрузки. Каждому такому оператору
соответствует имя функции, которую нужно определить в своем классе.
В табл. 7.1 перечислены все бинарные операторы, доступные для перегруз­
ки, и соответствующие им имена функций.
Таблица 7.1. Бинарные арифметические операторы,
доступные для перегрузки
Выражение
Имя функции
а * Ъ
а / Ъ
а %Ъ
tim es
div
mod
а + Ъ
а - b
plus
minus
Операторы для любых типов следуют тем же правилам приоритета, что
и для стандартных числовых типов. Например, в выражении а + Ъ * с
умножение всегда будет выполняться перед сложением, даже если это
ваши собственные версии операторов. Операторы *, / и %имеют одинако­
вый приоритет, который выше приоритета операторов + и -.
7.1. Перегрузка арифметических операторов ❖
221
Функции-операторы и Java
Перегруженные операторы Kotlin вполне доступны в Java-коде: так как каждый пере­
груженный оператор определяется как функция, их можно вызывать как обычные функ­
ции, используя полные имена. Вызывая Java-код из Kotlin, можно использовать синтаксис
операторов для любых методов с именами, совпадающими с соглашениями в Kotlin. Так
как в Java отсутствует синтаксис, позволяющий отметить функции-операторы, требование
использовать модификатор o p e ra to r к Java-коду не применяется, и вучет принимаются
только имена и количество параметров. ЕслиJava-класс определяетметод стребуемым по­
ведением, но под другим именем, вы можете создать функцию-расширение с правильным
именем, делегирующую выполнение операции существующемуJava-методу.
Определяя оператор, необязательно использовать одинаковые типы для
операндов. Например, давайте определим оператор, позволяющий мас­
штабировать точку в определенное число раз. Он может пригодиться для
представления точки в разных системах координат.
Листинг 7.3. Определение оператора с операндами разных типов
operator fun Point.times(scale: Double): Point {
return Point((x * scale).toInt(), (y * scale).toInt())
}
»> val p = Point(10, 20)
»> println(p * 1.5)
Point(x=15, y=30)
Обратите внимание, что операторы в Kotlin не поддерживают коммута­
тивность (перемену операндов местами) по умолчанию. Если необходимо
дать пользователям возможность использовать выражения вида 1 .5 * р
в дополнение к р * 1 .5 , следует определить отдельный оператор: opera­
to r fun D ou b le.tim es(p : P o in t): P oint.
Тип значения, возвращаемого функцией-оператором, также может отли­
чаться от типов операндов. Например, можно определить оператор, создаю­
щий строку путем повторения заданного символа указанное число раз.
Листинг 7.4. Определение оператора с отличающимся типом результата
operator fun Char.times(count: In t): String {
return toStringQ.repeat(count)
}
»> p rin tln ('a ' * 3)
aaa
222
❖
Глава 7. Перегрузка операторов и другие соглашения
Этот оператор принимает левый операнд типа Char, правый операнд
типа In t и возвращает результат типа S trin g . Такое сочетание типов опе­
рандов и результата вполне допустимо.
Заметьте также: подобно любым другим функциям, функции-операто­
ры могут иметь перегруженные версии. Можно определить несколько м е­
тодов с одним именем, отличающихся только типами параметров.
Отсутствие специальных операторов для поразрядных операций
В Kotlin отсутствуютлюбые поразрядные (битовые) операторы для стандартных число­
вых типов - и вследствие этого отсутствует возможность определять их для своих типов.
Для этих целей используются обычные функции, поддерживающие инфиксный синтак­
сис вызова. Вы также можете определить одноименные функции для работы со своими
типами.
Вот полный список функций, поддерживаемых в Kotlin для выполнения поразрядных
операций:
О
◦
◦
◦
О
shi - сдвиг влево со знаком;
shr - сдвиг вправо со знаком;
ushr - сдвиг вправо без знака;
and - поразрядное «И»;
o r - поразрядное «ИЛИ»;
О х о г - поразрядное «ИСКЛЮЧАЮЩЕЕ ИЛИ»;
о in v - поразрядная инверсия.
Следующий пример демонстрирует использование некоторых из этих функций:
»> println(0x0F and 0xF0)
0
»> println(0x0F or 0xF0)
255
»> println(0xl stil 4)
16
Теперь перейдем к обсуждению операторов, которые совмещают в себе
два действия: арифметическую операцию и присваивание (таких как +=).
7.1.2. Перегрузка составных операторов присваивания
Обычно, когда определяется оператор p lu s, Kotlin начинает поддержи­
вать не только операцию +, но и +=. Операторы +=, -= и другие называют
составными операторами присваивания. Например:
»> var point = Point(l, 2)
»> point += Point(3, 4)
»> println(point)
Point(x=4, y=6)
7.1. Перегрузка арифметических операторов ♦> 223
Это выражение действует точно так же, как p o in t = p o in t + P o in t(3 , 4 ).
Конечно, такое возможно только тогда, когда переменная изменяема.
В некоторых случаях имеет смысл определить операцию +=, которая
могла бы изменить объект, на который ссылается переменная, участвую­
щая в операции, а не менять переменную так, чтобы она ссылалась на дру­
гой объект. Один из таких случаев - добавление нового элемента в изме­
няемую коллекцию:
»> val numbers = ArrayList<Int>()
»> numbers += 42
»> println(numbers[0])
42
Если определить функцию с именем p lu sA ssign , возвращающую зна­
чение типа U nit, Kotlin будет вызывать её, встретив оператор +=. Дру­
гие составные бинарные операторы выглядят аналогично: minusAssign,
tim esA ssign и т. д.
В стандартной библиотеке Kotlin определяется функция p lu sA ssign для
изменяемых коллекции, и предыдущий пример использует ее:
operator fun <Т> MutableCoUection<T>.plusAssign(element: Т) {
tbis.add(element)
}
Теоретически, встретив оператор +=, ком­
а = a.plus(Ъ)
Ю
пилятор может вызвать любую из функций:
^ a.plusAssign(b)
plus и plusAssign (см. рис. 7.2). Если опреде­
Рис.
7.2.
Оператор
+=
может
лены и применимы обе функции, компиля­
быть преобразован в вызов
тор сообщит об ошибке. Исправить проблему
функции plus или plusAssign
проще всего заменой оператора обычным
вызовом функции. Также можно заменить var на val, чтобы операция
plusAssign оказалась недопустимой в текущем контексте. Но лучше все­
го изначально проектировать классы непротиворечивыми: старайтесь не
добавлять сразу обе функции, plus и plusAssign. Если класс неизменяе­
мый (как Point в одном из примеров выше), добавляйте в него только опе­
рации, возвращающие новые значения (например, plus). Если вы проек­
тируете изменяемый класс (например, построитель), добавляйте только
plusAssign и другие подобные операции.
Стандартная библиотека Kotlin поддерживает оба подхода для коллек­
ций. Операторы + и - всегда возвращают новую коллекцию. Операторы +=
и -= работают с изменяемыми коллекциями, модифицируя их на месте, а
для неизменяемых коллекций возвращают копию с модификациями. (То
есть операторы += и -= будут работать с неизменяемыми коллекциями,
только если переменная со ссылкой объявлена как var.) В качестве опе­
рандов этих операторов можно использовать отдельные элементы или
другие коллекции с элементами соответствующего типа:
1
а
CL
+
—
—
Т л
224 ❖
»>
»>
»>
»>
[1,
»>
[1,
Глава 7. Перегрузка операторов и другие соглашения
val lis t = arrayListO£(l, 2)
О — += изменяет содержимое списка «list»
lis t += 3
val newList = lis t + list0 f(4 , 5) < 1“ I * возвращает новый список,
p rin tln (lis t)
I содержащий все элементы
2, 3]
printIn(newList)
2, 3, 4, 5]
До сих пор мы обсуждали перегрузку бинарных операторов - операто­
ров, применяемых к двум значениям (например, а + b ). Однако в Kotlin
поддерживается возможность перегрузки унарных операторов, которые
применяются к единственному значению (например, - а ).
7.1.3. Перегрузка унарных операторов
Процедура перегрузки унарного оператора ничем не отличается от опи­
санной выше: объявляется функция (член или расширение) с предопре­
деленным именем, которая затем отмечается модификатором operator.
Рассмотрим это на примере.
Листинг 7.5. Определение унарного оператора
operator fun Point. unaryMinus(): Point {
<h
реализующая унарный
return Point(-x, -у) < Н Меняет знак координат точки I минус, не имеет параметров
}
I и возвращает их
»> val р = Point(10, 20)
»> println(-p)
Point(x=-10, у=-20)
Функции, используемые для перегрузки унарных операторов, не при­
нимают никаких аргументов. Как показано на рис. 7.3, оператор унарно­
го плюса действует аналогично. В табл. 7.2 пере­
числены все унарные операторы, которые можно
Рис.
7.3.
Унарный
+
перегрузить.
транслируется в вызов
функции unaryPLus
Таблица 7.2. Унарные арифметические операторы,
доступные для перегрузки
Выражение
Имяфункции
+а
unaryPlus
-а
unaryMinus
!а
not
++а, а++
inc
- - а , а--
dec
7.2. Перегрузка операторов сравнения
225
Когда определяются функции in c и dec для перегрузки операторов ин­
кремента и декремента, компилятор автоматически поддерживает ту же
семантику пред- и постинкремента, что и для обычных числовых типов.
Взгляните на следующий пример - перегружающий оператор ++ для клас­
са BigDecimal.
Листинг 7.6. Определение оператора инкремента
o p e ra to r fu n B ig D e c im a l.in c () = th is + B igD ecim al.O N E
» > v a r bd = B ig D e c im a l. ZERO
» > p rin tln (b d + + )
I увеличит значение переменной
< H после первого вызоваprintln
0
» > p rin tln (+ + b d )
2
< H увеличит значение переменной
I перед вторым вызовом println
Постфиксная операция ++ сначала вернет текущее значение перемен­
ной bd, а затем увеличит его, в то время как префиксная операция работа­
ет с точностью до наоборот. На экране появятся те же значения, как если
бы использовалась переменная типа In t, и для этого не требуется допол­
нительной поддержки.
7.2. Перегрузка операторов сравнения
По аналогии с арифметическими операторами Kotlin дает возможность ис­
пользовать операторы сравнения (==, !=,>,< и другие) с любыми объекта­
ми, а не только с простыми типами. Вместо вызова eq u als или compareTo,
как в Java, вы можете использовать непосредственные операторы срав­
нения, которые выглядят короче и понятнее. В этом разделе мы познако­
мимся с соглашениями, используемыми для поддержки этих операторов.
7.2.1. Операторы равенства: «equals»
Мы уже затрагивали тему равенства в разделе 4.3.1. Там мы узнали, что
в языке Kotlin оператор == транслируется в вызов метода equals. Это лишь
одно из применений принципа соглашений, о котором мы говорим.
Оператор ! = также транслирует­
ся в вызов eq u als, но с очевидным
Рис.
7.4.
Проверка
на
равенство
==
различием: результат вызова ин­
транслируется
в
вызов
equals
и
проверку
вертируется. Обратите внимание:
на равенство null
в отличие от всех других операторов, == и ! = можно использовать с операндами, способными иметь зна­
чение n u ll, потому что за кулисами эти операторы проверяют на равен­
ство значению n u ll. Сравнение а == b проверит операнды на равенство
n u ll, а затем, если эта проверка дала отрицательный результат, вызовется
226 ❖
Глава 7. Перегрузка операторов и другие соглашения
а . eq u a ls(b ) (см. рис. 7.4). Иначе результат может принять значение tru e,
только если оба аргумента являются пустыми (n u ll) ссылками.
Для класса P oint компилятор автоматически сгенерирует реализацию
eq u als, потому что класс снабжен модификатором data (подробности
описаны в разделе 4.3.2). Но если бы потребовалось написать её вручную,
она могла бы выглядеть как в листинге 7.7.
Листинг 7.7. Реализация метода equals
class Point(val х: In t, val у: In t) {
override fun equals(obj: Any?): Boolean { О— Переопределяет метод, объявленный в Any
i f (obj === this) return true
< Ь | Оптимизация: проверить - не является
i f (obj !is Point) return false
0~ | I ли параметр объектом «this»
return obj.x == x && obj.у == у
Проверка типа параметра
}
}
Использовать автоматическое приведение
к типу Point для доступа к свойствам х и у
»> println(Point(10, 20) == Point(10, 20))
true
»> println(Point(10, 20) != Point(5, 5))
true
»> println(null == Point(l, 2))
false
Здесь используется оператор строгого равенства, или идентичности
(===), чтобы проверить равенство параметра текущему объекту. Оператор
идентичности действует в точности как оператор == в Java: он сравнивает
ссылки своих аргументов (или значения, если аргументы - это значения
простого типа). Использование этого оператора - распространенная опти­
мизация реализаций eq u als. Обратите внимание, что оператор === недо­
ступен для перегрузки.
Функция eq u als отмечена модификатором o v er rid e, потому что (в
отличие от других соглашений) реализация метода имеется в классе Any
(и проверка равенства поддерживается в Kotlin для всех объектов). Это
также объясняет, почему не нужно добавлять модификатор operator:
базовый метод в классе Any уже отмечен этим модификатором, который
автоматически применяется ко всем методам, которые реализуют или пе­
рекрывают его. Также отметьте, что eq u als нельзя реализовать как рас­
ширение, потому что реализация наследуется из класса Any и всегда имеет
приоритет перед расширением.
Этот пример демонстрирует, что использование оператора != также
транслируется в вызов метода eq u als. Компилятор автоматически инвер­
тирует возвращаемое значение, поэтому для гарантии правильной работы
от вас не требуется ничего. А теперь перейдем к другим операторам срав­
нения.
7.2. Перегрузка операторов сравнения ♦
227
7.2.2. Операторы отношения: compareTo
Классы в Java могут реализовать интерфейс Comparable, чтобы дать воз­
можность использовать их в алгоритмах сравнения значении, таких как
поиск максимального значения или сортировка. Метод compareTo этого
интерфейса помогает определить, какой из двух объектов больше. Но в Java
отсутствует краткий синтаксис вызова этого метода. Только значения прос­
тых типов могут сравниваться с использованием < и >, а для всех остальных
типов приходится явно писать e le m e n tl. compareTo(element2).
Kotlin поддерживает тот же интерфейс Comparable. Но метод compare­
To этого интерфейса может вызываться по соглашениям и используется
операторами сравнения (<, >, <= и >=), которые автоматически транслиру­
ются в вызовы compareTo (см. рис. 7.5). Значение, возвращаемое методом
compareTo, должно иметь тип In t. Выражение p i < р2 эквивалентно вы­
ражению p i . compareTo(p2) < 0. Другие операторы сравнения работают
аналогично. Поскольку нет очевидно правильного способа сравнения то­
чек, воспользуемся старым добрым клас­
а >= b
сом Person, чтобы показать реализацию
Рис. 7.5. Сравнение двух объек­
метода. Реализация будет использовать
тов транслируется в сравнение с
алгоритм, используемый в телефонных
нулем результата, возвращаемого
справочниках (сначала сравниваются фа­
методом compareTo
милии, а затем, если они равны, сравни­
ваются имена).
Листинг 7.8. Реализация метода compareTo
class Person(
val firstName: String, val lastName: String
) : Comparable<Person> {
override fun compareTo(other: Person): Int {
return compareValuesBy(this, other,
Person::lastName, Person::firstName)
>
Вызывает заданные функции в
указанном порядке и сравнивает
возвращаемые ими результаты
>
»> val pi = Person("Alice", "Smith")
»> val p2 = Person("Bob", "Johnson")
»> println(pl < p2)
false
Мы реализовали интерфейс Comparable так, что объекты Person могут
сравниваться не только с помощью кода на Kotlin, но также и функций на
Java (например, функций, используемых для сортировки коллекций). Как
в случае с методом eq u als, модификатор operator уже применен к функ-
228
❖
Глава 7. Перегрузка операторов и другие соглашения
ции базового интерфейса. Поэтому нам не понадобилось повторять это
ключевое слово при переопределении функции.
Обратите внимание: чтобы упростить реализацию comparеТо, мы ис­
пользовали функцию compareValuesBy из стандартной библиотеки Kotlin.
Она принимает список функций обратного вызова, результаты которых
подлежат сравнению. Каждая из этих функций по очереди вызывается для
обоих объектов, сравниваются полученные значения, и возвращается ре­
зультат. Если значения первой пары отличаются, возвращается результат
их сравнения. Если они равны, вызывается следующая функция, и срав­
ниваются её результаты для каждого из объектов - или, если не осталось
других функций, возвращается 0. В качестве функций обратного вызова
можно передавать лямбда-выражения или, как в данном примере, ссылки
на свойства.
Также имейте в виду, что прямое сравнение полей вручную могло бы
работать быстрее, но пришлось бы написать больше кода. Как обычно,
предпочтение следует отдавать более компактному коду, а о производи­
тельности беспокоиться, только если сравнение планируется выполнять
очень часто.
Все Java-классы, реализующие интерфейс Comparable, можно сравни­
вать в коде на Kotlin с использованием краткого синтаксиса операторов:
» > p r in tln (" a b c " < "b a c ")
tr u e
Для этого не требуется добавлять никаких расширений.
7.3. Соглашения для коллекций и диапазонов
К наиболее распространенным операциям для работы с коллекциями от­
носятся операции извлечения и изменения значений элементов по их
индексам, а также операция проверки вхождения в коллекцию. Все такие
операции поддерживают синтаксис операторов: чтобы прочитать или
изменить значение элемента по индексу, используется синтаксис а[Ь]
(называется оператором индекса). Для проверки вхождения элемента в
коллекцию или в диапазон, а также для итераций по коллекциям можно
использовать оператор in . Эти операции можно добавить в свои классы,
действующие подобно коллекциям. Давайте посмотрим, какие соглаше­
ния используются для поддержки этих операций.
7.3.1. Обращение к элементам по индексам: «get» и «set»
Как известно, к элементам словарей в Kotlin можно обращаться так же,
как к элементам массивов в Java, - с применением квадратных скобок:
v a l v a lu e = m ap [key]
7.3. Соглашения для коллекций и диапазонов ❖
229
Тот же оператор можно использовать для изменения значений по клю­
чам в изменяемом словаре:
mutableMap[key] = newValue
Теперь посмотрим, как это работает. Оператор индекса в Kotlin - ещё
один пример соглашений. Операция чтения элемента с использованием
оператора индекса транслируется в вызов метода-оператора g et, а опе­
рация записи - в вызов s e t. Эти методы уже определены в интерфейсах
Мар и MutableMap. Ниже - о том, как добавить аналогичные методы в свой
класс.
Мы можем реализовать возможность обращения к координатам точки
с использованием квадратных скобок: р [0 ] - для доступа к координате X
и р [ 1 ] - для доступа к координате Y. Вот как реализовать и использовать
такую возможность.
Листинг 7.9. Реализация соглашения get
O —i Определение функции-оператора
operator fun Point.get(index: In t): Int {
| с именем «get»
return when(index) {
Вернуть координату, соответствующую
0 -> x
заданному индексу
1 -> у
else ->
throw IndexOutOfBoundsException("Invalid coordinate $index” )
}
}
»> val p = Point(10, 20)
»> p rin tln (p [l])
20
Как видите, достаточно определить функцию
g e t и отметить её модификатором operator.
Рис. 7.6. Операция доступа
После этого выражения вида р [1 ], где р - это
с применением квадратных
объект типа P oint, будут транслироваться в вы­
скобок транслируется в
зовы метода g et, как показано на рис. 7.6.
вызов функции get
Обратите внимание, что в функции g et мож­
но объявить параметр не только типа In t, но и любого другого типа. На­
пример, когда оператор индекса применяется к словарю, тип параметра
должен совпадать с типом ключей словаря, который может быть любым
произвольным типом. Также можно определить метод g e t с несколь­
кими параметрами. Например, в реализации класса, представляющего
двумерный массив или матрицу, можно определить метод operator fun
get(rowIndex: Int, collndex: Int) и вызывать его как matrix [row,
col]. Если доступ к элементам коллекции возможен с применением клю~ г п
X
L Э-
/
Ъ 1
-D J
^
Q СU \
Oi г
С
)
230 ❖
Глава 7. Перегрузка операторов идругие соглашения
чей разных типов, то допускается также определить перегруженные вер­
сии метода g e t с разными типами параметров.
Аналогично можно определить функцию, позволяющую изменять зна­
чение элемента по индексу с применением синтаксиса квадратных ско­
бок. Класс Point - неизменяемый, поэтому нет смысла добавлять в него
такой метод. Давайте лучше определим другой класс, представляющий
изменяемую точку, и используем его в качестве примера.
Листинг 7.10. Реализация соглашения s e t
data class MutablePoint(var x: In t, var y: In t)
operator fun MutablePoint.set( index: In t, value: In t) { <H Определение функции-оператора
when( index) {
| с именем «set»
0 -> x = value
Изменить координату, соответствующую
заданному индексу
1 -> у = value
else ->
throw IndexOutOfBoundsException("Invalid coordinate Jindex")
»> val p = MutablePoint(10, 20)
>» p [l] = 42
»> println(p)
MutablePoint(x=10, y=42)
Этот пример так же прост, как предыду­
щий: чтобы дать возможность использо­
Рис. 7.7. Операция присваива­
ния с применением квадратных
вать оператор индекса в операции присваи­
скобок транслируется в вызов
вания, достаточно определить функцию
функции
set
с именем s e t. Последний параметр в s e t
получает значение, указанное справа от оператора присваивания, а другие
аргументы соответствуют индексам внутри квадратных скобок (рис. 7.7).
A l a ,
J3J
-
C
|--------
®
• 3 w ^ \ wL f
/
C j
7.3.2. Соглашение «in»
Еще один оператор, поддерживаемый коллекциями, - оператор in . Он
используется для проверки вхождения объекта в коллекцию. Соответствую­
щая функция называется co n ta in s. Реализуем её, чтобы дать возможность
использовать оператор in для проверки вхождения точки в границы пря­
моугольника.
Листинг 7.11. Реализация соглашения
in
data class Rectangle(val upperLeft: Point, val lowerRight: Point)
7.3. Соглашения для коллекций и диапазонов ❖
operator fun Rectangle.contains(p: Point): Boolean {
return p.x in upperLeft.x u n til lowerRight.x &&
p.y in upperLeft.y u n til lowerRight.у
}
»> val rect = Rectangle(Point(10, 20), Point(50, 50))
»> println(Point(20, 30) in rect)
true
»> println(Point(5, 5) in rect)
false
231
Создает диапазон и проверяет принадлежностъ ему координаты «х»
Использует функцию «until» для
создания открытого диапазона
O —i
a in с
с *contains(а)
Метод co n ta in s вызывается для объекта
Рис. 7.8. Оператор in транссправа от in , а объект слева передается этому
лируется в вызов функции
методу в аргументе (см. рис. 7.8).
contains
В реализации метода R e c ta n g le .c o n ta in s мы задействовали функцию
u n t i l из стандартной библиотеки и с её помощью конструируем откры­
тый диапазон, который затем используем для проверки принадлежности
точки этому диапазону.
Открытый диапазон - это диапазон, не включающий конечного зна­
чения. Например, если сконструировать обычный (закрытый) диапазон
1 0 .. 20, он будет включать все значения от 10 до 20, в том числе и 20. От­
крытый диапазон от 10 до 20 включает число от 10 до 19, но не включает
20. Класс прямоугольника обычно определяется так, что правая нижняя
точка не считается частью прямоугольника, поэтому мы использовали от­
крытые диапазоны.
7.3.3. Соглашение rangeTo
Для создания диапазона используется синтаксис . . : например, 1 .. 10
перечисляет все числа от 1 до 10. Мы уже познакомились с диапазонами
в разделе 2.4.2, а теперь пришла пора
обсудить соглашение, помогающее
Рис.
7.9.
Оператор
..транслируется
создавать их. Оператор . . представля­
в вызов функции rangeTo
ет собой краткую форму вызова функ­
ции rangeTo (см. рис. 7.9).
Функция rangeTo возвращает диапазон. Вы можете реализовать под­
держку этого оператора в своем классе. Но если класс реализует интерфейс
Comparable, в этом нет необходимости: в таком случае диапазоны будут
создаваться средствами стандартной библиотеки КоШп. Библиотека вклю­
чает функцию rangeTo, которая может быть вызвана для любого элемента,
поддерживающего операцию сравнения:
operator fun <Т: Comparable<T>> T.rangeTo(that: Т): ClosedRange<T>
Эта функция возвращает диапазон, что дает возможность проверить
разные элементы на принадлежность ему. Для примера сконструируем
232 ❖
Глава 7. Перегрузка операторов и другие соглашения
диапазон дат, используя класс Local Date (объявлен в стандартной библио­
теке Java 8).
Листинг 7.12. Операции с диапазонами дат
»> val now = LocalDate.now()
»> val vacation = now. .now.plusDays(10)
»> println(now.plusWeeks(l) in vacation)
true
Создает 10-дневный диапазон,
начиная от текущей даты
Проверяет принадлежность
конкретной даты этому диапазону
Компилятор преобразует выражение now. .n ow .p lu sD ays(l0) в now.
rangeTo(now. p lu sD ays(1 0 )). Функция rangeTo не является членом класса
LocalDate - это функция-расширение для Comparable, как было показано
ранее.
Оператор rangeTo имеет более низкий приоритет, чем арифметические
операторы, поэтому мы рекомендуем пользоваться круглыми скобками,
чтобы избежать путаницы:
>» val п = 9
» > p r in tln ( 0 . .(п + 1 ))
0 .. 10
< Н Также можно записать как (Ln+1, но
I круглые скобки делают код более ясным
Также отметьте, что выражение 0. .n . fo r Each { } не будет компилиро­
ваться. Чтобы исправить эту проблему, диапазон нужно заключить в круг­
лые скобки:
»> (0. .n).forEadi { p rin t(it)
0123456789
}
<1
| Заключите диапазон в круглые скобки, чтобы
I получить возможность вызвать его метод
Теперь обсудим соглашения, используемые для итерации по коллекци­
ям и диапазонам.
7.3.4. Соглашение «iterator» для цикла «for»
Как рассказывалось в главе 2, циклы fo r в Kotlin используют тот же опе­
ратор in , что применяется для проверки принадлежности диапазону. Но
в данном контексте он предназначен для выполнения итераций. То есть
такие инструкции, как fo r (х in l i s t ) { ... }, транслируются в вызов
l i s t . it e r a to r ( ), который повторно вызывает методы hasNext и n ext, в точности как в Java.
Обратите внимание, что в Kotlin этот метод - соглашение, то есть метод
ite r a to r можно определить как расширение. Это объясняет возможность
итераций по обычным строкам Java: стандартная библиотека определя­
ет функцию-расширение ite r a to r в CharSequence, суперклассе, который
наследует класс S trin g:
Мультидекларации и функции component
operator fun CharSequence.iterato r(): Charlterator
<*“ 1 Эта библиотечная функция позволяет
I выполнять итерацию по строке
»> for (c in "abc") {}
Вы можете определять метод ite r a to r в своих классах. Например, сле­
дующий метод позволяет выполнять итерации по датам.
Листинг 7.13. Реализация итератора по диапазону дат
operator fun ClosedRange<LocalDate>.iterator(): Iterator<LocalDate> =
object : Iterator<LocalDate> {
<^~ \ Этот объект реализует интерфейс Iterator для
var current = start
I поддержки итераций по элементам LocalDate
override fun hasNext() =
current <= endlnclusive
J
Обратите внимание, что дня д ат
используется соглашение compareTo
override fun next() = current.apply {
<Э- | Возвращает текущую дату как
current = plusDays(l)
^ Увеличивает текущуюп I результат перед ее изменением
}
' дату на один день
»> val newYear = LocalDate.ofYearDay(2017, 1)
»> val daysOff = newYear.minusDays(l)..newYear
»> for (dayOff in daysOff) { println(dayOff) }
2016- 12-31
2017- 01-01
Выполняет итерации no daysOff,
<•“ 1 когда доступна соответствующая
I функция iterator
Обратите внимание, как определяется метод ite r a to r для нестандарт­
ного типа диапазона: аргумент имеет тип LocalDate. Библиотечная функ­
ция rangeTo, представленная в предыдущем разделе, возвращает экзем­
пляр ClosedRange, а расширение ite r a to r в ClosedRange<LocalDate>
позволяет использовать экземпляр диапазона в цикле for.
7.4. Мультидекларации и функции component
Обсуждая классы данных в разделе 4.3.2, мы упоминали, что раскроем
некоторые из их дополнительных особенностей позднее. Теперь, позна­
комившись с идеей соглашений, мы готовы рассмотреть мультидекларации
(destructuring declarations), которые позволяют распаковать единое со­
ставное значение и использовать его для инициализации нескольких пе­
ременных.
Вот как это работает:
»> val р = Point(10, 20)
»> val (х, у) = р
»> println(x)
< П Объявляются переменные х и у и инициализируются
' компонентами объекта р
234 ❖
Глава 7. Перегрузка операторов и другие соглашения
»> println(y)
20
Мультидекларация похожа на обычное объявление переменной, но со­
держит несколько переменных, заключенных в круглые скобки.
Скрытая от ваших глаз работа мультидеклараций также основана на
принципе соглашений. Для инициализации каждой переменной в муль­
тидекларации вызывается функция с именем components, где N - номер
позиции переменной в объявлении. Иными словами, предыдущий при­
мер транслируется в код, изобра­
val а = р .componentl()
женный на рис. 7.10.
val b = р .component2()
Для класса данных компиля­
Рис. 7.10. Мультидекларация транслируется
тор сгенерирует функции compo­
в вызовы функций componentA/
nent N для каждого свойства, объявленного в основном конструкторе. Следующий пример демонстрирует,
как можно объявить такие функции вручную в других классах, не являю­
щихся классами данных:
class Point(val х: In t, val у: In t) {
operator fun componentl() = x
operator fun component2() = у
}
Мультидекларации часто оказываются удобным способом возврата не­
скольких значений из функций. Для этого объявите класс данных для хра­
нения возвращаемых значений и используйте его в качестве типа значе­
ния, возвращаемого функцией. Синтаксис мультидеклараций позволяет
легко распаковать и использовать значения после вызова функции. Для
демонстрации напишем простую функцию, разбивающую имя файла на
отдельные имя и расширение.
Листинг 7.14. Использование мультидекларации для возврата из функции
нескольких значений
data class NameComponents(val name: String,
val extension: String)
fun splitFilename(fullName: String): NameComponents {
val result = fullNam e.split('. ', lim it = 2)
return NameComponents(result[0], result [1])
<H Возвратэкземпляракласса
}
I данныхизфункции
»> val (name, ext) = splitFilenameC'example.kt") <H Используетсинтаксисмультидеклараций
»> printIn(name)
I дляизвлечениязначений
example
7.4. Мультидекларации и функции component ❖
235
»> println(ext)
kt
Этот пример можно усовершенствовать, приняв во внимание, что функ­
ции component N имеются в массивах и коллекциях. Это может пригодиться
при работе с коллекциями, размер которых известен заранее. Именно та­
кой случай - функция s p l i t , возвращающая список с двумя элементами.
Листинг 7.15. Использование мультидекларации с коллекцией
data class NameComponents(
val name: String,
val extension: String)
fun splitFilename(fuUName: String): NameComponents {
val (name, extension) = fullNam e.split('. ', lim it = 2)
return NameComponents(name, extension)
}
Конечно, невозможно объявить бесконечное количество таких функций
components, чтобы можно было использовать этот синтаксис для работы
с произвольными коллекциями. Но обычно в этом нет никакой необхо­
димости. Стандартная библиотека позволяет использовать этот синтаксис
для извлечения первых пяти элементов из контейнера.
Ещё более простой способ возврата нескольких значений из функций
дают классы Pair и T rip le из стандартной библиотеки. В этом случае код
получается менее выразительным, потому что эти классы не позволяют
узнать смысл возвращаемого объекта, зато более лаконичным, потому что
отпадает необходимость объявлять свой класс данных.
7.4.1. Мультидекларации и циклы
Мультидекларации могут использоваться не только как инструкции
верхнего уровня в функциях, но и в других местах, где допускается объяв­
ление переменных - например, в циклах. Один из интересных приемов перечисление элементов словаря в цикле fo r. Вот маленький пример
использования этого синтаксиса для вывода всех элементов заданного
словаря.
Листинг 7.16. Использование мультидекларации для обхода элементов словаря
fun printEntries(map: Map<String, String>) {
for ((key, value) in map) {
<i~ l Мультидекларация
p rin tln (“$key -> $value” )
I в объявлении цикла
}
236 ❖
Глава 7. Перегрузка операторов и другие соглашения
»> val map = mapOf("Oracle" to "Java", "JetBrains" to "Kotlin")
»> printEntries(map)
Oracle -> Java
JetBrains -> Kotlin
В этом простом примере используются два соглашения Kotlin: одно - для
организации итерации по содержимому объекта, а другое - для поддерж­
ки мультидеклараций. Стандартная библиотека Kotlin включает функ­
цию-расширение ite r a to r для словарей, которая возвращает итератор
для обхода элементов словаря. То есть, в отличие от Java, в Kotlin есть воз­
можность выполнять итерации по словарю непосредственно. В Мар. Entry
имеются также функции-расширения component 1 и component2, которые
возвращают ключ и значение соответственно. В результате предыдущий
цикл транслируется в следующий эквивалентный код:
for (entry in map.entries) {
val key = entry.componentl()
val value = entry.component2Q
П ...
}
Этот пример ещё раз иллюстрирует важность функций-расширений для
соглашений.
7.5. Повторное использование логики
обращения к свойству: делегирование свойств
В заключение главы рассмотрим еще одну особенность, опирающуюся
на соглашения, одну из самых необычных и мощных в языке Kotlin: де­
легирование свойств. Эта особенность позволяет без труда реализовать
свойства с логикой сложнее, чем хранение данных в соответствующих
полях, без дублирования кода в каждом методе доступа. Например, свой­
ства могут хранить свои значения в базе данных, в сеансе браузера, в
словаре и так далее.
В основе этой особенности лежит делегирование: шаблон проектирова­
ния, согласно которому объект не сам выполняет требуемое задание, а де­
легирует его другому вспомогательному объекту. Такой вспомогательный
объект называется делегатом. Вы уже видели этот шаблон в разделе 4.3.3,
когда мы обсуждали делегирование классов. Но в данном случае данный
шаблон применяется к свойствам, которые могут делегировать логику
доступа методам вспомогательного объекта. Вы можете реализовать этот
шаблон вручную (как будет показано чуть ниже) или использовать лучшее
решение: воспользоваться встроенной поддержкой в языке Kotlin. Для на-
7.5. Повторное использование логики обращения к свойству: делегирование свойств ❖
237
чала познакомимся с общей идеей, а затем рассмотрим конкретные при­
меры.
7.5.1. Делегирование свойств: основы
В общем случае синтаксис делегирования свойств выглядит так:
class Foo {
var р: Type by DelegateQ
}
Свойство p делегирует логику своих методов доступа другому объекту:
в данном случае новому экземпляру класса D elegate. Экземпляр созда­
ется выражением, следующим за ключевым словом by, и может быть чем
угодно, удовлетворяющим требованиям соглашения для делегирования
свойств.
Компилятор создаст скрытое вспомогательное свойство, инициализи­
рованное экземпляром объекта-делегата, которому делегируется логика
работы свойства р. Для простоты назовем это свойство d eleg a te:
class Foo {
private val delegate = DelegateQ
Эю вспомогательное свойство,
сгенерированное компилятором
var р: Туре
set(value: Type) = delegate.setValue(..., value)
get() = delegate.getValue(...)
Методы доступа, сгенерированные
для свойства «р», вызывают
getValue и setvalue объекта
«delegate»
В соответствии с соглашением класс D elegate должен иметь мето­
ды getV alue и setV alue (последний требуется только для изменяемых
свойств). Как обычно, они могут быть членами или расширениями. Чтобы
упростить рассуждения, опустим их параметры; точные их сигнатуры бу­
дут показаны ниже в этой главе. В простейшем случае класс D elegate мог
бы выглядеть примерно так:
class Delegate {
operator fun getValue(. . . ) { . . . }
operator fun setValue(..
class Foo {
var р: Type by DelegateQ
}
»> val foo = FooQ
»> val oldValue = foo.p
»> foo.p = newValue
I Метод getValue реализует
<|J логику метода чтения
value: Type) { ... }
I Ключевое слово «Ьу» связывает
<]—Iсвойство с обьетпом-делегатом
Обращение к свойству rao.p приводит
к вызову delegate.getvalue(...
за кулисами
J Операция изменения значения свойства
вызывает delegatesetValue(..., newValue)
238
❖
Глава 7. Перегрузка операторов и другие соглашения
Свойство fo o .p можно использовать как обычно, но за кулисами
операции с ним будут вызывать методы вспомогательного свойства
типа D eleg a te. Чтобы понять, как этот механизм может пригодиться
на практике, рассмотрим пример, демонстрирующий мощь делегиро­
вания свойств: поддержку отложенной инициализации в библиотеке.
А затем покажем, как определять свои делегаты и в каких случаях это
может пригодиться.
7.5.2. Использование делегирования свойств:
отложенная инициализация и «by lazy()»
Отложенная инициализация (lazy initialization) - распространенный
шаблон, позволяющий отложить создание объекта до момента, когда он
действительно потребуется. Это может пригодиться, когда процесс ини­
циализации потребляет значительные ресурсы или данные в объекте мо­
гут не требоваться.
Для примера рассмотрим класс Person, включающий список указан­
ных пользователем адресов электронной почты. Адреса хранятся в базе
данных, и для их извлечения требуется определенное время. Хотелось бы
сделать так, чтобы адреса извлекались из базы данных только при первом
обращении к свойству и только один раз. Допустим, что у нас есть функция
loadEm ails, возвращающая адреса из базы данных:
class Email { / * . . . * / }
fun loadEmails(person: Person): List<Email> {
println("Load emails for ${person.name}")
return lis tO f(/* .. .*/)
}
Вот как можно реализовать отложенную загрузку, используя дополни­
тельное свойство _em ails, изначально хранящее n u ll, и список адресов
после загрузки.
Листинг 7.17. Реализация отложенной инициализации с использованием
вспомогательного свойства
class Person(val name: String) {
private var _emails: List<Email>? = null
val emails: List<Email>
get() {
i f (_emails == null) {
_emails = loadEmails(this)
>
Свойство «_emails», хранящее данные и
которому делегируется логика работы
свойства «emails»
7.5. Повторное использование логики обращения к свойству: делегирование свойств ❖
return emails!!
239
I
»> val p = Person("Alice")
»> p.emails
Load emails for Alice
»> p.emails
Здесь используется приём на основе так называемого теневого свойства
(backing property). У нас имеются свойство _em ails, хранящее значение,
и свойство em ails, открывающее доступ к нему для чтения. Мы вынуж­
дены использовать два свойства, потому что они имеют два разных типа:
_em ails может хранить значение n u ll, a em ails - нет. Этот приём исполь­
зуется очень часто, поэтому его стоит освоить.
Но код получился тяжелым для чтения - просто представьте, что вам
потребовалось реализовать несколько свойств с отложенной инициализа­
цией. Более того, этот приём не всегда работает правильно: реализация не
будет безопасной в контексте многопоточного выполнения. Однако Kotlin
предлагает более удачное решение.
Код станет намного проще, если использовать делегированные свойст­
ва, инкапсулирующие теневые свойства для хранения значений и логику,
гарантирующую инициализацию свойств только один раз. В данном слу­
чае можно использовать делегата, возвращаемого функцией la zy из стан­
дартной библиотеки.
Листинг 7.18. Реализация отложенной инициализации с использованием
делегирования свойства
class Person(val name: String) {
val emails by lazy { loadEmails(tbis) }
}
Функция lazy возвращает объект, имеющий метод getValue с соответ­
ствующей сигнатурой, - то есть её можно использовать с ключевым сло­
вом by для создания делегированного свойства. В аргументе функции lazy
передается лямбда-выражение, которое она вызывает для инициализации
значения. Функция lazy по умолчанию пригодна для использования в
многопоточном окружении, и если потребуется, ей можно передать допол­
нительные параметры, чтобы сообщить, какую блокировку использовать
или вообще игнорировать средства синхронизации, если класс никогда не
будет использоваться в многопоточной среде.
В следующем разделе мы углубимся в детали механизма делегирования
свойств и обсудим соглашения, действующие в этой области.
240 ❖
Глава 7. Перегрузка операторов и другие соглашения
7.5.3. Реализация делегирования свойств
Чтобы понять, как реализуется делегирование свойств, рассмотрим
еще один пример: уведомление обработчиков событий, когда свойство
объекта изменяет свое значение. Это может пригодиться в самых разных
ситуациях: например, когда объект представляет элемент пользователь­
ского интерфейса и требуется автоматически обновлять изображение на
экране при изменении содержимого объекта. Для решения подобных за­
дач в Java есть стандартный механизм: классы PropertyChangeSupport и
PropertyChangeEvent. Давайте сначала посмотрим, как можно использо­
вать их в Kotlin без делегирования свойств, а затем проведем рефакторинг
кода и применим поддержку делегирования.
Класс PropertyChangeSupport управляет списком обработчиков и пе­
редает им события PropertyChangeEvent. Чтоб задействовать этот меха­
низм, нужно сохранить экземпляр этого класса в поле класса компонента
JavaBean и делегировать ему обработку изменения свойства.
Чтобы не добавлять это поле в каждый класс, можно создать малень­
кий вспомогательный класс, который хранит экземпляр PropertyChange­
Support со списком обработчиков событий изменения свойства. Все ваши
классы могут наследовать этот вспомогательный класс, чтобы получить
доступ к ChangeSupport.
Листинг 7.19. Вспомогательный класс для использования PropertyChangeSupport
open class PropertyChangeAware {
protected val ChangeSupport = PropertyChangeSupport(this)
fun addPropertyChangeListener(listener: PropertyChangeListener) {
ChangeSupport.addPropertyChangeListener(listener)
}
fun removePropertyChangeListener(listener: PropertyChangeListener) {
ChangeSupport.removePropertyChangeListener(listener)
>
>
Теперь напишем класс Person. Определим одно неизменяемое свойство
(имя, которое обычно не меняется) и два изменяемых свойства: возраст и
размер зарплаты. Класс будет уведомлять обработчиков при изменении
возраста или размера зарплаты.
Листинг 7.20. Реализация передачи уведомлений об изменении свойств вручную
class Person(
val name: String, age: In t, salary: Int
7.5. Повторное использование логики обращения к свойству: делегирование свойств ❖
241
) : PropertyCtiangeAware() {
var age: Int = age
set(newValue) {
I Идентификатор«field»даётдоступ
val oldValue = fie ld
<И к полю, соответствующемусвойству
fie ld = newValue
changeSupport.firePropertyChange( < н уведомляетобработчиков
"age", oldValue, newValue)
| обизменениисвойства
}
var salary: Int = salary
set(newValue) {
val oldValue = fie ld
fie ld = newValue
changeSupport.firePropertyChange(
"salary", oldValue, newValue)
}
»> val p = Person("Dmitry", 34, 2000)
»> p.addPropertyChangeListener(
I Подключаетобработчик
PropertyChangeListener { event ->
<H событияизменениясвойства
println("Property ${event.propertyName} changed " +
"from ${event.oldValue} to ${event.newValue}")
...
... )
}
»> p.age = 35
Property age changed from 34 to 35
»> p.salary = 2100
Property salary changed from 2000 to 2100
Обратите внимание, что для доступа к полям, соответствующим свой­
ствам аде и sa la ry , в этом примере используется идентификатор field,
который обсуждался в разделе 4.2.4.
В методах записи присутствует масса повторяющегося кода. Давайте
попробуем извлечь класс, который будет хранить значение свойства и по­
сылать все необходимые уведомления.
Листинг 7.21. Реализация передачи уведомлений об изменении свойств
с применением вспомогательного класса
class ObservableProperty(
val propName: String, var propValue: In t,
val changeSupport: PropertyChangeSupport
) {
fun getValueQ: In t = propValue
242 ❖
Глава 7. Перегрузка операторов и другие соглашения
fun setValue(newValue: In t) {
val oldValue = propValue
propValue = newValue
changeSupport.firePropertyChange(propName, oldValue, newValue)
}
}
class Person(
val name: String, age: In t, salary: Int
) : PropertyChangeAware() {
val _age = ObservableProperty("age", age, cbangeSupport)
var age: Int
get() = _age.getValue()
set(value) { age.setValue(value) }
val _salary = ObservableProperty(11salary", salary, changeSupport)
var salary: Int
get() = _salary.getValue()
set(value) { salary.setValue(value) }
Теперь мы ещё ближе к пониманию механизма делегирования свойств
в Kotlin. Мы создали класс, хранящий значение свойства и автоматически
рассылающий уведомления при его изменении. Это избавило нас от мас­
сы повторяющегося кода, но теперь мы вынуждены создавать экземпляр
O bservableProperty для каждого свойства и делегировать ему операции
чтения и записи. Поддержка делегирования свойств в Kotlin позволяет из­
бавиться и от этого шаблонного кода. Но прежде чем узнать, как это дела­
ется, изменим сигнатуры методов O bservableProperty, чтобы привести
их в соответствие с соглашениями.
Листинг 7.22. ObservableProperty как объект-делегат для свойства
class ObservableProperty(
var propValue: In t, val changeSupport: PropertyChangeSupport
) {
operator fun getValue(p: Person, prop: KProperty<*>): Int = propValue
operator fun setValue(p: Person, prop: KProperty<*>, newValue: In t) {
val oldValue = propValue
propValue = newValue
changeSupport.firePropertyChange(prop.name, oldValue, newValue)
}
}
7.5. Повторное использование логики обращения к свойству: делегирование свойств ❖
243
По сравнению с предыдущей версией в коде появились следующие из­
менения:
О функции getV alue и setV alue теперь отмечены модификатором op­
era to r, как того требуют соглашения;
О в функции было добавлено по два параметра: один - для приёма эк­
земпляра, свойство которого требуется читать или изменять, а вто­
рой - для представления самого свойства. Свойство представлено
объектом типа KProperty. Мы подробно рассмотрим его в разделе
10.2, а пока просто имейте в виду, что обратиться к свойству по его
имени можно в виде KProperty .name;
О мы убрали свойство name, потому что теперь вы можете получить до­
ступ через KProperty.
Теперь можно использовать все волшебство механизма делегирования
свойств в Kotlin. Хотите увидеть, насколько короче стал код?
Листинг 7.23. Использование делегирования свойств для передачи извещений
об изменении
class Person(
val name: String, age: In t, salary: Int
) : PropertyChangeAware() {
var age: Int by ObservableProperty(age, changeSupport)
var salary: Int by ObservableProperty(salary, changeSupport)
}
Ключевое слово by заставляет компилятор Kotlin делать всё то, что мы де­
лали в предыдущем разделе вручную. Сравните этот код с предыдущей вер­
сией класса Person: код, сгенерированный компилятором, очень похож на
неё. Объект справа от by называется делегатом. КоШп автоматически сохра­
няет делегата в скрытом свойстве и вызывает методы getV alue и setV alue
делегата при попытке прочитать или изменить основное свойство.
Вместо реализации логики наблюдения за свойством вручную можно
воспользоваться стандартной библиотекой Kotlin. Оказывается, стандарт­
ная библиотека уже содержит класс, похожий на O bservableProperty.
Но класс в стандартной библиотеке никак не связан с классом
PropertyChangeSupport, использовавшимся выше, поэтому требуется пе­
редать лямбда-выражение, определяющее, как должны передаваться уве­
домления об изменении значения свойства. Вот как это сделать.
Листинг7.24. Использование Delegates.observable для отправки уведомлений
об изменении свойства
class Person(
val name: String, age: In t, salary: Int
❖
244
Глава 7. Перегрузка операторов и другие соглашения
) : PropertyCtiangeAware() {
private val observer = {
prop: KProperty<*>, oldValue: In t, newValue: Int ->
changeSupport.firePropertyChange(prop.name, oldValue, newValue)
}
var age: Int by Delegates.observable(age, observer)
var salary: Int by Delegates.observable(salary, observer)
}
Выражение справа от by не обязательно должно создавать новый эк­
земпляр. Это может быть вызов функции, другое свойство или любое вы­
ражение, при условии, что значением этого выражения является объект
с методами getV alue и setV alu e, принимающими параметры требуемых
типов. Как и другие соглашения, getV alue и setV alue могут быть метода­
ми, объявленными в самом объекте, или функциями-расширениями.
Обратите внимание: чтобы сделать примеры максимально простыми,
мы показали только делегирование свойств типа In t. Механизм делеги­
рования свойств полностью универсален и с успехом применяется к свой­
ствам любых типов.
7.5.4. Правила трансляции делегированных свойств
Ещё раз перечислим правила делегирования свойств. Допустим, у вас
имеется класс, делегирующий свойство:
class С {
var prop: Type by MyDelegateQ
}
val c = C()
Экземпляр MyDelegate будет хранить скрытое свойство (назовем его
< d eleg a te> ). Кроме того, для представления свойства компилятор будет
использовать объект типа KProperty (назовем его <property>).
В результате компилятор сгенерирует следующий код:
class С {
private val <delegate> = MyDelegate()
var prop: Type
get() = <delegate>.getValue(tbis, <property>)
set(value: Type) = <delegate>.setValue(tbis, <property>, value)
}
To есть внутри каждого метода доступа свойства компилятор вызовет
соответствующие методы getV alue и setV alue, как показано на рис. 7.11.
7.5. Повторное использование логики обращения к свойству: делегирование свойств ❖
val x = c.prop
c.prop = X
245
val x = <del egate>. getValue (c, <property>)
<
d e l eg a t e>.setValue (c , <proper ty >, x )
Рис. 7.11. При обращении к свойству вызываются функции
getValue и setValue объекта <delegate>
Механика делегирования свойств чрезвычайно проста и одновременно
способна поддерживать множество интересных сценариев. Можно опре­
делить, где должно храниться значение (в словаре, в базе данных или в
сеансовом cookie), а также что должно произойти в процессе обращения к
свойству (можно добавить проверку допустимости, послать уведомление
об изменении и так далее). Всё это можно реализовать с минимумом кода.
Давайте исследуем ещё один приём делегирования свойств в стандартной
библиотеке, а затем посмотрим, как использовать его в своих фреймворках.
7.5.5. Сохранение значений свойств в словаре
Кроме всего прочего, делегирование свойств широко применяется в
объектах с динамически определяемым набором атрибутов. Такие объек­
ты иногда называют расширяемыми объектами (expando objects). Напри­
мер, представьте систему управления контактами, которая позволяет со­
хранять произвольную информацию о ваших контактах. Каждый контакт
в такой системе имеет несколько обязательных свойств (как минимум
имя), которые обрабатываются специальным образом, а также произволь­
ное количество дополнительных атрибутов, разных для разных контактов
(например, день рождения младшего ребенка).
Для хранения таких атрибутов можно использовать словарь и реализо­
вать свойства для доступа к информации, требующей специальной обра­
ботки. Например:
Листинг 7.25. Определение свойства, хранящего свое значение в словаре
class Person {
private val _attributes = hashMapOf<String, String>()
fun setAttribute(attrName: String, value: String) {
attributes[attrName] = value
}
val name: String
get() = _attributes["name"]!!
}
< H Извлечение атрибута
I из словаря вручную
»> val р = Person()
»> val data = mapOf("name" to "Dmitry", "company" to "JetBrains")
246 ❖
Глава 7. Перегрузка операторов и другие соглашения
»> for ((attrName, value) in data)
... p.setAttribute(attrName, value)
»> println(p.name)
Dmitry
Здесь мы использовали обобщенный API для загрузки данных в объект
(в реальном проекте данные могут извлекаться из строки в формате JSON
или откуда-то ещё), а затем конкретный API для доступа к значению од­
ного из свойств. Задействовать механизм делегирования свойств в этом
коде очень просто: достаточно указать имя словаря вслед за ключевым
словом by.
Листинг 7.26. Делегированное свойство, хранящее свое значение в словаре
class Person {
private val _attributes = bashMapOf<String, String>()
fun setAttribute(attrName: String, value: String) {
_attributes[attrName] = value
}
val name: String by .attributes
}
<H Использоватьсловарь
I в ролиобьекта-делегата
Это возможно благодаря тому, что в стандартной библиотеке опреде­
лены функции-расширения getV alue и setV alue для стандартных ин­
терфейсов Мар и MutableMap. Имя свойства автоматически используется
как ключ для доступа к значению в словаре. Как показано в листинге 7.25,
ссылка на p.name фактически транслируется в вызов _ a t t r ib u t e s .g e t V alu e(p , prop), который, в свою очередь, возвращает результат выраже­
ния a ttr ib u te s [p r o p .пате].
7.5.6. Делегирование свойств в фреймворках
Возможность изменить способ хранения и изменения свойств объекта
чрезвычайно удобна для разработчиков фреймворков. В разделе 1.3.1 мы
показали пример использования делегированных свойств в фреймворке
для работы с базой данных. В этом разделе вы увидите похожий пример и
узнаете, как он работает.
Представим, что в нашей базе данных есть таблица Users с двумя столб­
цами: name, строкового типа, и аде, целочисленного типа. Мы можем опре­
делить Kotlin-классы Users и User, а затем загружать все записи из базы
данных и изменять их в коде на Kotlin посредством экземпляров класса
User.
7.5. Повторное использование логики обращения к свойству: делегирование свойств ❖
247
Листинг 7.27. Доступ к столбцам базы данных с использованием делегированных
свойств
object Users : IdTableQ {
Объект, соответствующий таблице в базе данных
val name = varcbar("name\ length = 50). indexQ Свойства, соответствующие
val age = integer("age")
столбцам в этой таблице
}
J
Каждый экземпляр User соответствует
конкретной записи в таблице
class User(id: EntitylD) : Entity(id) {
var name: String by Users.name <*“ 1 Значение «лате» - эго имя конкретного
var age: Int by Users.age
I пользователя, хранящееся в базе данных
}
Объект Users описывает таблицу базы данных. Он объявлен как ob j e c t,
потому что описывает таблицу в целом и должен присутствовать в един­
ственном экземпляре. Свойства объекта представляют столбцы таблицы.
Класс E ntity, родитель класса User, содержит отображение столбцов базы
данных на их значения для конкретной записи. Свойства в классе User полу­
чают значения столбцов паше и аде в базе данных для данного пользователя.
Пользоваться фреймворком особенно удобно, потому что извлечение
соответствующего значения из отображения в классе E n tity происходит
автоматически, а операция изменения отмечает объект как изменивший­
ся. Потом, если потребуется, его можно легко сохранить в базе данных. Вы
можете написать в своем коде u s e r . age += 1, и соответствующая запись
в базе данных автоматически изменится.
Теперь вы знаете достаточно, чтобы понять, как реализовать фреймворк
с таким API. Все атрибуты в User (name, age) реализованы как свойства,
делегированные объекту таблицы (Users.name, Users.age):
class User(id: EntitylD) : Entity(id) {
var name: String by Users.name
var age: Int by Users.age
Users.name - делегат
для свойства «пате»
}
Теперь посмотрим на явно заданные типы столбцов:
object Users IdTable() {
val name Column<String> = varchar("name", 50).indexQ
val age: Column<Int> = integer(“age” )
}
Для класса Column фреймворк определяет методы getValue и setValue,
удовлетворяющие соглашениям для делегатов в Kotlin:
operator fun <Т> Column<T>.getValue(o: Entity, desc: KProperty<*>): T {
/ / извлекает значение из базы данных
}
248 ❖
Глава 7. Перегрузка операторов и другие соглашения
operator fun <Т> Column<T>.setValue(o: Entity, desc: KProperty<*>, value: T)
/ / изменяет значение в базе данных
Свойство Column (U sers. name) можно использовать в роли делегата для
делегированного свойства (name). В этом случае выражение u se r . age += 1
в вашем коде компилятор превратит в примерно такую инструкцию: u ser.
ageD elegate.setV alu e(u ser.ageD elegate.getV alu eQ + 1) (мы опустили
параметры с экземплярами свойства и объекта). Методы getValue и setV alue
позаботятся об извлечении и изменении информации в базе данных.
Полную реализацию классов из этого примера можно найти в исходном
коде фреймворка Exposed (h ttp s: //gith u b .com /JetB rain s/E xp osed ). Мы
вновь вернемся к этому фреймворку в главе 11, когда займемся исследова­
нием приемов проектирования предметно-ориентированного языка (DSL).
7.6. Резюме
О Kotlin поддерживает перегрузку некоторых стандартных арифме­
тических операторов путем определения функций с соответствую­
щими именами, но не позволяет определять новые, нестандартные
операторы.
О Операторы сравнения транслируются в вызовы методов eq u als и
compareTo.
О Определив функции с именами g et, s e t и co n ta in s, можно обеспе­
чить поддержку операторов [ ] и in , чтобы сделать свой класс более
похожим на коллекции в Kotlin.
О Создание диапазонов и итерации по коллекциям также осуществля­
ются посредством соглашений.
О Мультидекларации позволяют инициализировать сразу несколько
переменных, распаковывая единственный объект, что можно ис­
пользовать для возврата нескольких значений из функций. Эта воз­
можность автоматически поддерживается для классов данных, но вы
можете также реализовать её в своем классе, определив функции с
именами component/V.
О Делегирование свойств дает возможность повторно использовать
логику хранения значений свойств, инициализации, чтения и изме­
нения. Это очень мощный механизм для разработки фреймворков.
О Функция la zy из стандартной библиотеки позволяет просто реали­
зовать отложенную инициализацию свойств.
О Функция D e le g a te s. ob servable позволяет наблюдать за изменения­
ми свойств.
О Делегированные свойства, использующие словари в роли делегатов,
дают гибкую возможность создавать объекты с переменным набо­
ром атрибутов.
ункции высшего порядка:
лямбда-выражения как
параметры и возвращаемые
значения
II
В этой главе:
■ типы функций;
■ функции высшего порядка и их применение для структуриро­
вания кода;
■ встраиваемые (inline) функции;
■ нелокальные возвраты и метки;
■ анонимные функции.
В главе 5 мы познакомились с лямбда-выражениями, где исследовали это
понятие в целом, и познакомились с функциями в стандартной библиоте­
ке, использующими лямбда-выражения. Лямбда-выражения - замечатель­
ный инструмент создания абстракций, и их возможности не ограничива­
ются только коллекциями и другими классами из стандартной библиотеки.
В этой главе вы узнаете, как создавать свои функции высшего порядка (high­
er-order functions), принимающие лямбда-выражения в аргументах и
возвращающие их. Вы увидите, как такие функции помогают упростить
код, избавиться от повторяющихся фрагментов кода и создавать ясные
абстракции. Вы также познакомитесь со встраиваемыми (inline) функция­
ми - мощной особенностью языка Kotlin, устраняющей накладные расхо­
ды, связанные с использованием лямбда-выражений, и обеспечивающей
гибкое управление потоком выполнения в лямбда-выражениях.
250 ❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры
8.1. Объявление функций высшего порядка
Ключевая идея этой главы - новое понятие: функции высшего порядка.
Функциями высшего порядка называют функции, которые принимают
другие функции в аргументах и/или возвращают их. В Kotlin функции мо­
гут быть представлены как обычные значения, в виде лямбда-выражений
или ссылок на функции. То есть функция высшего порядка - это любая
функция, которая принимает аргумент с лямбда-выражением или ссыл­
кой на функцию и/шш возвращает их. Например, функция filte r из стан­
дартной библиотеки принимает аргумент с функцией-предикатом и, со­
ответственно, является функцией высшего порядка:
lis t . f ilt e r { х > 0 }
В главе 5 мы познакомились со множеством функций высшего порядка,
объявленных в стандартной библиотеке Kotlin: map, w ith и другими. Те­
перь узнаем, как объявлять такие функции в своем коде. Для этого сначала
рассмотрим типы функций.
8.1.1. Типы функций
Чтобы объявить функцию, принимающую лямбда-выражение в аргу­
менте, нужно узнать, как объявить тип соответствующего параметра. Но
перед этим рассмотрим более простой случай и сохраним лямбда-выра­
жение в локальной переменной. Вы уже видели, как сделать это без объяв­
ления типа, полагаясь на механизм автоматического определения типов
в Kotlin:
val sum = { х: In t, у: Int -> х + у }
val action = { println(42) }
В данном случае компилятор определит, что обе переменные - sum и
a c tio n - имеют тип функции. Давайте посмотрим, как выглядит явное
объявление типов этих переменных:
Функция,
принимающая
два
параметра
J типа Int и возвращающая значение типа Int
val action: () -> Unit = { print ln(42) }
<H фущия, не имеющая аргументов
I и ничего не возвращающая
Чтобы объявить тип функции, поместите типы параметров в круглые
скобки, после которых добавьте оператор стрелки и тип значения, возвра­
щаемого функцией (см. рис. 8.1).
Типы
Возвращаемый
Как вы помните, тип Unit указывает, что функпараметров 1
тип
ция не возвращает осмысленного значения. Тип
f
(Int, String) -> Unit
возвращаемого значения Unit можно опустить,
Рис. 8.1. Синтаксис
объявляя обычную функцию, но в объявлениях
объявления
типа
функции
типов функций всегда требуется явно указывать
в Kotlin
8.1. Объявление функций высшего порядка ❖
251
тип возвращаемого значения, поэтому тип Uni t нельзя опустить в данном
контексте.
Обратите внимание, что в теле лямбда-выражения { х, у - > х + у }
можно опустить типы параметров х и у. Поскольку они указаны в объяв­
лении типа функции, их не нужно повторять в самом лямбда-выражении.
Точно как в любой другой функции, тип возвращаемого значения в объ­
явлении типа функции можно отметить как допускающий значение n u ll:
var canRetumNull: (In t, In t) -> Int? = { null }
Также можно определить переменную, которая может принимать зна­
чение n u ll и относиться к типу функции. Чтобы указать, что именно пе­
ременная, а не функция способна принимать значение n u ll, нужно за­
ключить определение типа функции в круглые скобки и добавить знак
вопроса в конце:
var funOrNull: ((In t, In t) -> Int)? = null
Обратите внимание на тонкое отличие этого примера от предыдущего. Если
опустить круглые скобки, получится тип функции, способной возвращать зна­
чение n u ll, а не тип переменной, способной принимать значение n u ll.
Имена параметров в типах функций
Втипах функций допускается указывать имена параметров:
fun performRequest(
u rl: String,
J
callback: (code: In t, content: String) -> Unit
) {
Определение типа функции
может включать именован­
ные параметры
/* ...* /
}
»> val u rl = "h ttp ://k o tl.in "
»> performRequest(url) { code, content -> / * . . . * /
»> performRequest(url) { code, page -> / * . . . * / }
J
Имена, указанные в
определении, можно
использовать как имена
аргументов лямбдавыражений...
О— ...или изменять их
Имена параметров не влияют на работу механизма контроля типов. Объявляя
лямбда-выражение, вы не обязаны использоватьте же имена параметров, что указаны в
объявлении типа функции. Но имена улучшают читаемость и могут использоваться в IDE
1 автодополнения ко;J
тля
8.1.2. Вызов функций, переданных в аргументах
Теперь, узнав, как определять функции высшего порядка, обсудим осо­
бенности их реализации. В первом простейшем примере используется то
252 ❖
Глава 8.Функции высшего порядка: лямбда-выражения как параметры...
же объявление типа, что и в лямбда-выражении sum, которое было показа­
но выше. Функция выполняет произвольную операцию с двумя числами,
2 и 3, и выводит результат.
Листинг 8.1. Определение простой функции высшего порядка
fun twoAndThree(operation: (In t, In t) -> In t) {
val result = operation^, 3)
<r~\ Вызов параметра
println("The result is $result")
I с типом функции
>»
The
»>
The
twoAndThree { a , b - > a + b }
result is 5
twoAndThree { a , b - > a * b }
result is 6
Вызов функции, переданной в аргументе, ничем не отличается от вы­
зова обычной функции: указываются имя функции и список аргументов
в круглых скобках.
Как более интересный пример определим свою реализацию функции
filte r из стандартной библиотеки. Для простоты ограничимся поддерж­
кой только типа S trin g , но обобщенная версия, способная работать с кол­
лекциями любых элементов, выглядит похоже. Объявление функции по­
казано на рис. 8.2.
Тип-получатель Имя параметра Тип функции для параметра
\ e
\
fun String.filter(predicate: (Char) -> Boolean): String
(
Тип параметра, передаваемого Тип значения, возвращаемого
функции в параметре
функцией в параметре
Рис. 8.2. Объявление функции filter с параметром-предикатом
Функция filte r принимает предикат как параметр. Тип p red ic a te - это
функция, которая получает параметр из одного символа и возвращает ло­
гический результат: tru e, если символ удовлетворяет требованиям преди­
ката и может быть включен в результирующую строку, и f a ls e в против­
ном случае. Вот как такая функция может быть реализована.
Листинг 8.2. Реализация простой версии функции f i l t e r
fun String.filter(predicate: (Char) -> Boolean): String {
val sb = StringBuilder()
for (index in 0 u n til length) {
val element = get(index)
J
i f (predicate(element)) sb.append(element)
Вызов функции, переданной
k3k аргумент для параметра
«predicate»
8.1. Объявление функций высшего порядка ❖
253
}
return sb.toString()
}
J
Передается лямбда-выражение в
аргументе дня параметра «predicate»
abc
Функция filte r реализовывается очень просто: она проверяет каждый
символ на соответствие предикату и в случае успеха добавляет в объект
S trin gB u ild er, содержащий результат.
Совет для пользователей IntelliJ IDEA
IntelliJ IDEA поддерживает пошаговое выполнение кода лямбда-выражения в отладчике.
Если попробовать по шагам пройти предыдущий пример, можно увидеть, как выполняется
тело функции f ilt e r и переданное ей лямбда-выражение по мере того, как функция обра­
батывает каждый элемент во входной строке.
8.1.3. Использование типов функций в коде на Java
За кулисами кода типы функций объявляются как обычные интерфейсы:
переменная, имеющая тип функции, - это реализация интерфейса FunctionA/. В стандартной библиотеке Kotlin определено несколько интерфей­
сов с разным числом аргументов функции: Function0<R> (эта функция не
принимает аргументов), F u n ctio n K P l, R> (принимает один аргумент) и
так далее. Каждый интерфейс определяет единственный метод invoke,
который вызывает функцию. Переменная, имеющая тип функции, - это
экземпляр класса, реализующего соответствующий интерфейс Function N,
метод invoke которого содержит тело лямбда-выражения.
Kotlin-функции, использующие типы функций, легко могут вызываться
из кода на Java. В Java 8 лямбда-выражения автоматически преобразуются
в значения типов функций:
/* Объявление в Kotlin */
fun processTheAnswer(f: (In t) -> In t) {
p rin tln (f(42))
}
/* lava */
»> processTheAnswer(number -> number + 1);
43
В более старых версиях Java можно передать экземпляр анонимного
класса, реализующего метод invoke из соответствующего интерфейса:
/* Java */
»> processTheAnswer(
254 ❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры...
new FunctionKInteger, Integer>() {
©Override
public Integer invoke(Integer number) {
System.out.println(number);
return number + 1;
}
});
<Н Использование КоШп-типа функции
I из Java (ниже версии Java 8)
В Java легко использовать функции-расширения из стандартной библио­
теки Kotlin, принимающие лямбда-выражения в аргументах. Но имейте в
виду, что код получается не таким читабельным, как в Kotlin, - вы должны
будете явно передать объект-получатель в первом аргументе:
/* lava */
»> List<String> strings = new ArrayList();
»> strings. add( “4 2 ” ) ;
| В Java-коде можно использовать функ»> Collect ionsKt.forEadi(strings, s -> {
< н ции из стандартной библиотеки Kotlin
System.out.println(s);
return Unit. INSTANCE;
< H Вы должны явно вернуть
• •• } ) ;
I значение типа Unit
В Java ваша функция или лямбда-выражение может ничего не возвра­
щать. Но в Kotlin такие функции возвращают значение типа U nit, и вы
должны явно вернуть его. Нельзя передать лямбда-выражение, возвра­
щающее void, в аргументе с типом функции, возвращающей U nit (как
(S tr in g ) -> U nit в предыдущем примере).
8.1.4. Значения по умолчанию и пустые значения
для параметров типов функций
Объявляя параметр в типе функции, можно также указать его значение
по умолчанию. Чтобы увидеть, где это может пригодиться, вернемся к
функции join T oS trin g, о которой мы говорили в главе 3. Вот реализация,
на которой мы остановились.
Листинг 8.3. joinToString с жестко зашитым преобразованием toString
fun <Т> Collection<T>.joinToString(
separator: String = ", ",
prefix: String =
postfix: String =
): String {
val result = StringBuilder(prefix)
for ((index, element) in tbis.witblndex()) {
if (index > 0) result.append(separator)
8.1. Объявление функций высшего порядка
result. append(element)
}
❖
255
<Н Преобразуетобъектвстроку
I сиспользованиемреализации
toStringпоумолчанию
result.append(postfix)
return result.toString()
Это гибкая реализация, но она не позволяет контролировать один важ­
ный аспект: преобразование в строки отдельных элементов коллекции.
Код использует вызов S trin gB u ild er.ap p en d (o: Any?), который всегда
преобразует объекты в строки с помощью метода to S tr in g . Это решение
пригодно для большинства, но не для всех ситуаций. Теперь вы знаете,
что можно передать лямбда-выражение, указывающее, как значения пре­
образовываются в строки. Но требование обязательной передачи такого
лямбда-выражения слишком обременительно, потому что в большинстве
случаев годится поведение по умолчанию. Для решения этого затрудне­
ния можно объявить параметр типа функции и определить его значение
по умолчанию как лямбда-выражение.
Листинг 8.4. Объявление параметра с типом функции и значением по умолчанию
fun <Т> Collection<T>.joinToString(
separator: String = ", ",
prefix: String =
postfix: String =
transform: (T) -> String = { it.toS tring() }
): String {
val result = StringBuilder(prefix)
<l“ | Объявлениепараметрастипом
I функцииилямбда-выражениемв
качествезначенияпоумолчанию
for ((index, element) in this.withlndex()) {
i f (index > 0) result.append(separator)
result.append(transform(element))
< н Вымв
, переданной
/
I варгументедляпараметра
«transform»
result.append(postfix)
return result.toString()
»> val letters = listO f ( "Alpha", "Beta")
I Используетсяфункция
»> println( le tte rs. j oinToString())
<H преобразованияпоумолчанию
Alpha, Beta
I Передаетсяаргумент
»> println( letters. joinToString { it.toLowerCaseQ })
< —Iслямбда-выражением
alpha, beta
»> println(letters.joinToString(separator = "! ", postfix = "! ",
transform = { it.tollpperCase() }))
о -. Использованиесинтаксисаименованных
ALPHA! BETA!
аргументовдм передачинескольких
аргументов, включаяммбда-выражение
256 ♦> Глава 8. Функции высшего порядка: лямбда-выражения как параметры
Обратите внимание, что это обобщенная функция: она имеет параметр
типа Т, обозначающий тип элемента в коллекции. Лямбда-выражение
transform получит аргумент этого типа.
Чтобы объявить значение по умолчанию для типа функции, не требует­
ся использовать специального синтаксиса - достаточно просто добавить
лямбда-выражение после знака =. Примеры демонстрируют разные спосо­
бы вызова функции: без лямбда-выражения (чтобы использовать преоб­
разование по умолчанию с помощью to S tr in g ()), с передачей за предела­
ми круглых скобок и с передачей в именованном аргументе.
Альтернативный подход состоит в том, чтобы объявить параметр типа
функции способным принимать значение n u ll. Имейте в виду, что функ­
цию, переданную в таком параметре, нельзя вызвать непосредственно:
Kotlin откажется компилировать такой код, потому что обнаружит воз­
можность появления исключения, вызванного обращением к пустому
указателю. Одно из возможных решений - явно проверить на равенство
значению n u ll:
fun foo(callback: (() -> Unit)?) {
И ...
i f (callback != null) {
callbackQ
}
}
Другое, более короткое решение основано на том, что тип функции это реализация интерфейса с методом invoke. Обычный метод, каковым
является invoke, можно вызвать, использовав синтаксис безопасного вы­
зова: c a llb a c k ? . in v o k e().
Вот как можно использовать этот прием в измененной версии joinT oS trin g.
Листинг 8.5. Использование параметра с типом функции, способного принимать
значение n u ll
fun <Т> Collection<T>.j oinToString(
separator: String = ", ",
prefix: String =
postfix: String = 11",
transform: ((T) -> String)? = null
): String {
val result = StringBuilder(prefix)
for ((index, element) in tbis.witblndex()) {
i f (index > 0) result. append( separator)
val str = transform?, invoke(element)
I Объявление параметра с типом
I функции, способного принимать
значение null
| Использование специального синтаксиса
o_l для безопасного вызова функции
8.1. Объявление функций высшего порядка ❖
?: element. toString()
result, append(str)
\
257
<Н Использование оператора «Элвис»
I для обработки случая,когда
функция для вызова не указана
result.append(postfix)
return result.toString()
}
Узнав, как писать функции, принимающие другие функции в аргумен­
тах, перейдем к следующей разновидности функций высшего порядка: к
функциям, возвращающим другие функции.
8.1.5. Возврат функций из функций
Вернуть функцию из другой функции бывает нужно реже, чем передать
функцию в аргументе, но такая возможность всё же может пригодиться.
Представьте фрагмент программы, логика работы которого сильно зави­
сит от состояния программы или от некоторых других условий, - например,
расчет стоимости доставки в зависимости от выбранного транспорта. Для
этого вы можете определить функцию, которая выбирает соответствую­
щий вариант логики и возвращает его как ещё одну функцию. Вот как это
выглядит в коде.
Листинг 8.6. Определение функции, возвращающей другую функцию
enum class Delivery { STANDARD, EXPEDITED }
class Order(val itemCount: In t)
fun getShippingCostCalculator(
delivery: Delivery): (Order) -> Double {
i f (delivery == Delivery.EXPEDITED) {
return { order -> 6 + 2.1 * order.itemCount
}
return { order -> 1.2 * order.itemCount }
Сохранение полученной
< I> W в переменной
getShippingCostCalculator(Delivery.EXPEDITED)
»> println("Shipping costs ${calculator(0rder(3))}"
Shipping costs 12.3
Чтобы объявить функцию, возвращающую другую функцию, нужно ука­
зать, что возвращаемое значение имеет тип функции. Функция getS h ip p in gC ostC alcu lator в листинге 8.6 возвращает функцию, которая прини­
мает значение типа Order и возвращает Double. Чтобы вернуть функцию,
258 ❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры
нужно записать выражение return и добавить лямбда-выражение, ссылку
на член или другое выражение с типом функции - например, локальную
переменную.
Рассмотрим ещё один пример, где пригодится приём возврата функций
из других функций. Допустим, вы работаете над графическим интерфей­
сом приложения, управляющего контактами, и нужно определить, какие
контакты отобразить на экране, ориентируясь на состояние пользователь­
ского интерфейса. Представьте, что пользовательский интерфейс позволя­
ет вводить строку и затем отображать контакты с именами, начинающи­
мися с этой строки; он также позволяет скрывать контакты, для которых
отсутствуют номера телефонов. Определим класс C o n ta c tL istF ilte r s
для хранения параметров, управляющих отображением.
class ContactListFilters {
var prefix: String = ""
var onlyWithPhoneNumber: Boolean = false
}
Когда пользователь вводит символ D, чтобы просмотреть контакты, в ко­
торых имена начинаются на букву Д изменяется значение поля prefix. Мы
опустили код, выполняющий необходимые изменения. (Было бы слишком
расточительно приводить в книге полный код реализации пользователь­
ского интерфейса, поэтому мы покажем упрощенный пример.)
Чтобы избежать тесной связи между логикой отображения списка кон­
тактов и фильтрацией, можно определить функцию, создающую предикат.
Этот предикат должен проверить prefix, а также присутствие номера теле­
фона, если требуется.
Листинг 8.7. Использование функции, возвращающей другую функцию
data class Person(
val firstName: String,
val lastName: String,
val phoneNumber: String?
class ContactListFilters {
var prefix: String = ""
var onlyWithPhoneNumber: Boolean = false
fun getPredicateQ: (Person) -> Boolean {
val startsWithPrefix = { p: Person ->
p.firstName.startsWith(prefix) || p.lastName.startsWith(prefix)
>
8.1. Объявление функций высшего порядка ❖
259
}
return { startsW ithPrefix(it)
&& i t .phoneNumber != null }
}
<H Возврат лямбда-выражения
I из этой функции
}
»> val contacts = listOf(Person("Dmitry", "Jemerov", "123-4567"),
Person("Svetlana", "Isakova", n u ll))
»> val contactListFilters = ContactListFilters()
»> with (contactListFilters) {
»>
prefix = "Dm"
»>
onlyWith PhoneNumber = true
»> >
»> print ln(contacts.filter(
I Передача функции, полученной от
...
contactListFilters. getPredicate() ) )
< b l QetPredicate, в виде аргумента методу «filter»
[Person(firstName=Dmitry, lastName=Demerov, phoneNumber=123-4567)]
Метод g et P red icate возвращает функцию, которая затем передается
как аргумент функции filte r . Типы функций в Kotlin позволяют выпол­
нять такие манипуляции так же легко и просто, как со значениями других
типов, например строками.
Функции высшего порядка - чрезвычайно мощный инструмент для
структурирования кода и устранения повторяющихся фрагментов. Давай­
те посмотрим, как лямбда-выражения помогают убрать повторяющуюся
логику.
8.1.6. Устранение повторяющихся фрагментов с помощью
лямбда-выражений
Типы функций и лямбда-выражения вместе - это великолепный инстру­
мент для создания кода многократного использования. Многие виды по­
вторений кода, которые обычно можно предотвратить только за счет ис­
пользования мудреных конструкции, теперь легко устранить с помощью
лаконичных лямбда-выражений.
Рассмотрим пример анализа посещений веб-сайта. Класс S it e V is it
хранит путь каждого посещения, его продолжительность и тип операци­
онной системы пользователя. Типы операционных систем представлены
в виде перечисления.
Листинг 8.8. Определение данных, описывающих посещение сайта
data class SiteVisit(
val path: String,
val duration: Double,
val os: OS
260 ❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры
)
enum class OS { WINDOWS, LINUX, MAC, IOS, ANDROID }
val log = listO f(
S ite V isit("/", 34.0, OS.WINDOWS),
S ite V isit("/M, 22.0, OS.MAC),
S iteV isit("/login", 12.0, OS.WINDOWS),
SiteVisit("/signup", 8.0, OS.IOS),
S ite V isit("/n, 16.3, OS.ANDROID)
)
Допустим, нам нужно показать среднюю продолжительность визитов
с компьютеров, действующих под управлением ОС Windows. Эту задачу
можно решить с помощью функции average.
Листинг 8.9. Анализ данных, описывающих посещение сайта, с применением жестко
заданных фильтров
val averageWindowsDuration = log
.filte r { it.o s == OS.WINDOWS }
.map(SiteVisit:duration)
.average()
»> println(averageWindowsDuration)
23.0
Теперь представим, что нам нужно вычислить ту же статистику для поль­
зователей Мае. Чтобы избежать повторения кода, тип платформы можно
выделить в параметр.
Листинг 8.10. Устранение повторений с помощью обычной функции
fun List<SiteVisit>.averageDurationFor(os: OS) =
<Н Повторяющийсякод
filte r { it.o s == os }.map(SiteVisit:: duration). average()
I выделенвфункцию
»> println(log. averageDurationFor(OS.WINDOWS))
23.0
»> println(log.averageDurationFor(OS.MAC))
22.0
Обратите внимание, как оформление этой функции в виде расширения
улучшает читаемость кода. Её можно даже объявить как локальную функ­
цию-расширение, если она применима только в локальном контексте.
Но это не самое удачное решение. Представьте, что мы определяем сред­
нюю продолжительность посещения пользователей мобильных платформ
(в настоящее время есть две такие платформы: iOS и Android).
8.1. Объявление функций высшего порядка ❖
261
Листинг 8.11. Анализ данных, описывающих посещение сайта, с применением
сложного, жестко заданного фильтра
val averageMobileDuration = log
.filte r { it.o s in set0f(0S.I0S, OS.ANDROID) }
.map(SiteVisit:duration)
.average()
»> print In (averageMobi leDurat ion)
12.15
Теперь простого параметра, представляющего тип платформы, оказа­
лось недостаточно. Кроме того, в какой-то момент понадобится проана­
лизировать журнал с использованием ещё более сложных условий - на­
пример, «средняя продолжительность посещения страницы регистрации
пользователями iOS». Эта проблема решается с помощью лямбда-выра­
жений. Мы можем использовать типы функций для выделения требуемых
условий в параметр.
Листинг 8.12. Устранение повторений с помощью функции высшего порядка
fun List<SiteVisit>.averageDurationFor(predicate: (S iteV isit) -> Boolean) =
f iIter(predicate) .map(SiteVisit::duration) .average()
»> println(log.averageDurationFor {
it.o s in setOf(OS.ANDROID, OS.IOS) })
12.15
»> println(log.averageDurationFor {
it.o s == OS.IOS && it.path == "/signup" })
8.0
Типы функций помогают избавиться от повторяющихся фрагментов
кода. Если вы испытываете желание скопировать и вставить какой-то
фрагмент кода, знайте, что этого повторения почти наверняка можно из­
бежать. Лямбда-выражения позволяют извлекать не только повторяющие­
ся данные, но также поведение.
Примечание. Применение типов функций и лямбда-выражений помогает упростить некото­
рые хорошо известные шаблоны проектирования. Возьмем шаблон «Стратегия» (Strategy).
Без лямбда-выражений он требует объявить интерфейс с несколькими реализациями, по од­
ной для каждой стратегии. При наличии вязыке поддержки типов функций их можно исполь­
зовать для описания стратегии и передавать разные лямбда-выражения в виде стратегий.
Мы обсудили порядок создания функций высшего порядка, а теперь по­
смотрим, как они влияют на производительность. Станет ли наш код мед-
262 ❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры
леннее, если мы повсюду начнем использовать функции высшего порядка
вместо старых добрых циклов и условных операторов? В следующем раз­
деле мы объясним, почему ответ на этот вопрос не всегда утвердительный
и как в некоторых ситуациях может помочь ключевое слово in lin e .
8.2. Встраиваемые функции: устранение
накладных расходов лямбда-выражений
Вы могли заметить, что в Kotlin краткий синтаксис передачи лямбда-вы­
ражений в аргументах напоминает синтаксис обычных инструкций i f и
fo r, и видели примеры в главе 5, когда мы обсуждали функции w ith и ap­
p ly. Но что можно сказать о производительности? Разве мы не создаем
неприятных неожиданностей, определяя функции, которые похожи на
обычные инструкции Java, но выполняются намного медленнее?
В главе 5 мы объяснили, что лямбда-выражения обычно компилируются
в анонимные классы. Но это означает, что каждый раз, когда используется
лямбда-выражение, создается дополнительный класс; и если лямбда-вы­
ражение хранит какие-то переменные, для каждого вызова создается но­
вый объект. Это влечет дополнительные накладные расходы, ухудшающие
эффективность реализации с лямбда-выражениями по сравнению с функ­
цией, которая выполняет тот же код непосредственно.
Может ли компилятор сгенерировать код, не уступающий по эффек­
тивности инструкциям Java и все еще позволяющий извлекать повторяю­
щийся код в библиотечные функции? Действительно, компилятор Kotlin
поддерживает такую возможность. Если отметить функцию модификато­
ром in lin e , компилятор не будет генерировать вызов функции в месте её
использования, а просто вставит код её реализации. Давайте разберемся,
как это работает, и рассмотрим конкретные примеры.
8.2.1. Как работает встраивание функций
Когда функция объявляется с модификатором in lin e , её тело становит­
ся встраиваемым - иными словами, оно подставляется вместо обычного
вызова функции. Давайте посмотрим, какой код получается в результате.
Функция в листинге 8.13 гарантирует доступность общего ресурса толь­
ко в одном потоке выполнения. Функция захватывает (блокирует) объект
Lock, выполняет заданный блок кода и затем освобождает блокировку.
Листинг 8.13. Определение встраиваемой функции
inline fun <Т> synctironized(lock: Lock, action: () -> T): T {
lock.lock()
try {
return action()
8.2. Встраиваемые функции: устранение накладных расходов лямбда-выражений ❖
263
}
fin a lly {
lock.unlockQ
}
}
val I = Lock()
synchronized^ I) {
II ...
}
Синтаксис вызова этой функции выглядит в точности как инструкция
synchronized в Java. Разница в том, что в Java инструкция synchronized
может использоваться с любым объектом, тогда как эта функция требует
передачи экземпляра блокировки Lock. Определение выше - лишь при­
мер; стандартная библиотека Kotlin определяет ещё одну версию функции
synchronized, принимающую произвольный объект.
Но явное использование блокировок для синхронизации позволяет пи­
сать более надежный и понятный код. В разделе 8.2.5 мы познакомимся с
функцией w ith Lock из стандартной библиотеки Kotlin, которую желатель­
но использовать всегда, когда требуется выполнить некоторую операцию
под защитой блокировки.
Так как мы объявили функцию synchronized встроенной (in lin e ),
её тело будет вставлено в каждом месте вызова, подобно инструкции
synchronized в Java. Рассмотрим следующий пример использования
syn ch ron ized ():
fun foo(l: Lock) {
println("Before sync")
synchronized^ I) {
println("Action")
}
println("A fter sync")
}
На рис. 8.3 приводится эквивалентный код, который будет скомпилиро­
ван в тот же байт-код.
fun _foo__(1: Lock) {
println ("Before sync") *— ’
i . lock (
_
— ,
'
ФУНКЦИИ fOO
Код, встраиваемый в место вызова
функции
synchronized
try {
I
printin ("Action")
Встраиваемый код стелом
} finally {
лямбда-выражения
»i ^MMiiMwiviVBri
mm
ivi « h i v
ш
1.unlock()
}
println ("After sync")
4-
}
Рис. 8.3. Скомпилированная версия функции foo
264 ❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры...
Обратите внимание, что встраивание применяется не только к реализа­
ции функции synchronized, но и к телу лямбда-выражения. Байт-код, сге­
нерированный для лямбда-выражения, становится частью определения
вызывающей функции и не заключается в анонимный класс, реализую­
щий интерфейс функции.
Заметьте также, что для встраиваемых функций сохранилась возмож­
ность передавать параметры с типом функции из переменных:
class LockOwner(val lock: Lock) {
fun runUnderLock(body: () -> Unit) {
synchronized!; lock, body)
}
< н Переменная с типом функции передается
| как аргумент, но не как лямбда-выражение
}
В данном случае код лямбда-выражения недоступен в точке вызова
функции, поэтому его нельзя встроить. Встроится только тело функции
synchronized, а лямбда-выражение будет вызвано как обычно. Функция
runllnderLock будет скомпилирована в байт-код, который выглядит как
функция ниже:
class LockOwner(val lock: Lock) {
fun __runUnderLock__(body: () -> Unit) {
O -i Эта фикция компилируется в такой
| же бант-код, что и настоящая функция
lock.lockQ
runUndeiLock
try {
body()
O - i Функция body не встраивается,
I потому что лямбда-выражение
}
отсутствует в точке вызова
fin a lly {
lock.unlockQ
}
}
}
Если использовать встраиваемую функцию в двух разных местах с раз­
ными лямбда-выражениями, каждый вызов встроится независимо. Код
встраиваемой функции скопируется в оба места, но с разными лямбда-вы­
ражениями.
8.2.2. Ограничения встраиваемых функций
Из-за особенностей встраивания не всякая функция, использующая
лямбда-выражения, может быть встраиваемой. Когда функция объявлена
встраиваемой, тело лямбда-выражения, переданное в аргументе, встраи­
вается непосредственно в конечный код. Это обстоятельство ограничивает
возможные варианты использования соответствующего параметра в теле
функции. Если функция, переданная в качестве параметра, вызывается, её
код легко можно встроить в точку вызова. Но если параметр сохраняется
где-то для последующего использования, код лямбда-выражения невоз-
8.2. Встраиваемые функции: устранение накладных расходов лямбда-выражений ❖ 265
можно встроить, потому что должен существовать объект, содержащий
этот код.
В общем случае параметр можно встроить, если его вызывают непосред­
ственно или передают как аргумент другой встраиваемой функции. Иначе
компилятор запретит встраивание параметра с сообщением об ошибке:
«Illegal usage of inline-parameter» (недопустимое использование встраи­
ваемого параметра).
Например, некоторые функции, работающие с последовательностями,
возвращают экземпляры классов, которые представляют операции с после­
довательностями и принимают лямбда-выражение в параметре конструк­
тора. Например, ниже приводится определение функции Sequence. map:
fun <Т, R> Sequence<T>.map(transform: (T) -> R): Sequence<R> {
return TransformingSequence(this, transform)
}
Функция map не вызывает функцию в параметре transf orm. Она передает
её конструктору класса, который сохранит эту функцию в своем свойстве.
Чтобы обеспечить такую возможность, лямбда-выражение в аргументе
transform должно быть скомпилировано в стандартное, невстраиваемое
представление - анонимный класс, реализующий интерфейс функции.
Если имеется функция, принимающая несколько лямбда-выражений
в аргументах, можно выбрать для встраивания только некоторые из них.
Это имеет смысл, когда одно из лямбда-выражений содержит много кода
или используется так, что не допускает встраивания. Соответствующие
параметры можно объявить невстраиваемыми, добавив модификатор
noinline:
inline fun foo(inlined: () -> Unit, noinline notlnlined: () -> Unit) {
II ...
}
Обратите внимание, что компилятор полностью поддерживает встраи­
вание функций, объявленных в других модулях или реализованных в сто­
ронних библиотеках. Кроме того, большинство встраиваемых функций
может вызываться из кода на Java, но такие вызовы будут не встраиваться,
а компилироваться как вызовы обычных функций.
Далее, в разделе 9.2.4, вы увидите, как ещё уместно использовать моди­
фикатор n o in lin e (что, впрочем, обусловлено ограничениями совмести­
мости с Java).
8.2.3. Встраивание операций с коллекциями
Теперь обсудим производительность функций из стандартной библио­
теки Kotlin, работающих с коллекциями. Большинство таких функций
принимает лямбда-выражения в аргументах. Будут ли аналогичные one-
266 ❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры...
рации, реализованные непосредственно, работать эффективнее функций
из стандартной библиотеки?
Например, сравним две реализации списков людей в листингах 8.14 и
8.15.
Листинг 8.14. Фильтрация списка с применением лямбда-выражения
data class Person(val name: String, val age: In t)
val people = listOf(Person("Alice", 29), Person("Bob", 31))
»> println(people.filter { it.age < 30 })
[Person(name=Alice, age=29)]
Код в листинге 8.14 можно переписать без использования лямбда-выра­
жения, как видно в листинге 8.15.
Листинг 8.15. Фильтрация списка вручную
»> val result = mutableListOf<Person>()
»> for (person in people) {
»>
i f (person.age < 30) result.add(person)
»> }
»> println(result)
[Person(name=Alice, age=29)]
Функция filte r в Kotlin объявлена как встраиваемая. Это означает, что
код функции filte r вместе с кодом заданного лямбда-выражения будет
встраиваться в точку вызова filte r . В результате для первой версии, ис­
пользующей функцию first, будет сгенерирован примерно такой же байткод, как для второй. Вы можете уверенно использовать идиоматичные
операции с коллекциями, а поддержка встраиваемых функций в Kotlin из­
бавит от беспокойств о производительности.
Попробуем теперь применить две операции, fi I t ег и map, друг за другом.
»> println(people.filter { it.age > 30 }
.map(Person::name))
[Bob]
В этом примере используются лямбда-выражение и ссылка на член.
Снова обе функции - filte r и шар - объявлены встраиваемыми, поэтому их
тела будут встроены в конечный код без создания дополнительных клас­
сов. Но этот код создает промежуточную коллекцию, где хранится резуль­
тат фильтрации списка. Код, сгенерированный из функции filte r , добав­
ляет элементы в эту коллекцию, а код, сгенерированный из функции тар,
читает их.
8.2. Встраиваемые функции: устранение накладных расходов лямбда-выражений ♦
267
Если число обрабатываемых элементов велико и накладные расходы на
создание промежуточной коллекции становятся слишком ощутимыми,
можно воспользоваться последовательностью, добавив в цепочку вызов
asSequence. Но в этом случае лямбда-выражения не будут встраиваться
(как было показано в предыдущем разделе). Каждая промежуточная по­
следовательность представлена объектом, хранящим лямбда-выражение
в своем поле, и заключительная операция заставляет выполниться всю
цепочку вызовов в последовательности. Поэтому, хотя операции в после­
довательности откладываются, вы не должны стремиться вставлять a s ­
Sequence в каждую цепочку операций с коллекциями в своём коде. Этот
приём дает преимущество только при работе с большими коллекциями, а
маленькие коллекции можно обрабатывать как обычно.
8.2.4. Когда следует объявлять функции встраиваемыми
После знакомства с преимуществами ключевого слова in lin e у вас мо­
жет появиться желание чаще использовать его для ускорения работы ва­
шего кода. Но оказывается, что это не лучшее решение. Ключевое слово
in lin e способно повысить производительность только функций, прини­
мающих лямбда-выражения, а в остальных случаях требуется потратить
время и оценить выигрыш.
Для вызовов обычных функций виртуальная машина JVM уже использу­
ет оптимизированный механизм встраивания. Она анализирует выполне­
ние кода и выполняет встраивание, если это дает преимущество. Это про­
исходит автоматически, когда байт-код транслируется в машинный код.
В байт-коде реализация каждой функции присутствует в единственном
экземпляре, и её не требуется копировать во все точки вызова, как в слу­
чае со встраиваемыми функциями в языке Kotlin. Более того, трассировка
стека выглядит яснее, если функция вызывается непосредственно.
С другой стороны, встраивание функций с лямбда-выражениями в аргу­
ментах дает определенные выгоды. Во-первых, сокращаются накладные
расходы. Время экономится не только на вызовах, но на создании допол­
нительных классов для лямбда-выражений и их экземпляров. Во-вторых,
в настоящее время JVM не в состоянии выполнить встраивание всех вы­
зовов с лямбда-выражениями. Наконец, встраивание позволяет использо­
вать особенности, которые не поддерживаются для обычных лямбда-вы­
ражений, такие как нелокальные возвраты, которые мы обсудим далее в
этой главе.
Кроме того, принимая решение об использовании модификатора
in lin e , не нужно забывать о размере кода. Если функция, которую вы
собираетесь объявить встраиваемой, достаточно велика, копирование
её байт-кода во все точки вызова может существенно увеличить общий
размер байт-кода. В этом случае попробуйте выделить код, не связан-
268 ❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры
ный с лямбда-выражением в аргументе, в отдельную, невстраиваемую
функцию. Загляните в стандартную библиотеку Kotlin и убедитесь, что
все встраиваемые функции в ней имеют очень маленький размер.
Далее мы посмотрим, как функции высшего порядка помогают усовер­
шенствовать код.
8.2.5. Использование встраиваемых лямбда-выражений
для управления ресурсами
Управление ресурсами - захват ресурса перед операцией и его осво­
бождение после - одна из областей, где применение лямбда-выражений
помогает избавиться от повторяющегося кода. Ресурсом в данном случае
может считаться что угодно: файл, блокировка, транзакция в базе данных
и так далее. Стандартная реализация такого шаблона заключается в ис­
пользовании инструкции try /fin a lly , в которой ресурс захватывается пе­
ред блоком tr y и освобождается в блоке fin ally.
Выше в этом разделе был пример того, как можно заключить логику ин­
струкции tr y /fin a lly в функцию и передать в эту функцию код исполь­
зования ресурса в виде лямбда-выражения. В этом примере демонстри­
ровалась реализация функции synchronized с тем же синтаксисом, что
и инструкция synchronized в Java: она принимает аргумент с объектом
блокировки. В стандартной библиотеке Kotlin есть ещё одна функция withLock, предлагающая более идиоматичный синтаксис для решения
той же задачи: она - функция-расширение для интерфейса Lock. Ниже пример её использования:
val I : Lock = ...
I Выполняет заданную операцию
I .withLock {
< Н под защитой блокировки
// операции с ресурсом под защитой данной блокировки
}
Вот как функция withLock определена в стандартной библиотеке Kotlin:
fun <Т> Lock. withLock( action: () -> T): T {
lock()
try {
return action()
} finally {
unlock()
}
}
< Н Идиома работы с блокировкой
| выделена в отдельную функцию
Файлы - это ещё одна распространенная разновидность ресурсов, для
работы с которыми полезен этот шаблон. В Java 7 даже был добавлен
специальный синтаксис для этого шаблона: инструкция try-with-resources.
8.3. Порядок выполнения функций высшего порядка ♦> 269
В следующем листинге демонстрируется Java-метод, использующий эту
инструкцию для чтения первой строки из файла.
Листинг 8.16. Использование try-with-resources в Java
/* Java */
static String readFirstLineFromFile(String path) throws IOException {
try (BufferedReader br =
new BufferedReader(new FileReader(path))) {
return br.readLineQ;
}
}
В Kotlin отсутствует эквивалентный синтаксис, потому что ту же задачу
можно почти бесшовно решить с помощью функции, имеющей параметр
с типом функции (то есть принимающей лямбда-выражение в аргументе).
Эта функция входит в состав стандартной библиотеки Kotlin и называется
use. Ниже показано, как её использовать, чтобы переписать пример в лис­
тинге 8.16 на языке Kotlin.
Листинг 8.17. Использование функции use для управления ресурсом
fun :
}
Функция use реализована как функция-расширение, которая применя­
ется к закрываемым ресурсам; она принимает аргумент с лямбда-выра­
жением. Функция вызывает лямбда-выражение и гарантирует закрытие
ресурса вне зависимости от того, как выполнится лямбда-выражение успешно или с исключением. Конечно, функция use объявлена как встраи­
ваемая, поэтому она не ухудшает производительность.
Обратите внимание, что в теле лямбда-выражения используется нелокаль­
ный возврат, чтобы вернуть значение из функции readFirstLineFrom File.
Давайте подробнее обсудим применение выражений return в лямбда-вы­
ражениях.
8.3. Порядок выполнения функций высшего
порядка
Используя лямбда-выражения взамен императивных конструкций (таких
как циклы), легко можно столкнуться с проблемой выражений return. Ин­
струкция return в середине цикла не вызывает недоразумений. Но что
270
❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры
случится, если такой цикл преобразовать в вызов функции, например
filte r ? Как будет работать return в этом случае? Давайте выясним это на
примерах.
8.3.1. Инструкции «return» в лямбда-выражениях:
выход из вмещающей функции
Сравним два разных способа итераций по элементам коллекции. Взгля­
нув на код в листинге 8.18, можно сразу же сказать, что при встрече с име­
нем A lic e функция lookF orA lice сразу же вернет управление вызываю­
щему коду.
Листинг 8.18. Использование re tu rn в обычном цикле
data class Person(val name: String, val age: In t)
val people = listOf(Person("Alice", 29), Person("Bob", 31))
fun lookForAlice(people: List<Person>) {
for (person in people) {
i f (person.name == "Alice") {
printIn( "Found!")
return
}
}
println("Alice is not found")
}
»> lookForAlice(people)
Found!
Можно ли безбоязненно использовать этот код в вызове функции
forEach? Как будет работать инструкция return в этом случае? Да, вы
можете уверенно использовать этот код в вызове forEach, как показано
ниже.
Листинг 8.19. Использование return в лямбда-выражении, передаваемом
в вызов forEach
fun lookForAlice(people: List<Person>) {
people.forEach {
i f (it.name == "Alice") {
printIn("Found!")
return
8.3. Порядок выполнения функций высшего порядка ❖
271
}
println("Alice is not found")
}
Ключевое слово return в лямбда-выражении производит выход из функ­
ции, в которой вызывается это лямбда-выражение, а не из него самого. То
есть инструкция return производит нелокальный возврат, потому что воз­
вращает результат из внешнего блока, а не из блока, содержащего return.
Чтобы понять логику этого правила, представьте, что ключевое слово
return используется в цикле fo r или в блоке synchronized внутри Ja­
va-метода. Очевидно, что оно должно произвести выход из функции, а не
из цикла или блока. Язык Kotlin переносит эту логику на функции, прини­
мающие лямбда-выражения в аргументах.
Обратите внимание, что выход из внешней функции выполняется толь­
ко тогда, когда функция, принимающая лямбда-выражение, является встраи­
ваемой. Тело функции forEach в листинге 8.19 встраивается вместе с телом
лямбда-выражения, поэтому выражение return производит выход из вме­
щающей функции. Использование выражения return в лямбда-выражениях,
передаваемых невстраиваемым функциям, недопустимо. Невстраиваемая
функция может сохранить переданное ей лямбда-выражение в перемен­
ной, чтобы выполнить его позже, когда она уже завершится, то есть когда
лямбда-выражение и его инструкция return окажутся в другом контексте.
8.3.2. Возврат из лямбда-выражений:
возврат с помощью меток
Лямбда-выражения поддерживают также локальный возврат. Локальный
возврат в лямбда-выражении напоминает своим действием выражение
break в цикле fo r. Он прерывает работу лямбда-выражения и продолжает
выполнение с инструкции, следующей сразу за вызовом лямбда-выраже­
ния. Чтобы отличить локальный возврат от нелокального, используются
метки. Можно отметить лямбда-выражение, из которого требуется произ­
вести выход, и затем сослаться на метку в выражении return.
Листинг 8.20. Локальный возврат с использованием метки
fun lookForAlice(people: List<Person>) {
people.forEach label§{
i f (it.name == "Alice") retumglabel
Мела для лямбда'
выражения
retum(jj>label
ссылается на ату метку
}
println("Alice might be somewhere")
}
»> lookForAlice(people)
Alice might be somewhere
Эта строка выводится
всегда
272 ❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры...
Выражение «this» с меткой
Теже правила использования меток относятся к выражению th is . Вглаве 5 мы обсуди­
ли лямбда-выражения с получателями - лямбда-выражениями, содержащими неявный
объект контекста, доступный по ссылке th is внутри лямбда-выражения (в главе 11 мы
объясним, как писать собственные функции, принимающие лямбда-выражения с получа­
телями в качестве аргументов). Еслидобавить метку к лямбда-выражению с получателем,
появится возможность обратиться к неявному получателю с использованием выражения
th is и соответствующей метки:
Этотнеявныйприемник
лямбда-выражениядоступен
»> println(StringBuilder(). apply sba{
поссылке!nis@sb
• « •
listO f(1, 2, 3).apply {
Ссылка«this»указьвает
thisgsb.append(this.toString())
нанеявныйприемник,
• •
ближайшийвтекущей
}
Доступымогутбытьвсенеявные
о
б
л
а
сти
ви
д
и
м
о
сти
• •
приемники, носамыевнешние})
толькопосредствомявтшхметок
[1, 2, 3]
• f t
По аналогии с метками для выражений re tu rn меткудля th is можно задатьявно или
воспользоваться именем вмещающей функции.
Чтобы отметить лямбда-выражение, добавьте имя метки (может быть
любым допустимым идентификатором) со следующим за ним символом @
перед открывающей фигурной скобкой лямбда-выражения. Чтобы произ­
вести выход из лямбда-выражения, добавьте символ @и имя метки сразу
после ключевого слова return, как это показано на рис. 8.4.
Меткалямбда-выражения
people.forEach
if (it.name == "Alice") return®label
}
W Выражение return
с■меткой
Рис. 8.4. Возврат из лямбда-выражения
с использованием символа «@» и метки
Также в роли метки может использоваться имя функции, принимающей
лямбда-выражение.
Листинг 8.21. Использование имени функции в роли метки для выражения re tu rn
fun lookForAlice(people: List<Person>) {
people.forEach {
i f (it.name == "Alice") retumgforEach
}
<h retum@forEachпроизведет
| выходизлямбда-выражения
8.3. Порядок выполнения функций высшего порядка ❖
273
println("Alice might be somewhere")
Обратите внимание, что если явно снабдить лямбда-выражение соб­
ственной меткой, использование имени функции в качестве метки не даст
желаемого результата. Лямбда-выражение не может иметь несколько м е­
ток.
Синтаксис нелокального возврата избыточно многословен и может вво­
дить в заблуждение, если лямбда-выражение содержит несколько выраже­
ний return. Исправить недостаток можно применением альтернативного
синтаксиса передачи блоков кода: анонимных функций.
8.3.3. Анонимные функции: по умолчанию возврат
выполняется локально
Анонимная функция - другой способ оформления блока кода для пере­
дачи в другую функцию. Начнем с примера.
Листинг 8.22. Использование return в анонимных функциях
fun lookForAlice(people: List<Person>) {
I Использует анонимную функцию
people. forEach( fun (person) {
< H вместо лямбда-выражения
i f (person.name == "Alice") return
<H «return» относится к ближайшей
print ln("${person. name} is not Alice")
I функции: анонимной функции
})
}
»> lookForAlice(people)
Bob is not Alice
Как видите, анонимная функция напоминает обычную функцию, отли­
чаясь только отсутствием имени и типа в объявлении параметра. Вот ещё
один пример.
Листинг 8.23. Использование анонимной функции в вызове filte r
people.filter(fun (person): Boolean {
return person.age < 30
})
Анонимные функции следуют тем же правилам, что и обычные функ­
ции, и должны определять тип возвращаемого значения. Анонимные
функции с телом-блоком, как в листинге 8.23, должны явно возвращать
значение заданного типа. В функции с телом-выражением инструкцию
return можно опустить.
274
❖
Глава 8. Функции высшего порядка: лямбда-выражения как параметры...
Листинг 8.24. Использование анонимной функции с телом-выражением
people.filter(fun (person) = person.age < 30)
Внутри анонимной функции выражение return без метки выполнит
выход из анонимной функции, а не из внешней. Здесь действует простое
правило: return производит выход из ближайшей функции, объявленной с
помощью ключевого слова fun. Лямбда-выражения определяются без клю­
чевого слова fun, поэтому return в лямбда-выражениях производит вы­
ход из внешней функции. Анонимные функции объявляются с помощью
fun; поэтому в предыдущем примере ближайшая функция для return это анонимная функция. Следовательно, выражение return производит
возврат из анонимной, а не из вмещающей функции. Разница видна на
рис. 8.5.
fun lookForAlice(people: List<Person>) {
people.f o r E a c h {fun(person) {
if (person.name == "Alice") return
}
/
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
fun lookForAlice(people: List<Person>)
people. f o r E a c h {
if (it.name == "Alice") returr
}
{
}
Рис. 8.5. Выражение return производит выход из ближайшей функции,
объявленной с помощью ключевого слова fun
Обратите внимание: несмотря на то что анонимная функция выгля­
дит как объявление обычной функции, в действительности она - лишь
другая синтаксическая форма лямбда-выражения. Правила реализации
лямбда-выражений и их встраивания во встраиваемых функциях точно
так же действуют для анонимных функций.
8.4. Резюме
О Типы функций позволяют объявлять переменные, параметры или
возвращаемые значения, хранящие ссылки на функции.
О Функции высшего порядка принимают другие функции в аргумен­
тах и/или возвращают их. Такие функции создаются с применением
типов функций в роли типов параметров и/или возвращаемых зна­
чений.
О Когда производится компиляция вызова встраиваемой функции, её
байт-код вместе с байт-кодом переданного ей лямбда-выражения
8.4. Резюме ❖
275
вставляется непосредственно в код, в точку вызова. Благодаря этому
вызов происходит без накладных расходов, как если бы аналогичный
код был написан явно.
О Функции высшего порядка упрощают повторное использование
кода и позволяют писать мощные обобщенные библиотеки.
О Встраиваемые функции дают возможность производить нелокальный
возврат, когда выражение return в лямбда-выражении производит
выход из вмещающей функции.
О Анонимные функции - это альтернативный синтаксис оформления
лямбда-выражений с иными правилами для выражения return. Их
можно использовать, когда потребуется написать блок кода с не­
сколькими точками выхода.
Обобщенные типы
В этой главе:
■ объявление обобщенных функций и классов;
■ стирание типов и овеществляемые параметры типов;
■ определение вариантности в месте объявления и в месте ис­
пользования.
Вы видели в этой книге несколько примеров использования обобщенных
типов. Они были понятны без пояснений, поскольку основные идеи объ­
явления и использования обобщенных классов и функций в Kotlin напо­
минают Java. В этой главе мы рассмотрим их подробнее. Мы глубже погру­
зимся в тему обобщенных типов и исследуем новые понятия, введенные в
Kotlin: овеществляемые типовые параметры и определение вариантности
в месте объявления. Они могут оказаться новыми для вас, но не волнуй­
тесь - глава раскрывает эту тему во всех подробностях.
Овеществляемые типовые параметры (reified type parameters) позволя­
ют ссылаться во время выполнения на конкретные типы, используемые
как типовые аргументы в вызовах встраиваемых функций. (Для обычных
классов или функций это невозможно, потому что типовые аргументы
стираются во время выполнения.)
Определение вариантности в месте объявления (declaration-site variance)
позволяет указать, является ли обобщенный тип, имеющий типовой ар­
гумент, подтипом или супертипом другого обобщенного типа с тем же
базовым типом и другим типовым аргументом. Например, таким спосо­
бом можно указать на возможность передачи типа L ist< In t> в функцию,
ожидающую List<Any>. Определение вариантности в месте использования
(use-site variance) преследует ту же цель для конкретного использования
обобщенного типа и, следовательно, решает те же задачи, что и метасим­
волы (wildcards) в Java.
9.1. Параметры обобщенных типов ❖
277
9.1. Параметры обобщенных типов
Поддержка обобщенных типов дает возможность определять парамет­
ризованные типы. Когда создается экземпляр такого типа, параметр типа
заменяется конкретным типом, который называется типовым аргумен­
том. Например, если в программе есть переменная типа L is t, то полезно
знать, элементы какого типа хранит этот список. Типовой параметр по­
зволяет указать именно это - то есть вместо «эта переменная хранит спи­
сок» можно сказать «эта переменная хранит список строк». Синтаксис
в Kotlin, говорящий «список строк», выглядит как в Java: L ist< S trin g > .
Также можно объявить несколько типовых параметров для класса. На­
пример, класс Мар имеет типовые параметры для ключей и значений:
c la s s Мар<К, V>, - и его можно инициализировать конкретными аргу­
ментами: Map<String, P erson x Итак, синтаксис выглядит в точности
как в Java.
Типовые аргументы, как и типы вообще, могут выводиться компилято­
ром Kotlin автоматически:
val authors = listO f( "Dmitry", "Svetlana")
Поскольку оба значения, переданных в вызов функции lis t O f , это
строки, то компилятор сообразит, что в этой инструкции создается спи­
сок строк L ist< S trin g > . С другой стороны, если понадобится создать
пустой список, типовой аргумент вывести неоткуда, поэтому вам при­
дется указать его явно. В случае создания списка у вас есть возможность
выбора: определить тип в объявлении переменной или задать типовой
аргумент для вызываемой функции, создающей список. Вот как это д е ­
лается:
val readers: MutableList<String> = mutableListOf()
val readers = mutableListOf<String>()
Эти объявления эквивалентны. Обратите внимание, что функции созда­
ния коллекций рассматриваются в разделе 6.3.
Примечание. В отличие от Java, Kotlin всегда требует, чтобы типовые аргументы указыва­
лись явно или могли быть выведены компилятором. Поддержка обобщенных типов появи­
лась только в версии Java 1.5, поэтому в этом языке необходимо было обеспечить совмес­
тимость с существующим кодом, написанным для более старых версий, и дать возможность
использовать обобщенные типы без типовых аргументов - так называемые необработанные
типы (raw type). Например, в Java можно объявить переменную типа L is t, не указывая типа
элементов списка. Но Kotlin изначально реализует обобщенные типы и не поддерживает
необработанных типов, поэтому типовые аргументы должны определяться всегда.
278 ❖
Глава 9. Обобщенные типы
9.1.1. Обобщенные функции и свойства
Если вы собираетесь написать функцию, работающую со списком, и хо­
тите, чтобы она работала с любыми списками (обобщенными), а не только
со списками элементов конкретного типа, вы должны определить обоб­
щенную функцию. Обобщенная функция имеет свои типовые параметры.
Такие типовые параметры замещаются конкретными типовыми аргумен­
тами во всех вызовах функции.
Большая часть библиотечных функций, работающих с коллекциями, обобщенные. Например, рассмотрим объявление функции s l i c e (рис. 9.1).
Эта функция возвращает список, содержащий только элементы с индекса­
ми, входящими в указанный диапазон.
Объявление типового параметра
fu n <Т> List<T>.slice(indices: IntRange): List<T>
Типовой параметр используется для определения
типа получателя и возвращаемого значения
Рис.9.1. Обобщенная функция slice имееттиповой параметр Т
Параметр типа Т функции используется для определения типа получа­
теля и возвращаемого значения; для обоих тип определен как List<T>.
Вызывая эту функцию для конкретного списка, можно явно передать ти­
повой аргумент. Но это требуется далеко не всегда, потому что компиля­
тор автоматически определяет типы, как показано далее.
Листинг 9.1. Вызов обобщенной функции
»>
»>
[а,
»>
[k,
val letters = (' а1. . 1z1). to L ist()
println(letters.slice<Char>(0..2)) <1— Типовой аргумент задан явно
Ь, с]
println(letters.slice(10. .13))
< Н Компилятор сам определит, что в данном
I , т , л]
| случае подТ подразумевается тип Char
В обоих случаях функция будет определена как имеющая тип List<Char>.
Компилятор подставит выведенный тип Char на место Т в объявлении
функции.
В разделе 8.1 мы показали объявление функции filte r , которая прини­
мает параметр с типом функции (Т) -> Boolean. Давайте посмотрим, как
применить её к переменным readers и authors из предыдущих примеров.
val authors = listO f( "Dmitry", "Svetlana")
val readers = mutableListOf<String>(/* ... * /)
fun <T> List<T>.filter(predicate: (T) -> Boolean): List<T>
»> readers, filte r { i t ! in authors }
9.1. Параметры обобщенных типов ❖
279
В данном случае автоматический параметр it лямбда-выражения
получит тип String. Компилятор способен сам вывести его: параметр
с лямбда-выражением в объявлении функции имеет обобщенный тип
Т (это тип параметра функции в (Т) -> Boolean). Компилятор пони­
мает, что Т - это String, потому что знает, что функция должна быть
вызвана для List<T>, a readers (получатель) имеет фактический тип
List<String>.
Типовые параметры можно объявлять для методов классов или интер­
фейсов, функций верхнего уровня и функций-расширений. В последнем
случае типовой параметр можно использовать для определения типа по­
лучателя и параметров, как в листингах 9.1 и 9.2: типовой параметр Т часть типа получателя List<T>, а также используется в параметре с типом
функции (Т) -> Boolean.
Используя тот же синтаксис, можно объявить обобщенные свойства-рас­
ширения. Например, ниже определяется свойство-расширение, которое
возвращает предпоследний элемент в списке:
val <Т> List<T>.penultimate: Т
get() = this[size - 2]
О—
I Это обобщенное свойство-расширение
| доступно для списков любого типа
»> print ln (lis tO f(l, 2, 3, 4 ) . penultimate)
3
< н В данном вызове параметр типа Т
| определяется как Int
Нельзя объявить обобщенное свойство, не являющееся расширением
Обычные свойства (не являющиеся расширениями) не могут иметь типовых парамет­
ров - нельзя сохранить несколько значений разных типов в свойстве класса, а поэтому
не имеет смысла объявлять свойства обобщенного типа, не являющиеся расширениями.
Если попробовать сделать это, то компилятор сообщит об ошибке:
»> val <Т> х: Т = T0D0()
ERROR: type parameter of a property must be used in its receiver type
Теперь посмотрим, как объявлять обобщенные классы.
9.1.2. Объявление обобщенных классов
Как в Java, в Kotlin имеется возможность объявлять обобщенные классы
или интерфейсы, поместив угловые скобки после имени класса и указав
в них типовые параметры. После этого типовые параметры можно ис­
пользовать в теле класса, как любые другие типы. Давайте посмотрим, как
можно объявить стандартный Java-интерфейс L ist на языке Kotlin. Для
простоты мы опустим большую часть методов:
280 ❖
Глава 9. Обобщенные типы
interface List<T> {
<Н Интерфейс List объявлен
operator fun get(index: In t): T < H т можно использовать в I с параметром типа Т
/ / •••
I интерфейсе или в классе
}
как обычный тип
Далее в этой главе, когда мы будем обсуждать тему вариантности, мы
усовершенствуем этот пример и посмотрим, как интерфейс L ist объявлен
в стандартной библиотеке Kotlin.
Если ваш класс наследует обобщенный класс (или реализует обобщен­
ный интерфейс), вы должны указать типовой аргумент для обобщенного
параметра базового типа. Это может быть или конкретный тип, или другой
типовой параметр:
J 3ror класс реализует List, подставляя
аргумент конкретного типа: String
override fun get(index: In t): String = . . . }
class ArrayList<T> : List<T> {
override fun get(index: In t): T = .
<H Обратите внимание: вместо T
I используется String
<i~\ Здесь обобщенный параметр типа Т класса
1 ArrayList является аргументом для List
}
Класс S tr in g L ist представляет коллекцию, которая может хранить
только элементы типа S trin g , поэтому в его определении используется
аргумент типа S trin g. Все функции в подклассе будут подставлять этот
конкретный тип вместо Т, то есть функция в классе S tr in g L ist будет
иметь сигнатуру fun g e t ( I n t ) : S trin g , а не fun g e t ( I n t ) : Т.
Класс A rrayL ist определяет свой типовой параметр Т и использует его
как типовой аргумент для суперкласса. Обратите внимание, что Т в ArrayList<T> - это не то же самое, что в List<T>, - это другой типовой пара­
метр, и он необязательно должен иметь то же имя.
В качестве типового аргумента для класса может даже использоваться
сам класс. Классы, реализующие интерфейс Comparable, - классический
пример этого шаблона. Любой элемент, поддерживающий сравнение, дол­
жен определять, как он будет сравниваться с объектами того же типа:
interface Comparable<T> {
fun compareTo(other: T): In t
}
class String : Comparable<String> {
override fun compareTo(other: String): In t = /* ... */
}
Класс S trin g реализует обобщенный интерфейс Comparable, подстав­
ляя тип S trin g для типового параметра Т.
До сих пор мы не видели отличий обобщенных типов в Kotlin от их соро­
дичей в Java. Но мы поговорим об этом далее, в разделах 9.2 и 9.3. А пока
9.1. Параметры обобщенных типов ❖
281
обсудим ещё одно понятие, действующее в Kotlin так же, как в Java, и по­
зволяющее писать удобные функции для работы с элементами, поддержи­
вающими сравнение.
9.1.3. Ограничения типовых параметров
Ограничения типовых параметров позволяют ограничивать круг допусти­
мых типов, которые можно использовать в качестве типовых аргументов
для классов и функций. Например, рассмотрим функцию, вычисляющую
сумму элементов списка. Она может использоваться со списками L ist< In t>
или List<Double>, но не со списками, например, L ist<String>. Чтобы вы­
разить это требование, можно определить ограничение для типового пара­
метра, указав, что типовой параметр функции sum должен быть числом.
Когда какой-то тип определяется как верхняя граница для типового па­
раметра, в качестве соответствующих типовых аргументов должен ука­
зываться либо именно этот тип, либо его подтипы. (Пока будем считать
термин «подтип» синонимом термина «подкласс». В разделе 9.3.2 мы про­
ведем границу между ними.)
Чтобы определить ограничение, нужно добавить двоеточие после имени
типового параметра, а затем указать тип, который должен стать верхней гра­
ницей, как показано на рис. 9.2. Чтобы выразить то же самое в Java, следует
использоватьключевое слово ex t ends: <Т extends Number> Т sum(List<T>
lis t).
Типовой параметр Верхняя граница
Г ^ \ Г
---------------
--------------- >1
fun <Т : Number> List<T>« sum() : T
Рис. 9.2. Для определения ограничения после имени
типового параметра указывается верхняя граница
Следующий вызов функции допустим, потому что фактический типо­
вой аргумент (In t) наследует Number:
»> p rin tln (lis tO f(l, 2, 3).sum())
6
После определения верхней границы типового параметра Т значения
типа Т можно использовать как значения типа верхней границы. Напри­
мер, можно вызывать методы, объявленные в классе, который использует­
ся в качестве верхней границы:
fun <Т : Number> oneHalf(value: Т): Double
return value.toDouble() / 2 . 0
}
»> println(oneHalf(3))
1.5
J
Tnii Numberслужитверхней
границейдлятиповогопараметра
<'—| Вызовметода, объявленного
I вклассеNumber
282
❖
Глава 9. Обобщенные типы
Теперь напишем обобщенную функцию, возвращающую наибольший
из двух элементов. Поскольку определить максимальное значение можно
только среди элементов, поддерживающих сравнение, это обстоятельство
необходимо отразить в сигнатуре функции. Вот как это можно сделать.
Листинг 9.3. Объявление функции с ограничением для типового параметра
fun <Т: ComparablecT» max(first: Т, second: Т): Т {
return i f ( fir s t > second) fir s t else second
}
»> println(max( "kotlin'1, "java"))
kotlin
Аргументыэтойфункции
I должныбытьэлементами,
поддерживающимисравнение
<~\
<Н Строкисравниваются
| поалфавиту
Если попытаться вызвать max с элементами несовместимых типов, код
просто не будет компилироваться:
»> println(m ax("kotlin", 42))
ERROR: Type parameter bound for T is not satisfied:
inferred type Any is not a subtype of Comparable<Any>
Верхняя граница для T - обобщенный тип Comparable<T>. Как вы виде­
ли выше, класс S trin g реализует Comparable<String>, что делает S trin g
допустимым типовым аргументом для функции max.
Напомним, что, согласно соглашениям об операторах в Kotlin, сокра­
щенная форма fir st > second компилируется в f ir s t . compareTo( second)
> 0. Такое сравнение возможно, потому что тип элемента first (то есть Т)
наследует Comparable<T>, а значит, first можно сравнить с другим эле­
ментом типа Т.
В тех редких случаях, когда требуется определить несколько ограниче­
ний для типового параметра, можно использовать несколько иной синтак­
сис. Например, обобщенный метод в листинге 9.4 гарантирует, что задан­
ная последовательность CharSequence имеет точку в конце. Этот приём
работает со стандартным классом S trin g B u ild er и с классом ja v a .n io .
CharBuffer.
Листинг 9.4. Определение нескольких ограничений для типового параметра
fun <Т> ensureTrailingPeriod(seq: Т)
I Списокограничений
where Т : CharSequence, Т : Appendable { <—I длятиповогопараметра
i f (!seq.endsWith('. ') ) {
<Н Вызовфункции-расширения, объявленной
seq. append(1. ')
<Н Вызовметодаиз 1 Д™интерфейсаCharSequence
j
I интерфейсаAppendable
»> val helloWorld = StringBuilder(“Hello World” )
9.1 Параметры обобщенных типов ❖
283
»> ensureTrailingPeriod(helloWorld)
»> println(helloWorld)
Hello World.
В данном случае мы указали, что тип, определенный в качестве типо­
вого аргумента, должен реализовать два интерфейса: CharSequence и Арpendable. Это означает, что со значениями данного типа можно использо­
вать операции обращения к данным (endsWith) и их изменения (append).
Далее обсудим ещё один случай использования ограничений типовых
параметров: когда требуется объявить, что типовой параметр не должен
поддерживать значения n u ll.
9.1.4. Ограничение поддержки null в типовом параметре
Когда объявляется обобщенный класс или функция, вместо его типово­
го параметра может быть подставлен любой типовой аргумент, включая
типы с поддержкой значения n u ll. То есть типовой параметр без верхней
границы на деле имеет верхнюю границу Any?. Рассмотрим следующий
пример:
class Processor<T> {
fun process(value: T) {
value?.bashCode()
}
J
«value» может иметь значение null,
поэтому приходится использовать
безопасный вызов
}
В функции p ro cess параметр valu e может принимать значение n u ll,
даже если его тип Т не отмечен знаком вопроса. Это объясняется тем, что
конкретные экземпляры класса P rocessor могут использовать тип с под­
держкой значения n u ll для Т:
..
_
,
I На место Т подставляется Stnng? val nullableStringProcessor = Processor<String?>()
<H ' Щ поддерживающий значение null
nullableStringProcessor.process(null)
<|—i Этот код, передающий «null» в аргументе
I «value», прекрасно компилируется
Чтобы гарантировать замену типового параметра только типами, не
поддерживающими значения n u ll, необходимо объявить ограничение.
Если это единственное требование к типу, то используйте в качестве верх­
ней границы тип Any:
class Processors : Any> {
fun process(value: T) {
value.hasbCode()
}
Верхняя граница не допускает использования
I типов с поддержкой значения «пиИ»
<*“1 «value» типа Т теперь не
I может иметь значения «null»
}
Ограничение <T : Any> гарантирует, что тип T всегда будет представ­
лять тип без поддержки значения n u ll. Код Processor<String?> будет
284 ❖
Глава 9. Обобщенные типы
отвергнут компилятором, потому что аргумент типа S trin g? не является
подтипом Any (это подтип типа Any?, менее конкретного типа):
»> val nullableStringProcessor = Processor<String?>()
Error: Type argument is not within its bounds: should be subtype of 'Any'
Обратите внимание, что такое ограничение можно наложить указанием
в верхней границе любого типа, не поддерживающего nu11, не только типа
Any.
Мы охватили основы обобщенных типов, наиболее схожие с Java. Теперь
перейдем к теме, которая может показаться знакомой разработчикам на
Java: поведение обобщенных типов во время выполнения.
9.2. Обобщенные типы во время выполнения:
стирание и овеществление параметров типов
Как вы уже наверняка знаете, обобщенные типы реализуются в JVM че­
рез механизм стирания типа (type erasure) - то есть типовые аргументы
экземпляров обобщенных классов не сохраняются во время выполнения.
В этом разделе мы обсудим практические следствия стирания типов для
Kotlin и то, как обойти эти ограничения, объявляя функции встраиваемы­
ми (in lin e ). Чтобы типовые аргументы не стирались (или, говоря терми­
нами языка Kotlin, овеществлялись), функцию можно объявить встраи­
ваемой. Мы подробно обсудим овеществляемые типовые параметры и
рассмотрим примеры, когда это может пригодиться.
9.2.1. Обобщенные типы во время выполнения:
проверка и приведение типов
Как и в Java, обобщенные типы в Kotlin стираются во время выполне­
ния. То есть экземпляр обобщенного класса не хранит информацию о ти­
повых аргументах, использованных для создания этого экземпляра. На­
пример, если создать список L ist< S trin g> и добавить в него несколько
строк, во время выполнения вы увидите, что этот список имеет тип L ist
- нет никакой возможности определить тип элементов списка. (Конечно,
можно извлечь элемент списка и проверить его тип, но такая проверка не
гарантирует, что другие элементы будут того же типа.)
Посмотрим, что происходит со следующими двумя списками во время
выполнения (см. рис. 9.3):
val lis t l: List<String> = listO f("a", "b")
val lis t2 : List<Int> = lis tO f(l, 2, 3)
Хотя компилятор видит два различных типа, во время выполнения спи­
ски выглядят совершенно одинаковыми. Несмотря на это, вы как програм-
9.2.0бобщенныетипы во время выполнения:сгирание и овеществление параметровтипов ❖
285
мист можете гарантировать, что L ist< S trin g> содержит только строки, а
L ist< In t> - только целые числа, потому что компилятор знает типовые
аргументы и может гарантировать сохранение в каждом списке только
элементов совместимых типов. (Конечно, можно обмануть компилятор,
применив приведение типов или используя необработанные типы Java в
операциях доступа к спискам, но для этого потребуется приложить допол­
нительные усилия.)
["а", "Ь"]
о
listl
о
list2
[1,
2, 3]
1
Рис. 9.3. Во время выполнения невозможно определить, что lis tl и List2
объявлены как список строк и список целых чисел, - обе переменные имеют тип List
Теперь поговорим об ограничениях, которые появляются в связи со сти­
ранием информации о типах. Так как типовые аргументы не сохраняются,
вы не сможете проверить их - например, вы не сможете убедиться, что
конкретный список состоит из строк, а не каких-то других объектов. Как
следствие типы с типовыми аргументами нельзя использовать в провер­
ках i s - например, следующий код не компилируется:
»> i f (value is List<String>) ( . . . )
ERROR: Cannot check for instance of erased type
Во время выполнения возможно определить, что значение имеет тип
L ist, но нельзя определить, что список хранит строки, объекты класса
Person или что-то ещё, - эта информация стерта. Обратите внимание, что
в стирании информации об обобщенном типе есть свои преимущества:
поскольку нужно хранить меньше информации о типе, уменьшается объ­
ем памяти, занимаемый программой.
Как отмечалось выше, Kotlin не позволяет использовать обобщенных ти­
пов без типовых аргументов. Соответственно, возникает вопрос: как про­
верить, что значение является списком, а не множеством или каким-то
другим объектом? Это можно сделать с помощью специального синтакси­
са проекций:
i f (value is List<*>) ( . . . )
Фактически вы должны указать * для каждого параметра типа, присут­
ствующего в объявлении типа. Далее в этой главе мы подробно обсудим
синтаксис проекций со звездочкой (и объясним, почему проекции назы­
ваются проекциями), а пока просто рассматривайте такое объявление как
тип с неизвестными аргументами (или как аналог L ist<?> в Java). Преды-
286
❖
Глава 9. Обобщенные типы
дущии пример проверяет, является ли valu e списком L i s t , но не делает
никаких предположений о типе элементов.
Обратите внимание, что в операторах приведения типов as и as?
по-прежнему можно использовать обобщенные типы. Но такое приве­
дение завершится удачно, если класс имеет совместимый базовый тип и
несовместимые типовые аргументы, потому что когда производится при­
ведение (во время выполнения), типовые аргументы неизвестны. По этой
причине компилятор выводит предупреждение «unchecked cast» (неконт­
ролируемое приведение) для каждой попытки такого приведения типов.
Но это всего лишь предупреждение, поэтому вы сможете использовать
значение как имеющее требуемый тип (см. листинг 9.5).
Листинг 9.5. Использование приведения с обобщенным типом
fun printSum(c: C o lle ctio n s) {
I Этот код породит предупреждение:
val in tL ist = с as? List<Int>
<3—1 Unchecked cast: List< >to List<lnt>
?: throw IllegalArgumentException("List is expected")
p rin tln (in tL is t.sum())
}
»> printSum(listOf(l, 2, 3))
б
<H Все работает,
I как ожидается
Этот код прекрасно скомпилируется: компилятор выведет преду­
преждение, но признает этот код допустимым. Если вызвать функцию
printSum со списком целых чисел или множеством, вы получите ожидае­
мое поведение: она выведет сумму в первом случае и возбудит исключение
I lle g a lA r g u m e n tE x c e p tio n во втором. Но если передать функции значе­
ние несовместимого типа, она возбудит исключение C la ssC a stE x c e p tio n :
»> printSum(setOf(l, 2, 3))
<Н Множество - не список, поэтому
IllegalArgumentException: List is expected
| возбуждается исключение
»> printSum(listOf("a", "b", "с"))
< H Приведение выполнено успешно, но
ClassCastException: String cannot be cast to Number
| потом возбуждается другое исключение
Обсудим исключение, которое возбуждается, когда функция printSum
получает список строк. Она не возбудила исключения IllegalA rgu m en t­
Exception, потому что невозможно убедиться, что типовой аргумент имел
вид L ist< In t> . Из-за этого операция приведения типа не заметила оши­
бок, и была вызвана функция sum. Во время её выполнения возникло ис­
ключение, потому что sum пытается извлекать из списка значения типа
Number и складывать их. Попытка использовать тип S trin g взамен Number
привела к появлению исключения C lassC astE xception во время выпол­
нения.
9.2.0бобщенныетипы во время выполнения: стирание иовещесгвлениепараметровтипов ❖
287
Обратите внимание, что компилятор Kotlin достаточно интеллектуален,
чтобы использовать в проверке i s информацию о типе, доступную во вре­
мя компиляции.
Листинг 9.6. Проверка типа с использованием известного типового аргумента
fun printSum(c: Collection<Int>) {
i f (c is List<Int>) {
println(c.sum())
0~| Такаяпроверка
I допупима
}
}
»> printSum(listOf(l, 2, 3))
6
Проверка типа в листинге 9.6 возможна потому, что наличие в коллек­
ции с (список или другая разновидность коллекций) целых чисел известно
на этапе компиляции.
Компилятор Kotlin всегда старается сообщить, какие проверки опасны
(отвергая проверки i s и выводя предупреждения для приведений as), а
какие допустимы. Вам остается только осознать смысл предупреждений и
самостоятельно определить безопасность выполняемых операций.
Как уже упоминалось, в Kotlin есть специальная конструкция, чтобы ис­
пользовать конкретные типовые аргументы в теле функции, - но такое до­
пускается только внутри встраиваемых функций. Давайте познакомимся с
этой особенностью.
9.2.2. Объявление функций с овеществляемыми типовыми
параметрами
Как обсуждалось выше, обобщенные типы стираются во время выпол­
нения. В результате вы получаете экземпляр обобщенного класса, для ко­
торого нельзя определить типового аргумента, использовавшегося при
создании экземпляра. То же относится к типовым аргументам для функ­
ций. В теле обобщенной функции нельзя ссылаться на типовой аргумент,
с которым она была вызвана:
»> fun <Т> isA(value: Any) = value is T
Error: Cannot check for instance of erased type: T
Это общее правило. Но есть одно исключение, позволяющее преодолеть
данное ограничение: встраиваемые (in lin e ) функции. Типовые парамет­
ры встраиваемых функций могут овеществляться - то есть во время вы­
полнения можно ссылаться на фактические типовые аргументы.
Мы подробно обсудили встраиваемые функции в разделе 8.2. Тем не
менее напомним: если добавить в объявление функции ключевое слово
288 ❖
Глава 9. Обобщенные типы
in lin e , компилятор будет подставлять фактическую реализацию функ­
ции во все точки, где она вызывается. Объявление функции встраиваемой
может способствовать увеличению производительности, особенно если
функция принимает аргументы с лямбда-выражениями: код лямбда-вы­
ражений также может встраиваться, поэтому отпадает необходимость
создавать анонимные классы. В этом разделе демонстрируется другой
пример пользы от встраиваемых функций: их типовые аргументы могут
овеществляться.
Если объявить предыдущую функцию isA с модификатором in lin e и
отметить типовой параметр как овеществляемый (reified), появится воз­
можность проверить, является ли valu e экземпляром типа Т.
Листинг 9.7. Объявление функции с овеществляемым типовым параметром
inline fun creified Т> isA(value: Any) = value is T
»> println(isA<String>("abc"))
true
»> println(isA<String>(123))
false
Рассмотрим менее очевидные примеры использования овеществляе­
мых типовых параметров. Один из них - функция filte r ls ln s ta n c e в
стандартной библиотеке. Эта функция принимает коллекцию, выбирает
из неё экземпляры заданного класса и возвращает только их. Вот как её
можно использовать.
Листинг 9.8. Использование функции filterlsln stan ce из стандартной библиотеки
»> val items = listOf("one", 2, "three")
»> println(item s.filterIsInstance<String>())
[one, three]
В этом коде мы указываем для функции типовой аргумент <String> и
этим заявляем, что нас интересуют только строки. Соответственно, воз­
вращаемое значение функции получает тип L ist< S trin g> . В данном слу­
чае типовой аргумент известен во время выполнения и filte r ls ln s ta n c e
использует его для проверки значений в списке.
Вот как выглядит упрощенная версия объявления функции f ilt e r ls ln ­
sta n ce в стандартной библиотеке Kotlin.
Листинг 9.9. Упрощенная версия объявления функции filte rls ln s ta n c e
inline fun <reified T>
Iterable<*>.filterlslnstance(): List<T> {
Ключевое слово «reified» объявляет,
<t~\ что этот типовой параметр не будет
I стерт во время выполнения
9.2.0бобщенныетипы во время выполнения:сгирание и овеществление параметровтипов
val destination = mutableListOf<T>()
for (element in th is) {
i f (element is T) {
destination, add(element)
289
<H функция может проверить принадлежность
| элемента к типу, указанному в типовом аргументе
}
}
return destination
}
Почему овеществление возможно только для встраиваемых функций
Как работает этот механизм? Почему во встраиваемых функциях допускается проверка
element is т, а в обычных классах или функциях - нет? Как было сказано в разде­
ле 8.2, для встраиваемых функций компилятор вставляет байт-код с их реализацией в
точки вызова. Каждый раз, когда в программе встречается вызов функции с овеществляе­
мым типовым параметром, компилятор точно знает, какой тип используется в качестве
типового аргумента для данного конкретного вызова. Соответственно, компилятор может
сгенерировать байт-код, который ссылается на конкретный класс, указанный в типовом
аргументе. В результате для вызова fiiterisinstance<string>, показанного в лис­
тинге 9.8, генерируется кед, эквивалентный следующему:
for (element in this) {
i f (element is String) {
destination.add(element)
Ссылается на
конкретный класс
}
}
Так как байт-код ссылается на конкретный класс, а не на типовой параметр, типовой
аргумент не стирается во время выполнения.
Обратите внимание, что встраиваемые функции с овеществляемыми типовыми пара­
метрами не могут быть вызваны из Java. Обычные встраиваемые функции можно вызвать
из Java, но только как функции без встраивания. Напротив, функции с овеществляемыми
параметрами типов требуют дополнительной обработки для подстановки значения ти­
повых аргументов в байт-код, и поэтому они всегда должны быть встраиваемыми. А это
делает невозможным их вызов таким способом, как это делает код на Java.
Встраиваемая функция может иметь несколько овеществляемых типо­
вых параметров, а также неовеществляемые типовые параметры в допол­
нение к овеществляемым. Обратите внимание, что функция f i l t e r l s l n s ta n ce объявлена встраиваемой, хотя она не принимает лямбда-выражений
в аргументах. В разделе 8.2.4 отмечалось, что встраивание даёт преиму­
щества по производительности, когда функция принимает параметры
типов функций, а соответствующие аргументы - лямбда-выражения -
290
❖
Глава 9. Обобщенные типы
встраиваются вместе с функцией. Но в данном случае функция объявлена
встраиваемой не ради этого, а чтобы дать возможность использовать ове­
ществляемый типовой параметр.
Чтобы гарантировать высокую производительность, вы должны следить
за размерами встраиваемых функций. Если функция становится слишком
большой, то лучше выделить из неё фрагмент, не зависящий от овеществ­
ляемых типовых параметров, и превратить его в отдельную, невстраивае­
мую функцию.
9.2.3. Замена ссылок на классы овеществляемыми
типовыми параметрами
Один из типичных примеров использования овеществляемых па­
раметров функций - создание адаптеров для API, принимающих па­
раметры типа ja v a .la n g .C la s s . Примером такого API может служить
ServiceL oader из JDK, который принимает ja v a . la n g .C la ss, представ­
ляющий интерфейс или абстрактный класс, и возвращает экземпляр слу­
жебного класса, который реализует этот интерфейс. Посмотрим, как ове­
ществляемые типовые параметры могут упростить работу с такими API.
Вот как выполняется загрузка службы с применением стандартного Java
APIServiceLoader:
val servicelmpl = ServiceLoader.load(Service::class.java)
Синтаксис : : c la s s , java показывает, как получить ja v a .la n g .C la ss,
соответствующий Kotlin-классу. Это точный эквивалент S e r v ic e .c la s s в
Java. Мы подробно обсудим эту тему в разделе 10.2, когда будем обсуждать
механизм рефлексии (отражения).
А теперь перепишем этот пример, использовав функцию с овеществляе­
мым типовым параметром:
val servicelmpl = loadService<Service>()
Так намного короче, правда? Класс загружаемой службы теперь опре­
деляется как типовой аргумент для функции load S ervice. Типовой аргу­
мент читается проще - ведь он короче, чем синтаксис :: c l a s s . j ava.
Давайте посмотрим, как определена эта функция load S ervice:
inline fun <reified T> loadService() {
return ServiceLoader. load(T: :class. java)
о— Параметр типа объявлен овеществляемым
<3— Обращение к классу с типом Т ::dass
}
К овеществляемым типовым параметрам можно применять тот же син­
таксис :: c la s s .ja v a , что и для обычных классов. Этот синтаксис вернет
ja v a .la n g .C la ss, соответствующий классу, указанному в типовом пара­
метре, который затем можно использовать как обычно.
9.2.0бобщенныетипы во время выполнения:сгирание и овеществление параметровтипов ❖
291
Упрощение функции startActivity в Android
Если вы разрабатываете приложения для Android, следующий пример покажется вам
знакомым: он запускает экземпляр A c tiv ity . Вместо передачи класса в виде java,
la n g . C lass вполне можно использовать овеществляемый типовой параметр:
inline fun <reified Т : Activity>
I Типовой параметр объявлен
Context. startA ctivity() {
<J—I овеществляемым
val intent = Intent(this, T :: class, java) <j—i Обращение к классу
startA ctivity(intent)
| с типом T::dass
}
startActivity<DetailActivity>()
9.2.4. Ограничения овеществляемых типовых параметров
Несмотря на удобства, овеществляемые типовые параметры имеют
определенные ограничения. Некоторые проистекают из самой идеи, дру­
гие обусловлены текущей реализацией и будут ослаблены в будущих вер­
сиях Kotlin.
В частности, овеществляемые типовые параметры можно использовать:
О в операциях проверки и приведения типа ( is , ! is , as, as?);
О совместно с механизмом рефлексии, как будет обсуждаться в главе
10(: tc la ss);
О для получения соответствующего ja v a . la n g . C lass (:: c l a s s . java);
О как типовой аргумент для вызова других функций.
Ниже перечислено то, чего нельзя делать:
О создавать новые экземпляры класса, указанного в типовом парамет­
ре;
О вызывать методы объекта-компаньона для класса в типовом пара­
метре ;
О использовать неовеществляемый типовой параметр в качестве ти­
пового аргумента при вызове функции с овеществляемым типовым
параметром;
О объявлять овеществляемыми типовые параметры для классов,
свойств и невстраиваемых функций.
У последнего ограничения есть интересное следствие: поскольку ове­
ществляемые типовые параметры могут использоваться только со встраи­
ваемыми функциями, их применение означает, что функция вместе со
всеми лямбда-выражениями, которые она принимает, становится встраи­
ваемой. Если лямбда-выражения не могут быть встроены из-за особен-
292
❖
Глава 9. Обобщенные типы
ностей их использования во встраиваемой функции, или если вы сами
не хотите делать их встраиваемыми, можно использовать модификатор
noin lin e , чтобы явно объявить их невстраиваемыми. (См. раздел 8.2.2.)
Теперь, обсудив особенности работы обобщенных типов, рассмотрим
поближе самые часто используемые обобщенные типы, присутствующие
в любой программе на языке Kotlin: коллекции и их подклассы. Мы будем
использовать их как отправную точку в обсуждении понятий подтипов и
вариантности.
9.3. Вариантность: обобщенные типы
и подтипы
Термин вариантность (variance) описывает, как связаны между собой
типы с одним базовым типом и разными типовыми аргументами: напри­
мер, List<String> и List<Any>. Сначала мы обсудим, почему эта связь
важна, а затем посмотрим, как она выражается в языке Kotlin. Понима­
ние вариантности пригодится, когда вы начнете писать свои обобщенные
классы и функции: это поможет вам создавать API, который не ограничи­
вает пользователей и соответствует их ожиданиям в отношении безопас­
ности типов.
9.3.1. Зачем нужна вариантность: передача аргумента
в функцию
Представим, что у нас есть функция, принимающая аргумент List<Any>.
Безопасно ли передать такой функции переменную типа List<String>?
Как известно, можно передать строку в функцию, ожидающую получить
аргумент Any, потому что класс String наследует Any. Но когда Any и String
выступают в роли типовых аргументов для интерфейса List, ситуация не
так очевидна.
Например, рассмотрим функцию, которая выводит содержимое списка.
fun printContents(list: List<Any>) {
p rin tln (lis t.joinToString())
}
»> printContents(listOf("abc", "bac"))
abc, bac
Всё выглядит хорошо. Функция интерпретирует каждый элемент как
значение типа Any, и так как любая строка - это значение типа Any, то об­
щая безопасность не нарушается.
А теперь взгляните на другую функцию, которая изменяет список (и по­
этому принимает M utableList в параметре):
9.3. Вариантность: обобщенные типы и подтипы ❖
293
fun addAnswer(list: MutableList<Any>) {
lis t .add(42)
}
Может ли произойти какая-либо неприятность, если передать этой
функции список строк?
Если эта строка
»> val strings = mutableListOf( "abc", "bac")
компилируется
»> addAnswer(strings)
»> println(strings.maxBy { it.length })
< Н ... вы получите исключение
| во время выполнения
ClassCastException: Integer cannot be cast to String
»Ф1
Мы объявили переменную strings типа MutableList<String>. Затем
попробовали передать её в функцию. Если бы компилятор принял эту
операцию, мы смогли бы добавить целое число в список строк, и это при­
вело бы к исключению во время выполнения (при попытке обратиться к
содержимому списка как к строкам). Поэтому данный вызов не компи­
лируется. Этот пример показывает, что не всегда безопасно передавать
MutableList<String> в аргументе, когда ожидается MutableList<Any>, компилятор Kotlin справедливо отвергает такие попытки.
Теперь вы можете сами ответить на вопрос о безопасности передачи
списка строк в функцию, ожидающую получить список объектов Any. Это
небезопасно, если функция добавляет или заменяет элементы в списке,
потому что можно нарушить совместимость типов. В других случаях это
безопасно (причины этого мы подробно обсудим далее). В Kotlin такими
ситуациями легко управлять, выбирая правильный интерфейс в зависи­
мости от разновидности списка - изменяемый/неизменяемый. Если функ­
ция принимает неизменяемый список, ей можно передать список L ist с
более конкретным типом элементов. Если список изменяемый, этого де­
лать нельзя.
Далее в этом разделе мы обобщим данный вопрос, распространив его не
только на L ist, но и на любой обобщенный класс. Вы также увидите, поче­
му интерфейсы L ist и M utableList отличаются в отношении их типовых
аргументов. Но прежде обсудим понятия тип и подтип.
9.3.2. Классы, типы и подтипы
Как обсуждалось в разделе 6.1.2, тип переменной определяет её воз­
можные значения. Иногда мы используем термины тип и класс как экви­
валентные, но на самом деле они неодинаковы. Настал момент познако­
миться с их отличиями.
В простейшем случае с необобщенным классом имя класса можно непо­
средственно использовать как название типа. Например, записав var х :
String, мы объявим переменную, способную хранить экземпляры класса
String. Но обратите внимание, что то же самое имя класса можно исполь-
294
❖
Глава 9. Обобщенные типы
зовать для объявления типа, способного принимать значение nul I : var х :
S trin g?. Это означает, что в Kotlin каждый класс можно использовать для
конструирования по меньшей мере двух типов.
Ситуация становится ещё более запутанной, когда в игру вступают обоб­
щенные классы. Чтобы получить действительный тип, нужно подставить
аргумент с конкретным типом для типового параметра в классе. L ist - это
не тип (это класс), но все следующие варианты подстановки - корректные
типы: L ist< In t> , L ist< S trin g?> , L ist< L ist< S trin g> > и так далее. Каж­
дый обобщенный класс потенциально способен породить бесконечное ко­
личество типов.
Чтобы мы могли перейти к обсуждению отношений между типами, не­
обходимо познакомиться с понятием подтипа. Тип В - это подтип типа А,
если значение типа В можно использовать везде, где ожидается значение
типа А. Например, In t - это подтип Number, но In t не является подтипом
S trin g . Это также иллюстрация того, что тип одновременно является под­
тип самого себя. (См. рис. 9.4.)
Смысл термина супертип противоположен термину подтип. Если А - это
подтипом В, тогда В - это супертип для А.
А
Number
-
i
✓
В
1
Int
jt
✓
Int
Int
String
T
Int
Рис. 9.4. В - подтип А, если его можно использовать везде, где ожидается А
Почему так важно знать, считается ли один тип подтипом другого? Каж­
дый раз, когда вы присваиваете значение переменной или передаете ар­
гумент в вызов функции, компилятор проверяет наличие отношения типподтип. Обратимся к примеру.
Листинг 9.10. Проверка отношения тип-подтип
fun te s t(i: In t) {
val n: Number = i
<H Скомпилируете, потомучтоInt
| являете подтипомNumber
fun f(s: String) { / * . . . * / }
I Heскомпилируете, потомучто
f ( i)
<H Int неявляете подтипомString
}
Сохранение значения в переменной допускается только тогда, когда
тип значения - это подтип типа переменной. Например, тип In t инициа­
лизатора - параметра i - это подтип типа Number переменной. То есть
такое объявление переменной п считается допустимым. Передача выра­
жения в функцию допускается, только когда тип выражения - это подтип
9.3. Вариантность: обобщенные типы и подтипы ❖
295
для типа параметра функции. В примере выше тип In t аргумента i - это
не подтип типа S trin g параметра функции f , поэтому её вызов не ком­
пилируется.
В простых случаях подтип означает то же самое, что подкласс. Напри­
мер, класс In t - это подкласс Number и, соответственно, тип In t - это под­
тип типа Number. Если класс реализует интерфейс, его тип становится под­
типом этого интерфейса: S trin g - подтип CharSequence.
Но типы, поддерживающие значение n u ll, демонстрируют случаи, ког­
да подтип - не то же самое, что подкласс. (См. рис. 9.5.)
А?
Int
ji
Int?
1
А
k
Int
*
Int?
I
Рис. 9.5. Тип А, не поддерживающий значения null, является
подтипом типа А?, поддерживающего null, но не наоборот
Тип, не поддерживающий значения n u ll, - это подтип его версии, под­
держивающей n u ll, но они оба соответствуют одному классу. В перемен­
ной с типом, поддерживающим значение n u ll, всегда можно сохранить
значение типа, не поддерживающего n u ll, но не наоборот (n u ll - недо­
пустимое значение для переменной с типом, не поддерживающим n u ll):
val s: String = "abc"
val t: String? = s
I Этоприсваивание допустимо, потому
< H что String является подтипомдля String?
Разница между подклассами и подтипами становится особенно важной,
когда речь заходит об обобщенных типах. Вопрос о безопасности передачи
переменной типа L ist< S trin g> в функцию, ожидающую получить значе­
ние типа L ist< S trin g> , теперь можно переформулировать в терминах под­
типов: является ли L ist< S trin g> подтипом List<Any>? Вы видели, почему
небезопасно считать M utableL ist<String> подтипом MutableList<Any>.
Очевидно, что обратное утверждение тоже верно: MutableList<Any> - это
не подтип M utableL ist<String>.
Обобщенный класс - например, M utableList - называют инвари­
антным по типовому параметру, если для любых разных типов А и В
MutableList<A> не является подтипом или супертипом MutableList<B>.
В Java все классы инвариантны (хотя конкретные декларации, использую­
щие эти классы, могут не быть инвариантными, как вы вскоре увидите).
В предыдущем разделе вы видели класс, для которого правила подти­
пов отличаются: L ist. Интерфейс L ist в Kotlin - это коллекция, доступная
только для чтения. Если А - это подтип подтипа В, тогда List<A> - это под­
тип List<B>. Такие классы и интерфейсы называют ковариантными. Идея
ковариантности подробно обсуждается в следующем разделе, где объяс-
296 ❖
Глава 9. Обобщенные типы
няется, когда появляется возможность объявлять классы и интерфейсы
как ковариантные.
9.3.3. Ковариантность: направление отношения
тип-подтип сохраняется
Ковариантный класс - это обобщенный класс (в качестве примера будем
использовать Producer<T>), для которого верно следующее: Producer<A> это подтип Producer<B>, если А - подтип В. Мы называем это сохранением
направления отношения тип-подтип. Например, Producer<Cat> - это под­
тип Producer<Animal>, потому что Cat - подтип Animal.
В Kotlin, чтобы объявить класс ковариантным по некоторому типовому
параметру, нужно добавить ключевое слово out перед именем типового
параметра:
interface Producercout Т> {
fun produce(): Т
}
< н Этот класс объявлен ковариантным
| по типовому параметру Т
Объявление типового параметра класса ковариантным разрешает пере­
давать значения этого класса в аргументах и возвращать их из функций,
когда типовой аргумент неточно соответствует типу параметра в опре­
делении функции. Например, представьте функцию, которая заботится о
питании группы животных, представленной классом Herd1. Типовой пара­
метр класса Herd идентифицирует тип животных в стаде.
Листинг 9.11. Определение инвариантного класса, аналогичного коллекции
open class Animal {
fun feed() { ... }
}
class Herd<T : Animal> {
val size: Int get() = ...
operator fun get(i: Int): T { ... }
}
<H Типовой параметр не
| объявлен ковариантным
fun feedAll(animals: Herd<Animal>) {
for (i in 0 until animals.size) {
animals[i].feed()
}
}
Предположим, что пользователь вашего кода завёл стадо кошек и ему
нужно позаботиться о них.
1 Herd (англ.) - стадо. - П рим, перев.
9.3. Вариантность: обобщенные типы и подтипы ❖
297
Листинг 9.12. Использование инвариантного класса, аналогичного коллекции
<|—i Cat-это
Animal
class Cat : Animal() {
fun cleanLitter() ( . . . )
I
}
fun takeCareOfCats(cats: Herd<Cat>) {
for ( i in 0 until cats.size) {
c a ts [i].cleanLitter()
/ / feedAll(cats)
}
< Н Ошибка: передан тип Herd<Cat>, тогда
| как ожидается тип Herd<Animal>
>
К сожалению, кошки останутся голодными: если попробовать передать
стадо в функцию feed A ll, компилятор сообщит о несоответствии типов.
Поскольку мы не использовали модификатор вариантности в параметре
типа Т в классе Herd, стадо кошек не считается подклассом стада живот­
ных. Чтобы преодолеть проблему, можно выполнить явное приведение
типа, но это излишне многословный, чреватый ошибками и практически
всегда неправильный способ преодоления проблем совместимости типов.
Поскольку класс Herd имеет API, напоминающий L ist, и не позволяет
своим клиентам добавлять или изменять животных в группе, его можно
объявить ковариантным и изменить вызывающий код.
Листинг 9.13. Использование ковариантного класса, аналогичного коллекции
class Herckout Т : Animal> {
< Н Теперь параметр Тявляется
| ковариантным
}
fun takeCareOfCats(cats: Herd<Cat>) {
for ( i in 0 u n til c a ts.siz e ) {
c a ts[i].c le a n L itte r()
}
}
feedA ll(cats)
< H Нет необходимости
| выполнять приведение типа
Не каждый класс можно объявить ковариантным: это может быть не­
безопасно. Объявление класса ковариантным по определенному типо­
вому параметру ограничивает возможные способы использования этого
параметра в классе. Чтобы гарантировать безопасность типов, он может
использоваться только в так называемых исходящих (out) позициях: то есть
класс может производить значения типа Т, но не потреблять их.
Использование типового параметра в объявлениях членов класса мож­
но разделить на входящие (in) и исходящие (out) позиции. Рассмотрим класс,
объявляющий параметр типа Т и содержащий функцию, которая исполь-
298
❖
Глава 9. Обобщенные типы
зует Т. Мы говорим, что если Т используется как тип возвращаемого значе­
ния функции, то он находится в исходящей позиции. В этом случае функ­
ция производит значения типа Т. Если Т используется как тип параметра
функции, он находится во входящей позиции. Такая функция потребляет
значения типа Т. Обе позиции показаны на рис. 9.6.
interface Transformer<Т> {
fun transform(t: T): T
>
«входящая»
ПОЗИЦИЯ
'
«исходящая»
позиция
Рис. 9.6. Тип параметра функции называют входящей позицией,
а тип возвращаемого значения - исходящей
Ключевое слово out в параметре типа класса требует, чтобы все методы,
использующие Т, указывали его только в исходящей позиции. Это клю­
чевое слово ограничивает возможные варианты использования Т, чтобы
гарантировать безопасность соответствующего отношения с подтипом.
Для примера рассмотрим класс Herd. Он использует параметр типа Т
только в одном месте: в определении типа возвращаемого значения м е­
тода get.
class Herckout Т : Animal> {
val size: Int get() = ...
operator fun get(i: Int): T { ... }
}
I Использует T как тип
< ] J возвращаемого значения
Это исходящая позиция, что означает, что объявить класс ковариантным
безопасно. Любой код, вызывающий метод g e t объекта типа Herd<An ima l>,
будет прекрасно работать, если метод вернет Cat, потому что Cat - это
подтип Animal.
Повторим ещё раз, что ключевое слово out перед параметром типа Т
означает следующее:
О сохраняется отношение подтипа (Producer<Cat> - это подтип
Producer<Animal>);
О Т может использоваться только в исходящих позициях.
Теперь рассмотрим интерфейс List<T>. Значения типа L ist в языке
Kotlin доступны только для чтения, потому что этот тип имеет метод g et,
возвращающий элемент типа Т, но не определяет никаких методов, сохра­
няющих в списке значения типа Т. То есть этот интерфейс также ковариантный.
interface List<out Т> : Collection<T> {
operator fun get(index: Int): T
II ...
}
Интерфейс неизменяемого типа определяет
только методы, возвращающие Т (то есть Т
находится в «исходящей» позиции)
9.3. Вариантность: обобщенные типы и подтипы ❖
299
Обратите внимание, что параметр типа можно использовать не только
как тип параметров или возвращаемого значения, но также как аргумент
типа в других типах. Например, интерфейс L ist содержит метод su b L ist,
возвращающий List<T>.
in te rfa c e List<out Т> : Collection<T> {
fun subList(fromIndex: I n t, tolndex: I n t) : List<T>
И ...
O—i Здесь T также находится
| в «исходящей» позиции
}
В данном случае тип Т используется в функции su b L ist в исходящей
позиции. Мы не будем углубляться в детали: если вам интересен точный
входящий
документацию
получится
ковариантным по типовому параметру, потому что он включает методы,
принимающие значения типа Т в виде параметров и возвращающие такие
значения (то есть тип Т присутствует в обеих позициях).
in te rfa c e MutableList<T>
: List<T>, MutableCollection<T> {
override fun add(element: T): Boolean
}
0 ~ i MutableList нельзя объявить
| ковариантным по T ...
< '—| ...потомучтоТиспользуется
I во «входящей» позиции
Компилятор требует соблюдать это ограничение и выводит сообщение
об ошибке, если попробовать объявить класс ковариантным: Type param­
e te r Т i s d eclared as 'o u t' but occurs in 'in ' p o s itio n (Типовой
параметр T объявлен как 1o u t', но используется во 1входящей1 позиции).
Обратите внимание, что параметры конструктора не находятся ни во
входящей, ни в исходящей позиции. Даже если параметр типа объявить
как out, вы все ещё сможете использовать его в объявлениях параметров
конструктора:
c la ss Herdcout Т: Animal>(vararg anim als: Т) { . . . }
Вариантность защищает от ошибок, когда экземпляры класса исполь­
зуются как экземпляры более обобщенного типа: вы просто не сможете
вызвать потенциально опасных методов. Конструктор - это не метод, ко­
торый можно вызвать позднее (после создания экземпляра), поэтому он
не представляет потенциальной опасности.
Однако если параметры конструктора объявлены с помощью ключевых
слов va I и/или var, то вместе с ними объявляются методы чтения и записи
для изменяемых свойств. Поэтому параметр типа оказывается в исходя­
щей позиции для неизменяемых свойств и в обеих позициях для изменяе­
мых:
c la ss Herd<T: Animal>(var leadAnimal: T, vararg animals: T) { . . . }
300 ❖
Глава 9. Обобщенные типы
В данном случае Т нельзя объявить исходящим, потому что класс содер­
жит метод записи для свойства leadAnimal - то есть использует тип Т во
входящей позиции.
Отметьте, что правила позиции охватывают только видимое извне
(p u b lic, p ro tected и in te r n a l) API класса. Параметры приватных мето­
дов не находятся ни в исходящей, ни во входящей позициях. Правила ва­
риантности защищают класс от неправильного использования внешними
клиентами и не применяются к внутренней реализации класса:
class Herckout Т: Animal>(private var leadAnimal: T, vararg animals: T) { ... }
Теперь мы можем безопасно объявить Herd ковариантным по Т, потому
что свойство leadAnimal объявлено приватным.
Вы можете спросить: что происходит с классами или интерфейсами, ког­
да параметр типа используется только во входящей позиции? В этом слу­
чае действует обратное отношение - подробнее о нём читайте в следую­
щем разделе.
9.3.4. Контравариантносгь: направление отношения
тип-подтип изменяется на противоположное
Понятие контравариантности можно рассматривать как обратное
понятию ковариантности: для контравариантного класса отношение
тип-подтип действует в противоположном направлении относительно
отношения между классами, использованными как типовые аргументы.
Начнем с примера: интерфейса Comparator. Этот интерфейс определяет
один метод, compare, который сравнивает два объекта:
interface Comparator<in Т> {
fun compare(el: Т, е2: Т): In t { ... }
}
< Н Т используется во
| «входящей» позиции
Как видите, метод этого интерфейса только потребляет значения типа Т.
То есть Т используется только во входящей позиции, и поэтому его имени
в объявлении предшествует ключевое слово in.
Реализация интерфейса Comparator для данного типа может срав­
нивать значения любых его подтипов. Например, при реализации
Comparator<Any> появляется возможность сравнивать значения любого
конкретного типа.
»> val anyComparator = Comparator<Any> {
el, e2 -> el.hashCodeQ - e2.tiastiCode()
... }
»> val strings: List<String> = ...
»> strings. sortedWith(anyComparator)
Реализацию Comparator можно использовать
для сравнения любых объектов конкретного
типа, таких как строки
9.3. Вариантность: обобщенные типы и подтипы ❖
301
Функция sortedWith ожидает получить Comparator<String> (реали­
зацию, способную сравнивать строки), но ей без всякой опаски можно
передать реализацию, сравнивающую более общие типы. Для сравнения
объектов конкретного типа можно использовать реализацию Comparator
для данного типа или для любого его супертипа. Это означает, что
Comparator<Any> - это подтип Comparator<String>, тогда как Any - это
супертип для String. Отношение вида тип-подтип между реализациями
Comparator для двух разных типов направлено противоположно отноше­
нию между самими этими типами.
Теперь вы готовы познакомиться с полным определением контравариантности. Класс, контравариантный по типовому параметру, - это обоб­
щенный класс (возьмем для примера Consumer<T>), для которого выпол­
няется следующее: Consumer<A> - это подтип Consumer<B>, если В - это
подтип А. Типовые аргументы А и В меняются местами, поэтому мы гово­
рим, что отношение тип-подтип обратно направленное. Например, Con sumer<Animal> - это подтип Consumer<Cat>.
На рис. 9.7 видны различия между отношениями вида тип-подтип для
классов, ковариантных и контравариантных по типовому параметру. Как
можно заметить, что для класса Producer отношение тип-подтип повто­
ряет соответствующее отношение для типовых аргументов, в то время как
для класса Consumer отношения противоположны.
Animal
ProducersAnimal>
к
к
Ковариант
Cat
Consumer<Animal>
Контравариант
Producer<Cat>
Рис. 9.7. Для ковариантного типа Producer<T> направление
отношения тип-подтип сохраняется, но для контравариантного
типа Consumer<T> направление отношения тип-подтип
изменяется на противоположное
Ключевое слово in означает, что значения соответствующего типа пе­
редаются в методы данного класса (считаются входящими значениями) и
потребляются этими методами. Подобно случаю ковариантности, ограни­
чение на использование типового параметра делает возможным конкрет­
ное отношение тип-подтип. Ключевое слово in перед именем типового
параметра Т сообщает, что направление отношения тип-подтип меняется
на противоположное и Т может использоваться только во входящих по­
зициях. В табл. 9.1 перечислены основные различия между возможными
видами вариантности.
302 ❖
Глава 9. Обобщенные типы
Таблица 9.1. Ковариантные, контравариантные и инвариантные классы
Producer<out Т>
Consumer<in Т>
MutableList<T>
Направление отношения тип-подтип
для классов сохраняется:
Producer<Cat> - подтип
Producer<Animal>.
Направление отношения
тип-подтип меняется на обратное
Consumer<Animal> - подтип
Consumer<Cat>.
Нет отношения
тип-подтип
Т только в исходящих позициях
Ттолько во входящих позициях
Т влюбых позициях
Класс или интерфейс может быть ковариантным по одному параметру
типа и контравариантным по другому. Классический пример - интерфейс
Function. Следующее объявление демонстрирует функцию с одним пара­
метром:
interface FunctionKin Р, out R> {
operator fun invoke(p: P): R
>
Нотация ( P) - > R - ещё одна легко читаемая форма, эквивалентная
FunctionK P, R>. Как видите, Р (тип параметра) использован только во
входящей позиции и отмечен ключевым словом in , тогда как R (тип воз­
вращаемого значения) использован только в исходящей позиции и отме­
чен ключевым словом out. Это означает, что понятие подтипа для типов
функций обратно первому типовому аргументу и совпадает со вторым.
Например, функции высшего порядка, перечисляющей всех кошек в груп­
пе, можно передать лямбда-выражение, принимающее любых животных.
fun enumerateCats(f: (Cat) -> Number) ( . . . )
fun Animal.getlndex(): Int = ...
J
Jra допустимый код в Kotlin. Animal супертип для Cat, a Int - подтип Number
На рис. 9.8 изображены направления отношений тип-подтип в преды­
дущем примере.
Cat
i
(Cat) -> Number
j
Number
jk
Animal
(Animal! -> Int
Int
Рис. 9.8. Функция (Т) -> R контравариантна по своему аргументу
и ковариантна по типу возвращаемого значения
9.3. Вариантность: обобщенные типы и подтипы ❖
303
Обратите внимание, что до сих пор во всех примерах вариантность
класса указывалась непосредственно в его объявлении и применялась
везде, где использовался класс. Java не поддерживает этого и предлагает
использовать метасимволы (wildcards) для определения вариантности ис­
пользования класса. Давайте посмотрим, чем отличаются эти два подхода
и как можно использовать второй подход в Kotlin.
9.3.5. Определение вариантности в месте использования:
определение вариантности для вхождений типов
Поддержка модификаторов вариантности в объявлениях классов - это
очень удобно, потому что указанные модификаторы применяются везде,
где используется класс. Это называют определением вариантности в месте
объявления. Знакомые с метасимволами типов в Java (? extends и ? super)
легко поймут, что Java обрабатывает вариантность иначе. Всякий раз, ког­
да в Java используется тип с параметром типа, есть возможность указать,
что в параметре типа можно передавать подтипы или супертипы. Это на­
зывается определением вариантности в месте использования.
Определение вариантности в месте объявления в Kotlin и метасимволы
типов в Java
Поддержка определения вариантности в месте объявления позволяет писать более
компактный код, потому что модификаторы вариантности указываются только один раз
и клиентам вашего класса не приходится задумываться о них. ВJava, чтобы создатьAPI в
соответствии с ожиданиями пользователей, разработчик библиотеки должен использо­
вать метасимволы все время: Function<? super т , ? extends R>. Если заглянуть
в исходный код стандартной библиотеки Java 8, можно увидеть, что метасимволы в ней
используются везде, где используется интерфейс F unctio n. Например, вот как объяв­
лен метод Stream.map:
/* Hava */
public interface Stream<T> {
<R> StreanKR> map(Function<? super T, ? extends R> mapper);
}
Определение вариантности в месте объявления делает код компактнее и элегантнее.
Kotlin тоже поддерживает возможность определения вариантности в
месте использования, позволяя указывать вариантность для конкретного
вхождения типового параметра, даже если он не был объявлен в классе
как ковариантный или контравариантный. Давайте посмотрим, как это
работает.
304 ❖
Глава 9. Обобщенные типы
Вы уже видели, что многие интерфейсы, такие как M utableList, в об­
щем случае не считаются ни ковариантными, ни контравариантными,
потому что они могут производить и потреблять значения с типами, ука­
занными в их типовых параметрах. Но нередко переменная такого типа в
конкретной функции используется только в одной из этих ролей: либо как
производитель, либо как потребитель. Например, взгляните на следую­
щую простую функцию.
Листинг 9.14. Функция копирования данных с инвариантными типовыми
параметрами
fun <Т> copyData(source: MutableList<T>,
destination: MutableList<T>) {
for (item in source) {
destination.add(item)
}
}
Эта функция копирует элементы из одной коллекции в другую. Хотя
обе коллекции имеют инвариантный тип, исходная коллекция (source)
используется только для чтения, а коллекция назначения (d e stin a tio n ) только для записи. Для такой операции типы элементов коллекций могут
не совпадать. Например, вполне корректно копировать коллекцию строк
в коллекцию объектов Any.
Чтобы эта функция работала со списками разных типов, можно ввести
второй параметр обобщенного типа.
Листинг 9.15. Функция копирования данных с двумя типовыми параметрами
fun <Т: R, R> copyData(source: MutableList<T>,
destination: MutableList<R>)
for (item in source) {
destination.add(item)
Тип элементов в исходной
коллекции должен быть
подтипом типа элементов в
коллекции назначения
}
}
»>
»>
»>
»>
[1,
val ints = mutableListOf(l, 2, 3)
val anyltems = mutableListOf<Any>()
copyData(ints, anyltems)
println(anyltems)
2, 3]
< | - | Этот вызов допустим, потому
I что Int является подтипом Any
Мы объявили два параметра обобщенных типов, представляющих типы
элементов в исходном и целевом списках. Чтобы копирование было воз­
можно, элементы в исходном списке должны иметь тип, являющийся под-
9.3. Вариантность: обобщенные типы и подтипы ❖
305
типом типа элементов в списке назначения, подобно тому, как тип In t
является подтипом Any в листинге 9.15.
Но Kotlin предлагает более элегантный способ выразить такую зави­
симость. Когда функция вызывает методы, имеющие типовой параметр
только во входящей (или только в исходящей) позиции, мы можем вос­
пользоваться этим и добавить модификаторы вариантности к конкрет­
ным случаям использования типового параметра в определении функ­
ции.
Листинг 9.16. Функция копирования данных с выходной проекцией типового
параметра
fun <Т> copyData(source: MutableList<out Т>,
destination: MutableList<T>)
for (item in source) {
destination.add(item)
В мело использования типа можно
добавить модификатор «out»: это
исключит возможность использования
методов с типом Т в позиции «in»
}
}
Мы можем добавить модификатор вариантности в место использова­
ния типового параметра в объявлении: в тип параметра (как в листинге
9.16), тип локальной переменной, тип возвращаемого значения и так да­
лее. Такое определение называется проекцией типа (type projection): оно
говорит, что source - это не обычный список M utableList, а его проекция
(с ограниченными возможностями). В данном случае допускается только
вызов методов, возвращающих обобщенный параметр типа (или, строго
говоря, использующих его только в исходящей (out) позиции). Компиля­
тор отвергнет вызовы методов, в которых данный типовой параметр ис­
пользуется как аргумент (во входящей (in) позиции):
»> val lis t: MutableList<out Number> = ...
»> list.add(42)
Error: Out-projected type ' MutableList<out Number>' prohibits
the use of 'fun add(element: E): Boolean'
He удивляйтесь, если у вас не получится вызвать какие-то методы при
использовании проекции типа. Чтобы получить возможность вызывать их,
нужно использовать обычные типы вместо проекций. Для этого может по­
требоваться объявить второй типовой параметр, зависящий от того, кото­
рый первоначально был проекцией, как в листинге 9.15.
Конечно, правильнее реализовать функцию copyData с использованием
типа List<T> для аргумента source, потому что она использует только м е­
тоды, объявленные в L ist, но не в M utableList, а вариантность параметра
типа L ist определена в его объявлении. Однако понимание этого примера
всё равно полезно, если учесть, что многие классы не имеют отдельного
306 ❖
Глава 9. Обобщенные типы
ковариантного интерфейса для чтения и инвариантного интерфейса для
чтения/записи, таких как L ist и M utableList.
Бессмысленно определять проекцию, такую как L is t< o u t Т>, для па­
раметра типа, который уже имеет исходящую (o u t) вариантность. Она
означает то же самое, что L ist< T > , потому что L is t объявлен как c la s s
L is tc o u t Т>. Компилятор Kotlin предупредит вас, когда встретит такую
избыточную проекцию.
Аналогично можно использовать модификатор in, чтобы обозначить,
что в данном конкретном случае соответствующее значение действует как
потребитель, а типовой параметр можно заменить любым его супертипом.
Вот как можно переписать листинг 9.16 с использованием входящей (in)
проекции.
Листинг 9.17. Функция копирования данных с входящей проекцией типового
параметра
fun <Т> copyData(source: MutableList<T>,
destination: MutableList<in T>)
for (item in source) {
destination.add(item)
}
}
Допускает возможность
использования целевой коллекции
с элементами другого типа, если
он является супертипом для типа
элементов в исходной коллекции
Примечание. Определение вариантности в месте использования в языке Kotlin прямо со­
ответствует ограниченным метасимволам в Java. Объявление MutabieListcout т> в
Kotlin означаетто же самое, что MutabieList<? extends т> вJava, а входящая проек­
ция MutableList<in Т> соответствует MutableList<? super Т>.
Проекции в месте использования помогают расширить диапазон допус­
тимых типов. А теперь исследуем экстремальный случай: когда допусти­
мыми становятся типы с любыми типовыми аргументами.
9.3.6. Проекция со звездочкой: использование * вместо
типового аргумента
Обсуждая операции проверки и приведения типов в начале этой гла­
вы, мы упомянули о поддержке особого синтаксиса проекций со звездочкой,
который можно использовать, чтобы сообщить об отсутствии информа­
ции об обобщенном аргументе. Например, список элементов неизвестного
типа выражается с применением синтаксиса List<*>. Давайте подробно
исследуем семантику проекций со звездочкой.
Прежде всего отметим, что M utableList<*> - это не то же самое, что
M utableList< A ny?> (важно, что M u ta b le L ist< T > инвариантен по Т). Тип
M utableList< A ny?> определяет список, содержащий элементы любого
9.3. Вариантность: обобщенные типы и подтипы ❖
307
типа. С другой стороны, тип M utableList<*> определяет список, содер­
жащий элементы конкретного типа, но неизвестно, какого именно. Спи­
сок создавался как список элементов конкретного типа, такого как S trin g
(нельзя создать новый ArrayList<*>), и код, создавший его, ожидает, что
он будет содержать только элементы этого типа. Поскольку конкретный
тип нам неизвестен, мы не можем добавлять новые элементы в этот спи­
сок, потому что рискуем обмануть ожидания вызывающего кода. Зато мы
можем извлекать элементы из списка, потому что точно знаем, что все
значения, хранящиеся в нём, соответствуют типу Any? - супертипу всех
типов в Kotlin:
»> val lis t: MutableList<Any?> = mutableListOf('a', 1, "q w e")
»> val chars = mutableListOf('a', 'b \ 'c')
J MutableList<*> - не то же
»> val unknownElements: MutableList<*> =
самое, что MutableList<Any?>
i f (Random().nextBoolean()) lis t else chars
»> unknownElements.add(42)
< Н Компилятор отвергнет
| попытку вызвать этот метод
Error: Out-projected type 'MutableList<*>' prohibits
the use of 'fun add(element: E): Boolean'
»> println(unknownElements.first())
<H Извлечение элем ент не представляет
а
| опасности: firstQвернет элемент типа Any?
Почему компилятор интерпретирует M utableList<*> как исходящую
проекцию типа? В данном контексте M utableList<*> проецируется в
(действует как) тип M utableList<out Апу?>: если о типе элементов ничего
не известно, безопасно только извлекать элементы типа Any?, а добавлять
новые элементы в список небезопасно. Если провести аналогию с мета­
символами типов в Java, МуТуре<*> в Kotlin соответствует МуТуре<?> в Java.
Примечание. Для контравариантных типовых параметров, таких как Consumercin т>,
проекция со звездочкой эквивалентна <in Nothings Компилятор не позволит вызывать
методы таких проекций со звездочками, имеющие т в сигнатуре. Если типовой параметр
объявлен как контравариантный, он может действовать только как потребитель, и, как об­
суждалось выше, мы не знаем точно, что именно он может потреблять. Поэтому мы ничего
не можем предложить ему для потребления. Если вас заинтересовала эта тема, загляните в
документацию Kotlin (h ttp : //mna.bz/3Ed7).
Синтаксис проекций со звездочкой используется, когда информация о
типовом аргументе не имеет никакого значения, то есть когда ваш код не
использует методов, ссылающихся на типовой параметр в сигнатуре, или
только читает данные без учета их типа. Например, вот как можно реали­
зовать функцию p r in t F ir s t , принимающую параметр с типом List<*>:
J
i f (list.isNotEmptyQ) {
B аргументе можно
передать любой список i jsNotEmptyQ не использует
< н параметра обобщенного типа
308 ❖
Глава 9. Обобщенные типы
p rin tln (lis t.£ irs t())
}
0~| firstOвернетAny?, новданном
| случаеэтогодостаточно
»> printFirst(listO f("Svetlana", "Dmitry"))
Svetlana
Как и в случае определения вариантности в месте использования, мож­
но использовать альтернативное решение - ввести дополнительный пара­
метр обобщенного типа:
fun <Т> p rin tF irs t(lis t: List<T>) {
О—| Исновадопускаетсяпередатьв
i f (list.isNotEmptyQ) {
| аргументелюбойсписок
p rin tln (lis t.firs tQ )
<Н НотеперьfirstOвернет
| значениетипаТ
}
}
Синтаксис проекций со звездочкой лаконичнее, но его можно использо­
вать только тогда, когда точное значение параметра обобщенного типа не
играет никакой роли: когда вы используете только методы, извлекающие
значения, не заботясь о типах этих значений.
Теперь рассмотрим другой пример использования проекции типа со
звездочкой и часто встречающиеся ошибки. Допустим, что нам нужно про­
верить ввод пользователя, и мы объявили интерфейс F ield V a lid a to r. Он
содержит параметр типа только во входящей позиции, поэтому его можно
объявить контравариантным. Это правильный способ объявления вали­
датора, способного проверить любой элемент, когда ожидается валидатор
строк (контравариантное объявление позволяет сделать это). Мы также
объявили два валидатора, проверяющих значения типа S trin g и In t.
Листинг 9.18. Интерфейсы для создания валидаторов ввода
interface FieIdVaIidator<in T> {
fun validate(input: T): Boolean
Tиспользуетсятольков
позиции«ш»(этотметод
}
потребляетзначениетипаТ)
object DefaultStringValidator : FieldValidator<String> {
override fun validate(input: String) = input.isNotEmpty()
Интерфейсобъявлен
контравариантнымпоТ
}
object DefaultlntValidator : FieldValidator<Int> {
override fun validate(input: In t) = input >= 0
}
Теперь представьте, что нам нужно сохранить все валидаторы в одном
контейнере и выбрать нужный в соответствии с типом введенного значе­
ния. У многих читателей сразу возникнет соблазн использовать в качестве
9.3. Вариантность: обобщенные типы и подтипы ❖
309
хранилища словарь. Поскольку нужно хранить валидаторы любых типов,
можно объявить словарь с ключами типа КСla s s (представляющего класс
в Kotlin - мы обсудим этот тип в главе 10) и значениями типа F ie ld V a lid ator<*> (который может ссылаться на валидатор любого типа):
»> val validators = mutableMapOf<KClass<*>, FieldValidator<*»()
»> validators[String::class] = DefaultStringValidator
>» validators[Int::class] = DefaultlntValidator
Но в этом случае возникают сложности с использованием валидаторов.
Мы не можем проверить строку, указав тип валидатора F ield V alid ator<*>. Это небезопасно, потому что компилятор ничего не знает о типе
валидатора:
»> validators[String: :class]!! .validate("")
Error: Out-projected type 'FieldValidator<*>' prohibits
the use of 'fun validate(input: T): Boolean'
< '—I Значение, хранящееся
I в словаре, имеет тел
FieldVaudator<‘ >
Мы уже видели эту ошибку выше, когда пытались добавить элемент в
M utableList<*>. В данном случае эта ошибка означает, что значение кон­
кретного типа небезопасно передавать валидатору для неизвестного типа.
Одно из решений этой проблемы - явно привести валидатор к требуемому
типу. Это небезопасно, так поступать не рекомендуется. Однако мы ис­
пользуем этот трюк как быстрое решение, помогающее скомпилировать
код, чтобы потом приступить к его реорганизации.
Листинг 9.19. Извлечение валидатора с использованием явного приведения типа
»> val stringValidator = validators [String:: class]
as FieldValidator<String> <3 i Warning: unchecked cast
»> println(stringValidator.validateC'"))
| (Внимание:неконтролируемое
false
приведение тепа)
Компилятор выведет предупреждение о неконтролируемом приведе­
нии типа. Однако обратите внимание, что этот код будет терпеть неуда­
чу только при попытке выполнить проверку, но не во время приведения
типа, потому что во время выполнения вся информация об обобщенных
типах стирается.
Листинг 9.20. Извлечение неправильного валидатора
И
»> val stringValidator = validators [In t:: class]
as FieldValidator<String>
»> stringValidator. validate("11)
j ava. lang. ClassCastException:
java.lang.String cannot be cast to java.lang.Number
at DefaultlntValidator.validate
Извлекается неверный валидатор
(возможно, по ошибке), но этот
код компилируется
I Это только предупреждение
Истинная ошибка не проявится,
пока вы не попробуете
использовать валидатор
310 ❖
Глава 9. Обобщенные типы
Этот код и код в листинге 9.19 схожи в том смысле, что в обоих случаях
компилятор только выводит предупреждение. Вся ответственность за пра­
вильное приведение типов ложится на ваши плечи.
Как видите, это решение небезопасно и чревато ошибками. Поэтому да­
вайте поищем другое решение задачи хранения валидаторов разных ти­
пов в одном месте.
Решение в листинге 9.21 использует тот же словарь v a lid a to r s, но все
операции доступа к нему инкапсулированы в два обобщенных метода, на
которые возлагается ответственность за регистрацию и выбор правиль­
ных валидаторов. Этот код тоже заставляет компилятор вывести преду­
преждение (то же самое) о неконтролируемом приведении типа, но на
этот раз объект V a lid a to rs контролирует доступ к словарю и гарантирует,
что никто не сможет изменить словарь по ошибке.
Листинг 9.21. Инкапсуляция доступа
к коллекции валидаторов
object Validators {
private val validators =
mutableMapOf<KClass<*>, FieldValidator<*»()
Используетсятотжесловарь,
| чтопрежде, нотеперьдоступ
извнек немузакрыт
fun <Т: Any> registerValidator(
kClass: KClass<T>, fieldValidator: FieldValidator<T>) {
validators[kClass] = fieldValidator
< П Добавляет в словарь только
Подавляет вывод предупреждения I правильную пару ключ/
}
значение, когда валидатор
I о неконтролируемом приведении
к типу FieldValidator<T>
соответствует классу
@Suppress( “UNCHECKEDCAST” )
operator fun <Т: Any> get(kClass: KClass<T>): FieldValidator<T> =
validators[kClass] as? FieldValidator<T>
?: throw IllegalArgumentException(
"No validator for ${kClass.simpleName}")
}
»> Validators.registerValidator(String::class, DefaultStringValidator)
»> Validators.registerValidator(Int::class, DefaultlntValidator)
»> println(Validators[String::class].validate("Kotlin"))
true
»> println(Validators[Int: :class].validate(42))
true
Теперь у нас есть безопасный API. Вся небезопасная логика скрыта в теле
класса, и мы гарантируем невозможность её ошибочного использования
путем локализации. Компилятор отвергнет любую попытку использовать
неправильный валидатор, потому что объект V a lid a to rs всегда дает пра­
вильную реализацию валидатора:
9.4. Резюме ❖
311
»> println(Validators[String::class].validate(42))
<h
Error: The integer lite ra l does not conform to the expected type String
Теперь метод «get» вернет экземпляр
TnnaTieldVaUdator<String>
Этот шаблон легко можно распространить на хранилище любых обоб­
щенных классов. Локализация небезопасного кода в отдельном месте
предотвращает ошибки и делает использование контейнера безопаснее.
Обратите внимание, что шаблон, описанный здесь, не специфичен для
Kotlin: тот же подход можно использовать в Java.
Обобщенные типы и вариантность в Java справедливо считаются наибо­
лее сложным аспектом языка. В Kotlin мы постарались сделать его макси­
мально простым и понятным, сохранив совместимость с Java.
9.4. Резюме
О Поддержка обобщенных типов в Kotlin очень похожа на аналогичную
поддержку в Java - она позволяет объявлять обобщенные функции
или классы тем же способом.
О Как и в Java, аргументы обобщенных типов существуют только на
этапе компиляции.
О Вы не можете использовать типы с аргументами вместе с операто­
ром i s , потому что типовые аргументы стираются во время выпол­
нения.
О Типовые параметры встраиваемых (inline) функций можно объ­
явить овеществляемыми, что позволит использовать их во время
выполнения для проверок и получения экземпляров java.lang.
Class.
О Вариантность позволяет определить, является ли один из двух обоб­
щенных типов с одним и тем же базовым классом и разными типо­
выми аргументами, подтипом или супертипом другого, если один из
типовых аргументов является подтипом другого. Класс можно объя­
вить ковариантным по типовому параметру, если параметр исполь­
зуется только в исходящих позициях.
О Противоположное верно для контравариантных случаев: класс мож­
но объявить контравариантным по типовому параметру, если он ис­
пользуется только во входящих позициях.
О Неизменяемый интерфейс List в Kotlin объявлен ковариантным, а
это означает, что List<String> - это подтип List<Any>.
О Интерфейс функции объявлен контравариантным по первому типо­
вому параметру и контравариантным по второму, что делает (A nim al)-> In t подтипом для (Cat)->Number.
312
❖
Глава 9. Обобщенные типы
О Kotlin позволяет объявить вариантность и для обобщенного класса в
целом (вариантность в месте объявления, declaration-site variance), и
в месте конкретного использования обобщенного типа (use-site vari­
ance).
О Синтаксис вариантности со звездочкой можно использовать, когда
типовой аргумент неизвестен или неважен.
Глава
Аннотации и механизм
рефлексии
В этой главе:
■ применение и определение аннотаций;
■ использование механизма рефлексии для интроспекции клас­
сов во время выполнения;
■ пример проекта на языке Kotlin.
К настоящему моменту мы познакомились со многими приёмами рабо­
ты с классами и функциями, но все они требовали явно указывать имена
классов и функций в исходном коде. Чтобы вызвать функцию, вы должны
знать класс, в котором она определена, а также имена и типы её парамет­
ров. Аннотации и механизм рефлексии дают возможность преодолеть это
ограничение и писать код, способный работать с неизвестными заранее
произвольными классами. С помощью аннотаций можно присвоить та­
ким классам особую семантику, а механизм рефлексии позволит исследо­
вать структуру классов во время выполнения.
Пользоваться аннотациями просто, а вот писать собственные аннота­
ции и особенно код, обрабатывающий их, - не самая простая задача. Син­
таксис использования аннотаций в Kotlin точно такой же, как в Java, но
синтаксис объявления собственных аннотаций несколько отличается. Ме­
ханизм рефлексии очень похож на Java по общей структуре прикладного
интерфейса, но отличается в деталях.
Для демонстрации использования аннотаций и инструментов рефлек­
сии мы покажем реализацию настоящего проекта: библиотеки сериализации/десериализации в формат JSON с названием JKid. Библиотека ис­
пользует механизм рефлексии для доступа к свойствам произвольных
объектов во время выполнения, а также для создания объектов на основе
314 ❖
Глава 10. Аннотации и механизм рефлексии
данных, полученных в файлах JSON. Аннотации помогут вам настраивать,
как именно библиотека сериализует и десериализует конкретные классы
и свойства.
10.1. Объявление и применение аннотаций
Большинство современных фреймворков на Java широко использует анно­
тации, поэтому вы наверняка сталкивались с ними, работая над Java-при­
ложениями. Основная идея в Kotlin та же самая. Аннотация позволяет
связать дополнительные метаданные с объявлением. Затем доступ к м е­
таданным можно получить с использованием инструментов, работающих
с исходным кодом, с файлами скомпилированных классов или во время
выполнения - в зависимости от того, как настроены аннотации.
10.1.1. Применение аннотаций
Аннотации в Kotlin используются так же, как в Java. Чтобы применить
аннотацию, нужно добавить её имя с приставкой @перед аннотируемым
объявлением. Аннотировать можно разные элементы кода, такие как
функции и классы.
Например, при использовании фреймворка JUnit (h ttp ://jun it.org /
junit4/) можно отметить тестовый метод аннотацией ©Test:
import org.junit.*
class MyTest {
Assert.assertTrue(true)
}
олжен вызываться как тестовый
Рассмотрим более интересный пример - аннотацию ©Deprecated.
В Kotlin она имеет то же значение, что и в Java, но Kotlin добавляет в неё
параметр replaceW ith, в котором можно указать шаблон замены для под­
держки постепенного перехода на новую версию API. Следующий пример
показывает, как передать аргументы в аннотацию (сообщение об исполь­
зовании устаревшего API и шаблон замены):
§Deprecated("Use removeAt(index) instead.", ReplaceWith("removeAt(index)"))
fun remove(index: In t) { ... }
Аргументы передаются в круглых скобках, в точности как при вызове
обычной функции. С таким объявлением, если кто-либо использует функ­
цию remove, IntelliJ IDEA не только покажет, какая функция должна ис­
пользоваться взамен (в данном случае removeAt), но также предложит воз­
можность выполнить замену автоматически.
10.1. Объявление и применение аннотаций ❖
315
Аннотации могут иметь параметры только определенных типов, в том
числе простые типы, строки, перечисления, ссылки на классы, классы дру­
гих аннотаций и их массивы. Синтаксис определения аргументов аннота­
ций немного отличается от используемого в Java:
О Чтобы передать в аргументе класс, нужно добавить :: class после
имени класса: @MyAnnotation(MyClass:: class).
О Чтобы передать в аргументе другую аннотацию, перед её именем не
нужно добавлять символа @. Например, ReplaceWith - это аннота­
ция, но если она используется как аргумент аннотации Deprecated,
перед её именем нужен символ @.
Чтобы передать в аргументе массив, используйте функцию arrayOf:
@RequestMapping(path = array0f('7foo", "/bar")).
Если класс аннотации объявлен на языке Java, параметр value авто­
матически преобразуется в массив, если необходимо, что позволяет
передавать аргументы без использования функции arrayOf.
Аргументы аннотаций должны быть известны на этапе компиляции - то
есть мы не можем ссылаться в аргументах на произвольные свойства. Что­
бы использовать свойство как аргумент аннотации, его необходимо отме­
тить модификатором co n st, который сообщает компилятору, что свойство
является константой времени компиляции. Вот пример аннотации ©Test
из фреймворка JUnit, которая определяет предельное время ожидания за­
вершения теста в миллисекундах в параметре tim eout:
const val TEST TIMEOUT = 100L
@Test(timeout = TEST_TIMEOUT) fun testMethod() { ... }
Как обсуждалось в разделе 3.3.1, свойства с модификатором const долж­
ны объявляться на верхнем уровне файла или объекта и должны инициа­
лизироваться значениями простых типов или строками. Если попытаться
использовать в аргументе аннотации обычное свойство, компилятор сге­
нерирует ошибку «Only ‘const val’ can be used in constant expressions» (В вы­
ражениях-константах можно использовать только ‘const val’).
10.1.2. Целевые элементы аннотаций
Во многих случаях одному объявлению в исходном коде на Kotlin соот­
ветствует несколько объявлений на Java, каждое из которых может быть
целью аннотации. Например, свойство в Kotlin соответствует полю в Java,
методу чтения и, возможно, методу записи и его параметру. Свойству,
объявленному в основном конструкторе, соответствует ещё один допол­
нительный элемент: параметр конструктора. Соответственно, может воз­
никнуть потребность определить, какой именно элемент аннотируется.
316 ❖
Глава 10. Аннотации и механизм рефлексии
Аннотируемый элемент М О Ж Н О указать С Объявление цели Имя аннотации
помощью объявления цели. Объявление цели
помещается между знаком @ и именем ан­
©get:Rule
нотации и отделяется от имени двоеточием.
Рис. 10.1. Синтаксис
Слово g e t на рис. 10.1 указывает, что анно­
объявления цели аннотации
тация @Rule применяется к методу чтения
(getter) свойства.
Рассмотрим пример использования этой аннотации. В JUnit можно ука­
зать правило для выполнения перед каждым тестовым методом. Например,
стандартное правило TemporaryFolder используется для создания файлов
и папок, которые будут автоматически удалены после выполнения метода.
Чтобы указать правило, в Java нужно объявить общедоступное (p u b lic)
поле или метод с аннотацией @Rule. Но если в тестовом классе на Kotlin
просто добавить аннотацию gRule перед свойством fo ld e r , фреймворк
JUnit возбудит исключение: «The @Rule ‘folder’ must be public» (Прави­
ло ‘folder’ должно быть общедоступным). Это происходит потому, что
@Rule применяется к полю, которое по умолчанию приватное. Чтобы при­
менить аннотацию к методу чтения, нужно явно указать цель аннотации
@get: Rule, как показано ниже:
class HasTempFolder {
@get: Rule
val folder = TemporaryFolderQ
<H Аннотируетсяметод
| чтения, анесвойство
@Test
fun testUsingTempFolder() {
val createdFile = folder.newFile("myfile.txt")
val createdFolder = folder.newFolder("subfolder")
// ...
}
}
При применении к свойству аннотации, объявленные в Java, по умол­
чанию применяются к соответствующему полю. Kotlin, в отличие от Java,
позволяет также объявлять аннотации, которые могут применяться непо­
средственно к свойствам.
Вот полный перечень поддерживаемых объявлений целей:
О property - Java-аннотации не могут применяться с этим объявлени­
ем цели;
О field - поле, сгенерированное для свойства;
О g e t - метод чтения свойства;
О s e t - метод записи в свойство;
О r e c e iv e r - параметр-получатель функции-расширения или свойст­
ва-расширения ;
О param - параметр конструктора;
10.1. Объявление и применение аннотаций ❖
317
О setparam - параметр метода записи в свойство;
О d e le g a te - поле, хранящее экземпляр делегата для делегированного
свойства;
О file - класс, содержащий функции и свойства верхнего уровня, объ­
явленные в файле.
Все аннотации с целью file должны находиться на верхнем уровне фай­
ла, перед директивой package. Например, к файлам часто применяется
аннотация @DvmName, которая изменяет имя соответствующего класса.
В разделе 3.2.3 был показан пример её использования: ©file:DvmName("S tringFunctions").
Управление Java API с помощью аннотаций
Kotlin поддерживает несколько аннотаций для управления компиляцией объявлений
на Kotlin в байт-код Java и их представлением для вызывающего кода на Java. Некоторые
из них замещают соответствующие ключевые слова языка Java: например, аннотации @
V olatile и © strictfp служат прямой заменой v o la tile и s tr ic tf p - ключевых
слов в Java. Другие помогают уточнить, как будет выглядеть объявление на Kotlin для
кода на Java:
• @JvmName изменяет имя Java-метода или поля, сгенерированного на основе
Kotlin-объявления;
• (aJvmStatic может применяться к методам в объявлениях объектов или объектов-компаньонов, чтобы со стороны Java они выглядели как статические методы;
• @DvmOverioads (аннотация, которая упоминалась в разделе 3.2.2) требует от
компилятора Kotlin сгенерировать перегруженные версии функции с параметрами,
имеющими значения по умолчанию;
• © Jvm Fieid позволяет открытьдоступ к свойству как к общедоступному Java-полю,
без методов чтения/записи.
Более подробные сведения об использовании этих аннотаций можно найти в докумен­
тирующих комментариях, в их исходном коде, а также в электронной документации - в
разделе, посвященном совместимости с Java.
Обратите внимание, что, в отличие от Java, Kotlin позволяет применять
аннотации не только к объявлениям классов функций и типов, но также к
произвольным выражениям. Типичным примером может служить анно­
тация ©Suppress, которую можно использовать для подавления конкрет­
ных предупреждений компилятора в контексте выражения. Вот пример
объявления локальной переменной с подавлением предупреждения о не­
контролируемом приведении типа:
fun te s t(lis t: List<*>) {
@Suppress( "UNCHECKED_CAST")
318 ❖
Глава 10. Аннотации и механизм рефлексии
val strings = lis t as List<String>
и ...
}
Обратите внимание, что IntelliJ IDEA дает возможность быстро встав­
лять эту аннотацию: нужно только нажать комбинацию клавиш Alt-Enter
на предупреждении компилятора и выбрать Suppress в контекстном меню.
10.1.3. Использование аннотаций для настройки
сериализации JSON
Аннотации часто применяются для настройки сериализации объектов.
С е р и а л и з а ц и я - это процесс преобразования объекта в двоичное или тек­
стовое представление, которое затем может быть сохранено или переда­
но по сети. Обратный процесс, д е с е р и а л и з а ц и я , преобразует такое пред­
ставление обратно в объект. Часто для сериализации используется формат
JSON. Существует большое множество библиотек, реализующих сериали­
зацию Java-объектов в формат JSON, включая Jackson (h ttp s: //g it h u b .
com /FasterX M L/jackson) и GSON (h t t p s : //g it h u b .c o m /g oog le /g s o n k
Как и любые другие Java-библиотеки, они полностью совместимы с Kotlin.
На протяжении этой главы мы будем обсуждать реализацию библиоте­
ки, предназначенную для этой цели, на чистом Kotlin - JKid. Она достаточ­
но маленькая, чтобы вы смогли без труда читать её исходный код, и мы
настоятельно рекомендуем делать это в процессе чтения этой главы.
Исходный код библиотеки JKid и упражнения
Полную реализацию библиотеки можно найти в пакете с исходным кодом примеров
ДЛЯ КНИГИ, ДОСТУПНОМ ПОадресу: h ttp s : //m anning.com /books/kotlin-in
tio n . - а также в репозитории: h ttp :
изучения реа­
лизации библиотеки и примеров откройте файл c h lO /J k id /b u ild .g ra d le как Gradle-проект
в своей IDE. Примеры можно найти в папке s rc A e s t/k o tim /e x a m p le s . Наша библиотека
не такая богатая и гибкая, как GSON или Jackson, но её вполне достаточно для практиче­
ского использования, и вы можете задействовать её в своих проектах.
ПроектЛОс! включает несколько упражнений, которые вы можете выполнить после про­
чтения этой главы, чтобы проверить, насколько хорошо вы понимаете основные идеи.
Описание упражнений вы найдете в файле проекта README.md или на странице про­
екта на сайте GitHub.
Н а ч н е м с прост ейш его п р и м е р а , проверяю щ его р а б о т у б и б л и о т е ки : сериа­
Person. Попробуем передать
экземпляр в функцию s e r ia liz e , которая должна вернуть строку с JSONпредставлением :
л и за ц и ю и десериализацию экзе м п л я р а класса
10.1. Объявление и применение аннотаций ❖
319
data class Person(val name: String, val age: In t)
»> val person = Person("Alice", 29)
»> println(serialize(person))
{"age": 29, "name": "Alice"}
ISON-представление объекта включает пары ключ/значение: пары имен
свойств и их значений для конкретного экземпляра, такие как “аде” : 29.
Чтобы воссоздать объект из JSON-представления, нужно вызвать функ­
цию d e s e r ia liz e :
>» val json = """{"name": "Alice", "age": 29}"""
»> println(deserialize<Person>(json))
Person(name=Alice, age=29)
Формат JSON не хранит информацию о типах объектов. Поэтому, созда­
вая экземпляр из данных в формате JSON, нужно явно указать аргумент
типа. В данном случае мы передали класс Person.
Рисунок 10.2 иллюстрирует эквивалентность между объектом и его
JSON-представлением. Обратите внимание, что сериализованная версия
объекта может содержать не только свойства простых типов или строки,
как показано на рис. 10.2, но также коллекции и экземпляры других объ­
ектов-значений и классов.
Сериализация
Десериализация
Рис. 10.2. Сериализация
и десериализация экземпляра Person
Для настройки сериализации и десериализации объектов можно ис­
пользовать аннотации. Выполняя сериализацию объекта в формат JSON,
библиотека по умолчанию пытается сериализовать все свойства и исполь­
зовать в качестве ключей их имена. Аннотации позволяют изменить это
поведение. В этом разделе мы обсудим две такие аннотации, @Dson Exclude
и @DsonName, а далее в этой главе познакомимся с их реализациями:
О аннотация @Dson Exclude отмечает свойство, которое должно быть
исключено из процесса сериализации/десериализации;
О аннотация <aDsonName позволяет указать строковый ключ в паре ключ/
значение, который должен представлять свойство вместо его имени.
Рассмотрим их на примере:
data class Person(
@DsonName("alias") val firstName: String,
@]sonExclude val age: Int? = null
)
320 ❖
Глава 10. Аннотации и механизм рефлексии
Мы аннотировали свойство firstName, чтобы изменить ключ, исполь­
зуемый для его представления в формате JSON. Мы также аннотировали
свойство аде, чтобы исключить его из процесса сериализации/десериализации. Обратите внимание, что при этом мы должны добавить значение
по умолчанию для свойства аде - иначе не получится создать новый эк­
земпляр Person в ходе десериализации. На рис. 10.3 показано, как изме­
нилось представление экземпляра класса Person.
Сериализация
Десериализация
Рис. 10.3. Сериализация и десериализация экземпляра Person
после добавления аннотаций
Итак, мы познакомились с самыми основными возможностями, реали­
зованными в библиотеке JKid: s e r i a l i z e ( ), d e s e r ia liz e r )> @3sonName и
gDsonExclude. Теперь приступим к изучению их реализации. Начнем с
объявления аннотаций.
10.1.4. Объявление аннотаций
В этом разделе вы узнаете, как объявлять аннотации, на примере анно­
таций из библиотеки JKid. Аннотация §DsonExclude - самая простая, по­
тому что не имеет никаких параметров:
annotation class DsonExclude
Синтаксис выглядит как объявление обычного класса с дополнитель­
ным модификатором annotation перед ключевым словом c la s s . Так как
классы аннотаций используются только для определения структур мета­
данных, связанных с объявлениями и выражениями, они не могут содер­
жать программного кода. Соответственно, компилятор не допускает воз­
можности определить тело класса-аннотации.
Параметры для аннотаций с параметрами объявляются в основном кон­
структоре :
annotation class HsonName(val name: String)
Для этого используется самый обычный синтаксис объявления основ­
ного конструктора. Ключевое слово v a l обязательно для всех параметров
в классе-аннотации.
Для сравнения ниже показано объявление той же аннотации в Java:
/* lava */
public ginterface DsonName {
10.1. Объявление и применение аннотаций ❖
321
String valueQ;
Обратите внимание, что Java-аннотации имеют метод valu e, а анно­
тации в Kotlin - свойство name. У метода valu e особое значение в Java:
применяя аннотацию, вы должны явно указывать имена всех атрибутов,
кроме valu e. В Kotlin, напротив, применение аннотации - это обычный
вызов конструктора. Можно использовать синтаксис именованных ар­
гументов, чтобы явно указать их значения, или опустить их: например,
аннотация @DsonName(name = "first_name") означает то же самое, что
@DsonName("first_name"), потому что name - это первый параметр кон­
структора DsonName. Однако, чтобы применить Java-аннотацию в Kotlin,
придется использовать синтаксис именованных аргументов и явно пере­
числить все аргументы, кроме valu e, который Kotlin также распознает как
специальный.
Далее обсудим, как управлять использованием аннотаций и как приме­
нять аннотации к другим аннотациям.
10.1.5. Метааннотации: управление обработкой аннотаций
По аналогии с Java классы-аннотаций в Kotlin тоже могут аннотировать­
ся. Аннотации, применяемые к классам-аннотациям, называют метаанно­
тациями. Стандартная библиотека содержит несколько таких аннотаций,
управляющих обработкой аннотаций компилятором. Также есть примеры
использования метааннотаций в других фреймворках: например, многие
библиотеки, реализующие механизм внедрения зависимостей, использу­
ют метааннотации, чтобы отметить аннотации, идентифицирующие раз­
ные внедряемые объекты одного типа.
Из метааннотаций, объявленных в стандартной библиотеке, наиболее
широко используется ©Target. Библиотека JKid использует их в объявле­
ниях DsonExclude и DsonName, чтобы ограничить круг допустимых целей.
Вот как она применяется:
@Target(Annotat ionTarget.PROPERTY)
annotation class DsonExclude
Метааннотация ©Target определяет типы элементов, к которым может
применяться объявляемая следом аннотация. Без неё аннотацию можно
будет применять к любым объявлениям - это не подходит для библиотеки
JKid, потому что она обрабатывает только аннотации свойств.
Список значений перечисления A nnotationTarget включает все воз­
можные цели, в том числе: классы, файлы, функции, свойства, методы до­
ступа к свойствам, типы, все выражения и так далее. Если нужно, можно
объявить несколько целей: @Target(AnnotationTarget.CLASS, Annota­
tion T arget . METHOD).
❖
Глава 10. Аннотации и механизм рефлексии
Чтобы объявить свою метааннотацию, необходимо использовать цель
ANNOTATTON_CLASS:
gTarget(AnnotationTarget.ANNOTATION_CLASS)
annotation class BindingAnnotation
gBindingAnnotation
annotation class MyBinding
Имейте в виду, что аннотацию с целью PROPERTY нельзя использовать
в Java-коде. Но к ней можно добавить вторую цель A nnotationT arget.
FIELD - в этом случае аннотация будет применяться к свойствам в Kotlin
и к полям в Java.
Аннотация © R etention
Программируя на Java, вы наверняка сталкивались с ещё одной важной метааннота­
цией, ©Retention. С её помощью можно определить, должна ли объявляемая анно­
тация сохраняться в файле .class и будет ли она доступна во время выполнения через
механизм рефлексии. По умолчанию Java сохраняет аннотации в файлах .class, но они
остаются недоступными во время выполнения. Однако в большинстве случаев доступ к
аннотациям во время выполнения был бы весьма желателен, поэтому в Kotlin использу­
ются иные умолчания: аннотации получают признак хранения runtime. Поэтому анно­
тации в JKid не определяют этого признака явно.
10.1.6. Классы как параметры аннотаций
Теперь вы знаете, как определять аннотации, хранящие статические
данные в виде аргументов. Но иногда требуется нечто иное: возможность
ссылаться на класс как объявление метаданных. Этого можно добиться,
если объявить класс аннотации со ссылкой на класс в параметре. Подходя­
щий пример - аннотация © D e se r ia liz e ln te r fa c e в библиотеке JKid, ко­
торая позволяет управлять десериализацией свойств с типом интерфейса.
Как известно, нельзя создать экземпляр интерфейса непосредственно, по­
этому нужно явно указать класс, который будет использоваться для соз­
дания экземпляра в процессе десериализации. Вот как используется эта
аннотация:
interface Company {
val name: String
}
data class CompanyImpl(override val name: String) : Company
data class Person(
10.1.Объявление и применение аннотаций ❖
323
val name: String,
@DeserializeInterface(CompanyImpl::class) val company: Company
Прочитав вложенный объект company для экземпляра Person, библиоте­
ка JKid создает и десериализует экземпляр Companylmpl, а затем сохраняет
его в свойстве company. Для этого в примере выше мы использовали анно­
тацию g D e s e r ia liz e ln te r fасе с аргументом Companylmpl:: c la s s . Чтобы
сослаться на класс, нужно указать его имя и ключевое слово :: c la s s вслед
за ним.
Теперь посмотрим, как объявлена эта аннотация. Она имеет единствен­
ный аргумент - ссылку на класс - это видно из примера @ D eserializeIn terface(Com panyIm pl: : c la s s ) :
annotation class Deserializelnterface(val targetClass: KClass<out Any>)
Тип KClass - это Kotlin-версия типа j ava. la n g . C lass в Java. Он исполь­
зуется для хранения ссылок на классы Kotlin (с возможностями этого типа
мы познакомимся в разделе «Рефлексия» далее в этой главе).
Типовой параметр в KClass определяет, на какие классы Kotlin может
ссылаться данная ссылка. Например, Companylmpl::c la s s имеет тип
KClass<Companylmpl>, который является подтипом типового параметра в
аннотации (см. рис. 10.4).
КС1asscout Any>
1
КС1ass<СompanyImp1>
Рис. 10.4. Тип аргумента аннотации CompanylmpL::class
(KClass<Companylmpl>) - это подтип типа параметра
аннотации (KClass<out Апу>)
Если указать типовой параметр KClass<Any> без модификатора out, по­
пытка передать аргумент Companylmpl:: c la s s будет отвергнута, и един­
ственным допустимым аргументом в этом случае будет Any:: c la s s . Клю­
чевое слово out указывает, что можно ссылаться не только на класс Any, но
и на классы, наследующие Any. В следующем разделе вы увидите ещё одну
аннотацию, которая принимает параметр с обобщенным классом.
10.1.7. Обобщенные классы в параметрах аннотаций
По умолчанию библиотека JKid сериализует свойства всех типов, кроме
примитивных, строковых и коллекций, как вложенные объекты. Но это по­
ведение можно изменить и предоставить свою логику для сериализации
некоторых значений.
324 ❖
Глава 10. Аннотации и механизм рефлексии
Аннотация <aCustomSerializer принимает в качестве аргумента ссылку
на нестандартный класс-сериализатор. Этот класс должен реализовывать
интерфейс V a lu eS eria lizer:
interface ValueSerializer<T> {
fun toJsonValue(value: T): Any?
fun from]sonValue(jsonValue: Any?): T
}
Допустим, нам нужно организовать сериализацию дат, и мы написа­
ли свой класс D a te S e r ia liz e r , реализующий интерфейс V a lu e S e r ia lizer<Date>. (Этот класс включен в исходный код JKid как пример: h t t p : / /
mng ,b z/7 5 a 7 .) Вот как можно подключить этот сериализатор к классу
Person:
data class Person(
val паше: String,
@CustomSerializer(DateSerializer::class) val birthDate: Date
)
Посмотрим, как объявлена аннотация @ Custom Serializer. Интерфейс
V a lu e S e r ia liz e r - обобщенный и имеет типовой параметр, поэтому мы
должны указать типовой аргумент, чтобы сослаться на конкретный тип.
Поскольку типы свойств, к которым будет применяться эта аннотация, за­
ранее неизвестны, то как аргумент здесь используется проекция со звез­
дочкой (этот приём обсуждался в разделе 9.3.6):
annotation class CustomSerializer(
val serializerClass: KClass<out ValueSerializerc*»
)
На рис. 10.5 виден тип параметра s e r ia liz e r C la s s и описаны разные
его части. Мы должны гарантировать, что аннотация сможет ссылаться
только на классы, реализующие интерфейс V a lu e S e r ia liz e r . Например,
объявление @ C ustom Serializer(D ate::c la s s ) должно быть отвергнуто,
потому что Date не реализует интерфейса V a lu e S e r ia liz e r .
Принимает DateSerializenxlass
как допустимый аргумент, но
отвергает Datenclass
fun <Т> List<T>.slice(indices: IntRange): List<T>
Допускается не только
ValueSerializer::class, но любой класс»
n aan u M riA in u u X /aliia C a ri^ li^ a r
Допускается ValueSerializer для
сериализации любых значений
Рис. 10.5. Тип параметра аннотации serializerClass.
Допускаются только ссылки на классы, наследующие ValueSerializer
10.2. Рефлексия: интроспекция объектов Kotlin во время выполнения ❖
325
Хитро, правда? Дальше мы можем применять этот шаблон всякий раз,
когда требуется использовать класс как аргумент аннотации. Можно напи­
сать KClass<out YourClassName>, а если YourClassName имеет собствен­
ные типовые аргументы, то заменить их звездочкой (*).
Теперь вы познакомились со всеми важными аспектами объявления и
применения аннотаций в Kotlin. Следующий шаг - узнать, как обращаться
к данным, хранящимся в аннотациях. Для этого нам понадобится исполь­
зовать механизм рефлексии.
10.2. Рефлексия: интроспекция объектов Kotlin
во время выполнения
Механизм рефлексии позволяет обращаться к свойствам и методам объ­
ектов динамически, во время выполнения, не зная заранее, каковы они.
Обычно обращение к методу или свойству в исходном коде программы
оформляется как ссылка на конкретное объявление, которую компиля­
тор обрабатывает статически и проверяет существование объявления. Но
иногда требуется написать код, который смог бы работать с объектами лю­
бых типов или с объектами, имена свойств и методов которых становятся
известны только во время выполнения. Библиотека сериализации с под­
держкой формата JSON - отличный пример такого кода: она должна уметь
сериализовать любой объект, поэтому не может ссылаться на конкретные
классы или свойства. Механизм рефлексии помогает ей справиться с этой
задачей.
Программы на Kotlin, использующие механизм рефлексии, имеют дос­
туп к двум разным прикладным интерфейсам. Первый - стандартный
механизм рефлексии в Java, реализованный в пакете java.L an g.reflect.
Поскольку классы Kotlin компилируются в обычный байт-код Java, меха­
низм рефлексии в Java прекрасно поддерживает их. В частности, Java-библиотеки, использующие механизм рефлексии, полностью совместимы с
кодом на Kotlin.
Второй - механизм рефлексии в Kotlin, реализованный в пакете k o t lin .
reflect. Он поддерживает понятия, отсутствующие в мире Java, например
свойства и типы, способные принимать значение n u ll. Но он не может
служить полной заменой механизма рефлексии в Java, и ниже вы увидите,
что иногда удобнее использовать механизм в Java. Также важно отметить,
что механизм рефлексии в Kotlin не ограничивается классами Kotlin: его
с успехом можно использовать для работы с классами, написанными на
любом языке JVM.
Примечание. Чтобы уменьшить объем библиотеки времени выполнения на платформах,
где это важно (таких как Android), библиотека рефлексии Kotlin распространяется как от­
дельный файл - kotlin-reflectjar, который по умолчанию не добавляется в зависимости
326 ❖
Глава 10. Аннотации и механизм рефлексии
новых проектов. Чтобы воспользоваться механизмом рефлексии Kotlin, необходимо явно
добавить эту библиотеку в зависимости. IntelliJ IDEA способна обнаруживать недостающую
зависимость и помогает добавлять её. Идентификатор труппы/артефакта в Maven для этой
библиотеки: o r g . j e t b r a i n s . k o t l i n : k o t l i n -re fle c t.
В этом разделе вы увидите, как JKid использует механизм рефлексии.
Мы начнём с той её части, что отвечает за сериализацию (потому что так
нам проще будет давать пояснения к коду), а затем перейдем к реализа­
ции парсинга JSON и десериализации. Но сначала посмотрим, что входит
в механизм рефлексии.
10.2.1. Механизм рефлексии в Kotlin: KCLass, KCallable,
KFunction и KProperty
Главная точка входа в механизм рефлексии Kotlin - это КСla s s , пред­
ставляющий класс. Это аналог ja v a .la n g .C la s s , и его можно использо­
вать для доступа ко всем объявлениям в классе, его суперклассах и так
далее. Получить экземпляр KClass можно с помощью выражения МуC la ss:: c la s s . Чтобы узнать класс объекта во время выполнения, сначала
нужно получить его Java-класс с помощью свойства javaC lass - прямо­
го эквивалента Java-метода ja v a . la n g . O b ject. g e tC la ss( ). Затем, чтобы
выполнить переход между механизмами рефлексии Java и Kotlin, следует
обратиться к свойству-расширению k o tlin :
class Person(val name: String, val age: In t)
»> val person = Person("Alice", 29)
»> val kClass = person. javaClass. kotlin <H Вернет экземпляр
»> printIn(kClass.simpleName)
I KQass<Person>
Person
»> kClass.memberProperties.forEach { println(it.name) }
age
name
Этот простой пример выводит имя класса и имена всех его свойств. Для
обхода всех его свойств, не являющихся расширениями и объявленных в
классе и в суперклассах, используется memberProperties.
Если заглянуть в объявление класса KClass, можно увидеть множество
полезных методов для доступа к содержимому класса:
interface KClass<T : Any> {
val simpleName: String?
val qualifiedName: String?
val members: Collection<KCallable<*»
val constructors: Collection<KFunction<T>>
val nestedClasses: Collection<KClass<*>>
10.2. Рефлексия: интроспекция объектов Kotlin во время выполнения ❖
327
« • «
}
Многие другие возможности KClass (включая свойство memberPropert i e s , использованное в предыдущем примере) объявлены как расшире­
ния. Полный список методов в классе KClass (включая расширения) можно
найти в справочнике по стандартной библиотеке flittp : / /mng. bz /em 4il.
Вы могли заметить, что список всех членов класса - это коллекция эк­
земпляров K Callable. K Callable - это суперинтерфейс для функций и
свойств. Он объявляет метод c a ll, с помощью которого можно вызвать
соответствующую функцию или метод чтения свойства:
interface KCallable<out R> {
fun call(vararg args: Any?): R
* ft *
}
Аргументы для вызываемой функции передаются в списке vararg. Сле­
дующий фрагмент демонстрирует, как использовать метод c a l l для вызо­
ва функции с использованием механизма рефлексии:
fun foo(x: Int) = println(x)
»> val kFunction = ::foo
»> kFunction.call(42)
42
Вы уже видели синтаксис :: f оо в разделе 5.1.5, а теперь можете видеть,
что в этом выражении его значение - экземпляр класса KFunction, часть
механизма рефлексии. Вызвать требуемую функцию можно с помощью
метода K C a lla b le .c a ll. В данном случае нужно передать единственный
аргумент: 42. Попытка вызвать функцию с неправильным количеством ар­
гументов - например, вообще без аргументов: k F u n c tio n .c a llQ , - при­
ведет к появлению исключения «IllegalArgumentException: Callable expects
1 arguments, but 0 were provided» (IllegalArgumentException: Вызываемый
объект ожидал получить 1 аргумент, но получил 0 ).
Однако в данном случае для вызова функции можно использовать более
конкретный метод. Выражение :: f оо имеет тип K F unctionK Int, Unit>,
содержащий информацию о типах параметров и возвращаемого значе­
ния. Цифра 1 в имени означает, что у функции только один параметр. Что­
бы вызвать функцию с помощью этого интерфейса, следует использовать
метод invoke. Он принимает фиксированное количество аргументов (в
данном случае 1), типы которых соответствуют типовым параметрам ин­
терфейса KFunctionl. Также можно вызвать kFunction непосредственно1:
import kotlin.reflect.KFunction2
fun sum(x: Int, y: Int) = x + у
1 В разделе 11.3мы расскажем,почемуможно вызватьkFunction,неуказываяимени метода invoke.
328 ❖
Глава 10. Аннотации и механизм рефлексии
»> val kFunction: KFunction2<Int, In t, Int> = :: sum
»> println(kFunction.invoke(l, 2) + kFunction(3, 4))
10
»> kFunction(l)
ERROR: No value passed for parameter p2
Теперь вы не сможете вызвать метод invoke объекта kFunction с не­
верным количеством аргументов: этот вызов просто не будет компилиро­
ваться. Соответственно, если у вас есть KFunction определенного типа с
известными типами параметров и возвращаемого значения, предпочти­
тельнее использовать метод invoke. Метод c a l l - более универсальный
инструмент, работающий со всеми типами функций, но он не поддержи­
вает безопасность типов.
Где и как определены интерфейсы KFunctionN?
Типы, такие как KFunctioni, представляют функции с разным количеством парамет­
ров. Каждый тип наследует KFunction и добавляет дополнительный метод invoke
с соответствующим количеством параметров. Например, KFunction2 объявляет oper­
ato r fun invoke(pi: p i , p2: P2): R, где pi и P2 представляюттипы парамет­
ров, a R - тип возвращаемого значения.
Эти типы функций - си нт е т и че ски е т ипы , генерируем ы е ко м п и л ят о р о м , и вы не
найдете их объявлений в пакете k o tlin . reflect. Это означает возможность исполь­
зовать интерфейс для функций с любым количеством параметров. Приём с использова­
нием синтетических типов уменьшает размер k o tlin -ru n tim e .ja r и помогает избежать
искусственных ограничений на возможное количество параметров функций.
Для вызова метода чтения свойства тоже можно использовать метод
c a l l экземпляра KProperty. Но интерфейс поддерживает более удобный
способ получения значения свойства: метод g et.
Чтобы вызвать метод g et, нужно использовать правильный интерфейс
для свойства в зависимости от его объявления. Свойства верхнего уровня
представлены экземплярами интерфейса KProperty©, метод g et которого
не имеет аргументов:
var
»>
»>
»>
counter = 0
val kProperty = :: counter
kProperty.setter.call(21)
printIn(kProperty.getQ)
Вызов метода записи посредством
механизма рефлексии с передачей
аргумента 21
<1~1 Получение значения
I свойства вызовом «get»
Свойство-член представлено экземпляром KPropertyl, который имеет
метод g e t с одним аргументом. Чтобы получить значение такого свой-
10.2. Рефлексия: интроспекция объектов Kotlin во время выполнения ❖
329
ства, нужно передать в аргументе экземпляр объекта, владеющего свой­
ством. Следующий пример сохраняет ссылку на свойство в переменной
memberProperty, а затем вызывает m em berProperty.get(person), чтобы
получить значение этого свойства из конкретного экземпляра person. То
есть если memberProperty будет ссылаться на свойство аде класса Person,
тогда вызов m em berProperty.get(person) вернет значение свойства
p e r so n .аде:
class Person(val name: String, val age: In t)
»> val person = Person("Alice", 29)
»> val memberProperty = Person:: age
»> println(memberProperty. get(person))
29
Обратите внимание, что KPropertyl - это обобщенный класс. Перемен­
ная memberProperty получит тип KProperty<Person, I n t>, где первый ти­
повой параметр соответствует типу получателя, а второй - типу свойства.
То есть метод g e t можно вызвать, только указав верный тип получателя, вызов memberProperty. g e t( "A lice") просто не скомпилируется.
Также отметьте, что механизм рефлексии можно использовать только
для обращения к свойствам, объявленным на верхнем уровне или в классе,
но не к локальным переменным внутри функций. Если объявить локаль­
ную переменную х и попытаться обратиться к ней с использованием син­
таксиса :: х, компилятор сообщит об ошибке: «References to variables aren’t
supported yet» (Ссылки на переменные пока не поддерживаются).
На рис. 10.6 изображена иерархия интерфейсов, которые можно исполь­
зовать для доступа к исходному коду элементов во время выполнения.
Поскольку все объявления могут аннотироваться, интерфейсы, представ­
ляющие объявления во время выполнения, такие как «C lass, «Function
и «parameter, наследуют KAnnotatedElement. «C lass используется для
представления элементов двух видов: классов и объектов. «Property
может представлять любые свойства, а его подкласс KMutableProperty только изменяемые свойства, объявленные с использованием var. Для ра­
боты с методами доступа к свойствам как с функциями можно использо­
вать специальные интерфейсы G etter и S e tte r , объявленные в Property и
KMutableProperty, - например, если понадобится извлечь их аннотации.
Оба интерфейса, представляющих методы доступа, наследуют «Function.
Для простоты мы опустили на рис. 10.6 некоторые специальные интер­
фейсы для свойств, такие как «Property©.
Теперь, после знакомства с основными особенностями механизма реф­
лексии в языке Kotlin, можно переходить к обзору реализации библиотеки
JKid.
330 ❖
Глава 10. Аннотации и механизм рефлексии
Рис. 10.6. Иерархия интерфейсов в механизме рефлексии KotLin
10.2.2. Сериализация объектов с использованием
механизма рефлексии
Для начала вспомним, как выглядит объявление функции сериализации
в JKid:
fun serialize(obj: Any): String
Эта функция принимает объект и возвращает строку с его представле­
нием в формате JSON. Строка конструируется в экземпляре S trin g B u ild ег. По мере сериализации свойств объекта и их значений они добавля­
ются в конец объекта S trin gB u ild er. Чтобы сделать вызов append более
компактным, поместим реализацию в функцию-расширение для S tr in g B uilder. Это позволит вызывать append без квалификатора:
private fun StringBuilder.serializeObject(x: Any) {
append(...)
}
Преобразование параметра функции в получатель функции-расшире­
ния - распространенный шаблон в Kotlin, и мы подробно обсудим его в
разделе 11.2.1. Обратите внимание, что функция s e r ia liz e O b je c t не
расширяет интерфейса класса S trin gB u ild er. Она выполняет операции,
осмысленные только в данном конкретном контексте, поэтому мы отме­
тили её модификатором p r iv a te , который гарантирует невозможность
использования функции в любом другом месте. Она объявлена как расши­
рение, чтобы подчеркнуть, что конкретный объект первичен для данного
блока кода, и упростить работу с этим объектом.
В результате всю работу функция s e r ia liz e делегирует методу
se r ia liz e O b je c t:
fun serialize(obj: Any): String = buildString { serializeObject(obj) }
10.2. Рефлексия: интроспекция объектов Kotlin во время выполнения ❖
331
Как показано в разделе 5.5.2, b u ild S tr in g создает экземпляр S tr in g B uilder и дает возможность заполнить его с использованием лямбда-вы­
ражения. В данном случае требуемое содержимое возвращается вызовом
s e r ia liz e O b je c t(o b j).
Теперь обсудим поведение функции сериализации. По умолчанию она
сериализует все свойства объекта. Простые типы и строки сериализуют­
ся как числа, логические значения и строки. Коллекции сериализуются в
JSON-массивы. Свойства других типов сериализуются во вложенные объ­
екты. Как отмечалось в предыдущем разделе, это поведение можно на­
страивать с применением аннотаций.
Давайте рассмотрим реализацию s e r ia l izeO b ject, где вы увидите при­
менение механизма рефлексии на практике.
Листинг 10.1. Сериализация объекта
private fun StringBuilder.serializeObjectCobj: Any) {
val kClass - obj .javaClass.kotlin
<H Подшетьэкземпляр
val properties = kClass.memberProperties <H Полштъвсе
I KClass для объекта
I свойства класса
properties.joinToStringBuilder(
this, prefix =
postfix = “} ” ) { prop ->
serializeString(prop.name)
<•“1 Получить имя
append(“ : “ )
I свойства
serializePropertyValue(prop.get(obi))
<•“1 Получить
I значение свойства
}
}
Реализация этой функции должна выглядеть очевидной: она поочеред­
но сериализует все свойства класса. Строка JSON, получающаяся в резуль­
тате, выглядит примерно так: { propl: v a lu e l, prop2: value2 }. Функ­
ция join T oS trin gB u ild er обеспечивает разделение свойств запятыми.
Функция s e r ia liz e S tr in g экранирует специальные символы, как того
требует формат JSON. Функция seria lizeP ro p erty V a lu e проверяет тип
значения - примитивный, строка, коллекция или вложенный объект - и
сериализует его соответственно.
В предыдущем разделе мы узнали, как получить значение экземпляра
«Property: вызвать метод g et. Там мы использовали ссылку на свойство
P erson:: age с типом K PropertyK Person, Int>, что позволило компи­
лятору точно определить типы получателя и значения свойства. Однако
в этом примере точные типы неизвестны, потому что мы перебираем все
свойства класса объекта. Поэтому переменная prop получит тип «Pro­
p erty К А пу, *>, а вызов prop. g et (obj ) вернет значение типа Any. Мы не
даем никакой информации для проверки типа получателя во время ком­
пиляции, но поскольку передаем тот же объект, для которого извлекаем
❖
Глава 10. Аннотации и механизм рефлексии
список свойств, тип получателя всегда будет правильным. Посмотрим да­
лее, как реализованы аннотации, управляющие сериализацией.
10.2.3. Настройка сериализации с помощью аннотаций
Выше в этой главе вы видели объявления аннотаций, позволяющих на­
страивать процесс сериализации в формат JSON. В частности, мы обсудили
аннотации @DsonExclude, gJsonName и @ C u sto m S eria lizer. Теперь пришло
время посмотреть, как они обрабатываются функцией s e r i a l i z e O b j e c t .
Начнем с @DsonExclude. Эта аннотация позволяет исключить некоторые
свойства из процесса сериализации. Давайте посмотрим, как следует из­
менить функцию s e r i a l i z e O b j e c t для поддержки этой возможности.
Как вы помните, для получения всех свойств класса мы использова­
ли свойство-расширение memberProperties экземпляра KClass. Но те­
перь задача сложнее: мы должны отфильтровать свойства с аннотацией
@0son Exclude. Посмотрим, как это сделать.
Интерфейс KAnnotatedElement определяет свойство an n otation s, воз­
вращающее коллекцию экземпляров всех аннотаций (сохраняющихся во
время выполнения), которые применялись к элементам в исходном коде.
Так как KProperty наследует KAnnotatedElement, мы легко можем полу­
чить все аннотации для данного свойства с помощью p rop erty.an n ota­
tio n s .
Но нам не нужны все аннотации - мы должны отыскать только конкрет­
ные, необходимые нам. Эту задачу решает вспомогательная функция find A n n otation :
inline fun creified T> KAnnotatedElement.findAnnotation(): T?
= annotations.filterIsInstance<T>() .firstO rN ull()
Функция findAnnotation возвращает аннотации с типом, указанным в
качестве типового аргумента, если они есть. Она использует шаблон, об­
суждавшийся в разделе 9.2.3, с овеществляемым типовым параметром
(reified), чтобы дать возможность передавать класс аннотации в типовом
аргументе.
Теперь функцию findAnnotation можно использовать вместе с функци­
ей filte r из стандартной библиотеки, чтобы отфильтровать свойства с ан­
нотацией ©DsonExclude:
val properties = kClass.memberProperties
.filte r { it.findAnnotation<DsonExclude>() == null }
Следующая аннотация: gDsonName. Мы напомним её объявление и при­
мер использования:
annotation class DsonName(val name: String)
data class Person(
10.2. Рефлексия: интроспекция объектов Kotlin во время выполнения ♦> 333
@DsonName("alias") val firstName: String,
val age: Int
В данном случае нас интересует не только сама аннотация, но и её ар­
гумент: имя, которое должно использоваться для обозначения свойства в
JSON-представлении. К счастью, в этом случае нам тоже поможет функция
findArmot a t io n :
val propName = jsonNameAnn?.name ?: prop.name
J
Получить экземпляр аннотации
(jpJsonName, если имеется
О - ] Получить аргумент «пате» или использовать
I «рторлапте» no умолчанию
Если свойство не снабжено аннотацией @DsonName, то j sonNameAnn по­
лучит значение n u ll и мы будем использовать имя свойства prop.name.
Если аннотация присутствует, то будет использовано указанное в ней имя.
Рассмотрим порядок сериализации экземпляра класса Person, объ­
явленного выше. В ходе сериализации свойства firstName переменная
j sonNameAnn получит ссылку на соответствующий экземпляр класса ан­
нотации DsonName. То есть j sonNameAnn?. name вернет непустое значе­
ние " alia" , которое будет использовано как ключ в JSON-представлении.
В ходе сериализации свойства аде аннотация не обнаружится, поэтому в
качестве ключа будет использовано собственное имя свойства аде.
Добавим все изменения, о которых мы рассказали, и посмотрим на по­
лучившуюся реализацию.
Листинг 10.2. Сериализация объекта с фильтрацией свойств
private fun StringBuilder.serializeObject(obj: Any) {
obj.javaClass.kotlin.memberProperties
.filte r { i t .findAnnotation<JsonExclude>() == null }
.joinToStringBuilder(this, prefix =
postfix = "}") {
serializeProperty(it, obj)
}
}
Теперь свойства с аннотацией @3son Exclude будут отфильтровываться.
Мы также извлекли логику сериализации свойства в отдельную функцию
se r ia liz e P r o p e r ty .
Листинг 10.3. Сериализация единственного свойства
private fun StringBuilder.serializeProperty(
prop: KPropertyKAny, *>, obj: Any
) {
val jsonNameAnn = prop.findAnnotation<JsonName>Q
334 ❖
Глава Ю.Аннотации и механизм рефлексии
val propName = jsonNameAnn?.name ?: prop.name
serializeString(propName)
append(": ")
serializePropertyValue(prop.get(obj))
}
Имя свойства обрабатывается в соответствии с аннотацией @DsonName,
как обсуждалось выше.
Перейдем к реализации поддержки последней оставшейся аннотации,
@ C u sto m S e r ia liz e r . Реализация основана на функции g e t S e r i a l i z e r ,
которая возвращает экземпляр V a l u e S e r i a l i z e r , зарегистрированный в
аннотации < a C u sto m S eria lizer. Например, если объявить класс P erson ,
как показано ниже, и вызвать g e t S e r i a l i z e r ( ) во время сериализации
свойства b ir t h D a t e , она вернет экземпляр D a t e S e r i a l i z e r :
data class Person(
val name: String,
@CustomSerializer(DateSerializer::class) val birthDate: Date
)
Повторим объявление аннотации @ Custom Serializer, чтобы вам проще
было понять реализацию g e tS e r ia liz e r :
annotation class CustomSerializer(
val serializerClass: KClass<out ValueSerializer<*>>
)
А вот как реализована функция g e t S e r i a l i z e r .
Листинг 10.4. Извлечение объекта, реализующего сериализацию
fun KProperty<*>.getSerializer(): ValueSerializer<Any?>? {
val customSerializerAnn = findAnnotation<CustomSerializer>() ?: return null
val serializerClass = customSerializerAnn.serializerClass
val valueSerializer = serializerClass.objectlnstance
?: serializerClass.createlnstance()
@Suppress( "UNCHECKEDCAST")
return valueSerializer as ValueSerializer<Any?>
}
Это функция-расширение для K Property, потому что свойство - это пер­
вичный объект, который обрабатывается методом. Она вызывает функцию
fin d A n n otation , чтобы получить экземпляр аннотации @ C u stom S erializ е г , если он существует. Её аргумент, s e r i a l i z e r C l a s s , определяет класс,
экземпляр которого требуется получить.
10.2. Рефлексия: интроспекция объектов КоШп во время выполнения ♦> 335
Самое интересное здесь - способ обработки классов и объектов («одино­
чек» в Kotlin) как значений аннотации © C ustom Serializer. И те, и другие
представлены классом «C lass. Разница лишь в том, что объекты имеют
непустое свойство o b je c tln sta n c e , которое можно использовать для до­
ступа к единственному экземпляру, созданному для объекта. Например,
D a te S e r ia liz e r объявлен как объект, поэтому его свойство o b je c tln ­
sta n ce хранит ссылку на единственный экземпляр D a te S e r ia liz e r . Для
сериализации будет использоваться этот экземпляр, и вызов c r e a te ln sta n ce не произойдет.
Если «C lass представляет обычный класс, то вызовом c r e a te ln sta n c e
создается новый экземпляр. Эта функция похожа на ja v a .la n g .C la s s .
new lnstance.
Теперь можно задействовать g e tS e r ia liz e r в реализации s e r ia liz e Property. Ниже приводится окончательная версия функции.
Листинг 10.5. Сериализация свойства с поддержкой нестандартного способа
сериализации
private fun StringBuilder.serializeProperty(
prop: «Propertyl<Any, *>, obj: Any
) {
val name = prop.findAnnotation<3sonName>()?.name ?: prop.name
serializeString(name)
append(": ")
val value = prop.get(obj)
Использовать нестандартную
val jsonValue =
реализацию сериализации для
свойства, если указана
prop.getSerializer()?.tolsonValue(value)
?: value
serializePropertyValue(jsonValue)
Иначе использовать значение
J
свойства, как прежде
Если для преобразования значения свойства в JSON-совместимый фор­
мат указан нестандартный механизм сериализации, se r ia liz e P r o p e r ty
использует его, вызывая toDsonValue. Если же он не указан, используется
фактическое значение свойства.
Теперь, после знакомства с частью библиотеки, осуществляющей сериа­
лизацию в формат ISON, перейдем к парсингу и десериализации. Для де­
сериализации потребуется написать больше кода, поэтому мы не будем
исследовать его полностью, а рассмотрим только структуру реализации
и объясним, как использовать механизм рефлексии для десериализации
объектов.
336 ❖
Глава 10. Аннотации и механизм рефлексии
10.2.4. Парсинг формата JSON и десериализация
объектов
Начнем со второй части нашей истории: с реализации логики десе­
риализации. Прежде всего отметим, что API десериализации состоит из
единственной функции:
inline fun <reified Т: Any> deserializerjson: String): T
Вот как она используется:
data class Author(val name: String)
data class Book(val title : String, val author: Author)
»> val json = '" " '{" title " : "Catch-22", "author": {"name":
»> val book = deserialize<Book>(json)
»> println(book)
Book(title=Catch-22, author=Author(name=D. Heller))
Heller"}}"'"'
Мы передаем функции d e s e r ia liz e тип объекта как овеществляемый
типовой параметр и получаем от неё новый экземпляр объекта.
Десериализация формата JSON - более сложная задача, чем сериали­
зация, потому что вовлекает в себя не только механизм рефлексии, но и
парсинг JSON-строки. Десериализация JSON в библиотеке JKid реализова­
на традиционным образом и состоит из трёх этапов: лексический анализ,
синтаксический анализ (парсинг), а также собственно компонент десериа­
лизации.
В процессе лексического анализа входная строка разбивается на список
лексем. Различаются два вида лексем: символьные лексемы, представляю­
щие отдельные символы со специальным значением (запятые, двоеточия
и скобки, квадратные и фигурные), и лексемы-значения, соответствующие
строкам, числам, логическим значениям и значениям n u ll. Примерами
лексем разного вида могут служить: левая фигурная скобка ({), строковое
значение ("Catch-22") и целочисленное значение (42).
Парсер (выполняющий синтаксический анализ) отвечает за преобра­
зование списка лексем в структурированное представление. Его задача в
библиотеке JKid - распознать общую структуру JSON и преобразовать от­
дельные лексемы в семантически значимые элементы: пары ключ/значение, объекты и массивы.
Интерфейс DsonObject представляет объект или массив, который де­
сериализуется в данный момент. Обнаруживая новые свойства текущего
объекта (простые значения, составные свойства или массивы), парсер вы­
зывает соответствующие методы.
10.2. Рефлексия: интроспекция объектов Kotlin во время выполнения ❖
337
Листинг 10.6. Интерфейс обратных вызовов парсера JSON
interface DsonObject {
fun setSimpleProperty(propertyName: String, value: Any?)
fun createObject(propertyName: String): DsonObject
fun createArray(propertyName: String): DsonObject
}
В параметре propertyName эти методы принимают ключ JSON. То есть,
когда парсер встречает свойство author с объектом в качестве значения,
он вызывает метод createO b ject(" au th or" ). Для свойств с простыми
значениями вызывается метод setSim pleP roperty, которому в аргументе
valu e передается фактическая лексема. Реализации DsonObject отвечают
за создание новых объектов для свойств и сохранение ссылок на них во
внешнем объекте.
На рис. 10.7 показаны входные и выходные данные для каждого этапа
лексического и синтаксического анализа при десериализации строки при­
мера. Еще раз напомним: в ходе лексического анализа входная строка пре­
образуется в список лексем, а затем этот список обрабатывается на этапе
синтаксического анализа (парсинга), и для каждого значимого элемента
вызываются соответствующие методы интерфейса DsonObject.
Собственно десериализация выполняется реализацией DsonObject, ко­
торая постепенно конструирует новый экземпляр соответствующего типа.
В ходе этого процесса нужно определить соответствие между свойствами
класса и ключами JSON ( t i t l e , author и name на рис. 10.7) и создать вло­
женные объекты-значения (например, экземпляр Author), и только после
этого можно создать новый экземпляр требуемого класса (Book).
{"title": "Catch-22", "author": {"name”: "J.Heller"}}
Лексический анализ: JSON-строка разбивается на лексемы
1
"title"
9
9
"Catch-22"
J
"author"
□0
"name "
□
"J.Heller"
}}
Синтаксический анализ (парсинг): обрабатываются различные
семантические элементы
Десериализация: создается и возвращается экземпляр требуемого класса
Рис. 10.7. Парсинг строки в формате JSON: лексический
и синтаксический анализ и десериализация
338 ❖
Глава 10. Аннотации и механизм рефлексии
Библиотека JKid создавалась для работы с классами данных, поэтому все
пары ключ/значение, загруженные из файла JSON, она передает конструк­
тору десериализуемого класса как параметры. Она не поддерживает уста­
новку свойств в экземплярах объектов после их создания. Это означает,
что данные должны где-то храниться до момента создания объекта, пока
происходит чтение файла JSON.
Требование хранить компоненты до создания объекта очень напоми­
нает традиционный шаблон «Строитель» (Builder), с той лишь разницей,
что реализации этого шаблона обычно предназначены для создания объ­
ектов конкретного типа, а наше решение должно быть полностью универ­
сальным. Чтобы было веселее, используем для обозначения реализации
термин «зерно» (seed). Десериализуя формат JSON, мы должны уметь соз­
давать разные составные конструкции: объекты, коллекции и словари.
Классы ObjectSeed, O bjectL istSeed и V alueL istSeed отвечают за созда­
ние объектов и списков составных объектов или простых значений соот­
ветственно. Конструирование словарей мы оставляем вам как упражнение
для самостоятельного решения.
Базовый интерфейс Seed наследует DsonObject и объявляет дополни­
тельный метод spawn («прорастить»), возвращающий созданный экзем­
пляр по окончании процесса конструирования. Он также объявляет метод
createC om positeProperty для создания вложенных объектов и списков
(для их конструирования используется та же базовая логика).
Листинг 10.7. Интерфейс для создания объектов из JSON-файлов
interface Seed: JsonObject {
fun spawn(): Any?
fun createCompositeProperty(
propertyName: String,
isList: Boolean
): DsonObject
override fun createObject(propertyName: String) =
createCompositeProperty(propertyName, false)
override fun createArray(propertyName: String) =
createCompositeProperty(propertyName, true)
II ...
}
Метод spawn можно считать аналогом метода b u ild , возвращающего
окончательное значение. Он возвращает сконструированный объект для
Obj ectS eed или список для Obj e c tL istS e e d или V alueL istSeed. Мы не бу-
10.2. Рефлексия: интроспекция объектов КоШп во время выполнения ❖
339
дем подробно обсуждать, как десериализуются списки, а сосредоточим все
внимание на создании объектов - более сложной и вместе с тем наглядно
демонстрирующей основную идею части.
Но прежде рассмотрим основную функцию d e s e r ia liz e , которая вы­
полняет всю работу по десериализации значения.
Листинг 10.8. Функция десериализации
верхнего уровня
fun <Т: Any> deserialize(json: Reader, targetClass: KClass<T>): T {
val seed = ObjectSeed(targetClass, ClassInfoCacheQ)
Parser(json, seed).parse()
return seed.spawn()
}
Перед началом парсинга создается экземпляр Obj ectS eed для хранения
свойств будущего объекта, а затем вызывается парсер, которому передает­
ся объект j son, читающий входную строку. После обработки входной стро­
ки вызывается функция spawn, которая должна сконструировать оконча­
тельный объект.
Теперь обратим внимание на реализацию Obj ectS eed , который хранит
состояние конструируемого объекта. Obj ectS eed принимает ссылку на це­
левой класс и объект c la s s ln f oCache, хранящий информацию о свойствах
класса. Эта информация позже будет использована для создания экзем­
пляров класса. C lassInfoC ache и C la ssln fo - вспомогательные классы,
которые мы обсудим в следующем разделе.
Листинг 10.9. Десериализация
объекта
class ObjectSeed<out Т: Any>(
targetClass: KClass<T>,
val ClassInfoCache: ClassInfoCache
) : Seed {
private val classlnfo: Classlnfo<T> =
classInfoCache[targetClass]
J
Кэширует информацию, необходимую
для создания экземпляра targetClass
private val valueArguments = mutableMapOf<KParameter, Any?>()
private val seedArguments = mutableMapOf<KParameter, Seed>()
private val arguments: MapcKParameter, Any?>
<—i Созданиесловаряизпараметров
get () = valueArguments +
I конструктораиихзначений
seedArguments.mapValues { it.value.spawnQ }
override fun setSimpleProperty(propertyName: String, value: Any?) {
val param = classlnfo.getConstructorParameter(propertyName)
340 ❖
Глава 10. Аннотации и механизм рефлексии
valueArguments[param] =
<J—
classInfo.deserializeConstructorArgument(param, value)
}
Запись значения для
параметра конструктора,
override fun createCompositeProperty(
если это простое значение
propertyName: String, is L is t: Boolean
): Seed {
val param = classInfo.getConstructorParameter(propertyName)
val deserializeAs <H Загружаетзначениеизаннотации
classInfo.getDeserializeClass(propertyName)
| Deserializelnterface, еслиимеется
val seed = createSeedForType(
Создание ObjectSeed или
deserializeAs ?: param.type.javaType, isList)
CoUectionSeed, в зависимости
от типа параметра...
return seed.apply { $eedArguments[param] = this }
}
override fun spawn(): T =
classlnfo.createlnstance(arguments)
...и запись его в словарь
seedArguments
< П Создание экземпляра targetdass с
' передачей словаря аргументов
O bjectSeed конструирует словарь из параметров конструктора и
их значений. Для этого используются два изменяемых словаря: v a lueArguments для простых значений и seedArguments для составных
значений. Новые аргументы добавляются в словарь valueArguments
вызовом setSim pleP roperty, а в словарь seedArguments - вызовом
createC om positeProperty. Новые составные «зёрна» изначально имеют
пустое значение, а затем заполняются данными, извлекаемыми из входно­
го потока. В заключение метод spawn рекурсивно собирает все сконструи­
рованные «зёрна», вызывая метод spawn каждого из них.
Обратите внимание, что вызов arguments в теле метода spawn за­
пускает рекурсивную процедуру конструирования аргументов: метод
чтения свойства arguments вызывает методы spawn всех аргументов в
seedArguments. Функция createSeedForType анализирует тип парамет­
ра и создает O bjectSeed, O b jectL istS eed или V alueL istSeed, в зависи­
мости от типа параметра. Исследование её реализации мы оставляем вам
в качестве самостоятельного упражнения.
Теперь посмотрим, как функция C la s s ln fo . c r e a te ln sta n c e создает эк­
земпляр ta r g e tC la ss.
10.2.5. Заключительный этап десериализации: caLLByQ
и создание объектов с использованием рефлексии
Последний этап, с которым мы должны разобраться, - как класс
C la ssln fo конструирует окончательный экземпляр и кэширует информа­
цию о параметрах конструктора. Он используется в Obj ectSeed. Но, преж-
10.2. Рефлексия: интроспекция объектов Kotlin во время выполнения ❖
341
де чем углубиться в детали реализации, познакомимся с программным
интерфейсом механизма рефлексии, позволяющим создавать объекты.
Вы уже видели метод « C a lla b le .c a ll, который вызывает функцию
или конструктор, передавая им полученный список аргументов. Этот
метод прекрасно справляется со своей задачей в большинстве случаев,
но имеет существенное ограничение: он не поддерживает параметров
со значениями по умолчанию. В нашем случае, если пользователь пы­
тается десериализовать объект, конструктор которого имеет параметры
со значениями по умолчанию, мы определенно не должны требовать
присутствия соответствующих аргументов в строке JSON. Поэтому ис­
пользуем другой метод, поддерживающий параметры со значениями по
умолчанию: « C a lla b le .c a llB y .
interface KCallable<out R> {
fun callBy(args: Map<KParameter, Any?>): R
}
Метод принимает словарь с параметрами и их значениями, которые
впоследствии будут переданы как аргументы. Если параметр в словаре
отсутствует, будет использовано его значение по умолчанию (если опре­
делено). Также интересно отметить, что параметры необязательно долж­
ны указываться в правильном порядке - можно просто читать пары имя/
значение из JSON, отыскивать соответствующий параметр и добавлять его
значение в словарь.
Единственное, о чем действительно необходимо позаботиться, - выбор
правильного типа. Тип значения в словаре args должен соответствовать
типу параметра в конструкторе - в противном случае возникнет исключе­
ние IllegalA rgum entE xception. Это особенно важно для числовых типов:
мы должны точно знать тип параметра - In t, Long, Double или какой-то
другой простой тип - и преобразовать число из ISON в значение правиль­
ного типа. Для этого используется свойство «Param eter. type.
Преобразование типа выполняется через тот же интерфейс ValueSer ia liz e r , использовавшийся для нестандартной сериализации. Если
свойство не отмечено аннотацией © C ustom Serializer, мы извлекаем
стандартную реализацию для данного типа.
Листинг 10.10. Получение сериализатора по типу значения
fun serializerForType(type: Type): ValueSerializercout Any?>? =
when(type) {
Byte::class.java -> ByteSerializer
Int::class.java -> IntSerializer
Boolean::class.java -> BooleanSerializer
// ...
342 ❖
Глава 10. Аннотации и механизм рефлексии
else -> null
}
Соответствующая реализация V a lu e S e r ia liz e r выполнит необходи­
мую проверку типа или преобразование.
Листинг 10.11. Сериализатор для логических значений
object BooleanSerializer : ValueSerializer<Boolean> {
override fun fromlsonValue(jsonValue: Any?): Boolean {
i f (jsonValue !is Boolean) throw ]KidException("Boolean expected")
return jsonValue
}
override fun toDsonValue(value: Boolean) = value
}
Метод c a l I By дает возможность вызвать основной конструктор объекта
и передать ему словарь с параметрами и соответствующими значениями.
Механизм V a lu e S e r ia liz e r гарантирует, что значения в словаре будут
иметь правильные типы. Теперь посмотрим, как вызвать этот метод.
Цель класса C lassInfoC ache - уменьшить накладные расходы, связан­
ные с использованием механизма рефлексии. Напомним, что аннотации,
управляющие сериализацией и десериализацией (@DsonName ngCustomSer ia liz e r ) , применяются к свойствам, а не к параметрам. Когда произво­
дится десериализация объекта, мы имеем дело с параметрами конструк­
тора, а не со свойствами, поэтому для получения аннотаций необходимо
отыскать соответствующие свойства. Если выполнять такой поиск при из­
влечении каждой пары ключ/значение, это слишком замедлит процесс де­
сериализации, поэтому мы делаем это только один раз для каждого класса
и сохраняем информацию в кэше. Ниже приводится полная реализация
C lassInfoC ache.
Листинг 10.12. Хранилище данных, полученных с помощью механизма рефлексии
class ClassInfoCache {
private val cacheData = mutableMapOf<KClass<*>, Classlnfo<*»()
@Suppress( "UNCHECKED_CAST")
operator fun <T : Any> get(cls: KClass<T>): Classlnfo<T> =
cacheData.getOrPut(cls) { Classlnfo(cls) } as ClassInfo<T>
Здесь используется шаблон, обсуждавшийся в разделе 9.3.6: мы удаляем
информацию о типе, когда сохраняем значения в словаре, но реализация
метода g e t гарантирует, что возвращаемый C la ssln f о<Т> имеет правиль-
10.2. Рефлексия: интроспекция объектов КоШп во время выполнения ❖
343
ный аргумент типа. Обратите внимание на вызов getOrPut: если словарь
cacheData уже хранит элемент для e ls , он вернет этот элемент. Иначе бу­
дет вызвано лямбда-выражение, которое вычислит значение для ключа,
сохранит его в словаре и вернет.
Класс C lass In fo отвечает за создание нового экземпляра целевого клас­
са и кэширование необходимой информации. Чтобы упростить код, мы
опустили некоторые функции и тривиальные операции инициализации.
Также можно заметить, что вместо использования !! готовый код возбуж­
дает исключение с информативным сообщением (вы тоже можете взять на
вооружение этот отличный приём).
Листинг 10.13. Кэширование параметров конструктора и данных из аннотаций
class ClassInfo<T : Any>(cls: KClass<T>) {
private val constructor = cls.primaryConstructor!!
private val j sonNameToParamMap = hashMapOf<String, KParameter>()
private val paramToSerializerMap =
hashMapOf<KParameter, ValueSerializer<out Any?»()
private val jsonNameToDeserializeClassMap =
hashMapOf<String, Class<out Any>?>()
in it {
constructor.parameters.forEach { cacheDataForParameter(cls, it ) }
}
fun getConstructorParameter(propertyName: String): KParameter =
jsonNameToParam[propertyName]!!
fun deserializeConstructorArgument(
param: KParameter, value: Any?): Any? {
val serializer = paramToSerializer[param]
i f (serializer != null) return serializer.fronOsonValue(value)
validateArgumentType(param, value)
return value
}
fun createlnstance(arguments: Map<KParameter, Any?>): T {
ensureAllParametersPresent(arguments)
return constructor.callBy(arguments)
}
//
}
I
t
|
344 ❖
Глава 10. Аннотации и механизм рефлексии
В разделе инициализации этот код отыскивает свойства, соответствую­
щие параметрам конструктора, и извлекает их аннотации. Данные сохра­
няются в трех словарях: j sonNameToParam - определяет параметр, соот­
ветствующий каждому ключу в файле JSON; param T oSerializer - хранит
реализации сериализации для всех параметров; и jsonNameToDeserializ e C la s s - хранит класс, заданный в аргументе аннотации @Deserializ e ln t e r f асе, если имеется. Затем C la ssln fo передает параметры кон­
структора по именам свойств и вызывает код, использующий параметр
как ключ для отображения параметра в аргумент.
Функции cacheDataForParameter, validateArgumentType и ensureA llP aram etersP resent - приватные. Ниже приводится реализация ensureA U Param etersPresent, а код других функций вы можете исследовать
самостоятельно.
Листинг 10.14. Проверка наличия требуемых параметров
private fun ensureAUParametersPresent(arguments: MapcKParameter, Any?>) {
for (param in constructor.parameters) {
i f (arguments[param] == null &&
!param.isOptional && iparam.type.isMarkedNullable) {
throw DKidException("Missing value for parameter ${param.name}")
}
}
}
Эта функция проверяет наличие значений для всех параметров. Обрати­
те внимание, как здесь использован механизм рефлексии. Если параметр
имеет значение по умолчанию, то param. isO p tio n a l принимает значение
tru e и мы можем опустить аргумент для него - в этом случае будет исполь­
зоваться значение по умолчанию. Если тип параметра допускает значе­
ние n u ll (ty p e . isM arkedNullable сообщит об этом), в качестве значения
по умолчанию будет использовано n u ll. Для всех остальных параметров
требуется передать соответствующие аргументы, иначе будет возбуждено
исключение. Кэширование информации, извлеченной с использованием
механизма рефлексии, гарантирует, что поиск аннотаций будет произво­
диться только один раз, а не для каждого свойства, встреченного в JSONданных.
На этом мы завершаем обсуждение реализации библиотеки JKid.
В этой главе мы исследовали библиотеку сериализации/десериализации JSON, реализованную поверх механизма рефлексии и использую­
щую аннотации для управления ее поведением. Все продемонстриро­
ванные приёмы и подходы вы можете успешно использовать в своих
фреймворках.
10.3. Резюме ❖
345
10.3. Резюме
о
о
о
о
о
о
о
о
о
о
о
о
Синтаксис применения аннотаций в Kotlin практически неотличим
от Java.
Kotlin позволяет применять аннотации к более широкому кругу эле­
ментов, чем Java, включая файлы и выражения.
Аргумент аннотации может быть значением простого типа, строкой,
перечислением, ссылкой на класс, экземпляром класса другой анно­
тации или их массивом.
Определяя целевой элемент аннотаций в месте использования, на­
пример @get: Rule, можно указать, к какому элементу применяется
аннотация, если единственное объявление на Kotlin порождает не­
сколько элементов в байт-коде.
Класс аннотации объявляется как класс с основным конструктором,
не имеющим тела, все параметры которого являются va I -свойствами.
С помощью метааннотаций можно определить цель, режим сохране­
ния и другие атрибуты аннотаций.
Механизм рефлексии позволяет перебирать и обращаться к мето­
дам и свойствам объектов во время выполнения. Он имеет интер­
фейсы, представляющие разные виды объявлений, такие как классы
(KClass), функции («Function) и так далее.
Получить экземпляр «C lass можно с помощью ClassNam e:: c la s s ,
если класс заранее известен, или obj . javaC lass .k o tlin , чтобы по­
лучить класс из экземпляра объекта.
Оба интерфейса, «Function и «Property, наследуют «C allab le, кото­
рый определяет обобщенный метод c a ll.
Для вызова методов, имеющих параметры со значениями по умол­
чанию, можно использовать метод « C a lla b le . callB y.
«Function©, KFunctionl и так далее - это функции с разным коли­
чеством параметров, которые можно использовать для вызова м е­
тодов.
«Property© и KPropertyl - это свойства с разным количеством при­
емников. Они поддерживают метод g e t для получения значения.
KMutableProperty© и KM utablePropertyl наследуют эти интерфей­
сы для поддержки свойств, позволяющих изменять значения вызо­
вом метода s e t.
Глава
Конструирование DSL
В этой главе:
создание предметно-ориентированных языков;
использование лямбда-выражений с получателями;
применение соглашения invoke;
примеры существующих предметно-ориентированных язы
ков на Kotlin.
В этой главе мы обсудим подходы к проектированию выразительных и
идиоматичных программных интерфейсов (API) классов на языке Kotlin
с использованием предметно-ориентированных языков (Domain-Specific
Languages, DSL). Исследуем различия между традиционными и DSL-ориентированными API и посмотрим, как можно применять DSL-ориентированные API для решения широкого круга практических задач: операций
с базами данных, динамического создания страниц HTML, тестирования,
создания сценариев сборки, определения макетов пользовательского ин­
терфейса для Android и многих других.
Проектирование предметно-ориентированных языков в Kotlin опирает­
ся на многие возможности языка, две из которых мы пока не исследовали
полностью. С одной из них мы уже сталкивались в главе 5: лямбда-выра­
жения с получателями, которые дают возможность создать структуру DSL,
изменяя правила разрешения имен в блоках кода. Другая - новая для вас:
соглашение invoke, позволяющее более гибко комбинировать лямбда-вы­
ражения и операции присваивания значений свойствам в коде DSL. В этой
главе мы детально исследуем обе эти особенности.
11.1. От API к DSL
Прежде чем углубиться в обсуждение предметно-ориентированных язы­
ков, обсудим задачу, стоящую перед нами. Наша конечная цель - достичь
11.1. От API к DSL ❖
347
максимальной читаемости и выразительности кода. Этой цели невозмож­
но достичь, если всё внимание сосредоточить только на отдельных клас­
сах. Большая часть кода в классах взаимодействует с другими классами,
поэтому мы должны уделить внимание интерфейсам, через которые про­
текают взаимодействия, или, иными словами, программным интерфей­
сам классов.
Важно помнить, что создание выразительных и удобных API - прерога­
тива не только создателей библиотек, но и каждого разработчика. Подобно
библиотекам, предоставляющим программные интерфейсы для их исполь­
зования, каждый класс в приложении предоставляет другим классам воз­
можность взаимодействовать с ним. Удобство и выразительность взаимо­
действий помогут обеспечить простоту сопровождения проекта в будущем.
В ходе чтения этой книги вы познакомились со множеством особенно­
стей Kotlin, которые позволяют создавать ясные API для классов. Но что
имеется в виду под выражением «ясный API»? Две вещи:
О читателям кода должно быть ясно, что он делает. Этого можно до­
биться, выбирая говорящие имена и понятия (что справедливо для
кода на любом языке программирования);
О код должен выглядеть прозрачным, простым и не перегруженным
избыточными синтаксическими конструкциями. То, как достичь
этой цели, - основное содержание этой главы. Ясный API порой даже
может не отличаться от встроенных особенностей языка.
В число особенностей Kotlin, помогающих создавать ясные API, вхо­
дят: функции-расширения, инфиксные вызовы, сокращенный синтаксис
лямбда-выражений и перегрузка операторов. В табл. 11.1 демонстрирует­
ся, как они помогают уменьшить синтаксическую нагрузку на код.
Таблица 11.1. Особенности Kotlin для поддержки ясного синтаксиса
Обычный синтаксис
Улучшенный синтаксис
s>..'.
S tr in g U til.c a p ita liz e ( s )
s .c a p it a liz e ( )
Функция-расширение
l.to (" o n e " )
1 to "one"
Инфиксный вызов
set.a d d (2 )
s e t += 2
Перегрузка операторов
map.get("key")
тар[пкеуи]
Соглашение о вызове
метода get
file .u s e ({ f -> f.r e a d Q } )
file.u se { it.r e a d Q
Лямбда-выражения вне
круглыхскобок
sb.append("yes")
sb.append("no")
with (sb ) {
append("yes")
append("no")
Лямбда-выражения с
получателем
348 ❖
Глава И . Конструирование DSL
В этой главе мы выйдем за рамки определения ясных API и познакомимся
с поддержкой создания предметно-ориентированных языков в Kotlin. Эта
поддержка основывается на особенностях, помогающих создавать ясные
API, и дополняет их возможностью создания структур из вызовов несколь­
ких методов. Получающиеся в результате предметно-ориентированные
языки могут быть более выразительными и удобными, чем программные
интерфейсы, сконструированные из отдельных вызовов методов.
Так же как другие особенности, поддержка DSL в Kotlin является пол­
ностью статически типизированной и включает все преимущества стати­
ческой типизации, такие как выявление ошибок на этапе компиляции и
улучшенная поддержка в IDE.
Чтобы вы могли получить общее представление, ниже приводится пара
примеров, демонстрирующих возможности поддержки DSL в Kotlin. Сле­
дующее выражение возвращает предыдущий день (точнее, всего лишь его
дату):
val yesterday = 1.days.ago
а эта функция генерирует HTML-таблицу:
fun createSimpleTable() = createHTML().
table {
tr {
td { +"ceU" }
}
}
В данной главе вы узнаете, как устроены эти примеры. Но, перед тем как
углубиться в детали, давайте выясним, что же такое эти предметно-ориен­
тированные языки.
11.1.1. Понятие предметно-ориентированного языка
Понятие предметно-ориентированного языка появилось почти одно­
временно с понятием языка программирования как такового. Мы разли­
чаем языки программирования общего назначения, обладающие достаточно
полным набором возможностей для решения практически любых задач с
использованием компьютера, и предметно-ориентированные языки (Do­
main-Specific Language, DSL), ориентированные на решение задач из од­
ной конкретной предметной области и не обладающие средствами для
решения любых других задач.
Типичные примеры предметно-ориентированных языков, с которыми
вы наверняка знакомы, - SOL и регулярные выражения. Они прекрасно
приспособлены для решения узкого круга задач управления базами дан­
ных и текстовыми строками соответственно, но у вас не получится на­
писать на них целое приложение. (По крайней мере, мы на это надеемся.
11.1. От API к DSL ❖
349
Даже мысль о том, что кто-то может написать целое приложение на языке
регулярных выражений, вызывает у нас дрожь.)
Заметьте, как в этих языках увеличивается эффективность в достиже­
нии цели за счет ограничения их технических возможностей. Когда нужно
выполнить SQL-запрос, мы не пишем определение, класса или функции, а
используем конкретное ключевое слово, которое определяет тип запроса и
предполагает определенный синтаксис и набор сопутствующих ключевых
слов. Язык регулярных выражений обладает ещё более узким кругом син­
таксических конструкции: программа непосредственно описывает, какой
текст будет совпадать с шаблоном, и использует компактный синтаксис из
знаков препинания, чтобы показать, какие отличия в совпавшем тексте
могут считаться допустимыми. Благодаря такому компактному синтакси­
су на DSL можно более кратко выразить предметную операцию, чем на
языке общего назначения.
Другая важная особенность предметно-ориентированных языков - их
стремление к декларативному синтаксису, тогда как языки общего назна­
чения в большинстве случаев императивные. Императивный язык опи­
сывает последовательность действий, которые требуется выполнить для
завершения операции, а декларативный язык описывает желаемый ре­
зультат, оставляя детали его получения на усмотрение движка, который
интерпретирует код на этом языке. Благодаря этому часто можно повы­
сить эффективность кода, потому что все необходимые оптимизации реа­
лизуются только один раз - в исполняющем движке. Императивный под­
ход, напротив, требует оптимизировать каждую операцию отдельно.
В противовес всем этим достоинствам предметно-ориентированные
языки имеют один существенный недостаток: код на этих языках сложно
встраивать в приложения, написанные на языках общего назначения. Они
имеют свой отличительный синтаксис, который нельзя напрямую исполь­
зовать в программах на другом языке. Поэтому, чтобы вызвать програм­
му, написанную на предметно-ориентированном языке, ее приходится со­
хранять в отдельном файле или встраивать в основную программу в виде
строкового литерала. Это существенно усложняет проверку правильности
взаимодействий DSL с основным языком на этапе компиляции, отладку
программ на DSL и поддержку в IDE. Кроме того, отличительный синтаксис
требует дополнительных знаний и часто делает код трудным для чтения.
Чтобы решить эту проблему и сохранить основные преимущества DSL,
недавно была предложена идея внутренних предметно-ориентированных
языков. Давайте посмотрим, в чем она заключается.
11.1.2. Внутренние предметно-ориентированные языки
В противоположность внешним DSL, обладающим собственным синтак­
сисом, внутренние DSL - это часть программы, написанная на языке обще-
350 ❖
Глава 11. Конструирование DSL
го назначения и имеющая точно такой же синтаксис. То есть внутренний
DSL нельзя считать полностью независимым языком - скорее, это иной
способ использования основного языка с сохранением преимуществ, при­
сущих предметно-ориентированным языкам.
Для сравнения посмотрим, как одну и ту же задачу можно решить с по­
мощью внешнего и внутреннего DSL. Представьте, что в нашей базе дан­
ных есть две таблицы, Customer и Country, причём каждая запись в Cus­
tomer ссылается на запись в таблице Country, которая определяет страну
проживания клиента. Наша задача: определить страну, где живет боль­
шинство наших клиентов. В качестве внешнего DSL будем использовать
SQL, а в качестве внутреннего - язык, реализованный в фреймворке Ex­
posed (https: //github.com/3etBrains/Exposed), написанном на языке
Kotlin и предназначенном для доступа к базам данных. Вот как выглядит
решение на языке SQL:
SELECT Country.name, COUNT(Customer.id)
FROM Country
JOIN Customer
ON Country.id = Customer.country_id
GROUP BY Country.name
ORDER BY COUNT(Customer.id) DESC
LIMIT 1
Мы не можем просто вставить код SQL в программу: нам нужен не­
который механизм, поддерживающий взаимодействия между кодом на
основном языке приложения (в данном случае Kotlin) и кодом на языке
запросов. Обычно лучшее, на что можно рассчитывать, - это поместить
SQL-запрос в строковый литерал и надеяться, что наша IDE поможет на­
писать и проверить его.
Для сравнения ниже приводится тот же запрос, сконструированный с
использованием возможностей Kotlin и Exposed:
(Country join Customer)
.sIice(Country.name, Count(Customer.id ))
.selectAll()
.groupBy(Country.name)
.orderBy(Count(Customer.id), isAsc = false)
.lim it(l)
Как видите, эти две версии довольно схожи. Фактически вторая вер­
сия генерирует и выполняет тот же SQL-запрос, что мы написали вруч­
ную, но она написана на языке Kotlin, a s e le c t A ll, groupBy, orderBy и
другие инструкции являются обычными методами. Кроме того, нам не
нужно тратить времени и сил на преобразование данных, возвращаемых
SQL-запросом, в объекты Kotlin - они сразу возвращаются в виде самых
обычных объектов Kotlin. Итак, внутренним DSL мы называем код, пред-
11.1. От API к DSL ❖
351
назначенный для решения конкретной задачи (конструирования SQLзапросов) и реализованный в виде библиотеки на языке общего назначе­
ния (Kotlin).
11.1.3. Структура предметно-ориентированных языков
Вообще говоря, не существует четких границ между DSL и обычным API,
и часто критерием становится субъективное мнение: «Для меня этот код
выглядит как код на предметно-ориентированном языке». Предметно­
ориентированные языки очень часто опираются на те особенности языков
программирования, которые широко используются в других контекстах,
например инфиксные вызовы и перегрузка операторов. Но помимо этого,
предметно-ориентированные языки часто обладают характерной чертой,
отсутствующей в других API: структурой, или грамматикой.
Типичная библиотека состоит из множества методов, и использующий
её клиент вызывает эти методы по одному. Последовательности вызовов
методов не имеют предопределенной структуры, а контекст выполняемых
операций не сохраняется между вызовами. Такие API иногда называют ко­
мандными API. Напротив, вызовы методов в DSL образуют более крупные
структуры, определяемые грамматикой DSL. В Kotlin структура DSL обыч­
но создается с применением вложенных лямбда-выражений или цепочек
из вызовов методов. Это видно в предыдущем примере: чтобы выполнить
запрос, необходимо вызвать комбинацию методов, описывающих разные
аспекты требуемого набора результатов, и такая комбинация читается
проще, чем единственный вызов, принимающий все необходимые для
создания запроса аргументы.
Наличие грамматики - вот что позволяет нам называть внутренний DSL
языком. В естественных языках, таких как английский или русский, пред­
ложения составляются из слов, с учетом определенных грамматических
правил, диктующих порядок объединения этих слов. Аналогично в DSL
единственная операция может состоять из нескольких вызовов функций,
а проверка типов в компиляторе гарантирует их объединение в осмыс­
ленные конструкции. В результате функциям обычно даются имена-гла­
голы (groupBy, orderBy)1, а их аргументы играют роль существительных
(Country. name).
Одно из преимуществ наличия структуры в DSL - она позволяет исполь­
зовать общий контекст в нескольких вызовах функций, не воссоздавая его
заново в каждом вызове. Это иллюстрирует следующий пример, демон­
стрирующий описание зависимостей в сценариях сборки Gradle (h ttp s : / /
qithub.com/gradle/qradle-script-kotlin):
dependencies {
compile("ju n it:ju n it:4 .11")
1
Сгруппировать, упорядочить. - Прим. ред.
< H Структура формируется вложенными
| лямбда-выражениями
❖
Глава 11. Конструирование DSL
compile("com.google.in je ct:guice:4.1.0")
}
Для сравнения ниже приводится реализация тех же операций с исполь­
зованием обычного командного API. Обратите внимание, как много по­
вторений возникает в этом коде:
project.dependencies.add("compile", "ju n it:ju n it:4 .11")
project.dependencies.add("compile", "com.google.in je c t:guice:4.1.0")
Составление цепочек из вызовов методов - еще один способ создания
структуры в DSL. Этот приём широко используется в фреймворках тести­
рования для разбития проверки на несколько вызовов методов. Такие
проверки легче читаются, особенно если используется инфиксный син­
таксис вызовов. Следующий пример взят из kotlintest (h ttp s : / / g i t h u b .
c o m / k o t l i n t e s t / k o t l i n t e s t l . стороннего фреймворка тестирования для
Kotlin, который мы обсудим в разделе 11.4.1:
str should startWith("kot")
<Н Структураформируется
| цепочкой из вызовов методов
Обратите внимание, насколько сложнее воспринимается та же проверка
на JUnit API, перегруженная излишними синтаксическими элементами:
assertTrue( s tr. startsWith( "kot11))
Теперь рассмотрим пример внутреннего DSL более подробно.
11.1.4. Создание разметки HTML с помощью
внутреннего DSL
Чтобы пробудить ваш интерес, в начале этой главы мы привели фраг­
мент кода на предметно-ориентированном языке, предназначенном для
конструирования разметки HTML. В этом разделе мы обсудим этот язык
более подробно. Программный интерфейс, описываемый здесь, реализует
библиотека kotlinx.html (h t t p s : / / g i t h u b . c o m / K o t l i n / k o t l i n x . h t m l ). Вот
маленький фрагмент, создающий таблицу с единственной ячейкой:
fun createSimpleTable() = createHTML().
table {
tr {
td { +"cell" }
}
}
Очевидно, что предыдущая структура создает следующую HTML-таблицу:
<table>
<tr>
<td>cell</td>
11.1. От API к DSL ❖
353
</tr>
</table>
Функция createSim pleT able возвращает строку с HTML-таблицей.
Почему предпочтительнее создавать разметку HTML в коде на Kotlin,
а не хранить ее в отдельном файле? Во-первых, Kotlin-версия гаранти­
рует безопасность типов: вы сможете использовать тег td только внутри
тега tr ; в противном случае код просто не скомпилируется. Но, что осо­
бенно важно, это самый обычный программный код, и в нём можно ис­
пользовать любые конструкции языка. То есть такой подход позволяет
создавать ячейки динамически (например, для отображения элементов
словаря) в том же месте, где определена таблица:
fun createAnotherTable() = createHTML() .table {
val numbers = mapOf(l to "one", 2 to "two")
for ((num, string) in numbers) {
tr {
td { +"$num" }
td { +string }
}
}
Сгенерированная в результате разметка HTML будет содержать желае­
мые данные:
<table>
< tr>
<td>l</td>
<td>one</td>
</tr>
<tr>
<td>2</td>
<td>two</td>
</tr>
</table>
HTML - канонический пример языка разметки, который прекрасно под­
ходит для иллюстрации идеи. Но тот же подход можно использовать для
любого языка с похожей структурой, такого как XML. Чуть ниже мы обсу­
дим, как работает такой код в Kotlin.
Теперь, когда мы узнали, что такое предметно-ориентированный язык
и зачем он может понадобиться, давайте посмотрим, как Kotlin помогает
создавать такие языки. Для начала детальнее рассмотрим лямбда-выра­
жения с получателями - ключевую особенность, помогающую построить
грамматику DSL.
354 ❖
Глава 11. Конструирование DSL
11.2. Создание структурированных API:
лямбда-выражения с получателями в DSL
Лямбда-выражения с получателями - мощная особенность Kotlin, позво­
ляющая конструировать API с определенной структурой. Как уже говори­
лось, наличие структуры - один из ключевых аспектов, отличающих пред­
метно-ориентированные языки от обычных программных интерфейсов.
Исследуем эту особенность детальнее и познакомимся с некоторыми ис­
пользующими её предметно-ориентированными языками.
11.2.1. Лямбда-выражения с получателями и типы
функций-расширений
Лямбда-выражения с получателями коротко рассматривались в раз­
деле 5.5, где были представлены функции b u ild S tr in g , w ith и apply из
стандартной библиотеки. Теперь на примере функции b u ild S trin g нам
предстоит узнать, как они реализованы. Эта функция позволяет конструи­
ровать строки из фрагментов, по очереди добавляемых в S trin gB u ild er.
Для начала обсуждения определим функцию b u ild S trin g , которая при­
нимает аргумент с обычным лямбда-выражением. Похожий пример вы
уже видели в главе 8, поэтому следующее определение не станет для вас
новинкой.
Листинг 11.1. Определение buildString, которая принимает аргумент
с лямбда-выражением
fun buildString(
builderAction: (StringBuilder) -> Unit <H Объявление параметра
): String {
I с типом функции
val sb = StringBuilder()
builderAction(sb)
<H Передача StringBuilder лямбда-выражению,
return sb.toString()
I полученному в качестве артумента
}
»> val s = buildString {
it.append("Hello, ")
i t . append( "World!")
* * *
< H Ссылка«й»указывает
| на экземпляр StringBuilder
}
»> println(s)
Hello, World!
Этот код легко понять, но пользоваться такой функцией сложнее, чем
хотелось бы. Обратите внимание, что мы вынуждены использовать i t в
теле лямбда-выражения для ссылки на экземпляр S trin g B u ild er (мы мог­
ли бы определить свой, именованный параметр и использовать его вместо
11.2. Создание структурированных API: лямбда-выражения с получателями в DSL ❖
355
i t , но это не избавит нас от ненужной работы). Главная задача лямбда-вы­
ражения - заполнить S trin g B u ild er текстом. Поэтому хотелось бы как-то
избавиться от необходимости повторять ссылку i t . и получить возмож­
ность вызывать методы S trin g B u ild er непосредственно, заменив i t . ap­
pend простым вызовом append.
Для этого мы должны преобразовать лямбда-выражение в лямбда-вы­
ражение с получателем. Так мы сможем придать одному из параметров
лямбда-выражения специальный статус получателя и ссылаться на его
члены непосредственно, без всякого квалификатора. Следующий листинг
показывает, как этого добиться.
Листинг 11.2. Определение b u ild S trin g , которая принимает лямбда-выражение
с получателем
fun buildString(
builderAction: StringBuilder.() -> Unit
< П Объявление параметра с типом
) : String {
I функции с получателем
val sb = StringBuilderQ
sb.builderAction()
<*~\ Передача StringBuilder лямбда-выражению
return sb.toStringQ
I в качестве получателя
}
»> val s = buildString {
this.append("Hello,
append("World!")
J
Ключевое слово «this» ссылается
на экземпляр StringBuilder
... }
»> println(s)
Hello, World!
Обсудим различия между листингами 11.1 и 11.2. Прежде всего обратите
внимание, насколько проще стало пользоваться функцией b u ild S trin g .
Теперь мы можем передать лямбда-выражение с получателем и избавить­
ся от ссылки i t в его теле. Мы заменили вызов i t . append( ) на append().
Полная форма вызова теперь имеет вид t h i s . append( ), но, как и в случае с
обычными членами класса, явная ссылка t h is , как правило, нужна только
для устранения неоднозначности.
Теперь рассмотрим изменения в объявлении функции b u ild S trin g . Для
параметра мы указали тип функции-расширения вместо обычного типа
функции. Чтобы объявить, что параметр имеет тип функции-расширения,
мы должны вынести один из параметров этого типа функции за круглые
скобки и расположить его перед ними, отделив точкой от остальной ча­
сти объявления типа. В листинге 11.2 мы заменили (S tr in g B u ild e r ) ->
U nit на S tr in g B u ild e r .( ) -> U nit. Этот специальный тип называется
типом получателя (receiver type), а значение этого типа, что передается в
356 ❖
Глава 11. Конструирование DSL
лямбда-выражение, - объектом-получателем (receiver object). На рис. 11.1
показано более сложное объявление типа функции-расширения.
Тип получателя Типы параметров;Тип возвращаемого
значения
^
Г
'i
String.(Int, Int) -> Unit
Рис. 11.1. Тип функции-расширения с получателем типа String,
двумя параметрами типа Int и возвращаемым значением типа Unit
Почему именно тип функции-расширения? Идея доступа к членам
внешнего типа без явного использования квалификатора напоминает
поддержку функций-расширений, которая позволяет определять свои
методы для классов, объявленных где-то ещё. Функции-расширения и
лямбда-выражения с получателем получают объект-получатель, который
должен быть передан в вызов функции и доступен в её теле. Фактически
тип функции-расширения описывает блок кода, который можно вызвать
как функцию-расширение.
Способ вызова лямбда-выражения также изменился после того, как мы
заменили обычный тип функции типом функции-расширения. Теперь
лямбда-выражение вызывается не как обычная функция, получающая
объект в аргументе, а как функция-расширение. Обычное лямбда-выраже­
ние получало экземпляр StringBuilder в аргументе, и мы вызывали его,
используя синтаксис bui IderAct ion (sb ). При использовании лямбда-вы­
ражения с получателем его вызов приобрел вид sb.builderAction().
Повторим ещё раз: builderAct ion не является методом, объявленным в
классе StringBuilder, - это параметр, имеющий тип функции, который
вызывается с применением того же синтаксиса, что используется для
функций-расширений.
На рис. 11.2 показано соответствие между аргументом и параметром
функции b u ild S trin g . Он также иллюстрирует объект-получатель, для
которого вызывается тело лямбда-выражения.
buildString { this.append("!") }
1
1
1----- ------1
fun buildString(builderAction: StringBuilder.() -> Unit): String {
val sb = StringBuilder()
.builderAction()
}
Рис. 11.2. Аргумент функции buildString (лямбда-выражение с получателем)
соответствует параметру типа функции-расширения (builderAction);
когда вызывается тело лямбда-выражения, получатель (sb)
превращается в неявный получатель (this)
11.2. Создание структурированных API: лямбда-выражения с получателями в DSL
357
Также можно объявить переменную с типом функции-расширения, как
показано в листинге 11.3. В результате появится возможность вызывать её
как функцию-расширение или передавать как аргумент в вызов функции,
принимающей лямбда-выражение с получателем.
Листинг 11.3. Сохранение лямбда-выражения с получателем в переменной
val appendExcl : StringBuilder.() -> Unit =
{ this.append("!") }
appendExcl - это значение, имеющее
I тип функции-расширения
<i~ \
»> val StringBuilder = StringBuilder("Hi")
»> StringBuilder.appendExcl()
»> println(stringBuilder)
»> println(buildString(appendExcl))
!
< *- | appendExcl можно вызвать
I как функцию-расширение
appendExcl можно также
I передать как аргумент
<H
Обратите внимание, что в исходном коде лямбда-выражение с получате­
лем выглядит в точности как обычное лямбда-выражение. Чтобы увидеть,
есть ли у лямбда-выражения получатель, нужно рассмотреть функцию,
принимающую лямбда-выражение: её сигнатура сообщит, есть ли получа­
тель у лямбда-выражения и какого типа. Например, можно посмотреть на
объявление функции b u ild S tr in g или заглянуть в документацию в своей
IDE, увидеть, что она принимает лямбда-выражение типа S tr in g B u ild e r .
( ) -> U nit, и сделать вывод, что в теле лямбда-выражения можно вызы­
вать методы S trin g B u ild e r без квалификатора.
Реализация b u ild S tr in g в стандартной библиотеке короче, чем в лис­
тинге 11.2. Вместо явного вызова b u ild erA ction она передает аргумент
функции apply (с которой мы познакомились в разделе 5.5). Это позволяет
сократить определение функции до одной строки:
fun buildString(builderAction: StringBuilder.() -> Unit): String =
StringBuilder( ) .apply(builderAction).toString()
Функция apply фактически принимает объект, для которого произведен
вызов (в данном случае новый экземпляр S trin gB u ild er), и использует
его в качестве неявного получателя для вызова функции или лямбда-вы­
ражения, переданного в аргументе (b u ild erA ction в данном примере).
В разделе 5.5 мы познакомились с ещё одной интересной функцией из
стандартной библиотеки: w ith. Давайте исследуем их реализации:
inline fun <Т> Т.apply(block: Т.() -> Unit): Т {
blockQ
Эквивалентно вызову thi$.block0; вызывает
лямбда-выражение с получателем функции
return this < H Возвращает
объект-получатель
«apply» в качестве объекта-получателя
358 ❖
Глава 11. Конструирование DSL
inline fun <T, R> with (receiver: T, block: T.() -> R): R =
receiver.block()
I Возвращаетрезультат
< l J вы зова лям бда-вы раж ения
Попросту говоря, функции apply и w ith просто вызывают аргумент с
типом функции-расширения на заданном получателе. Функция apply
объявлена как расширение типа получателя, тогда как w ith принимает
получателя в первом аргументе. Кроме того, apply возвращает сам объ­
ект-получатель, a w ith возвращает результат вызова лямбда-выражения.
Если результат не имеет значения, эти функции можно считать взаимо­
заменяемыми:
»> val map = mutableMapOf(1 to "one")
»> map.apply { this[2] = "two"}
»> with (map) { this[3] = "three" }
»> println(map)
{l=one, 2=two, 3=three}
Функции w ith и apply широко используются в Kotlin, и мы надеемся,
что вы уже оценили их удобство в вашем собственном коде.
Мы ещё раз подробно рассмотрели лямбда-выражения с получателем
и поговорили о типах функций-расширений. Теперь посмотрим, как они
используются в контексте предметно-ориентированных языков.
11.2.2. Использование лямбда-выражений с получателями
в построителях разметки HTML
Kotlin DSL для HTML, или «предметно-ориентированный язык для
создания разметки HTML», обычно называют построителем HTML, и он
представляет более общее понятие типизированных построителей. Впер­
вые идея построителей завоевала большую популярность в сообществе
Groovy (www. g r o o v y - la n g . o r g / d s I s . h tm l# b u iI d e r s ) . Построители дают
возможность создавать иерархии объектов декларативным способом, ко­
торый хорошо подходит для создания XML или размещения компонентов
пользовательского интерфейса.
В Kotlin используется та же идея, но построители на Kotlin типизирован­
ные. Это делает их более удобными в использовании, безопасными и в не­
котором смысле более привлекательными, чем динамические построите­
ли в Groovy. Давайте посмотрим, как построители HTML работают в Kotlin.
Листинг 11.4. Создание простой HTML-таблицы с помощью построителя на Kotlin
fun createSimpleTable() = createHTML().
table {
tr {
11.2. Создание структурированных API: лямбда-выражения с получателями в DSL ❖
359
td { +"ceU" }
}
}
Это обычный код на языке Kotlin, а не специальный язык шаблонов или
что-то подобное: ta b le , t r и td - это всего лишь функции. Все они - функ­
ции высшего порядка и принимают лямбда-выражения с получателями.
Важно отметить, что лямбда-выражения изменяют правила разрешения
имен. В лямбда-выражении, переданном в функцию ta b le , можно исполь­
зовать функцию t r , чтобы создать HTML-тег <tr>. За пределами этого
лямбда-выражения функция t r будет недоступна. Аналогично функция td
доступна только внутри t г. (Обратите внимание, как дизайн API вынужда­
ет следовать правилам грамматики языка HTML.)
Контекст разрешения имен в каждом блоке определяется типом получа­
теля каждого лямбда-выражения. Лямбда-выражение, передаваемое в вы­
зов ta b le , получает получатель специального типа TABLE, который опре­
деляет метод tr . Аналогично функция t r ожидает лямбда-расширения
типа TR. Следующий листинг - значительно упрощенное представление
объявлений этих классов и методов.
Листинг 11.5. Определение классов тегов для построителя разметки HTML
open class Tag
class TABLE : Tag {
fun tr ( in it : TR.Q -> Unit)
}
class TR : Tag {
fun td (in it : TD.Q -> Unit)
J
Функция tr принимает лямбда-выражение
с приемником типа TR
J
Функция td принимает лямбда-выражение
с приемником типа TD
}
class TD : Tag
TABLE, TR и TD - это вспомогательные классы, которые не должны явно
появляться в коде, и именно поэтому их имена состоят только из заглав­
ных букв. Все они наследуют суперкласс Tag. Каждый класс определяет
методы для создания допустимых тегов: класс TABLE, кроме других, опре­
деляет метод t r , а класс TR определяет метод td.
Обратите внимание на типы параметров i n i t функций t r и td: это
функции-расширения TR. ( ) -> U nit и TD. ( ) -> U nit. Они определяют
типы получателей в лямбда-выражениях: TR и TD соответственно.
Чтобы было понятнее, мы можем переписать листинг 11.4, сделав все
получатели более явными. Напомним, что обратиться к получателю
лямбда-выражения, которое передается функции f оо, можно как tbis@ foo.
360 ❖
Глава 11. Конструирование DSL
Листинг 11.6. Явное использование получателей в вызовах построителя HTML
fun createSimpleTable() = createHTML().
table {
I this@tableимеет
(thisgtable).tr {
<H mnTABLE
(th isg tr).td {
0- . this@trимеет
+"ceU" о -. Здесьдоступеннеявный
I ranTR
}
| получательthis@tdтипаTD
}
}
Если вместе с построителем попытаться использовать обычное
лямбда-выражение вместо лямбда-выражения с получателем, синтаксис
может стать нечитаемым, как в примере выше. Вам пришлось бы исполь­
зовать ссылку i t для вызова методов создания тегов или присваивать имя
параметру в каждом лямбда-выражении. Возможность использовать не­
явный получатель и скрыть ссылку t h is делает синтаксис построителей
компактнее и более похожим на оригинальную разметку HTML.
Обратите внимание, что если лямбда-выражение с получателем по­
местить в другое лямбда-выражение (как в листинге 11.6), то получа­
тель внешнего лямбда-выражения останется доступным во вложенных
лямбда-выражениях. Например, в лямбда-выражении, которое передает­
ся как аргумент функции td , доступны все три получателя (th is g ta b le ,
this@ tr, this@ td). Но в версии Kotlin 1.1 появится возможность исполь­
зовать аннотацию ©DslMarker для ограничения доступности внешних по­
лучателей.
Итак, мы знаем, как синтаксис построителей HTML зависит от лямбда-вы­
ражений с получателями. Теперь обсудим, как генерируется желаемая разметка.
В листинге 11.6 использована функция, объявленная в библиотеке
kotlinx.html. Далее мы реализуем более простую версию библиотеки по­
строителя HTML: для этого расширим объявления тегов TABLE, TR и TD и
добавим поддержку для создания окончательной разметки. Точка входа
для этой упрощенной версии создает HTML-тег <t able> вызовом функции
ta b le .
Листинг 11.7. Создание разметки HTML в виде строки
fun createTableQ =
table {
tr {
td {
}
}
11.2. Создание структурированных API: лямбда-выражения с получателями в DSL ❖
361
}
»> println(createTable())
<table><tr><td></tdx/trx/table>
Функция ta b le создает новый экземпляр тега TABLE, инициализирует
(вызывая функцию, переданную в параметре in i t ) и возвращает его:
fun ta b le (in it: TABLE.() -> Unit) = TABLE().apply(init)
Внутри createT ab le в функцию ta b le передается лямбда-выражение,
содержащее вызов функции tr . Вот как можно переписать этот вызов, что­
бы неявное сделать явным: t a b l e ( i n i t = { t h i s . t r { . . . } } ) . Функция
t r будет вызвана как метод вновь созданного экземпляра TABLE - как если
бы мы записали его так: TABLE( ) . t r { . . . }.
В этом коротком примере <table> - это тег верхнего уровня, а осталь­
ные вложены в него. Каждый тег хранит список ссылок на своих потомков.
Поэтому функция t r должна не только инициализировать новый экзем­
пляр тега TR, но также добавить его в список потомков внешнего тега.
Листинг 11.8. Определение функции создания тега
fun tr ( in it: TR.() -> Unit) {
val t r = TR()
tr .in it( )
children.add(tr)
}
Такая логика инициализации тега и добавления его в список потомков
внешнего тега характерна для всех тегов, поэтому её можно выделить в от­
дельную функцию-член d o ln it суперкласса Tag. Функция d o ln it отвечает
за две операции: сохранение ссылки на дочерний тег и вызов лямбда-вы­
ражения, полученного в аргументе. Другие теги будут просто вызывать её:
например, функция t r создает новый экземпляр класса TR и затем пере­
дает его функции doln i t вместе с лямбда-выражением в аргументе in i t :
doInit(T R ( ) , i n i t ) . В листинге 11.9 приводится полный пример, демон­
стрирующий создание желаемой разметки HTML.
Листинг 11.9. Полная реализация простого построителя HTML
open class Tag(val name: String) {
private val children = mutableListOf<Tag>()
| ХранитBte
вложенныетега
protected fun <T : Tag> doInit(child: T, in it: T.() -> Unit) {
c h ild .in it()
о — Инициализациядочернеготега
362 ❖
Глава 11. Конструирование DSL
children.add(child)
}
override fun toString() =
"<$name>${children. joinToString("" )}</$name>"
}
< н Возвратполучившейся
| разметкиввидестроки
fun ta b le (in it: TABLE.() -> Unit) = TABLEQ.apply(init)
class TABLE : Tag("table") {
fun tr ( in it: TR.() -> Unit) = doInit(TR(), in it)
}
class TR : TagC'tr") {
fun td (in it: TD.() -> Unit) = doInit(TD(), in it)
}
< H Создает и инициализирует
| тег Ш и добавляет его в
список потомков TABLE
< Н Добавляет новый экземпляр ТО
| в список потомков TR
class TD : Tag("td")
fun createTableQ =
table {
tr {
td {
}
}
}
»> println(createTable())
<table><tr><td></tdx/tr></table>
Каждый тег хранит список вложенных тегов и отображает себя соответ­
ственно: сначала свое имя и затем рекурсивно все вложенные теги. Текст
внутри тегов и атрибуты тегов в данной реализации не поддерживаются.
Реализацию с полными возможностями вы найдете в исходных текстах
вышеупомянутой библиотеки kotlinx.html.
Обратите внимание, что функции создания тегов добавляют соответ­
ствующий тег в список потомков своего родительского тега. Это дает воз­
можность генерировать теги динамически.
Листинг 11.10. Динамическое создание тегов с помощью построителя HTML
fun createAnotherTable() = table {
for ( i in 1..2) {
tr {
< H Каждый вызов «tr» создает
td {
| новый тег TR и добавляет его
в
список
потомков
TABLE
}
}
11.2. Создание структурированных API: лямбда-выражения с получателями в DSL ❖
363
»> println(createAnotherTable())
<table><tr><td></tdx/tr><tr><td></td></tr></table>
Как видите, лямбда-выражения с получателями - отличный инструмент
для сознания предметно-ориентированных языков. Благодаря возможно­
сти изменения контекста разрешения имен в блоке кода они позволяют
определять структурированные API - это характерная черта, отличающая
DSL от простых последовательностей вызовов методов. Теперь давайте об­
судим преимущества интеграции такого DSL в статически типизирован­
ный язык программирования.
11.2.3. Построители на Kotlin: поддержка абстракций
и многократного использования
Разрабатывая программный код, мы можем пользоваться множеством
инструментов, чтобы избежать дублирования и сделать код более вырази­
тельным и читаемым. Например, можно оформить повторяющийся код в
виде новых функций и дать им говорящие имена. Это не так просто (если
вообще возможно) проделать с SQL или HTML. Но внутренние предмет­
но-ориентированные языки в Kotlin, используемые для решения анало­
гичных задач, позволяют выделять повторяющиеся фрагменты в новые
функции и повторно использовать их.
Рассмотрим пример из библиотеки Bootstrap flr ttp : / / g e t b o o t s t r a p .
comi. популярного фреймворка для разработки HTML, CSS и JS в динамич­
ных веб-приложениях. Возьмем за основу конкретный пример: добавле­
ние раскрывающихся списков в приложение. Чтобы добавить такой спи­
сок непосредственно в страницу HTML, нужно скопировать необходимый
фрагмент и вставить его в нужное место, связав его с кнопкой или другим
элементом, отображающим список. От нас требуется только добавить в
раскрывающееся меню необходимые ссылки и их заголовки. В листин­
ге 1.11 приводится начальный HTML-код (сильно упрощенный, чтобы не
загромождать разметку атрибутами s ty le ).
Листинг 11.11. Создание раскрывающегося меню средствами Bootstrap
<div class="dropdown">
<button class="btn dropdown-toggle">
Dropdown
<span class="caret"x/span>
</button>
<ul class="dropdown-menu">
< lix a href="#">Action</aX/li>
364 ❖
Глава 11. Конструирование DSL
<li><a href="#">Another action</a></li>
< li role="separator" class="divider"x/li>
< li class="dropdown-header">Header</li>
< lix a href="#">Separated lin k < /a x /li>
</ul>
</div>
Чтобы воспроизвести аналогичную структуру в Kotlin, можно восполь­
зоваться библиотекой kotlinx.html и её функциями d iv, button, u l, l i и
другими.
Листинг 11.12. Создание раскрывающегося меню средствами построителя
HTML в Kotlin
fun buildDropdown() = createHTMLQ.div(classes = "dropdown") {
button(classes = "btn dropdown-toggle") {
+"Dropdown"
span(classes = "caret")
}
ul(classes = "dropdown-menu") {
l i { a("#") { +"Action" } }
l i { a("#") { +"Anotber action" } }
l i { role = "separator"; classes = setOf("divider") }
l i { classes = setOf("dropdown-header"); +"Header" }
l i { a(“#” ) { +"Separated link" } }
}
}
Но код можно сделать более компактным. Так как d iv, button и про­
чие - это обычные функции, мы можем вынести повторяющуюся логику в
отдельные функции и сделать код более удобочитаемым. Результат может
выглядеть так, как в листинге 11.13.
Листинг 11.13. Создание раскрывающегося меню с помощью вспомогательных
функций
fun dropdownExample() = createHTML() .dropdown {
dropdownButton { +"Dropdown" }
dropdownMenu {
item("#", "Action")
item("#", "Another action")
divider()
dropdownHeader("Header")
item("#", "Separated lin k")
}
}
11.2. Создание структурированных API: лямбда-выражения с получателями в DSL
❖
565
Теперь ненужные детали скрыты, код стал более ясным. Давайте по­
смотрим, как удалось добиться такого результата. Начнем с функции
item . У неё два параметра: ссылка и имя соответствующего пункта меню.
Код функции должен добавить новый элемент списка: l i { a (h r e f)
{ +name } }. Единственная неясность - как вызвать l i в теле функции?
Следует ли объявить эту функцию расширением? Да, фактически мы мо­
жем сделать её функцией-расширением для класса UL, потому что l i сама
является функцией-расширением для этого класса. В листинге 11.13 функ­
ция item неявно вызывается как метод t h is типа UL:
fun UL.item(href: String, name: String) = l i { a(href) { +name } }
Вновь объявленную функцию item можно использовать в любом теге
UL, и каждый её вызов будет добавлять экземпляр тега LI. Выделив функ­
цию item , мы можем изменить исходную версию так, как показано в лис­
тинге 11.14, не влияя на сгенерированную разметку HTML.
Листинг 11.14. Использование функции item для конструирования
раскрывающегося меню
ul {
classes = setOf("dropdown-menu")
item("#", "Action")
item("#'\ "Another action")
l i { role = "separator"; classes = setOf("divider") }
l i { classes = setOf("dropdown-header"); +"Header" }
item("#", "Separated lin k")
}
Аналогично добавляются другие функции-расширения
позволяющие заменить остальные теги l i .
для
UL,
fun UL.divider() = l i { role = "separator"; classes = setOf("divider") }
fun UL.dropdownHeader(text: String) =
l i { classes = setOf("dropdown-header"); +text }
Теперь посмотрим, как реализована функция dropdownMenu. Она созда­
ет тег u l с заданным классом2 dropdown-menu и принимает лямбда-выра­
жение с получателем, которое заполняет тег содержимым.
dropdownMenu {
item("#", "Action")
}
2 Здесь имеется в виду класс CSS. - П рим . ред.
366 ❖
Глава 11. Конструирование DSL
Мы заменили блок u l { . . . } вызовом dropdownMenu { . . . }, по­
этому получатель в лямбда-выражении останется прежним. Функция
dropdownMenu принимает лямбда-выражения как расширения для UL, что
позволяет вам вызывать такие функции, как UL. item , как вы делали рань­
ше. Вот как объявлена эта функция:
fun DIV.dropdownMenu(block: UL.Q -> Unit) = ul("dropdown-menu", block)
Функция dropdownButton реализована аналогично. Мы опустим её
здесь, но вы можете найти полную реализацию в примерах, поставляемых
в составе библиотеки kotlinx.html.
Наконец, рассмотрим функцию dropdown. Это одна из самых нетри­
виальных функций в нашем примере, потому что может вызываться из
любого тега: раскрывающееся меню можно поместить куда угодно.
Листинг 11.15. Функция верхнего уровня для создания раскрывающихся меню
fun StringBuilder.dropdown(
block: DIV.() -> Unit
): String = div("dropdown", block)
Эту упрощенную версию можно использовать, чтобы просто вывести
разметку HTML в строку. Полная реализация в kotlinx.html использует аб­
страктный класс TagConsumer как получатель, благодаря чему поддержи­
ваются разные варианты для вывода HTML.
Данный пример иллюстрирует, как обычные приёмы абстрагирования
и повторного использования могут улучшить код и сделать его проще и
понятнее.
А теперь познакомимся с ещё одним инструментом, помогающим соз­
давать гибкие структуры в предметно-ориентированных языках: согла­
шение invoke.
11.3. Гибкое вложение блоков
с использованием соглашения «invoke»
Соглашение invoke позволяет вызывать объекты как функции. Вы уже ви­
дели, что объекты с типами функций можно вызывать как функции. Но
благодаря соглашению invoke мы можем определять собственные объек­
ты, поддерживающие тот же синтаксис.
Обратите внимание, что эта особенность не предназначена для повсе­
местного использования, потому что она позволяет писать трудные для
понимания выражения, например 1 (). Но иногда она пригождается в
предметно-ориентированных языках. Далее покажем, где это может при­
меняться, но сначала обсудим само соглашение.
11.3. Гибкое вложение блоков с использованием соглашения «invoke» ♦> 367
11.3.1. Соглашение «invoke»: объекты, вызываемые
как функции
В главе 7 мы детально обсудили идею соглашений в Kotlin: в частности,
именованные функции, которые вызываются не как обычно, а с использо­
ванием другого, более компактного синтаксиса. Например, в той главе мы
обсудили соглашение g et, позволяющее обращаться к объектам с исполь­
зованием оператора индексирования. Обращение fo o [b a r] к переменной
f оо типа Foo транслируется в вызов f о о . g et(b a r ), если соответствующая
функция g e t определена как член класса Foo или как функция-расшире­
ние для Foo.
Соглашение invoke фактически делает то же самое - с той лишь разни­
цей, что квадратные скобки заменяются круглыми. Если класс определяет
функцию invoke с модификатором operator, его экземпляры можно вы­
зывать как функции, как показано в листинге 11.16.
Листинг 11.16. Определение метода invoke в классе
class Greeter(val greeting: String) {
operator fun invoke(name: String) {
println("{greeting, $name!")
<j-. Определениеметода«invoke»
| вклассеGreeter
}
}
»> val bavarianGreeter = Greeter("Servus")
»> bavarianGreeter( "Dmitry")
<H ВызовэкземпляраGreeter
Servus, Dmitry!
| какфункции
Здесь в классе Greater определяется метод invoke. Это позволяет вызы­
вать экземпляры Greeter как обычные функции. За кулисами выражение
bavarianGreeter("Dmitry") компилируется в вызов bavarianGreeter.
invoke("Dmitry"). Здесь нет никакой мистики - это самое обычное со­
глашение, помогающее писать более компактные и ясные выражения.
Метод invoke не ограничивается какой-то одной конкретной сигнату­
рой. Его можно объявить с любым количеством параметров и с любым ти­
пом возвращаемого значения и даже определить перегруженные версии
invoke с разными типами параметров. Эти сигнатуры можно использо­
вать для вызова экземпляров класса как функций. Рассмотрим пример,
когда это соглашение может пригодиться на практике: сначала в контек­
сте обычного программирования, а затем в DSL.
11.3.2. Соглашение «invoke» и типы функций
Многие из вас наверняка помнят, что мы уже использовали соглашение
invoke ранее в этой книге. В разделе 8.1.2 мы обсуждали возможность вы-
❖
368
Глава 11. Конструирование DSL
зова переменной с типом функции, поддерживающим значение n u ll, как
lambda?, invoke О , использовав безопасный синтаксис вызова с именем
метода invoke.
Теперь, после знакомства с соглашением invoke, вам должно быть по­
нятно, что вызов лямбда-выражения (с добавлением круглых скобок после
него: lambda( )) - это не что иное, как применение данного соглашения.
Лямбда-выражения, кроме встраиваемых, компилируются в классы, реа­
лизующие интерфейсы функций (F u n ctionl и другие), а эти интерфейсы
определяют метод invoke с соответствующим количеством параметров:
interface Function2<in PI, in P2, out R> {
operator fun invoke(pl: PI, p2: P2): R
O —i Этот интерфейс обозначает функцию,
| принимающую точно два аргумента
}
Когда мы вызываем лямбда-выражение как функцию, данная опера­
ция в соответствии с соглашением транслируется в вызов метода invoke.
Где может пригодиться это знание? Оно поможет разбить код сложных
лямбда-выражений на несколько методов, сохранив возможность их ис­
пользования с функциями, принимающими параметры с типами функ­
ций. Для этого можно определить класс, реализующий интерфейс типа
функции. В качестве базового можно явно использовать один из типов
Function^ или, как показано в листинге 11.17, применить сокращенный
синтаксис: (P I, Р2) -> R. В этом примере такой класс используется для
фильтрации списка проблем с применением сложных условий.
Листинг 11.17. Наследование типа функции и переопределение метода invokeO
data class Issue(
val id: String, val project: String, val type: String,
val p rio rity : String, val description: String
)
class ImportantIssuesPredicate(val project: String)
| В качестве базового класса
: (Issue) -> Boolean {
< } J используется тип функции
override fun invoke(issue: Issue): Boolean {
return issue.project == project && issue.isImportant()
private fun Issue.isImportant(): Boolean {
return type == "Bug" &&
(p rio rity == "Major" || p rio rity == "C ritica l")
}
»> val i l = Issue("IDEA-154446", "IDEA", "Bug", "Major",
...
"Save settings failed")
»> val i2 = Issue("KT-12183", "Kotlin", "Feature", "Normal",
Реализация метода
«invoke»
11.3. Гибкое вложение блоков с использованием соглашения «invoke» ❖
369
... "Intention: convert several calls on the same receiver to with/apply")
»> val predicate = ImportantIssuesPredicate("IDEA")
»> for (issue in lis tO f( il, i2).filter(predicate)) {
println(issue.id)
... }
IDEA-154446
Здесь у предиката слишком сложная логика, чтобы уместить её в един­
ственном лямбда-выражении. Поэтому мы разбили её на несколько м е­
тодов, чтобы отчетливее осмыслить каждый из них. Преобразование
лямбда-выражения в класс, реализующий интерфейс типа функции и пе­
реопределяющий метод invoke, - это один из способов выполнить такой
рефакторинг. Преимущество этого подхода заключается в том, что область
видимости методов, выделяемых из тела лямбда-выражения, сужена до
минимума; они доступны только из класса предиката. Это ценно, когда в
классе предиката и окружающем коде есть много логики, и её стоит четко
разделить по зонам ответственности.
Теперь посмотрим, как соглашение invoke помогает создавать более
гибкие структуры в предметно-ориентированных языках.
11.3.3. Соглашение «invoke» в предметно-ориентированных
языках: объявление зависимостей в Gradle
Вернемся к примеру Gradle DSL для настройки зависимостей модуля.
Вот код, который демонстрировался выше:
dependencies {
compile("ju n it:ju n it:4.11")
}
Часто бывает желательно, чтобы в одном API поддерживались и вложен­
ные блоки, как в данном примере, и простые последовательности вызовов.
Иными словами, хотелось бы иметь возможность использовать любую из
двух форм записи:
dependencies .compile("ju n it: ju n it:4. И ")
dependencies {
compile("junit:ju n it:4 .11")
}
При такой организации пользователи DSL смогут использовать вло­
женные блоки, когда потребуется определить несколько зависимостей, и
простые вызовы для единственных зависимостей, что позволит сделать
код более компактным.
В первом случае вызывается метод com pile переменной dependencies.
Вторую форму записи можно получить, определив метод invoke в depen -
370 ❖
Глава 11. Конструирование DSL
d en cies, который принимает аргумент с лямбда-выражением. Полный
синтаксис этого вызова: d ep en d en cies. in v o k e ({. . . } ) .
Объект dependencies - это экземпляр класса DependencyHandler, кото­
рый определяет оба метода, compile и invoke. Метод invoke принимает
лямбда-выражение с получателем как аргумент, и тип получателя этого
метода - снова DependencyHandler. Происходящее в теле лямбда-выра­
жения вам уже знакомо: имея получатель типа DependencyHandler, оно
может вызвать метод вроде compile напрямую. Следующий небольшой
пример в листинге 11.18 демонстрирует, как осуществляется эта часть
DependencyHandler.
Листинг 11.18. Использование invoke для поддержки гибкого синтаксиса DSL
class DependencyHandler {
fun compile(coordinate: String) {
println("Added dependency on {coordinate")
0 - i Определяется обычный
| командный API
}
operator fun invoke(
body: DependencyHandler.() -> Unit) {
body()
<h «this»ссылаетсянафункцию
}
I body: this.bodyO
< н Определяется«invoke»
I дляподдержкиDSLAPI
}
»> val dependencies = DependencyHandlerQ
»> dependencies.compile("org.jetbrains.ko tlin :kotlin-stdlib:1.0.0")
Added dependency on org.jetbrains.kotlin:kotlin-stdlib:1.0.0
»> dependencies {
...
com pile("org.]etbrains.kotlin:kotlin-reflect:1.0.0M)
»> >
Added dependency on org.jetbrains.kotlin:kotlin-reflect:1.0.0
Добавляя первую зависимость, мы вызвали метод com pile непосредст­
венно. Второй вызов фактически транслируется в:
dependencies.invoke({
th is .compile("org.jetbrains.kotlin:kotlin-reflect:1.0.0")
})
Иными словами, здесь мы вызываем dependencies как функцию и пере­
даем лямбду как аргумент. Параметр лямбда-выражения имеет тип функ­
ции с получателем, а тип получателя - тот же тип DependencyHandl ег. Метод
invoke вызывает лямбда-выражение. Поскольку этот метод принадлежит
11.4. Предметно-ориентированные языки Kotlin на практике ❖
371
классу DependencyHandler, то экземпляр этого класса доступен как неяв­
ный получатель, и нам не требуется явно указывать его, вызывая body( ).
Переопределение метода invoke - это всего лишь один маленький фраг­
мент кода, но он существенно повысил гибкость DSL API. Это универсаль­
ный шаблон, и его можно использовать в самых разных DSL почти без мо­
дификаций.
Теперь вы знакомы с двумя новыми особенностями Kotlin, помогающи­
ми создавать свои предметно-ориентированные языки: лямбда-выраже­
ния с получателем и соглашение invoke. Давайте посмотрим, как эти и
другие особенности Kotlin работают в контексте DSL.
11.4. Предметно-ориентированные языки
Kotlin на практике
Теперь вы знакомы со всеми особенностями Kotlin, используемыми для
создания предметно-ориентированных языков. Некоторые, такие как
расширения и инфиксный вызов, должны уже стать для вас старыми до­
брыми друзьями. Другие, как лямбда-выражения с получателями, впервые
подробно обсуждались в этой главе. Давайте соберем все эти знания вме­
сте и исследуем несколько практических примеров создания DSL. Мы ох­
ватим самые разные темы: тестирование, поддержка литералов дат, зап­
росы к базам данных и конструирование пользовательского интерфейса
для Android.
11.4.1. Цепочки инфиксных вызовов:
«should» в фреймворках тестирования
Как упоминалось выше, ясный синтаксис - одна из отличительных черт
внутренних DSL, и его можно достичь за счет уменьшения количества зна­
ков препинания в коде. Большинство внутренних DSL сводится к выполне­
нию последовательностей вызовов методов, поэтому всё, что способствует
уменьшению синтаксического шума в вызовах методов, широко исполь­
зуется в этой области. В число таких особенностей Kotlin входят сокра­
щенный синтаксис вызова лямбда-выражений (который мы уже деталь­
но обсудили) и инфиксный вызов функций. Синтаксис инфиксных вызовов
упоминался в разделе 3.4.3, а здесь мы сосредоточимся на его применении
в DSL.
Рассмотрим пример использования предметно-ориентированного язы­
ка kotlintest (https: //github.com/kotlintest/kotlintest. библиотека
тестирования, разработанная по примеру Scalatest), который мы уже ви­
дели в этой главе.
372 ❖
Глава 11. Конструирование DSL
Листинг 11.19. Запись проверки на предметно-ориентированном языке kotlintest
s should startWith("kot")
Этот тестовый вызов потерпит неудачу, если значение переменной s не
будет начинаться с последовательности символов «kot». Программный код
читается практически как обычное предложение на английском языке:
«The s string should start with this constant» (Строка s должна начинаться с
этой константы). Чтобы добиться такой выразительности, мы должны объ­
явить функцию should с модификатором infix.
Листинг 11.20. Реализация функции sh o u ld
in fix fun <Т> Т.should(matcher: Matcher<T>) = matcher.test(this)
Функция should ожидает получить экземпляр Matcher, обобщенно­
го интерфейса для проверки значений. startW ith реализует интерфейс
Matcher и проверяет, начинается ли строка с указанной подстроки.
Листинг 11.21. Определение интерфейса M atcher в kotlintest DSL
interface Matcher<T> {
fun test(value: T)
}
class startWith(val prefix: String) : Matcher<String> {
override fun test(value: String) {
i f ( lvalue.startsWith(prefix))
throw AssertionError("String $value does not start with $prefix")
}
}
Обратите внимание, что в обычном коде рекомендуется начинать име­
на классов с большой буквы (то есть имя startW ith следовало бы записать
как StartW ith), но предметно-ориентированные языки часто отступают
от этого правила. Листинг 11.19 демонстрирует, как применение инфикс­
ной формы записи вызовов в контексте DSL помогает уменьшить синтак­
сический шум в коде. Проявив немного изобретательности, этот шум мож­
но уменьшить ещё больше - например, kotlintest DSL поддерживает такую
форму записи.
Листинг 11.22. Составление цепочки вызовов в kotlintest DSL
"kotlin" should start with "kot"
11.4. Предметно-ориентированные языки Kotlin на практике ❖
373
На первый взгляд этот код не имеет ничего общего с языком Kotlin. Что­
бы понять, как такое возможно, преобразуем инфиксные вызовы в обыч­
ные.
"kotlin".should(start).with("kot")
Как видите, в действительности код в листинге 11.22 - это последова­
тельность из двух инфиксных вызовов, a s t a r t - аргумент первого из них.
Фактически s t a r t ссылается на объявление объекта, a should и w ith функции, вызываемые с применением инфиксной нотации.
Функция should представлена в перегруженной версии, которая ис­
пользует объект s t a r t как тип параметра и возвращает промежуточную
обертку, обладающую методом w ith.
Листинг 11.23. Определение API для поддержки цепочек инфиксных вызовов
object start
in fix fun String.should(x: start): StartWrapper = StartWrapper(tbis)
class StartWrapper(val value: String) {
in fix fun with(prefix: String) =
i f ( !value.startsWith(prefix))
throw AssertionError(
"String does not start with Jprefix: lvalue")
}
Обратите внимание, что вне контекста DSL редко имеет смысл исполь­
зовать объект в роли типа параметра, потому что он имеется в единствен­
ном экземпляре и к нему проще обратиться напрямую, чем передавать в
аргументе. Но в данном случае такой приём оправдан: объект использует­
ся не для передачи данных в функцию, а как часть грамматики DSL. Пере­
давая start в аргументе, мы можем выбрать правильную перегруженную
версию should и получить экземпляр StartWrapper в результате. У класса
StartWrapper есть функция-член with, принимающая аргумент с факти­
ческим значением, необходимым для проверки.
Библиотека поддерживает и другие средства сопоставления, и всё при­
менение в коде читается как обычное предложение на английском языке:
"kotlin" should end with "in"
"kotlin" should have substring "o tl"
С этой целью для функции should определено несколько перегружен­
ных версий, которые принимают экземпляры объектов end и have и воз­
вращают экземпляры EndWrapper и HaveWrapper соответственно.
Это довольно необычный пример предметно-ориентированного язы­
ка, но настолько впечатляющий, что мы должны были показать, как он
374 ❖
Глава 11. Конструирование DSL
работает. Комбинирование инфиксных вызовов и экземпляров объектов
позволяет конструировать весьма сложные грамматики и использовать
ясный и выразительный синтаксис. И конечно, DSL остается полностью
типизированным. Неправильное сочетание функций и объектов просто не
будет компилироваться.
11.4.2. Определение расширений для простых типов:
обработка дат
Теперь рассмотрим ещё один пример, обещанный в начале главы:
val yesterday = 1.days.ago
val tomorrow = 1.days.fromNow
Для реализации этого DSL с использованием j ava .tim e из Java 8 и Kotlin
достаточно написать всего несколько строк кода. Вот часть реализации,
имеющая отношение к примеру.
Листинг 11.24. Определение предметно-ориентированного языка для работы
с датами
val In t.days: Period
get() = Period.ofDays(this)
val Period.ago: LocalDate
get() = LocalDate.now() - this
val Period.fromNow: LocalDate
get() = LocalDate.now() + this
«this» ссылается на значение
числовой константы
Вызов LocalOate.minus с использованием
синтаксиса операторов
Вызов LocalDate.plus с использованием
синтаксиса операторов
»> println(l.days.ago)
2016- 08-16
»> println( 1. days. fromNow)
2016- 08-18
Здесь days - это свойство-расширение для типа In t. Kotlin не ограни­
чивает типов, которые можно использовать в качестве получателей для
функций-расширений: мы легко можем определить желаемые расшире­
ния для простых типов и вызывать их относительно констант. Свойство
days возвращает значение типа Period, который в JDK 8 представляет ин­
тервал между двумя датами.
Чтобы завершить предложение и поддержать слово ago, нужно опреде­
лить ещё одно свойство-расширение - на этот раз для класса P eriod. Тип
этого свойства - LocalDate, и оно представляет дату. Обратите внимание,
что оператор - (минус) в реализации свойства ago не опирается ни на ка­
кие расширения в Kotlin. JDK-класс LocalDate определяет метод с име-
11.4. Предметно-ориентированные языки Kotlin на практике ❖
375
нем minus и единственным параметром, который соответствует соглаше­
нию об операторе - (минус) в языке Kotlin, поэтому Kotlin автоматически
отображает этот оператор в вызов метода. Полную реализацию библиоте­
ки, поддерживающей дни и другие единицы измерения времени, вы най­
дете В библиотеке kxdate на GitHub (https: //github.com/yole/kxdatey
Теперь, поняв, как работает этот простой DSL, перейдем к более сложно­
му примеру: реализации DSL-запросов к базе данных.
11.4.3. Члены-расширения: внутренний DSL для SQL
Вы уже знаете, какую важную роль играют функции-расширения в архи­
тектуре предметно-ориентированных языков. В этом разделе мы исследу­
ем еще один трюк, упоминавшийся выше: объявление функций-расшире­
ний в классе. Такие функции или свойства являются членами содержащего
их класса и в то же время расширяют какой-либо другой тип. Мы называем
такие функции и свойства членами-расширениями.
Рассмотрим пару примеров использования членов-расширений. Они
взяты из внутреннего DSL для SQL, реализованного в фреймворке Exposed,
уже упоминавшемся выше. Но сначала мы должны обсудить, как Exposed
позволяет определять структуру базы данных.
Для работы с таблицами в базе данных SOL фреймворк Exposed требу­
ет объявлять их как объекты, наследующие класс Table. Вот как выглядит
объявление простой таблицы Country с двумя столбцами.
Листинг 11.25. Объявление таблицы в Exposed
object Country : Table() {
val id = integer("id").autoIncrement().primaryKey()
val name = varcbar("name", 50)
}
Это объявление соответствует таблице в базе данных. Чтобы создать эту
таблицу, нужно вызвать метод S ch em a lltils.crea te(C o u n try ), который
сгенерирует все необходимые инструкции SQL, опираясь на объявление
структуры таблицы:
CREATE TABLE IF NOT EXISTS Country (
id INT AUTO_INCREMENT NOT NULL,
name VARCHAR(50) NOT NULL,
CONSTRAINT pk Country PRIMARY KEY (id )
)
По аналогии с созданием разметки HTML объявления в оригинальном
коде на Kotlin превращаются в элементы сгенерированной инструкции
SQL.
376 ❖
Глава 11. Конструирование DSL
Если проверить типы свойств в объекте Country, можно заметить, что
все они имеют тип Column с обязательным типовым аргументом: id - тип
Column<Int>, a name - тип Column<String>.
Класс Table в фреймворке Exposed определяет все типы столбцов, ко­
торые можно объявить в определении таблицы, включая использованные
выше:
class Table {
fun integer(name: String): Column<Int>
fun varchar(name: String, length: In t): Column<String>
и ...
}
Методы in te g e r и varchar создают новые столбцы для хранения цело­
численных и строковых значений соответственно.
Теперь посмотрим, как задать свойства столбцов. Для этого используют­
ся члены-расширения:
val id = integer("id").autoIncrement().priinaryKey()
Методы autoincrem ent и primaryKey определяют свойства столбцов.
Все эти методы могут быть вызваны относительно экземпляра Column и
возвращают сам этот экземпляр, что дает возможность составлять цепоч­
ки из вызовов методов. Вот упрощенные объявления этих функций:
class Table {
I Объявляетэтотстолбец
fun <Т> Column<T>.primaryKey(): Column<T>
<Н первичнымключом
fun Column<Int>. autoIncrement(): ColumrKlnt:* <3 i Автоматическоеувеличение
И ...
I поддерживаюттолько
}
целочисленныезначения
Эти функции - члены класса Table. То есть мы не сможем использовать
их за пределами области видимости этого класса. Теперь вы знаете, по­
чему имеет смысл объявлять методы как члены-расширения: это способ
ограничить область их применения. У вас не получится определить свой­
ства столбцов вне контекста таблицы: компилятор не найдет необходи­
мых для этого методов.
Другая замечательная особенность используемых здесь функций-рас­
ширений - возможность ограничить тип получателя. Даже притом, что
любой столбец таблицы может быть первичным ключом, автоматическое
наращивание (auto-increment) поддерживают только числовые столбцы.
Чтобы выразить это ограничение в API, нужно объявить метод a u to ln crement как расширение для типа Column<Int>. Попытка объявить столбец
любого другого типа автоматически наращиваемым вызовет ошибку на
этапе компиляции.
Кроме того, когда какой-либо столбец объявляется первичным ключом
с помощью primaryKey, эта информация сохраняется в таблице, содержа-
11.4. Предметно-ориентированные языки KotLin на практике ❖
377
щей столбец. Объявление этой функции как члена класса Table позволяет
сохранить необходимую информацию прямо в экземпляре таблицы.
Члены-расширения остаются обычными членами
Члены-расширения имеют один важный недостаток: ограничение расширяемости. Они
принадлежат r -классу, поэтомуу вас не получится определить новые члены-расширения
на стороне.
Например, представьте, что вам требуется добавить в Exposed поддержку новой базы
данных и эта база данных поддерживает некоторые новые атрибуты столбцов. Чтобы
добиться своей цели, вы должны были бы изменить определение класса Table и до­
бавить в него члены-расширения для новых атрибутов. Но вы не сможете добавить не­
обходимые объявления, не прикасаясь к исходному классу, как это возможно в случае с
обычными расширениями (не членами), потому что у таких расширений не будетдоступа
к экземпляру Table, где они смогли бы сохранить определения.
Рассмотрим ещё один член-расширение, который можно найти в прос­
том запросе SELECT. Представьте, что мы объявили две таблицы, Customer
и Country, и каждая запись в таблице Customer хранит ссылку на страну
(запись в Country), где проживает клиент. Следующий код выводит имена
всех клиентов, проживающих в США (USA).
Листинг 11.26. Соединение двух таблиц в Exposed
val result = (Country join Customer)
.select { Country, name eq "USA" }
<—i Этимстрокамcoonerm
«ОД:
result. forEach { print ln( i t [Customer, name]) }
| WHERECountry.name="OSA"
Метод s e le c t можно вызвать относительно экземпляра Table или со­
единения двух таблиц. Его аргумент - лямбда-выражение, определяющее
условие выбора требуемых данных.
Но где определен метод eq? Мы можем уверенно сказать, что это ин­
фиксная функция, принимающая строку "USA" как аргумент, и справедли­
во предположить, что это ещё один член-расширение.
В данном случае мы имеем дело с ещё одной функцией-расширением
для Column, которая одновременно проявляется как член и потому мо­
жет использоваться только в соответствующем контексте - например, для
определения условия в вызове метода s e le c t . Вот как выглядят упрощен­
ные объявления методов s e le c t и eq:
fun Table.select(where: SqlExpressionBuilder.Q -> Op<Boolean>) : Query
object SqlExpressionBuilder {
in fix fun<T> Column<T>.eq(t: T) : Op<Boolean>
378 ❖
//
Глава 11. Конструирование DSL
» » »
}
Объект SqlE xpressionB uilder определяет несколько способов выраже­
ния условий: сравнение значений, проверка на n u ll, выполнение ариф­
метических операций и так далее. Вам не придется явно использовать их
в программном коде, но вы будете регулярно вызывать их посредством
неявного получателя. Функция s e le c t принимает лямбда-выражение с
получателем, которым неявно становится объект SqlE xp ression B u ild ­
er. Это позволяет использовать в теле лямбда-выражения все возможные
функции-расширения, объявленные в этом объекте, такие как eq.
Вы увидели два типа расширений для столбцов: используемые в объяв­
лении Table и применяемые для сравнения значений в условиях. Без под­
держки членов-расширений вам пришлось бы объявлять все эти функции
как расширения или члены класса Column, что позволило бы использовать
их в любом контексте. Поддержка членов-расширений дает возможность
управлять их доступностью.
Примечание. В разделе 7.5.6 мы видели код, работающий с Exposed, когда обсуждали ис­
пользование делегируемых свойств в фреймворках. Делегируемые свойства часто приме­
няются в DSL, и фреймворк Exposed прекрасно иллюстрирует это. Мы не будем возвращать­
ся к обсуждению делегируемых свойств, потому что достаточно детально охватили их. Но
если вы намерены создать свой предметно-ориентированный язык или усовершенствовать
свой программный интерфейс, не забывайте об этой интересной особенности.
11.4.4. Anko: динамическое создание пользовательских
интерфейсов в Android
Обсуждая лямбда-выражения с получателями, мы упоминали, что они
прекрасно подходят для размещения компонентов пользовательского
интерфейса. Давайте посмотрим, как библиотека Anko (https: //github.
com /Kot iin /ankol может помочь конструировать пользовательские ин­
терфейсы для Android-приложений.
Сначала посмотрим, как библиотека Anko обертывает знакомый про­
граммный интерфейс Android в DSL-подобную структуру. В листинге 11.27
определяется диалог, демонстрирующий некоторое надоедливое преду­
преждение и две кнопки (подтверждающая желание продолжить и оста­
навливающая обработку).
Листинг 11.27. Использование Anko для вывода диалога в Android
fun Activity.showAreYouSureAlert(process: () -> Unit) {
a le rt(title = "Are you sure?1',
message = "Are you really sure?") {
11.4. Предметно-ориентированные языки Kotlin на практике ❖
379
positiveButton("Yes") { process() }
negativeButton("No") { cancel() }
}
}
Заметили три лямбда-выражения в коде? Первое передается функции
a le r t в третьем аргументе. Другие два - передаются функциям p o s it iv e Button и negativeB utton . Получатель первого (внешнего) лямбда-вы­
ражения имеет тип A lertD ialogB u ild er. Здесь мы снова видим тот же
шаблон: имя класса A lertD ia lo g B u ild er нигде не появляется в коде не­
посредственно, но мы обращаемся к его членам, добавляя элементы в диа­
лог. Вот как объявлены члены, используемые в листинге 11.27.
Листинг 11.28. Объявление программного интерфейса a le rt
fun Context.alert(
message: String,
title : String,
in it: AlertDialogBuilder.() -> Unit
class AlertDialogBuilder {
fun positiveButton(text: String, callback: Dialoglnterface.() -> Unit)
fun negativeButton(text: String, callback: Dialoglnterface.() -> Unit)
П ...
}
Мы добавили две кнопки в диалог. Если пользователь щелкнет на кноп­
ке Yes (Да), будет выполнена затребованная операция. Если пользователь
не уверен, операция будет отменена. Метод ca n cel является членом ин­
терфейса D ia lo g ln te r f асе, поэтому он вызывается относительно неявно­
го получателя данного лямбда-выражения.
Теперь рассмотрим более сложный пример, где Anko DSL действует как
полноценная замена макету размещения элементов пользовательского
интерфейса в XML. В листинге 11.29 объявляется простая форма с двумя
текстовыми полями ввода: одно служит для ввода адреса электронной
почты, а второе - пароля. В конце добавляется кнопка с обработчиком со­
бытия щелчка на ней.
Листинг 11.29. Использование Anko для определения простой формы
verticalLayout {
I Объявление элемента EditText
val email = editText {
<3-1 и сохранение ссылки на него
bint = "Email"
< н Неявным получателем в этом лямбда-выражении является
}
| обычный класс из Android API: android.widgetEditText
val password = editText {
380 ❖
Глава 11. Конструирование DSL
hint = "Password"
< h Короткий способ вызова
I EditTexLsetHint(’Password")
transformationMethod =
PasswordTransformationMettiod. getlnstance()
Вызовет
EdHTexLsetTransformationMethodf...)
}
I Объявление новой
button("Log In") {
< H кнопки...
onClick {
<H ...и то, что должно произойти
logIn(email.text, password.text) <1-1
I в результате щелчка по ней
Ссылки на элементы
пользовательского интерфейса
для доступа к их данным
Лямбда-выражения с получателями - замечательный инструмент, упро­
щающий объявление структурированных элементов пользовательского
интерфейса. Объявление их в коде (в сравнении с файлами XML) позволя­
ет выделять повторяющуюся логику и использовать её повторно, как было
показано в разделе 11.2.3. Мы можем отделить пользовательский интер­
фейс от прикладной логики и поместить их в разные компоненты, но и то,
и другое будет реализовано в коде на языке Kotlin.
11.5. Резюме
О Внутренние предметно-ориентированные языки - это шаблон про­
ектирования программных интерфейсов, который можно использо­
вать для создания более выразительных API со структурами, состоя­
щими из нескольких вызовов методов.
О Лямбда-выражения с получателями используют вложенную струк­
туру, чтобы переопределить порядок разрешения методов в теле
лямбда-выражения.
О Параметр, принимаемый лямбда-выражением с получателем, имеет
тип функции-расширения, и вызывающая функция передает экзем­
пляр получателя в вызов лямбда-выражения.
О Преимущество внутренних предметно-ориентированных языков в
Kotlin перед внешними языками шаблонов или разметки заключа­
ется в возможности повторно использовать код и создавать абстрак­
ции.
О Использование объектов со специальными именами в параметрах
инфиксных вызовов помогает создавать предметно-ориентирован­
ные языки, выражения на которых читаются как предложения на
английском языке, без лишних знаков.
О Определение расширений для простых типов дает возможность соз­
давать удобочитаемые синтаксические конструкции для литералов
разного рода, таких как даты.
11.5. Резюме ❖
381
О Соглашение invoke позволяет вызывать произвольные объекты так,
как если бы они были функциями.
О Библиотека kotlinx.html реализует внутренний предметно-ориенти­
рованный язык для создания HTML-страниц, который легко можно
дополнить поддержкой фреймворков, предназначенных для созда­
ния пользовательских интерфейсов.
О Библиотека kotlintest реализует внутренний предметно-ориентиро­
ванный язык для поддержки удобочитаемых конструкций проверки
в модульных тестах.
О Библиотека Exposed реализует внутренний предметно-ориентированный язык для работы с базами данных.
О Библиотека Алко реализует несколько разных инструментов для
разработки Android-приложений, включая внутренний предметно­
ориентированный язык для определения макетов пользовательских
интерфейсов.
Сборка проектов на Kotun
В этом приложении рассказывается, как организовать сборку кода на
Kotlin с использованием Gradle, Maven и Ant. Также здесь вы узнаете, как
собирать приложения на Kotlin для Android.
А.1. Сборка кода на Kotlin с помощью Gradle
Для сборки проектов на Kotlin рекомендуется использовать систему
Gradle. Gradle используется как стандартная система сборки проектов для
Android и, кроме того, поддерживает все другие виды проектов, которые
могут быть написаны на Kotlin. Gradle имеет гибкую модель проектов и
обеспечивает высокую производительность, в первую очередь благодаря
поддержке инкрементальной сборки, долгоживущих процессов сборки
(демон Gradle) и других продвинутых приемов.
Разработчики Gradle работают над поддержкой Kotlin для создания сце­
нариев сборки, что позволит вам использовать один язык и для приложе­
ний, и для сценариев сборки. В момент написания этих строк работа ещё
не была завершена, поэтому более подробную информацию по этой теме
ищите по адресу: https://github.com/gradle/gradle-script-kotlin.
Для сценариев сборки Gradle в этой книге мы использовали синтаксис
Groovy.
Вот как выглядит стандартный Gradle-сценарий для сборки Kotlin-npoекта:
buildscript {
ext.kotlin_version = '1.0.6'
repositories {
mavenCentral()
}
dependencies {
classpath "org.jetbrains.kotlin:" +
"kotlin-gradle-plugin:$kotlin version
}
Добавление зависимости
сценария сборки от плагина
поддержки Kotlin в Gradle
А.1. Сборка кода на Kotlin с помощью Gradle
apply plugin: 'java'
apply plugin: 'kotlin
J
383
Применяет плагин Kotlin
применяя
для Gradle
repositories {
mavenCentral()
}
dependencies {
compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version
Д обавляет зависимость
от стандартной
библиотеки Kotlin
}
Сценарий ищет файлы с исходным кодом на языке Kotlin в следующих
каталогах:
О src/main/java и src/main/kotlin - файлы с исходным кодом приложе­
ния;
О src/test/java и src/test/kotlin - файлы с исходным кодом тестов.
В большинстве случаев рекомендуется хранить файлы с исходным ко­
дом на Kotlin и Java в одном каталоге. В частности, когда Kotlin внедряется
в существующий проект, использование одного общего каталога умень­
шит сложности, возникающие при преобразовании Java-файлов на Kotlin.
Если вы используете механизм рефлексии в Kotlin, добавьте ещё одну
зависимость: библиотеку рефлексии Kotlin. Для этого включите следую­
щую строку в раздел dependencies:
compile "org.jetbrains.kotlin:kotlin-reflect:$kotlin_version"
A. 1.1. Сборка Kotlin-приложений для Android
с помощью Gradle
Сборка приложений для Android осуществляется иначе, чем сборка
обычных Java-приложений, поэтому для их сборки используют другой
плагин для Gradle. Вместо apply p lu g in : 'k o t lin ' добавьте в сценарий
сборки следующую строку:
apply plugin: 'kotlin-android'
Остальные настройки остаются такими же, как для обычных приложе­
ний.
Если у вас появится желание хранить исходный код на Kotlin в отдельных
каталогах (например, в src/main/kotlin), зарегистрируйте их, чтобы Android
Studio распознавала их как корневые каталоги с исходными текстами. Вот
как это можно сделать:
384 ♦> Приложение А. Сборка проектов на Kotlin
android {
•
V
*
sourceSets {
main.java.srcDirs += 'src/main/kotlin'
}
}
A.1.2. Сборка проектов с обработкой аннотаций
Многие Java-фреймворки, особенно те, что применяются для создания
Android-приложений, опираются на обработку аннотаций во время ком­
пиляции. Чтобы использовать такие фреймворки в программах на Kotlin,
нужно разрешить обработку аннотаций в сценарии сборки. Для этого до­
бавьте такую строку:
apply plugin: 'kotlin-kapt'
Если у вас уже есть проект на Java, зависящий от обработки аннотаций, и
вы решили внедрить в него Kotlin, то вам придется удалить существующую
конфигурацию инструмента apt. Инструмент обработки аннотаций для
Kotlin обрабатывает аннотации в классах на обоих языках, Java и Kotlin, а
использование двух отдельных инструментов обработки аннотаций будет
излишним. Чтобы указать зависимости, требуемые для обработки аннота­
ций, добавьте их в конфигурацию зависимостей k ap t:
dependencies {
compile 1com.google.dagger:dagger:2.41
kapt ' com.google.dagger:dagger-compiler:2.4'
}
В случае, когда процессоры аннотаций используются для каталогов ап droidT est или t e s t , соответствующие конфигурации kapt называются
kaptAndroidTest и kaptT est.
А.2. Сборка проектов на Kotlin
с помощью Maven
Если вы предпочитаете собирать проекты с помощью Maven, то его тоже
можно использовать для сборки проектов на Kotlin. Самый простой способ
создать Maven-проект на Kotlin - использовать архетип org. je tb r a in s .
k o tlin : kot I in-archetype-jvm . Чтобы добавить поддержку Kotlin в су­
ществующий Maven-проект, достаточно выбрать пункт Tools —> Kotlin —>
Configure Kotlin (Инструменты —>Kotlin —»Настройка Kotlin) в представле­
нии Project (Проект), в плагине Kotlin IntelliJ IDEA.
Чтобы вручную добавить поддержку Maven в проект на Kotlin, нужно вы­
полнить следующие шаги:
A.3. Сборка кода на Kotlin с помощьюAnt ❖
385
1. Добавить зависимость от стандартной библиотеки Kotlin (иденти­
фикатор группы: o r g .je tb r a in s .k o tlin ; идентификатор артефак­
та: k o t lin - s t d lib ) .
2. Добавить плагин Kotlin Maven (идентификатор группы: o r g .j e t b r a in s, k o tlin ; идентификатор артефакта: k otlin -m aven -p lu gin )
и настроить его запуск на этапах компиляции и тестирования.
3. Настроить каталоги с исходными текстами, если вы храните исход­
ный код на Kotlin отдельно от исходного кода на Java.
Ради экономии места мы не будем приводить здесь полных примеров
файлов pom.xml, но вы найдете их в электронной документации по адресу:
h t t p s : //k o t lin la n g .o r g /d o c s /r e f e r e n c e /u s in g m a v e n .h t m l.
В смешанных Java/Kotlin-проектах необходимо настраивать плагин
Kotlin так, чтобы он запускался перед запуском плагина Java. Это нужно
потому, что плагин Kotlin способен анализировать исходный код на Java,
тогда как плагин Java может читать только классы .class - то есть файлы с
исходным кодом на Kotlin должны быть скомпилированы в файлы .class до
того, как запустится плагин Java. Пример настройки вы найдете по адресу:
h ttp ://m n q .b z /7 3 o d .
А.З. Сборка кода на Kotlin с помощью Ant
Для сборки проектов с помощью Ant Kotlin реализует две задачи: задача
< k o tlin c > компилирует модули на Kotlin, a <w ithK otlin> служит расши­
рением задачи <j avac> для сборки смешанных модулей на Kotlin/Java. Вот
простой пример использования < k otlin c> :
<project name="Ant Task Test" default="build">
ctypedef resource="org/jetbrains/kotIin/ant/antlib.xml"
classpath="${kotlin.lib}/kotlin-ant.jar"/>
<H Определение задачи
I <kotlinc>
ctarget name="build">
<kotlinc output="hello.jar">
Выполнит сборку единственного
каталога с исходным кодом
<src path="src"/>
с помощью <kotlinc> и упакует
</kotlinc>
результат
в
jar-файл
</target>
</proj ect>
Задача < k o tlin c> для Ant автоматически добавляет зависимость от
стандартной библиотеки, поэтому вам не придется добавлять дополни­
тельные аргументы для настройки этой задачи. Она также поддерживает
упаковку скомпилированных файлов .class в jar-файл.
Вот пример использования задачи <withKot lin > для сборки смешанно­
го модуля на Java/Kotlin:
386 ❖
Приложение А. Сборка проектов на KotLin
<project name="Ant Task Test" default="build">
<typedef resource3"org/jetbrains/kotIin/ant/antlib.xml"
classpath-'${kotlin.lib}/kotlin-ant.jar"/>
<]—iОпределениезадачи
<wittiKotlin>
<target name="build">
<javac destdir=”classes" srcdir="src">• ! Использование задачи <wMotlin> для
<withKotlin/>
компиляции смешанного модуля на Kotlin/Java
</j avac>
<iar destfile="hello.iar">
< - | Упакует скомпилированные
<f ileset dir="classes"/>
| классы в jar-файл
</j ar>
</target>
</proj ect>
В отличие от <kotlinc>, задача <withKotlin> не поддерживает автома­
тическую упаковку скомпилированных классов, поэтому в данном приме­
ре используется отдельная задача <j аг> для упаковки.
Приложение
В этом приложении кратко рассказывается, как писать документирующие
комментарии в коде на Kotlin и как на основе этих комментариев
генерировать документацию с описанием API.
В.1. Документирующие комментарии в Kotlin
Документирующие комментарии с описанием объявлений на языке Kotlin
напоминают аналогичные комментарии lavadoc в lava и называются KDoc.
По аналогии с комментариями Javadoc KDoc-комментарии начинаются с
последовательности /* * и для описания конкретных частей объявлений
используют теги, начинающиеся с @. Основное отличие KDoc от Javadoc
заключается в том, что для записи комментариев используется формат
Markdown (https://daringfireball .net/projects/markdown) вместо
HTML. Чтобы упростить создание комментариев, KDoc поддерживает не­
сколько дополнительных соглашений для ссылки на элементы документа­
ции - например, с описанием параметров функции.
Вот простой пример KDoc-комментария с описанием функции.
Листинг В.1. Комментарий KDoc
/##
* Вычисляет сумму двух чисел, [а] и [Ь]
*/
fun sum(a: Int, b: Int) = a + b
Чтобы сослаться на объявление внутри комментария KDoc, нужно за­
ключить имя этого объявления в квадратные скобки. В листинге В.1 это со­
глашение используется для ссылки на параметры описываемой функции,
но точно так же можно ссылаться на другие объявления. Если объявление,
на которое нужно сослаться, импортируется в код, содержащий коммен-
388 ❖
Приложение В. Документирование кода на Kotlin
тарий KDoc, его имя можно использовать непосредственно. В противном
случае следует указывать полностью квалифицированные имена. Если у
вас появится желание определить свою метку для ссылки, используйте две
пары квадратных скобок и поместите метку в первую пару, а имя объяв­
ления - во вторую: [например] [com . mycompany. S o m e th in g T e st. s im p le ] .
Вот более сложный пример, демонстрирующий использование тегов в
комментариях.
Листинг В.2. Теги в комментариях
/##
* Выполняет сложную операцию.
Описание
*
параметра
* gparam remote Если имеет значение true, операция выполняется удаленно
* greturn Результат выполнения операции
Описание возвращаемого значения
* gthrows IOException если соединение с удаленным узлом будет разорвано
* gsample com.mycompany.SomethingTest.simple
Описание
*/
возможного
fun somethingComplicated(remote: Boolean): ComplicatedResult { » « » }
исключения
Включает в тепл документации
указанную функцию как пример
Синтаксис тегов в точности совпадает с Javadoc. Но, кроме стандартных
тегов Javadoc, в KDoc поддерживается несколько дополнительных тегов
для описания понятий, отсутствующих в Java, таких как тег © receiver для
описания получателя функции-расширения или свойства-расширения.
Полный список поддерживаемых тегов можно найти на странице h t t p : / /
kotlinlana.orq/docs/reference/kotlin-doc.html.
Ter ©sample можно использовать для включения в текст документации
текста указанной функции в качестве примера использования описывае­
мого API. Значение тега - полное квалифицированное имя включаемого
метода.
Кроме того, в KDoc не поддерживаются следующие теги Javadoc:
О ©deprecated - вместо него используется аннотация ©Deprecated;
О © inheritdoc - не поддерживается, потому что документирующие
комментарии в Kotlin всегда автоматически наследуются переопре­
деляющими объявлениями;
О ©code, © lite r a l и © link - не поддерживаются, потому что использу­
ется соответствующее форматирование Markdown.
Обратите внимание: в команде разработчиков Kotlin предпочитают до­
кументировать параметры и возвращаемые значения функций непосред­
ственно в тексте документации, как в листинге В.1. Использовать теги, как
это сделано в листинге В.2, рекомендуется только тогда, когда параметр
B.2. Создание документации с описанием API
❖
389
или возвращаемое значение имеет сложную семантику и его описание
должно быть четко отделено от основного текста документации.
В.2. Создание документации с описанием API
Инструмент, генерирующий документацию из исходного кода на Kotlin,
называется Dokka: https://git.hub.com/kotlin/dokka. Так же как сам
Kotlin, Dokka полностью поддерживает смешанные проекты на Java/Kotlin.
Он может читать комментарии Javadoc в коде на Java и комментарии KDoc
в коде на Kotlin, а также генерировать документацию, охватывающую весь
API модуля вне зависимости от языка, использовавшегося для определе­
ния каждого класса. Dokka поддерживает несколько выходных форматов,
включая простую разметку HTML, разметку HTML в стиле Javadoc (которая
использует синтаксис Java во всех объявлениях и показывает, как API вы­
глядит с точки зрения Java) и Markdown.
Запускать Dokka можно из командной строки или из сценариев сборки
Ant, Maven или Gradle. Рекомендуемый способ - добавить вызов Dokka в
сценарии Gradle для сборки вашего модуля. Вот минимально необходимая
конфигурация Dokka в сценарии сборки для Gradle:
buildscript {
ext.dokka_version = '0.9.13'
repositories {
j center()
}
dependencies {
classpath "org. jetbrains.dokka:dokka-gradle-plugin: ${dokka version}1'
}
apply plugin: 'org.jetbrains.dokka'
С этой конфигурацией вы сможете сгенерировать документацию в фор­
мате HTML с описанием своего модуля, выполнив команду ./gradlew
dokka.
Информацию о дополнительных параметрах инструмента Dokka вы
найдете ПО адресу: https://github.com/Kotlin/dokka/blob/master/
README.md.В документации также описывается, как пользоваться Dokka в
роли автономного инструмента или интегрировать его в сценарии сборки
для Maven и Ant.
Приложение
Экосистема Kotlin
Несмотря на относительно юный возраст, Kotlin уже имеет обширную
экосистему библиотек, фреймворков и инструментов, большая часть из
которых создана внешним сообществом разработчиков. В этом приложе­
нии мы дадим несколько советов, которые пригодятся для исследования
этой экосистемы. Конечно, книга - не лучший способ передачи сведений о
быстро расширяющейся коллекции инструментов, поэтому в первую оче­
редь отметим ресурс, где вы сможете найти самую свежую информацию:
https://kotlin.link/.
И напомним ещё раз: Kotlin полностью совместим с экосистемой биб­
лиотек Java. Подбирая библиотеку для решения своей задачи, не ограни­
чивайте круг поиска только библиотеками, написанными на Kotlin, - вы
можете с успехом использовать стандартные библиотеки для Java. Теперь
перечислим некоторые библиотеки, достойные вашего внимания. Некото­
рые из Java-библиотек предлагают расширения для Kotlin с более ясными
и идиоматичными API, и вы должны стремиться использовать эти расши­
рения, если они доступны.
С.1. Тестирование
Помимо стандартных JUnit и TestNG, которые прекрасно работают с Kotlin,
существуют другие фреймворки, реализующие выразительные предмет­
но-ориентированные языки для записи тестов на Kotlin:
О KotlinTeSt (h ttp s : //q ith u b . c o m /k o tlin te s t/k o tlin te s t) - гибкий
фреймворк тестирования, написанный в духе ScalaTest и упоминав­
шийся в главе 11. Поддерживает несколько разных подходов к запи­
си тестов;
О Spek (h ttp s: / /q ith u b .с о т /jetb rain s/sp ek ^ - фреймворк тести­
рования в стиле BDD для Kotlin, первоначально разработанный в
JetBrains и теперь поддерживаемый сообществом.
Если вы уверенно чувствуете себя с JUnit и вас интересует лишь более
выразительный предметно-ориентированный язык для выполнения про­
верок, обратите внимание на Hamkrest (https: //github.com /npryce/ham -
C.5. Веб-приложения ❖
391
k r e s t ). Если вы широко используете фиктивные объекты в своих тестах,
вам определенно стоит взглянуть на фреймворк Mockito-Kotlin ( h t t p s : / /
g ith u b .c o m /n h a a r m a n /m o c k ito -k o tlin ), который решает некоторые
проблемы, связанные с созданием фиктивных экземпляров классов Kotlin,
и реализует выразительный DSL.
С.2. Внедрение зависимостей
Популярные фреймворки с поддержкой внедрения зависимостей, такие
как Spring, Guice и Dagger, прекрасно работают с Kotlin. Если вам инте­
ресно познакомиться с аналогичным решением на Kotlin, познакомьтесь
С фреймворком Kodein (h ttp s : //a ith u b .c o m /S a lo m o n B r y s/K o d e in ), кото­
рый предлагает удобный DSL для настройки зависимостей и имеет весьма
эффективную реализацию.
С.З. Сериализация JSON
Те, кто ищут более мощное решение для сериализации JSON, чем библио­
тека JKid, описанная в главе 10, имеют богатый выбор. Предпочитающие
Jackson могут использовать модуль jackson-module-kotlin (h ttp s : / / g i t h u b .
com /F a sterX M L /ja ck so n -m o d u le-k o tlin k обладающий глубокой интегра­
цией с Kotlin, включая поддержку классов данных. Для GSON есть вели­
колепная библиотека оберток Kotson (h ttp s : //g ith u b .c o m /S a lo m o n B r y s/
Kotsonk А те, кому требуется более легкое решение, реализованное ис­
ключительно на Kotlin, могут попробовать Klaxon ( h t t p s : / / g i t h u b . с о т /
С.4. Клиенты HTTP
Если вам понадобится написать на Kotlin клиента для REST API, обрати­
те внимание на Retrofit (h ttp : / /s q u a r e .g it h u b . i o / r e t r o f i t ) . Это Javaбиблиотека, также совместимая c Android, которая прекрасно работает
с Kotlin. Для более низкоуровневых решений можно порекомендовать
OkHttp (h ttp : / /s q u a r e .g it h u b . i o / o k h t t p / l или Fuel, библиотеку под­
держки HTTP на Kotlin (h ttp s : // g it h u b .c o m /k it t in u n f /F u e l) .
C.5. Веб-приложения
Для разработки серверной части веб-приложений наиболее зрелые вари­
анты на сегодняшний день - Java-фреймворки Spring, Spark Java и vert.x.
Версия Spring 5.0 будет включать встроенную поддержку Kotlin. Желаю­
щие использовать Kotlin с предыдущими версиями Spring могут найти до­
полнительную информацию и вспомогательные функции в проекте Spring
Kotlin (h ttp s : //g it h u b .c o m /s d e le u z e /s p r in g - k o t lin ) . Библиотека vert.x
392
❖
Приложение С. Экосистема КоШп
также официально поддерживает Kotlin: https://github.com/vert-xg/
vertx-lang-kotlin/.
Из решений, написанных исключительно на Kotlin, можно порекомен­
довать:
О Ktor (h t t p s : / /g ith u b . com /K otlin /k tor) - пробный проект JetBrains,
эксперимент по созданию современного, полнофункционального
фреймворка для разработки веб-приложений с идиоматичным API;
О Kara (h t t p s : / /github.com /T inyM ission/kara^ - оригинальный
веб-фреймворк на Kotlin, используемый в JetBrains и в других ком­
паниях;
О Wasabi (https: //github. com/wasabifx/wasabi^ - HTTP-фреймворк,
основанный на библиотеке Netty. Имеет выразительный Kotlin API;
О Kovert (https: / /github.com/kohesive/koverti - REST-фреЙМВорк,
основанный на библиотеке vert.x.
Для создания разметки HTML можно использовать библиотеку kotlinx.
html (https: //github.com/kotl.in/kotlinx.htmlk обсуждавшуюся в гла­
ве 11. Если вы предпочитаете более традиционные подходы, то используйте
механизмы шаблонов для Java - например, Thymeleaf (www. thymeleaf.org).
C.6. Доступ к базам данных
В дополнение к традиционным средствам для работы с базами данных,
доступным в Java (Hibernate и другие), существует несколько вариан­
тов специально для Kotlin. Мы ближе всего знакомы с Exposed (https://
github.com/jetbrains/Exposed) - фреймворком, позволяющим генери­
ровать SQL-код и несколько раз обсуждавшимся в этой книге. Некоторые
альтернативы перечислены на странице https://kot lin.Iink.
C.7. Утилиты и структуры данных
В последнее время набирает популярность парадигма реактивного про­
граммирования, и язык Kotlin прекрасно подходит для неё. Библиотека
Rxjava (https: //github.com/ReactiveX/Rx3ava) де-факто стала стандар­
том для реактивного программирования в JVM и имеет официальную под­
держку Kotlin https: //github.com/ReactiveX/RxKotlin.
Ниже перечислены библиотеки, содержащие утилиты и структуры дан­
ных, которые могут пригодиться в ваших проектах:
О funKTionale (https: //github.com/MarioAriasC/funKTionale^ - реа­
лизует широкий диапазон примитивов функционального програм­
мирования (например, частичное применение функций);
О Kovenant (https://github.com/mplatvoet/kovenant) - реализация
отложенных вычислений для Kotlin и Android.
C.8. Настольные приложения ❖
393
С.8. Настольные приложения
Если вы занимаетесь разработкой настольных приложений на основе JVM,
вы почти наверняка используете JavaFX. TomadoFX flittps://github.com/
edvin/tornadofx^ включает разнообразные адаптеры для JavaFX, образуя
естественную среду для разработки настольных приложений на Kotlin.
Предметный указатель
Символы
@CustomSerializer, аннотация 325, 335, 342
@ Deprecated, аннотация 315, 389
@Deserializelnterface, аннотация 323
@JsonExclude, аннотация 320
@JsonName, аннотация 320
@JsonName, аннотация 333
@JvmField, аннотация 318
@JvmName, аннотация 318
@JvmStatic, аннотация 318
@NotNull, аннотация 176
@Nullable, аннотация 176
@receiver,Ter 389
^R etention, аннотация 323
@Rule, аннотация 317
@sample,Ter 389
©Suppress, аннотация 318
©Target, аннотация 322
©Test, аннотация 316
- оператор
обзор 220
— оператор 222
* оператор
обзор 220
/ оператор
обзор 220
%оператор
обзор 220
+ оператор
обзор 220
++оператор 224
+= оператор 219, 222
=== оператор 226
?: оператор Элвис 178
@символ 315
{} (фигурные скобки) 141
А
аде, свойство 141, 321
AlertDialogBuilder, класс 380
alert, функция 380
all
функция 152
Android-приложения, сборка с помощью Gradle 384
Anko, библиотека 379
определение простой формы 380
AnnotationTarget, перечисление 322
annotation, модификатор 321
Ant, сборка кода на Kotlin 386
Any, класс 226
Any, тип 200
Any?, тип 200
any, функция 152
Appendable, интерфейс 284
append, метод 331, 356
apply, функция 169, 359
arrayListOf, функция 209
ArrayList, класс 281
arrayOf, функция 316
asSequence, функция 157, 160
as? оператор 180
average, функция 261
В
BigDecimal, класс 225
Biglnteger, класс 219
Book, класс 154
Boolean?, тип 197
Bootstrap, библиотека 364
break, инструкция 272
builderAction, параметр 357
buildString, функция 170, 355, 356
build, метод 339
Button, класс 161
by Lazy(), прием 238
by, ключевое слово 237
cacheData, словарь 344
callback?.invoke(), метод 257
са11Ву(), метод 341
call, метод 328
Предметный указатель
CharSequence, интерфейс 284
CharSequence, класс 232
CLassCastException, исключение 287
CLassInfoCach, класс 340
Classlnfo, класс 340
Column, класс 247
Comparable, интерфейс 227, 281
compareTo, метод 227
compareValuesBy, функция 228
compare, метод 301
compile, метод 370
componentl, функция 236
component2, функция 236
componentN, функция 234
const, модификатор 316
Consumer, класс 302
ContactListFilters, класс 259
contains, функция 230
count, функция 153
createCompositeProperty, метод 339
createSeedForType, функция 341
createSimpleTable, функция 354
createViewWithCustomAttributes, функция 170
D
DateSerializer, класс 325, 336
dec, функция 225
Delegates.observable, функция 249
Delegate, класс 238
delegate, цель 318
dependencies, переменная 370
DependencyHandler, класс 371
deserialize, функция 320, 337
div, функция 220
dolnit, функция 362
Dokka 390
DSL (Domain-Specific Languages) 347, 383
внешние 351
внутренние 351
лямбда-выражения с приемниками 355
создание разметки HTML 353
структура 352
Е
endsWith, метод 284
ensureAUParametersPresent, функция 345
Entity, класс 247
❖
595
equals, метод 225
Exposed, фреймворк 351, 378, 393
extends, ключевое слово 282
F
field, идентификатор 241
field, цель 317
file, цель 318
filterlslnstance, функция 289, 290
filter,функция 150, 251, 253, 260, 267
findAnnotation, функция 333
find, функция 153, 158
firstOrNull, функция 153
forEach, функция 145, 272
for, цикл
метод iterator 232
Fuel, библиотека 392
FunctionNjnn 254
Function, интерфейс 303
funKTionale, библиотека 393
G
generateSequence, функция 160
getPredicate, метод 260
getSerializer, функция 335
getShippingCostCaleulator, функция 258
Getter, интерфейс 330
getValue, метод 239
getValue, функция 243
get, метод 229
get, функция 368
get, цель 317
Gradle DSL 370
Gradle, сценарии сборки 352
groupBy, метод 351
groupBy, функция 154
H
Hamkrest, фреймворк 391
hashMapOf, функция 209
hashSetOf, функция 209
Herd, класс 297, 301
I
IllegalArgumentException, исключение 287, 342
inc, функция 225
inline, ключевое слово 263, 268
396 ♦
Предметный указатель
Int?, тип 197
invoke, метод 328
invoke? метод 254
invoke, соглашение 367
в предметно-ориентированных языках 370
вызов объектов 368
и типы функций 368
invoke, функция 368
in, ключевое слово 301
in, оператор
обзор 230
is, проверка 286
iterator, метод 156, 232
it, параметр 280
it, соглашение 144
it, ссылка 361
J
Java
вызов функций 254
функциональные интерфейсы, использование
лямбда-выражений 161
javaClass, свойство 327
java.lang.Qass, класс 292
java.Lang.lterable, интерфейс 218
java.nio.CharBuffer, класс 283
joinToStringBuilder, метод 332
joinToString, функция 143, 255
JSON
парсинг и десериализация объектов 337
сериализация, настройка с помощью
аннотаций 319
jsonNameToDeseriaLizeCLass, словарь 345
jsonNameToParam, словарь 345
JsonObject, интерфейс 337
JvmOverloads, аннотация 318
К
KAnnotatedElement, интерфейс 333
Kara, веб-фреймворк 393
KCallable.call, метод 342
KCalLable, класс 327
KClass, класс 327
kFunction.call(), функция 328
KFunction, класс 327
Kodein, фреймворк 392
Kotlin
система типов 172
kotLintest,библиотека 353, 372
KotlinTest, фреймворк 391
kotlinx.html, библиотека 363, 393
kotlin, свойство 327
Kotlin, экосистема 391
веб-приложения 392
внедрение зависимостей 392
доступ к базам данных 393
клиенты HTTP 392
настольные приложения 394
сериализация JSON 392
тестирование 391
утилиты и структуры данных 393
Kovenant, библиотека 393
Kovert, REST-фреймворк 393
KProperty, класс 243, 327
Ktor, проект 393
L
ateinit, модификатор 187
azy, функция 239
et, функция 184
.inkedMapOf, функция 209
jnkedSetOf, функция 209
jstOf, функция 209, 278
List, интерфейс 280, 307
List, тип 209
oadEmails, функция 238
LoadService, функция 291
.ocalDate, класс 232
_ock. объект 263
М
mapKeys? функция 154
mapOf, функция 209
mapValues, функция 154
Мар, интерфейс 229
Мар, тип 209
тар, функция 150, 266, 267
Markdown 388
тахВу, функция 141, 144
max, функция 283
memberProperties, свойство 328
minusAssign, функция 223
Предметный указатель ❖
minus, функция 220
Mockito-KotLin, фреймворк 392
mod, функция 220
mutabLeListOf, функция 209
MutableList, интерфейс 293, 300, 307
mutableMapOf, функция 209
MutableMap, интерфейс 229
mutabLeSetOf, функция 209
naturalNumbers, функция 160
noinlme, модификатор 266, 293
Nothing,тип 202
подфункция 224
null
поддержка в Kotlin 172
NuLLPointerException, исключение 172
способы борьбы 176
О
objectlnstance, свойство 336
ObjectListSeed, класс 339
ObjectSeed, класс 339
ObservableProperty, класс 242
OkHttp, библиотека 392
OnClickListener, интерфейс 139, 161
onCLick, метод 147
operator, ключевое слово 219
orderBy, метод 351
out, ключевое слово 299
Р
Pair, класс 235
paramToSerializer, словарь 345
рагат,цель 317
Person, класс 140, 320
plusAssign, функция 223
plus, метод 218
plus, функция 220
Point, класс 219
printSum, функция 288
Processor, класс 284
process, функция 284
Producer, класс 302
PropertyChangeEvent, класс 240
PropertyChangeSupport, класс 240
property, цель 317
R
rangeTo, функция 231
receiver, цель 317
Rectangle.contains, функция 231
Ref, класс 147
remove, функция 315
replaceWith, параметр 315
Retrofit, библиотека 392
return, выражение 259
return, инструкция 271
Runnable, интерфейс 162
run, метод 163
run, функция 148
RxJava, библиотека 393
RxKotlin, расширение 393
S
SAM-конструкторы 164
Seed, интерфейс 339
selectAll, метод 351
Sequence.map, функция 266
Sequence, интерфейс 156
serializePropertyValue, функция 332
serializeProperty, функция 334, 336
serializerClass, параметр 325
serializeString, функция 332
serialize, функция 319
ServiceLoader, класс 291
setOf, функция 209
setOnClickListener, функция 161
$е1рагат,цель 318
setSimpleProperty, метод 338
Setter, интерфейс 330
setValue, функция 243
set, метод 229
Set, тип 209
set, цель 317
should, функция 373
SiteVisit, класс 260
slice, функция 279
sortedMapOf, функция 209
sortedSetOf, функция 209
spawn, функция 340
Spek, фреймворк 391
Spring Kotlin, проект 392
Stream.map, метод 304
397
398 <♦ Пред метн ый указател ь
stringBuilder, аргумент 168
StringBuilder, класс 355
StringList, класс 281
String, класс 281
strLenSafe, функция 174
strLen, функция 173
synchronized, функция 264, 269
Т
table, фунция 360
TemporaryFolder, правило 317
this, ссылка 166
Thymeleaf, механизм шаблонов 393
timeout, параметр 316
timesAssign, функция 223
times, функция 220
toList, функция 157
TornadoFX, библиотека 394
toString, метод 143, 256
Triple, класс 235
try/finally, инструкция 269
try-with-resources, инструкция 269
tr, функция 360
Т, параметр типа 279
U
unaryMinus, функция 224
unaryPlus, функция 224
Unit,тип 201
use, функция 270
ValueListSeed, класс 339
ValueSerializer, интерфейс 325, 342
value, метод 322
vert.x, библиотека 392
W
Wasabi, HTTP-фреймворк 393
withLock, функция 264, 269
w ith,функция 166, 359
А
аннотации
для настройки сериализации JSON 319
классы как параметры 323
метааннотации 322
настройка сериализации 333
обобщенные классы, параметры 324
объявление 321
применение 315
управление обработкой 322
цели аннотаций 316
аннотация, обработка 385
аргументы типов 279
арифметические операторы, перегрузка 219
двухместные 219, 220
составные операторы присваивания 222
унарные операторы 224
безопасное приведение типов 180
В
вариантность
определение в месте использования 304
определение в месте объявления 304
определение для вхождений типов 304
вариантность в месте объявления 277
веб-приложения 392
верхняя граница типов 282
внедрение зависимостей 392
внешние переменные 146
возврат функций из функций 258
встраиваемые функции 250, 263, 288
встраивание операций с коллекциями 266
как работает встраивание 263
когда использовать 268
ограничения 265
управление ресурсами с помощью
лямбда-выражений 269
Д
двухместные арифметические операторы 219
декларативные языки 350
делегаты 236
делегирование свойств 236
вфреймворках 246
основы 237
отложенная инициализация 238
правила трансляции 244
реализация 240
сохранение значений в словаре 245
десериализация 319
Предметный указатель ❖
399
иапазоны
закрытые 231
открытые 231
соглашения 231
документирование, кода на КоШп 388
доступ к базам данных 393
groupBy 154
map 150
командные API 352
коммутативность 221
константы времени компиляции
контравариантность 301
завершающие операции 157
захват переменных 146
лексемы-значения 337
лексемы-символы 337
литералы, простых типов 199
лямбда-выражения
возврат из 272
встраивание, для управления ресурсами 269
доступность переменных в области
видимости 145
захват переменных 146
и коллекции 140
инструкция return 271
использование функциональных интерфейсов
Java 161
обзор 138
синтаксис 141
с приемниками
в построителях разметки HTML 359
функции with и apply 166
с приемниками в DSL 355
с приемником
сохранение в переменной 358
ссылки на члены класса 148
устранение повторяющихся фрагментов 260
функции with и apply 169
функциональный API для коллекций 150
all 152
any 152
count 152
filter и map 150
find 152
flatMap 154
flatten 154
groupBy 154
И
изменяемые переменные 147
инициализация, отложенная 238
инфиксные функции 348
инфиксный вызов функций 372
квадратные скобки 228
классы
как параметры аннотаций 323
обобщенные
объявление 280
классы,типы и подтипы 294
клиенты HTTP 392
ковариантность 297
код на Kotlin
генерирование документации 390
документирование 388
сборка с помощью Ant 386
сборка с помощью GradLe 383
сборка с помощью Maven 385
коллекции
и лямбда-выражения 140
как платформенные типы 210
соглашения 228
метод iterator для цикла for 232
оператор in 230
оператор индекса 228
функциональный API 150
all 152
any 152
count 152
filter 150
find 152
flatMap 154
flatten 154
M
массивы
объектов и простых типов 213
массивы и коллекции 203
допустимость null 203
400 ❖
Предметный указатель
изменяемые и неизменяемые 206
метааннотации 322
мультидекларации 233
и циклы 235
Н
наследование 194
настольные приложения 394
неизменяемые переменные 147
О
обобщенные типы
во время выполнения 285
ограничения овеществляемых параметров
типов 292
и подтипы 293
передача аргумента в функцию 293
ограничение поддержки null 284
подтипы
классы и типы 293, 294
обращение отношения тип-подтип 301
сохранение отношения тип-подтип 297
проверка и приведение типов 285
стирание типов 285
обобщенные типы, во время выполнения
замена ссылок на классы 291
объявление функций с овеществляемыми
параметрами типов 288
обработка аннотаций 385
объект-приемник 357
объекты
сериализация
с использованием механизма рефлексии 331
овеществляемые параметры типов 277
замена ссылок на классы 291
объявление функций 288
оператор безопасного вызова ?. 177
оператор индекса 228
оператор строгого равенства, или идентичности 226
операторы сравнения, перегрузка 225
операторы отношения 227
операторы равенства 225
отложенная инициализация 238
отложенная инициализация, свойства 186
П
параметры обобщенных типов 278
ограничения овеществляемых параметров
типов 292
обобщенные функции и свойства 279
объявление обобщенных классов 280
ограничение поддержки null 284
ограничения 282
параметры типов
овеществляемые параметры типов
замена ссылок на классы 291
объявление функций 288
ограничения 282
параметры типов с поддержкой null 189
пары ключ/значение 320
перегрузка
арифметических операторов 219, 222
двухместных 219
составные операторы присваивания 222
унарные операторы 224
платформенные типы 191
назначение 193
подтипы и обобщенные типы 293
поразрядные операторы 222
порядок выполнения функций высшего
порядка 270
return в лямбда-выражениях 271
возврат из лямбда-выражений 272
последовательности 156
построители разметки HTML 359
предметно-ориентированные языки 347, 383
внешние 351
внутренние 351
инфиксный вызов функций 372
и соглашение invoke 370
лямбда-выражения с приемниками 355
на практике 372
поддержка SOL 376
расширения для простых типов
даты 375
создание пользовательских интерфейсов в
Android 379
создание разметки HTML 353
структура 352
члены расширения
недостатки 378
члены-расширения 376
преобразования чисел 198
проекции типов 306
Предметный указатель ❖
промежуточные операции 157
простые типы 195
с поддержкой null 197
Р
раскрывающееся меню 365
расширение типов с поддержкой null 188
расширения для простых типов 375
расширяемые объекты 245
рефлексии, механизм
createSeedForType, функция 341
в Kotlin 327
сериализация объектов 331
С
свойства
обобщенные 279
члены 329
сериализация JSON 392
синтаксис проекций со звездочкой 307, 309
обзор 286
синтетические типы, генерируемые
компилятором 329
составные операторы присваивания 222
ссылки на конструктор 149
ссылки на члены класса 148
стирание типов 285
строки
преобразование 200
структурированные API 355
Т
теневое свойство 239
тестирование 391
типы с поддержкой null 173
типы функций 251
У
унарные операторы 224
утверждение!! 182
утилиты и структуры данных 393
Ф
фигурные скобки 141
финальные переменные 146
функции
401
обобщенные 279
функции высшего порядка
возврат функций из функций 258
встраиваемые функции 263
встраивание операций с коллекциями 266
как работает встраивание 263
когда использовать 268
ограничения 265
управление ресурсами с помощью лямбдавыражений 269
использование из Java 254
объявление 251
вызов функций, переданных в аргументах 252
значения по умолчанию для параметров 255
порядок выполнения 270
return в лямбда-выражениях 271
возврат из лямбда-выражений 272
типы функций 251
устранение повторяющихся фрагментов 260
Ц
цепочки вызовов в kotlintest DSL 373
Ч
члены расширения
недостатки 378
члены-расширения 376
Э
экосистема Kotlin 391
веб-приложения 392
внедрение зависимостей 392
доступ к базам данных 393
клиенты HTTP 392
настольные приложения 394
сериализация JSON 392
тестирование 391
утилиты и структуры данных 393
Я
ясные API 348
Книги издательства «Д М К П ресс» мож но заказать в торгово-издательском х о л ­
динге «П ланета Альянс» наложенны м платежом, выслав открытку или письмо по
почтовому адресу: 115487, г. Москва, 2-й Нагатинский пр-д, д. 6А.
При оф ормлении заказа следует указать адрес (полностью ), по которому должны
быть высланы книги; фамилию, имя и отчество получателя. Ж елательно также ука­
зать свой телефон и электронный адрес.
Эти книги вы мож ете заказать и в интернет-магазине: www.alians-kniga.ru.
Оптовые закупки: тел. (4 9 9 ) 782-38-89
Электронный адрес: books@alians-kniga.ru.
Ж емеров Дмитрий Борисович
И сакова Светлана Сергеевна
Kotlin в ействии
Главный редактор М о вч а н Д . А .
dmkpress@gmail.com
П еревод с английского К и селев А . К
Корректор С и н яева Г. К
Верстка П а р а н ск а я Н. В .
Д изайн облож ки М о вч а н А . Г.
Ф ормат 7 0 х 1 0 0 У 16. Печать цифровая.
Уел. печ. л. 37,68. Тираж 200 экз.
Веб-сайт издательства: www.дмк.pф