- Filtering collections
- Filter by predicate
- Partition
- Test predicates
- Фильтрация коллекций
- Фильтр с предикатом
- Фильтр с разделением
- Проверочные предикаты
- Kotlin Android Extensions: полное руководство
- Что такое Kotlin Android Extensions?
- Как этим пользоваться
- Включаем Kotlin Android Extensions в наш код
- Восстанавливаем view из XML
- Магия Kotlin Android Extensions
- Kotlin Android Extensions ― работа с фрагментами
- Kotlin Android extensions и Custom View
- Восстанавливаем views из другого view
- Kotlin Android Extensions версии 1.1.4
- Применяем на ViewHolder (или любом пользовательском классе)
- Kotlin Android Extension. Реализация Parcelable
- Настройка кэша
- Заключение
Filtering collections
Filtering is one of the most popular tasks in collection processing. In Kotlin, filtering conditions are defined by predicates – lambda functions that take a collection element and return a boolean value: true means that the given element matches the predicate, false means the opposite.
The standard library contains a group of extension functions that let you filter collections in a single call. These functions leave the original collection unchanged, so they are available for both mutable and read-only collections. To operate the filtering result, you should assign it to a variable or chain the functions after filtering.
Filter by predicate
The basic filtering function is filter() . When called with a predicate, filter() returns the collection elements that match it. For both List and Set , the resulting collection is a List , for Map it’s a Map as well.
The predicates in filter() can only check the values of the elements. If you want to use element positions in the filter, use filterIndexed() . It takes a predicate with two arguments: the index and the value of an element.
To filter collections by negative conditions, use filterNot() . It returns a list of elements for which the predicate yields false .
filterNotNull() returns all non-null elements. Being called on a List , filterNotNull() returns a List , thus allowing you to treat the elements as non-null objects.
Partition
Another filtering function – partition() – filters a collection by a predicate and keeps the elements that don’t match it in a separate list. So, you have a Pair of List s as a return value: the first list containing elements that match the predicate and the second one containing everything else from the original collection.
Test predicates
Finally, there are functions that simply test a predicate against collection elements:
any() returns true if at least one element matches the given predicate.
none() returns true if none of the elements match the given predicate.
all() returns true if all elements match the given predicate. Note that all() returns true when called with any valid predicate on an empty collection. Such behavior is known in logic as vacuous truth.
any() and none() can also be used without a predicate: in this case they just check the collection emptiness. any() returns true if there are elements and false if there aren’t; none() does the opposite.
Источник
Фильтрация коллекций
Фильтрация — одна из самых популярных задач при работе с коллекцией. В Kotlin условия фильтра задаются с помощью предикатов — лямбда-функций, которые принимают элемент коллекции, а возвращают логическое значение ( boolean ): true означает, что элемент соответствует предикату, false — не соответствует.
В стандартной библиотеке есть группа функций-расширений, с помощью которых можно фильтровать коллекции за один вызов такой функции. Они не изменяют исходную коллекцию, поэтому их можно использовать и для изменяемых, и для неизменяемых коллекций. Чтобы использовать результат фильтрации, вы должны либо присвоить его переменной, либо использовать его в цепочке вызовов.
Фильтр с предикатом
Основная функция для фильтра коллекций — filter() . Если использовать filter() с предикатом, то будут возвращены те элементы, которые ему соответствуют. Для List и Set функция возвращает результат типа List , для Map возвращается Map .
В функции filter() предикаты могут проверять только значения элементов. Если при фильтрации вы хотите использовать индексы элементов, то вам нужна функция filterIndexed() . Она принимает предикат с двумя аргументами: индекс и значение элемента.
Если вы хотите отфильтровать элементы, которые не соответствуют заданному условию, то используйте функцию filterNot() . Она возвращает те элементы, для которых предикат вернул значение false .
Также существуют функции, которые фильтруют только элементы заданного типа:
()` returns a `List `, thus allowing you to call functions of the `T` type on its items. —>
filterIsInstance() возвращает элементы заданного типа. При вызове функции filterIsInstance () для списка типа List вернётся список типа List , что позволяет вызывать специфичные для элементов T функции.
filterNotNull() возвращает значения неравные null . При вызове функции для списка List вернётся список типа List , что позволяет обращаться к элементам как к ненулевым объектам.
Фильтр с разделением
Другая функция для фильтрации — partition() — фильтрует коллекцию по предикату и сохраняет элементы, которые ему не соответствуют, в отдельном списке. Возвращает объект типа Pair
, где первый список содержит элементы, соответствующие предикату, а второй — все остальные элементы из исходной коллекции.
Проверочные предикаты
Ну и наконец, есть функции, которые проверяют каждый элемент на соответствие предикату:
- any() — возвращает true , если хотя бы один элемент соответствует предикату.
- none() — возвращает true , если ни один элемент не соответствует предикату.
- all() — возвращает true , если все элементы соответствуют предикату. Обратите внимание, что если вызвать all() для пустой коллекции с любым валидным предикатом, то функция вернёт true . Такое поведение известно как бессмысленная истина (ориг. vacuous truth).
any() и none() могут использоваться без предиката. В этом случае они просто проверяют пуста ли коллекция. any() возвращает true , если в коллекции есть элементы, а none() наоборот, возвращает true , если коллекция пуста.
Источник
Kotlin Android Extensions: полное руководство
Oct 9, 2018 · 7 min read
Если у вас уже есть опыт разработки приложений для Android, вероятно, вы уже устали использовать findViewById, чтобы восстанавливать view. Или, может быть, вы уже сдались и начали использовать известную библиотеку ― Butterknife. Если это ваш случай, то вы влюбитесь в Kotlin Android Extensions.
Что такое Kotlin Android Extensions?
Kotlin Android Extensions — это плагин для Kotlin, который включён в стандартный пакет. Он позволяет восстанавливать view из Activities, Fragments, и Views удивительно-бесшовным способом.
Плагин генерирует дополнительный код, который позволяет получить доступ к view в виде XML, так же, как если бы вы имели дело с properties с именем id, который вы использовали при определении структуры.
Т а кже он создаёт локальный кэш view. При первом использовании свойства, плагин выполнит стандартный findViewById. В последующем, view будет восстановлен из кэша, поэтому доступ к нему будет быстрее.
Как этим пользоваться
Посмотрим, насколько это просто. В первом примере рассмотрим activity:
Включаем Kotlin Android Extensions в наш код
Хотя плагин уже интегрирован (устанавливать новый не нужно), если вы хотите его использовать, вам нужно подключить плагин в модуль Android:
И это все что вам потребуется. Теперь вы можете начать работу с ним.
Восстанавливаем view из XML
С этого момента, восстановить view, также просто, как использовать view id, которое вы определили в XML, непосредственно в вашем activity.
Представьте, что у вас есть такой XML:
Как видно, в TextView есть id welcomeMessage .
Просто напишите следующий код в MainActivity:
Чтобы это работало, нужен специальный импорт (я написал его ниже), но IDE может автоматически импортировать его. Проще и быть не может!
Как я уже упоминал, сгенерированный код включает кэш view, поэтому, если вы повторно обратитесь к view, это не потребует выполнения findViewById снова.
Давайте посмотрим, что происходит под капотом.
Магия Kotlin Android Extensions
Когда начинаешь работать с Kotlin, действительно интересно понять байт-код, который генерируется при использовании той или иной функции. Это поможет вам понять скрытую цену ваших решений.
В меню Tools → Kotlin, вы найдёте мощный инструмент Show Kotlin Bytecode. Если кликнуть по нему, вы увидите байт-код, который будет сгенерирован, когда открытый файл класса будет скомпилирован.
Для большинства людей, байт-код не особенно полезен, но тут есть ещё одна опция: Decompile.
Эта опция покажет вам Java репрезентацию байт-кода, который был сгенерирован в Kotlin. Так, вы сможете более-менее понять, как будет выглядеть код Java, эквивалентный тому, что вы написали на Kotlin.
Я собираюсь использовать это на примере activity и посмотреть код, сгенерированный Kotlin Android Extensions.
Вот интересная часть:
Это и есть кэш view, о котором мы говорили.
При запросе view, его поиск начинается в кэше. Если view нет в кэше, то он туда будет добавлен, как только будет найден. Всё просто.
Кроме того, в код добавляется функция для очистки кэша: clearFindViewByIdCache. Её можно использовать, скажем, когда старые view уже не актуальны и вам нужно получить новые.
Тогда, эта строка:
Превращается в эту:
Таким образом, плагин не генерирует свойства для каждого view, это ненастоящие свойства. Плагин просто заменяет код во время компиляции, чтобы получить доступ к кэшу view. Затем, он приводит к нужному типу и вызывает метод.
Kotlin Android Extensions ― работа с фрагментами
Этот плагин можно использовать с фрагментами.
Проблема с фрагментами заключается в том, что view может обновится, а экземпляр фрагмента останется прежним. Что произойдёт? А то, что view находящееся в кэше, перестанет быть валидным.
Давайте посмотрим код, который генерирует плагин, если мы используем его с фрагментом. Я создаю простой фрагмент, который использует тот же XML, который я написал выше:
В onViewCreated , я снова изменяю текст TextView . Что насчёт сгенерированного байт-кода?
Всё тоже самое, как и в activity, с небольшой разницей:
Когда view перестанет быть актуальным, этот метод вызовет clearFindViewByIdCache , так что мы в безопасности!
Kotlin Android extensions и Custom View
С custom view, плагин работает схожим образом. Скажем, у нас есть такой view:
Я создаю очень простое custom view и генерирую конструкторы с новым намерением, которое использует аннотацию @JvmOverloads :
В примере выше, я изменяю текст в itemTitle . Сгенерированный код должен искать view в кэше. Не имеет смысла снова копировать тот же код полностью. Вы можете наблюдать это в строке, которая изменяет текст:
Отлично! В custom views мы тоже вызываем findViewById только первый раз.
Восстанавливаем views из другого view
Последняя альтернатива, которую предлагает Kotlin Android Extensions: использовать свойства напрямую из другого view.
Я использую схему, схожую с той, что была в предыдущем разделе. Представьте, что это было закачано в адаптер для примера.
Вы также можете получить доступ к subviews напрямую, просто используя этот плагин:
Хотя плагин и может помочь заполнить import, здесь есть небольшое отличие:
Несколько вещей, которые вам нужно знать:
- Во время компиляции, вы можете ссылаться на любое view из любого другого view. Это значит, вы можете ссылаться на view, которое не является его прямым потомком. Это плохо скажется на времени выполнения при попытке восстановить view, которого не существует.
- В этом случае, view не кэшировано, как в случае с Activities и Fragments.
Почему так? В отличие от предыдущих случаев, здесь у плагина нет места, чтобы генерировать необходимый код для кэша.
Если вы снова перечитаете код, который сгенерирован плагином, где вызываются свойства из view, вы увидите это:
Как видно, здесь нет запроса к кэшу. Будьте осторожны, если у вас комплексное view, и вы используете его в адаптере. Это может повлиять на производительность.
Также у вас есть альтернатива: Kotlin 1.1.4
Kotlin Android Extensions версии 1.1.4
Начиная с этой, новой версии Kotlin, в Android Extensions включили новые интересные функции: кэш в любом классе (включая ViewHolder ) и новая аннотация, названная @Parcelize . Также есть способ настраивать сгенерированный кэш.
Мы вернёмся к ним через минуту, но вам следует знать, что эти новые фичи ― не завершены, так что, вам нужно включить их с помощью build.gradle :
Применяем на ViewHolder (или любом пользовательском классе)
Теперь есть простой способ построить кэш для любого класса. Единственное требование заключается в том, чтобы класс имплементировал интерфейс LayoutContainer . Этот интерфейс предоставит view, которое плагин будет использовать, чтобы искать subviews. Представьте, что у вас есть ViewHolder, который содержит view со структурой, описанной в предыдущем примере. Всё что вам нужно сделать:
containerView ― единственное, что мы перезаписываем из интерфейса LayoutContainer . Это все что вам необходимо.
С этого момента, у вас есть доступ к views напрямую. Нет необходимости присоединять itemView, чтобы получить доступ к subviews.
Ещё раз, если вы посмотрите на сгенерированный код, вы увидите, что view берётся из кэша:
Здесь я применял его на ViewHolder , но это достаточно универсальный подход и его можно использовать с любым классом.
Kotlin Android Extension. Реализация Parcelable
С новой аннотацией @Parcelize , можно с лёгкостью имплементировать Parcelable c любым классом.
Вам нужно добавить аннотацию, а плагин сделает за вас всю сложную работу:
Далее, как вам должно быть известно, можно добавить объект к любому намерению:
И восстановить объект из намерения в любой точке (в этом случае: из activity):
Настройка кэша
В этот экспериментальный набор, включена новая фича ― аннотация @ContainerOptions . Она даёт возможность настраивать способ построения кэша, или даже предотвращать его создание классом.
По умолчанию, используется Hashmap , как мы видели ранее. Его можно заменить на SparseArray из Android framework, что может быть более эффективно в некоторых ситуациях. Или, если вам не нужен кэш для класса, по каким-то причинам, такая возможность тоже есть.
Вот как это использовать:
На данный момент существуют следующие варианты:
Заключение
Вы увидели, как легко работать с Android views в Kotlin. Благодаря простому плагину, можно забыть обо всём этом ужасном коде, связанном с восстановлением view. Этот плагин создаёт для нас необходимые свойства с приведением правильного типа, безо всяких проблем.
Кроме того, Kotlin 1.1.4 добавляет интересные фичи, которые будут действительно полезны в некоторых случаях, к которым плагин ранее не имел отношения.
Источник