Случайны выбор дневника Раскрыть/свернуть полный список возможностей


Найдено 2030 сообщений
Cообщения с меткой

rambler - Самое интересное в блогах

Следующие 30  »
rss_rss_hh_new

Страх и ненависть и пагинация

Пятница, 22 Июля 2016 г. 10:39 (ссылка)

А в чем проблема?



Типичная пагинация



Как бы нам не хотелось этого отрицать, практика показывает, что подавляющее большинство своего времени типичный iOS-разработчик проводит за работой с табличками. Проектирование сервисного слоя — это интригующе, разработка универсального роутинга в приложении — захватывающе, а от настройки гибких политик кэширования вообще крышу сносит, но работа с табличными интерфейсами — это наши серые будни. Иногда луч света все же попадает и в эту область, и вместо очередной возни с constraint'ами перед нами может встать задача реализации постраничной загрузки — или, как это модно называть в мобильных приложениях, infinite scroll'а.





Грузить сразу все новости, объявления, списки фильмов с удаленного ресурса как минимум не эффективно, поэтому в большинстве случаев сервер предоставляет клиентам различные механизмы разбития всего объема данных на части ограниченного размера.



Как говорится, so far so good. Мы загружаем первую партию данных, отображаем их в таблице, прокручиваем её до конца, загружаем следующую партию — и так до бесконечности. К сожалению — ну или к счастью, мы же любим вызов — на этом все только начинается.



В зависимости от сложности проекта и степени костыльности API, достаточно простая задача рискует переродиться в Нечто. Нечто именно с большой буквы, потому что это создание в итоге обретает свою собственную жизнь и начинает рушить судьбы всех, кто его коснется. Ближе к делу — приведу пример из реальной жизни, случившийся, тем не менее, в совсем абстрактном проекте.



Условия, с которыми нужно было работать:




  • любой из загруженных элементов может быть изменен с течением времени;

  • на стороне клиента нужно уметь прятать посты авторов из черного списка — учитывая, что сервер продолжает их возвращать;

  • несмотря на локальную фильтрацию, при запросе следующей страницы пользователь должен получить не меньше 20 новых элементов;

  • выдача целиком пересобирается раз в час — некоторые посты добавляются, некоторые — исчезают, и обязательно меняются все позиции в списке;

  • обращение к серверу идет не напрямую, а через CDN, что влечет за собой интересные артефакты;

  • единственный механизм постраничной загрузки, который может предложить сервер — это limit/offset.



Плохие новости — сделать в подобных случаях все правильно сложно. Хорошие новости — у меня в запасе есть целый структурированный арсенал костылей, который помогает справиться с большинством возникающих вопросов и проблем.



Декомпозиция



Сколь угодно сложная проблема или задача становится решаемой, если разбить её на ограниченное количество шагов. Наш случай не исключение. Чтобы понять принцип работы всей системы постраничной загрузки в вашем приложении достаточно декомпозировать её на несколько секций:




  1. Правила изменения количества элементов в выдаче:


    • Лента статична. Пример: Список заведений в редакционной подборке. Будучи один раз составленным, он уже не меняется.

    • Новые элементы добавляются строго сверху. Пример: История просмотра страниц приложения. В самом простом виде единственное её изменение — это добавление в начало списка новых просмотров страниц.

    • Любая часть выдачи может быть изменена. Пример: Список писем в почтовом клиенте. Пользователь может удалять, перемещать и получать новые письма, поэтому список может быть изменен на любой позиции.


  2. Правила изменения актуальности выдачи:


    • Выдача всегда остается актуальной. Пример: Все то же почтовое приложение. Элементы его могут меняться постепенно, нет строго детерминированной точки перехода из одного состояния в другое.

    • Выдача может быть переформирована в неопределенный момент времени. Пример: Новостное приложение с интеллектуальным ранжированием. Раз в час выдача новостей пересобирается и наиболее актуальные материалы перебираются в самый верх списка.


  3. Правила обновления контента:


    • Отображаемые данные не обновляются. Пример: Ячейки с названиями ресторанов. Смена названий настолько редка, что этой вероятностью можно смело пренебречь.

    • Отображаемые данные могут быть изменены. Пример: Ячейки со счетчиком лайков. С течением времени этот счетчик меняется — и нужно уметь обновлять эти данные для уже закэшированных элементов.




Задача реализации постраничной загрузки чаще всего делится на две крупные части: подгрузка данных вниз и обновление ленты, обычно совершаемое при pull-to-refresh. К каждой из этих задач требуется свой подход, целиком зависящий от приведенной выше схемы.



Костыли



Этот раздел — ключевая часть всего материала. Я собрал все костыли, которые вынужденно использовал при реализации сложного механизма постраничной загрузки на limit/offset.



Небольшой ликбез. Limit/offset — это наиболее часто встречающийся подход к реализации постраничной загрузки данных. Offset — это сдвиг относительно первого элемента. Limit — количество загружаемых данных.



Пример: пользователь хочет загрузить 10 новостей, начиная с двадцатой. offset: 10, limit: 20.


Подгрузка вниз / Лента изменяется



Если лента может быть изменена, не важно каким образом, то при попытке запросить следующую страницу мы можем столкнуться со сдвигом элементов вверх или вниз. Решение проблемы состоит из двух шагов. Первый относится к смещениям вниз. Представим ситуацию, при которой у нас уже загружена первая страница из пяти элементов. До следующего запроса структура данных на сервере изменилась и сверху выдачи добавились два новых элемента. Теперь при загрузке следующей страницы мы получим два элемента, которые у нас уже есть в кэше.



Подгрузка вниз / Лента изменяется



Ситуация может быть и хуже, если за время отсутствия синхронизации на сервер добавилось элементов больше, чем установлено в свойстве limit — тогда мы не получим ни одного нового элемента. Если в качестве offset'а мы будем использовать общее количество элементов в кэше, то застрянем в этой точке навсегда, так как продолжим запрашивать те элементы, которые уже были загружены.



Проблема решается достаточно просто. При получении очередной порции данных мы подсчитываем количество пересечений с закэшированным контентом — и в дальнейшем используем полученное значение как сдвиг offset'а. В приведенном выше примере этот сдвиг будет равен 2.



paging.startIndex = cachedPosts.count + intersections;
paging.count = 5;


Подгрузка вниз / Любая часть выдачи может быть изменена



Рассмотрим следующую ситуацию: мы загрузили страницу, но затем первые два элемента были удалены. Запросив следующую порцию данных, получаем дырку в два элемента. Если ничего не предпринять, приложение об этом ничего не узнает — и данные никогда не загрузятся.



Подгрузка вниз / Любая часть выдачи может быть изменена



Выход из этой ситуации — всегда запрашивать данные с наложением в один элемент. Если при получении данных мы не найдем пересечений — можно либо отменить результат запроса, либо повторить его с другими параметрами.



paging.startIndex = startIndex - 1;
paging.count = 5;


Небольшой лайфхак в копилку — если какие-то элементы в ленте потеряются, всегда можно сделать серьезное лицо и прочитать лекцию про интеллектуальное ранжирование данных, выполняемое на клиенте. Не поверят — покажите Facebook, у которых одна и та же выдача на каждом устройстве всегда выглядит абсолютно по-разному.


Подгрузка вниз / Выдача может быть реструктуризована в случайный момент времени



В таком случае самым простым вариантом реализации будет работа с так называемым слепком ленты. Под этим термином обычно понимают список идентификаторов всех записей выдачи. При первом открытии мы запрашиваем такой слепок и сохраняем его в базе, либо просто держим в памяти. Теперь для получения следующей страницы мы будем пользоваться не стандартным limit/offset, а более сложным запросом — просить сервер отдать посты по конкретным 20 идентификаторам.



NSRange pageRange = NSMakeRange = (startIndex, 20);
NSArray *postIds = [snapshot subarrayWithRange:pageRange];
[self makeRequestWithIds:postIds];


Даже если выдача неожиданно будет реструктуризована, нам это не помешает — мы работаем с тем слепком, который был актуален на момент первого запроса — и для клиента лента будет отсортирована точно также, как в момент первого открытия.



Подгрузка вниз / Выдача может быть реструктуризована в случайный момент времени



Обновление ленты / Элементы добавляются сверху



В этом случае нам в первую очередь необходимо уметь определять наличие дырок, образующихся в том случае, если со времени последней синхронизации было добавлено большое количество новых элементов.

Мы запрашиваем константное количество данных и проверяем наличие пересечений с данными из кэша. Если пересечения есть — все хорошо, можно продолжать работать в обычном режиме. Если пересечений нет — это значит, что мы пропустили несколько постов.



Обновление ленты / Элементы добавляются сверху



Что делать в этом случае — нужно решать для каждого конкретного приложения. Можно сбросить все данные, кроме запрошенных пяти элементов. Можно продолжать подгружать элементы сверху постранично, пока не будут обнаружены пересечения.



if (intersections == 0) {
[self dropCache];
}


Обновление ленты / Любая часть выдачи может быть изменена



У проблемы есть два способа решения:




  1. Сервер отдает diff’ы изменений в ленте, к примеру, основываясь на сохраненном Last-Modified последнего синхронизированного состояния выдачи. Параметр Last-Modified мы получаем из заголовков ответа сервера. Клиенту в таком случае останется просто применить эти изменения на состояние базы.



    for (ShortPost *post in diff) {
    [self updateCacheWith:post];
    }



  2. Если сервер так не умеет — приходится снова писать дополнительную сотню строк на клиенте. Нам нужно получить слепок постов (прямо как в одном из предыдущих пунктов) и сравнить его с текущим состоянием хранимых в кэше данных.



    for (ShortPost *post in snapshot) {
    if (![cachedPosts containsObject:post]) {
    [self downloadPost:post];
    }
    }
    for (Post *post in cachedPosts) {
    if (![snapshot containsObject:post]) {
    [self deletePost:post];
    }
    }





Все отсутствующие в слепке элементы — удалить, все недостающие — загрузить.



Обновление ленты / Меняется сортировка



Если выдача была реструктуризована, мы должны об этом узнать. Проще всего это сделать, послав на сервер head-запрос и сравнив параметры etag или Last-Modified с сохраненными значениями.



NSString *lastModified = [self makeFeedHeadRequest];

if (![lastModified isEqual:cachedLastModified]) {
[self dropCache];
[self obtainPostSnapshot];
[self obtainFirstPage];
}


Если результат сравнения отрицательный — состояние кэша сбрасывается, слепок id обновляется.



Обновление ленты / Элементы выдачи могут меняться



Если элементы списка содержат изменяющиеся со временем данные, вроде рейтинга или количества лайков — их нужно обновлять. Решение проблемы, в принципе, коррелирует с одним из предыдущих пунктов — мы работаем либо с diff’ом, возвращенным сервером, либо запрашиваем краткие структуры данных, содержащие только значимые поля. После этого вручную обновляем состояние элементов.



for (NSUInteger i = 0; i < cachedPosts.count; i++) {
Post *cachedPost = cachedPosts[i];
ShortPost *post = snapshot[i];

if (![cachedPost isEqual:post]) {
[cachedPost updatePostWithShortPost:post];
}
}


Главное — максимально сократить количество передаваемых данных.



Советы на будущее



В завершении хочу дать несколько советов разной степени полезности.



Совет 1, очевидный



Бывает очень удобно иметь специальный объект, описывающий текущую выдачу. Назовите его списком, категорией, фидом — не важно.



@interface Feed: NSObject

@property (nonatomic, copy) NSArray *posts;
@property (nonatomic, copy) NSArray *snapshot;
@property (nonatomic, assign) NSUInteger offset;
@property (nonatomic, assign) NSUInteger maxCount;
@property (nonatomic, strong) NSDate *lastModified;

@end


Он может содержать текущий offset, максимальное количество элементов ленты, дату Last-Modified, слепок id — все, что нужно для описания списка элементов.



Совет 2, архитектурный



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

Отделяйте логику запроса данных от логики их получения, обработки и отображения.



Отделяйте логику запроса данных от логики их получения, обработки и отображения



Абстрагируйтесь от сложностей и костылей, которые мы обсудили в этой статье. Наша главная цель — обеспечить постоянную синхронизацию состояния кэша и отображения. Если на экране отображается то же самое, что находится в базе данных — жизнь становится намного проще.



В этом, к примеру, может помочь NSFetchedResultsController, уведомления CoreData или схожие механизмы других ORM.



Совет 3, маскировочный



Инкапсулируйте всю логику обновления ленты и пагинации в отдельном объекте — фасаде над сервисами, занимающимися непосредственной загрузкой.



Именно в этом объекте находятся самые страшные вещи — вложенные блоки, сверка индексов и пересечений, логические ветвления. Для потребителей интерфейс фасада выглядит предельно простым и предоставляет основные методы для работы с постраничными данными — загрузка следующей страницы, обновление списка и полная его перезагрузка. Обратите особое внимание на то, что этот объект должен быть максимально хорошо протестирован.



Совет 4, самый главный



До последнего пытайтесь настоять на нормальной реализации постраничной загрузки на сервере. Limit/offset это, конечно, достаточно гибкое решение, однако клиент должен быть простым. Нет, правда, максимально простым!



Полезные ссылки




Original source: habrahabr.ru (comments, light).

https://habrahabr.ru/post/306158/

Метки:   Комментарии (0)КомментироватьВ цитатник или сообщество
motsyuk

«Ленте.ру» сменился главный редактор » Poznavatel.com - твой гид в интернете

Суббота, 23 Апреля 2016 г. 16:00 (ссылка)
poznavatel.com/48--lenteru-...aktor.html


«ленте.ру» сменился главный редактор главным редактором «ленты.ру» назначен александр белоновский. он сменил на этом посту алексея

Метки:   Комментарии (0)КомментироватьВ цитатник или сообщество
rss_rss_hh_new

Генерамба — кодогенератор для iOS разработки

Четверг, 11 Февраля 2016 г. 14:55 (ссылка)


image



TL;DR

Мы написали классный кодогенератор для iOS-разработки, обладающий следующими достоинствами:


  • Поддержка Swift и Objective-C,

  • Использование языка разметки liquid для создания шаблонов,

  • Гибкая система управления шаблонами,

  • Интеграция с менеджером зависимостей Cocoapods.



Больше подробностей — под катом.

Читать дальше →

https://habrahabr.ru/post/276275/

Метки:   Комментарии (0)КомментироватьВ цитатник или сообщество
rss_rss_hh_new

Анонс Rambler.iOS #5 — VIPER Edition

Вторник, 08 Декабря 2015 г. 13:00 (ссылка)


image



Мы строили, строили и наконец построили! Да здравствуем мы, ура!

Чебурашка
Читать дальше →

http://habrahabr.ru/post/272551/

Комментарии (0)КомментироватьВ цитатник или сообщество
rss_rss_hh_new

Конвейерное производство Android приложений

Понедельник, 26 Октября 2015 г. 19:21 (ссылка)

Многие разработчики сталкиваются с задачей создания кастомизированных приложений. Например, разработка нескольких версий одного приложения или изменения стандартного приложения под требования заказчика. Мы в Rambler&Co столкнулись с такой задачей при разработке Rambler кассы и ее брендированных версий под отдельные кинотеатры. В данной статье рассмотрим эволюцию архитектуры такого приложения, а также инструменты, которые упрощают нам жизнь.







Постановка задачи



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



Цели и конверсия


Кастомизированные приложения положительно влияют на конверсию. Основная цель пользователей в приложении – просмотр расписания любимого кинотеатра и покупка билетов. Наличие приложений позволяет сократить кол-во кликов от открытия до нажатия кнопки купить билет на 2-3 клика. А как известно, каждый клик это -N% пользователей. Так же присутствует возможность доносить до пользователей информацию об акциях и скидках.



Архитектура



Изменения касаются UI, основные сущности и функционал остаются без изменений. Фильтрация источников не требуется, выполняется со стороны API.



Изначально была задача сделать одну брендированную версию, планы по развитию были весьма туманны. Ветвление по версиям было через if. Примерно так:



if (TYPE == KASSA1) {
return 1;
} else if (TYPE == KASSA2) {
return 2;
} else {
return 3;
}


Или через switch:



switch (TYPE) {
case KASSA1:
return 1;
case KASSA2:
return 2;
default:
return 3;
}


Решение очень плохое, множество недостатков и почти нет преимуществ. Вся разработка в одной кодовой базе, огромное количество кода, сложная отладка и дебаг, проблема деплоя. Вся гамма эмоций на одной картинке:

IF, IF EVEREWHERE




Flavors


Следующей веткой эволюции стало использование Gradle Flavors + build Types

Создаются отдельные версии приложений, переключение между ними происходит в окошке build types, параллельно можно задавать конфигурации, например: debug, release, manager, testOrder и так далее. Каждая конфигурация содержит свой код и ресурсы. Одной из неприятных особенностей flavors является сложная навигация по коду в неактивной ветке. Пример конфигурации:



productFlavors {
kassaCinema1 {
applicationId "ru.rambler.cinema1"
versionName "1.3"
}
kassaCinema2 {
applicationId "ru.rambler.cinema2"
versionName "1.1"
}
}


Основные возможности:


http://habrahabr.ru/post/269429/

Метки:   Комментарии (0)КомментироватьВ цитатник или сообщество
rss_rss_hh_new

По итогам Rambler.iOS #4

Вторник, 29 Сентября 2015 г. 17:59 (ссылка)





В прошлую пятницу на уютной мансарде компании Rambler&Co прошла четвертая встреча iOS разработчиков Москвы.



Докладчиков, по уже сложившейся традиции, было трое.



Максим Савушкин рассказал, как создать модульное приложение, с помощью чего минимальными усилиями осуществлять брендинг. Им были затронуты такие темы, как VIPER, Nimbus и Typhoon.

Видео

Слайды



Мы, кстати, оказались немного обескуражены вопросом о том, зачем превращать код с множеством if-else во что-то красивое и модульное: казалось, что Фаулер и его единомышленники рассказали до нас это много раз, однако, возможно, у кого-то из вас есть какие-то комментарии к той или иной стороне баррикад.



Доклад Егора Толстого был посвящен вопросам многопоточности в iOS приложениях и решению классических задач синхронизации. Кроме того, в качестве примера использования NSOperations для решения одной из проблем, была показана красивая демка создания молекул воды из потоков-атомов.







Видео

Слайды

Проект на GitHub



Для короткого перерыва Сергей Крапивенский подготовил раунд “Своей игры” с вопросами по около-iOsным темам. 4 участника, 25 вопросов и всего один приз, но, кажется, весело было как игрокам, так и зрителям.







После Егора все наши секреты написания бизнес-логики и грабли, по которым мы прошлись, раскрыл Герман Сапрыкин:

Видео

Слайды



Хотелось бы поблагодарить всех, кто пришел, проявил активность и поучаствовал в коротенькой «Своей Игре» и снова поздравить счастливого обладателя новенькой лицензии на AppCode. Судя по тому, что игра стала одной из самых позитивных частей нашей встречи, мы решили подумать над дальнейшим развитием подобного интерактива.



Если вы хотите выступить на следующей конференции Rambler.iOS, ждем ваших писем с предполагаемыми темами на rambler.ios@rambler-co.ru.



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



И спасибо Екатерине Коровкиной за помощь в проведении мероприятия и составление пресс-релиза!



Original source: habrahabr.ru (comments, light).

http://habrahabr.ru/post/267913/

Метки:   Комментарии (0)КомментироватьВ цитатник или сообщество
rss_rss_hh_new

Moscow Python Meetup в Rambler&Co

Среда, 23 Сентября 2015 г. 13:49 (ссылка)






8-го октября (четверг) в Rambler&Co мы ждем в гости Moscow Python Meetup. 1-я встреча нового сезона начнется в 19.00. На встрече нас ждут 3 доклада.



Читать дальше →

http://habrahabr.ru/post/267543/

Метки:   Комментарии (0)КомментироватьВ цитатник или сообщество
rss_rss_hh_new

Открытый митап Rambler.Android

Вторник, 01 Сентября 2015 г. 13:02 (ссылка)

Rambler.Android — периодические встречи Android-разработчиков, проводимые компанией Rambler&Co.



В сентябре у нас будет третья встреча, и она будет особенная. После предыдущих двух, которые были внутренними, мы решили полностью изменить формат. Участие во встрече будет открытым, и любой, кто вовлечён в Android разработку, теперь может присоединиться к нам.



Темы докладов:


  • Конвейерное производство приложений (Мельников Андрей — andrey7mel)

  • Android M: опыт личного знакомства (Щенёв Вадим — v555)

  • Vector Drawable API. Возможности применения (Осипенко Олег — basnopisets)



Время проведения: 10 сентября, 19:00

Место проведения: Москва, Варшавское ш., 9 с.1 (БЦ «Даниловские мануфактуры»).

Регистрация (количество мест ограничено)

Наш twitter: @rambler_android

Original source: habrahabr.ru (comments, light).

http://habrahabr.ru/post/265867/

Метки:   Комментарии (0)КомментироватьВ цитатник или сообщество
rss_rss_hh_new

Управляем зависимостями в iOS-приложениях правильно: Typhoon Tips & Tricks

Четверг, 13 Августа 2015 г. 14:27 (ссылка)





В предыдущих частях цикла мы рассмотрели основные аспекты работы Typhoon и подготовились к полноценному применению его на практике. Тем не менее, помимо затронутых тем, фреймворк предоставляет большое количество других функций.



В этой статье мы рассмотрим следующие особенности Typhoon Framework:


  • Автоинъекция (также известная как autowiring),

  • Автоматический выбор из альтернативных реализаций одного TyphoonDefinition,

  • Особенности работы с TyphoonConfig

  • Использование TyphoonPatcher для организации интеграционных тестов,

  • Применение runtime-атрибутов при создании объектов,

  • Реализация фабрик на базе TyphoonAssembly,

  • Постпроцессинг объектов, создаваемых при помощи Typhoon,

  • Инструменты для написания асинхронных тестов.



Цикл «Управляем зависимостями в iOS-приложениях правильно»





Автоинъекции/Autowire



Зачастую, особенно в небольших проектах, не хватает времени на реализацию полноценного слоя TyphoonAssembly уровня контроллеров, в то время как сервисный слой уже готов. В таком случае может быть целесообразным использование автоинъекций, так же известных как autowiring. Посмотрим на простой пример конфигурации экрана просмотра почтового сообщения:

@interface RCMMessageViewController : UIViewController
#import TyphoonAutoInjection.h>

@protocol RCMMessageService;
@class RCMMessageRendererBase;

@interface RCMMessageViewController : UIViewController

@property (strong, nonatomic) InjectedProtocol(RCMMessageService) messageService;
@property (strong, nonatomic) InjectedClass(RCMMessageRendererBase) renderer;

@end


И единственная на данный момент TyphoonAssembly в приложении, указанная в Info.plist:

@implementation RCMHelperAssembly
@implementation RCMHelperAssembly

- (RCMMessageRendererBase *)messageRenderer {
return [TyphoonDefinition withClass:[RCMMessageRendererBase class]];
}

- (id )messageService {
return [TyphoonDefinition withClass:[RCMMessageServiceBase class]];
}

@end


Попробуем запустить приложение с такой конфигурацией:





Как видим, нужные зависимости были подставлены автоматически. Обращаю внимание на то, что при использовании автоинъекции не требуется писать метод, отдающий TyphoonDefinition для ViewController'а. Также стоит отметить, что такой подход работает только при создании UIViewController из TyphoonStoryboard.



Похожий подход может быть использован и при написании интеграционных тестов — вместо того, чтобы вручную создавать зависимости тестируемого объекта, можно автоматически подставить их из определенной TyphoonAssembly:

@interface RCMMessageServiceBaseTests : XCTestCase
#import TyphoonAutoInjection.h>

@interface RCMMessageServiceBaseTests : XCTestCase
@property (nonatomic, strong) InjectedProtocol(RCMMessageService) messageService;
@end

@implementation RCMMessageServiceBaseTests

- (void)setUp {
[super setUp];
[[[RCMServiceComponentsAssemblyBase new] activate] inject:self];
}

- (void)testThatServiceObtainsMessage {
// ...
}

@end


Аналогичным образом зависимости подставляются в UIViewController, созданный вручную, либо из xib.



Как и у любой технологии, у autowire есть как достоинства:


  • Экономия времени за счет отсутствия необходимости реализовывать некоторые assembly,

  • Более информативные интерфейсы объектов — сразу же видно, какие зависимости подставляются при помощи Typhoon, какие — самостоятельно,

  • Если какая-либо из автоматически подставляемых зависимостей объекта не найдена в фабрике, crash произойдет сразу же (в случае ручной подстановки это может вообще пройти незамеченным).



так и недостатки:


  • Привязка к Typhoon уходит за пределы assembly и затрагивает конкретные классы,

  • Просмотрев структуру модулей TyphoonAssembly проекта, нельзя судить о его архитектуре в целом.



Правило хорошего кода, выработанное нами в Rambler&Co — лучше потратить некоторое время и подготовить хорошо структурированные модули уровня Presentation, в которых будут содержаться definition'ы для всех ViewController'ов, а возможности autowire использовать только в интеграционных тестах. Наличие хорошо документированной при помощи TyphoonAssembly структуры проекта во многом превосходит все достоинства автоинъекции.



TyphoonDefinition+Option



В предыдущей статье мы рассматривали пример использования двух разных реализаций одной TyphoonAssembly — боевой и фейковой. Тем не менее, иногда такой подход равносилен стрельбе из пушек по воробьям — а Typhoon предоставляет нам гораздо более изящные способы решения проблемы.



Рассмотрим еще один кейс из Рамблер.Почты:

Команда QA попросила добавить в приложение специальное debug-меню, позволяющее работать с логами, узнавать текущий номер билда и прочие подобные вещи. Экран настроек — это таблица, которая собирается из коллекции ViewModel'ей отдельным классом RCMSettingsConfigurator. У этого класса две реализации — Base и Debug, которые включаются соответствующими build scheme. Перед нами встал выбор из трех вариантов реализации этой задачи:


  • Создавать конфигуратор вручную при помощи #ifdef'ов, определяющих значения препроцессорной директивы,

  • Написать две реализации assembly, создающей объекты для user story настроек,

  • Использовать категорию TyphoonDefinition+Option.



Первый вариант, конечно, не выбор настоящих ниндзя (ну не дело это, активно использовать #ifdef'ы в коде мобильного приложения). Второй вариант — это та самая вышеупомянутая пушка, нацеленная на невинных воробьев. Третий способ с одной стороны очень прост в реализации, с другой — достаточно гибко расширяется. Остановимся на нем подробнее.



Для начала посмотрим на интерфейс категории, используя методы которой, мы можем получать определенные definition'ы в зависимости от значения параметра, подставленного в поле option:

@interface TyphoonDefinition (Option)
@interface TyphoonDefinition (Option)

+ (id)withOption:(id)option yes:(id)yesInjection no:(id)noInjection;
+ (id)withOption:(id)option matcher:(TyphoonMatcherBlock)matcherBlock;
+ (id)withOption:(id)option matcher:(TyphoonMatcherBlock)matcherBlock autoInjectionConfig:(void(^)(id config))configBlock;

@end


К примеру, в рассматриваемом кейсе это выглядит следующим образом:

- (id )settingsConfigurator
- (id )settingsConfigurator {
return [TyphoonDefinition withOption:@(DEBUG)
yes:[self debugSettingsConfigurator]
no:[self baseSettingsConfigurator]];
}


Использование объекта TyphoonOptionMatcher позволяет работать и с более сложными условиями:

- (id )settingsConfiguratorWithOption:(id)option
- (id )settingsConfiguratorWithOption:(id)option {
return [TyphoonDefinition withOption:option matcher:^(TyphoonOptionMatcher *matcher) {
[matcher caseEqual:@"qa-team" use:[self qaSettingsConfigurator]];
[matcher caseEqual:@"big-bosses" use:[self bigBossesSettingsConfigurator]];
[matcher caseEqual:@"ios-dream-team" use:[self iosTeamSettingsConfigurator]];
[matcher caseMemberOfClass:[RCMConfiguratorOption class] use:[self settingsConfiguratorWithOption:option]];
[matcher defaultUse:[self defaultSettingsConfigurator]];
}];
}


Еще одна возможность — использовать параметр option в качестве ключа для поиска требуемого TyphoonDefinition:

- (id )settingsConfiguratorWithOption:(id)option
- (id )settingsConfiguratorWithOption:(id)option {
return [TyphoonDefinition withOption:option matcher:^(TyphoonOptionMatcher *matcher) {
[matcher useDefinitionWithKeyMatchedOptionValue];
}];
// При option = @"debugSettingsConfigurator" вернет definition из метода - debugSettingsConfigurator
}


Конечно, злоупотреблять этой возможностью тоже не стоит — если альтернативные реализации нужны сразу для большого количества объектов одного уровня абстракции, имеет смысл подменять целый модуль TyphoonAssembly.



TyphoonConfig и TyphoonTypeConverter



В самой первой статье в одном из примеров использования Typhoon я уже упоминал TyphoonConfig, использовав его для инъекции URL серверного API в один из network-клиентов. Пришло время взглянуть на него повнимательнее.



Поддерживаемые форматы конфигурационных файлов:


  • plist,

  • properties,

  • json



Примитивные типы (числа, BOOL, строки) указываются «как есть»:

{
"config": {
"defaultFontSize": 17,
"openLinksInExternalBrowser" : NO
}
}


Typhoon позволяет оперировать и некоторыми другими объектами: NSURL, UIColor, NSNumber, UIImage. В таком случае используется специальный синтаксис:

{
"config": {
"baseURL": NSURL(https:// mail.rambler.ru),
"logoImage" : UIImage(rambler-mail-logo-new)
}
}


Кроме того, при необходимости мы можем добавить собственный TypeConverter и описать в конфигурационном файле объекты любого другого класса. К примеру, мы хотим инкапсулировать все детали стиля приложения в одном объекте — RCMStyleModel:

@interface RCMStyleTypeConverter : NSObject
typedef NS_ENUM(NSUInteger, RCMStyleComponent) {
RCMStylePrimaryColorComponent = 0,
RCMStyleDefaultFontSizeComponent = 1,
RCMStyleDefaultFontNameComponent = 2
};

@interface RCMStyleTypeConverter : NSObject
@end

@implementation RCMStyleTypeConverter

- (NSString *)supportedType {
return @"RCMStyle";
}

- (id)convert:(NSString *)stringValue {
NSArray *styleComponents = [stringValue componentsSeparatedByString:@";"];

NSString *colorString = styleComponents[RCMStylePrimaryColorComponent];
UIColor *primaryColor = [self colorFromHexString:colorString];

NSString *defaultFontSizeString = styleComponents[RCMStyleDefaultFontSizeComponent];
CGFloat defaultFontSize = [defaultFontSizeString floatValue];

NSString *defaultFontName = styleComponents[RCMStyleDefaultFontNameComponent];
UIFont *defaultFont = [UIFont fontWithName:defaultFontName size:defaultFontSize];

RCMStyleModel *styleModel = [[RCMStyleModel alloc] init];
styleModel.primaryColor = primaryColor;
styleModel.defaultFontSize = defaultFontSize;
styleModel.defaultFont = defaultFont;

return styleModel;
}


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

{
"config": {
"defaultStyle": RCMStyle(#8732A9;17;HelveticeNeue-Regular),
"anotherStyle" : RCMStyle(#AABBCC;15;SanFrancisco)
}
}


Таким образом, если в одну и ту же сущность передаются сразу несколько параметров из конфигурационного файла, стоит задуматься об объединении их в отдельный модельный объект и написании для него TypeConverter'а.



TyphoonPatcher



Основное отличие интеграционных и unit тестов в том, что в первом случае мы тестируем взаимодействие отдельных модулей приложения друг с другом, а во втором — каждый конкретный модуль в отрыве от всех остальных. Так вот, Typhoon просто восхитителен для организации интеграционных тестов.



К примеру, в нашем проекте есть следующая цепочка зависимостей:

RCMPushNotificationCenter -> RCMPushService -> RCMNetworkClient



Мы хотим протестировать поведение RCMPushNotificationCenter в зависимости от различных результатов обращения к серверу. Вместо того, чтобы вручную создавать тестируемый объект, подставлять в него stub'овый RCMPushService и подменять реализации его методов, мы можем воспользоваться уже готовой инфраструктурой TyphoonAssembly:

- (void)setUp
- (void)setUp {
[super setUp];

NSArray *collaboratingAssemblies = @[[RCMClientAssembly new], [RCMCoreComponentsAssembly new]];
TyphoonAssembly *serviceComponents = [[RCMServiceComponentsAssemblyBase new] activateWithCollaboratingAssemblies:collaboratingAssemblies];
self.pushNotificationCenter = [serviceComponents pushNotificationCenter];

TyphoonPatcher *patcher = [[TyphoonPatcher alloc] init];
[patcher patchDefinitionWithSelector:@selector(networkClient) withObject:^id{
return [RCMFakeNetworkClient new];
}];
}


Объект TyphoonPatcher позволяет нам пропатчить метод, отдающий TyphoonDefinition, в любом из модулей TyphoonAssembly. В передаваемом TyphoonPatcher блоке можно не просто передавать другой инстанс класса, но и использовать mock'и, реализуемые различными фреймворками.



Runtime arguments



Typhoon позволяет инстанциировать объекты не только с заранее заданными зависимостями, но и с использованием runtime параметров. Понадобиться это может, к примеру, при реализации абстрактной фабрики. Рассмотрим пример:



У нас есть RCMMessageViewController, обязательной зависимостью которого является объект сообщения — RCMMessage:

- (void)setUp
@interface RCMMessageViewController : UIViewController

- (instancetype)initWithMessage:(RCMMessage *)message;
@property (nonatomic, strong) id messageService;

@end


Объект message неизвестен на момент регистрации TyphoonDefinition'ов при активации TyphoonAssembly — поэтому нам нужно уметь создавать его на лету. Для этого в TyphoonAssembly соответствующей user story напишем следующий метод:

- (UIViewController *)messageViewControllerWithMessage:(RCMMessage *)message
- (UIViewController *)messageViewControllerWithMessage:(RCMMessage *)message {
return [TyphoonDefinition withClass:[RCMMessageViewController class] configuration:^(TyphoonDefinition *definition) {
[definition useInitializer:@selector(initWithMessage:) parameters:^(TyphoonMethod *initializer) {
[initializer injectParameterWith:message];
}];

[definition injectProperty:@selector(messageService)
with:[self.serviceComponents messageService]];
}];
}


Вынесем этот метод в отдельный протокол, к примеру, RCMMessageControllerFactory, и проинжектим его в роутер:

- (id)foldersRouter
- (id)foldersRouter {
return [TyphoonDefinition withClass:[RCMFoldersRouterBase class] configuration:^(TyphoonDefinition *definition) {
[definition injectProperty:@selector(messageControllerFactory)
with:self];
}];
}


И добавим в роутер реализацию создания этого контроллера:

- (void)showMessageViewControllerFromSourceController
- (void)showMessageViewControllerFromSourceController:(UIViewController *)sourceViewController
withMessage:(id )message {
RCMMessageViewController *messageViewController = [self.messageControllerFactory messageViewControllerWithMessage:message];
...
}


Стоит упомянуть и несколько ограничений этой техники:


  • Runtime аргументы обязательно должны представлять собой объекты. Примитивы при необходимости могут быть завернуты в NSValue,

  • Переданные фабрике объекты должны использоваться в своем первоначальном виде, их состояние изменять нельзя,

  • Стоит аккуратно использовать в сочетании с циклическими зависимостями. Runtime аргументы должны быть переданы всем объектам зависимости, иначе она не решится правильным образом.



Factory Definitions



В некоторых ситуациях бывает удобно зарегистрировать TyphoonDefinition, умеющий генерировать другие definition'ы. Объясню на конкретном примере:



За создание пользовательских аватарок отвечает специальная фабрика — RCMTextAvatarFactory:

@interface RCMTextAvatarFactory : NSObject
@interface RCMTextAvatarFactory : NSObject
- (RCMTextAvatar *)avatarWithName:(NSString *)name;
@end


Аватарки, создаваемые этой фабрикой, необходимо передавать в другие объекты. Реализуется это следующим образом — для начала регистрируется definition для фабрики:

- (RCMTextAvatarFactory *)textAvatarFactory
- (RCMTextAvatarFactory *)textAvatarFactory {
return [TyphoonDefinition withClass:[RCMTextAvatarFactory class]];
}


И затем регистрируются definition'ы для создаваемых этой фабрикой сущностей:

- (RCMTextAvatar *)textAvatarForUserName:(NSString *)userName
- (RCMTextAvatar *)textAvatarForUserName:(NSString *)userName {
return [TyphoonDefinition withFactory:[self textAvatarFactory] selector:@selector(avatarWithName:) parameters:^(TyphoonMethod *factoryMethod) {
[factoryMethod injectParameterWith:userName];
}];
}


Кстати, эта возможность позволяет плавно мигрировать с использования сервис-локатора, если вы этим грешили, на Typhoon. Первым шагом будет регистрация локатора в качестве фабрики, а вторым — реализация TyphoonDefinition'ов для сервисов с использованием factoryMethod'ов:

- (id )messageService
- (id )messageService {
return [TyphoonDefinition withFactory:[self serviceLocator] selector:@selector(messageService)];
}




TyphoonInstancePostProcessor/TyphoonDefinitionPostProcessor



Эти протоколы используются для создания так называемых инфраструктурных компонентов. Если assembly возвращает такой объект, он обрабатывается отлично от обычных definition’ов.



Использование TyphoonInstancePostProcessor позволяет нам вклиниться в момент возврата контейнером инстансов создаваемых зависимостей и каким-нибудь образом их обработать. К примеру, это можно использовать для логирования всех обращений к определенным объектам, скажем, к networkService'ам:



Для начала напишем простой декоратор, выводящий в лог все сообщения, посылаемые объекту:

@interface RCMDecoratedService : NSProxy
@interface RCMDecoratedService : NSProxy
+ (instancetype)decoratedServiceWith:(NSObject *)service;
@end

@interface RCMDecoratedService()
@property (strong, nonatomic) NSObject *service;
@end

@implementation RCMDecoratedService
- (instancetype)initWithService:(NSObject *)service {
self.service = service;
return self;
}

+ (instancetype)decoratedServiceWith:(NSObject *)service {
return [[self alloc] initWithService:service];
}

- (NSMethodSignature *)methodSignatureForSelector:(SEL)sel {
return [self.service methodSignatureForSelector:sel];
}

- (void)forwardInvocation:(NSInvocation *)invocation {
NSLog(invocation.debugDescription);
[invocation invokeWithTarget:self.service];
}
@end


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

@interface RCMLoggingInstancePostProcessor : NSObject
@interface RCMLoggingInstancePostProcessor : NSObject 
@end

@implementation RCMLoggingInstancePostProcessor
- (id)postProcessInstance:(id)instance {
if ([self isAppropriateInstance:instance]) {
RCMDecoratedService *decoratedService = [RCMDecoratedService decoratedServiceWith:instance];
return decoratedService;
}
return instance;
}

- (BOOL)isAppropriateInstance:(id)instance {
if ([instance conformsToProtocol:@protocol(RCMService)]) {
return YES;
}
return NO;
}
@end


И последний шаг — зарегистрировать RCMLoggingInstancePostProcessor в одной из TyphoonAssembly. Сам объект не участвует в процессе инъекции зависимостей и живет сам по себе. Его жизненный цикл привязан ко времени жизни TyphoonComponentFactory.

@implementation RCMApplicationAssembly
@implementation RCMApplicationAssembly
- (id)loggingProcessor {
return [TyphoonDefinition withClass:[RCMLoggingInstancePostProcessor class]];
}
...
@end


Теперь все создаваемые Typhoon'ом зависимости будут проходить через RCMLoggingInstancePostProcessor — а те из них, кто реализует протокол RCMService — оборачиваться в NSProxy.



Другой инфраструктурный компонент, TyphoonDefinitionPostProcessor, позволяет обрабатывать все зарегистрированные definition'ы до того, как будут созданы описываемые ими объекты. Таким образом, мы можем любым образом конфигурировать и пересобирать переданные такому процессору TyphoonDefinition'ы:

- (void)postProcessDefinition:(TyphoonDefinition *)definition replacement:(TyphoonDefinition **)definitionToReplace withFactory:(TyphoonComponentFactory *)factory;


В качестве примеров использования этого компонента можно привести уже упомянутые в статье TyphoonPatcher и TyphoonConfigPostProcessor.



Асинхронное тестирование



Для тех, кто по какой-то причине не может или не хочет использовать XCTestExpectation, Typhoon предлагает свой набор методов для реализации тестирования асинхронных вызовов. Рассмотрим в качестве примера тест синхронизации почтовых сборщиков:

- (void)testThatServiceSynchronizeMailBoxesList
- (void)testThatServiceSynchronizeMailBoxesList {
// given
NSInteger const kExpectedMailBoxCount = 4;
[OHHTTPStubs stubRequestsPassingTest:REQUEST_TEST_YES
withStubResponse:TEST_RESPONSE_WITH_FILE(@"mailboxes_success")];
__block NSInteger resultCount;
__block NSError *responseError = nil;

// when
[self.mailBoxService synchronizeMailBoxesWithCompletionBlock:^(NSError *error) {
responseError = error;
NSFetchedResultsController *controller = [self.mailBoxService fetchedResultsControllerWithAllMailBoxes];
resultCount = controller.fetchedObjects.count;
}];

// then
[TyphoonTestUtils waitForCondition:^BOOL{
typhoon_asynch_condition(resultCount > 0);
} andPerformTests:^{
XCTAssertNil(responseError);
XCTAssertEqual(resultCount, kExpectedMailBoxCount);
}];
}


Стандартный timeout, добавленный разработчиками — семь секунд, условие проверяется каждую секунду. Если оно не будет выполнено — тест провалится с соответствующим exception'ом. При необходимости можно использовать и свой timeout:

TyphoonTestUtils wait:30.0f secondsForCondition:^BOOL
[TyphoonTestUtils wait:30.0f secondsForCondition:^BOOL{
typhoon_asynch_condition(resultCount > 0);
} andPerformTests:^{
XCTAssertNil(responseError);
XCTAssertEqual(resultCount, kExpectedMailBoxCount);
}];




Заключение



В этом материале мы рассмотрели большое количество различных возможностей Typhoon Framework — автоинъекцию, использование конфигурационных файлов, хелперы для проведения интеграционного тестирования и многое другое. Владение этими техниками позволит вам решить больше задач без изобретения своих велосипедов, пусть даже они и не будут использоваться каждый день.



В следующей части цикла мы вкратце рассмотрим две других реализации Dependency Injection контейнеров для Cocoa — Objection и BloodMagic. Ну и небольшая новость напоследок — мы с моим коллегой Германом Сапрыкиным вошли в команду разработчиков Typhoon, так что фреймворк стал еще чуть более отечественным.



Цикл «Управляем зависимостями в iOS-приложениях правильно»





Полезные ссылки





Original source: habrahabr.ru (comments, light).

http://habrahabr.ru/post/264683/

Комментарии (0)КомментироватьВ цитатник или сообщество

Следующие 30  »

<rambler - Самое интересное в блогах

Страницы: [1] 2 3 ..
.. 10

LiveInternet.Ru Ссылки: на главную|почта|знакомства|одноклассники|фото|открытки|тесты|чат
О проекте: помощь|контакты|разместить рекламу|версия для pda