Dependency Injection в iOS

Егор Толстой
Инженер-разработчик iOS приложений
Dependency Injection в iOS

View Slide

Об авторе
• Twitter: @igrekde
• GitHub: github.com/igrekde
• Блог: etolstoy.ru/blog

View Slide

Содержание
• Принцип инверсии зависимостей
• Паттерны Dependency Injection
• DI в проектах Rambler&Co
• Typhoon Framework

View Slide

Принцип инверсии
зависимостей

View Slide

SOLID
• S – The Single Responsibility Principle
• O – The Open-Closed Principle
• L – The Liskov Substitution Principle
• I – Interface Segregation Principle
• D – The Dependency Inversion Principle

View Slide

–Роберт Мартин, “Принципы, паттерны и методики гибкой разработки”
Модули верхнего уровня не должны зависеть от модулей
нижнего уровня. И те и другие должны зависеть от
абстракций.
Абстракции не должны зависеть от деталей. Детали должны
зависеть от абстракций.

View Slide

Dependency Inversion

View Slide

IoC vs DI vs DIP
• IoC – Inversion of Control
• DI – Dependency Injection
• DIP – Dependency Inversion Principle

View Slide

Inversion of Control

View Slide

Dependency Injection

View Slide

Dependency Inversion Principle

View Slide

Паттерны Dependency
Injection

View Slide

Паттерны DI
• Initializer Injection
• Property Injection
• Method Injection
• Service Locator
• DI Container

View Slide

Initializer Injection
@interface RCMNetworkService
- (instancetype)initWithClient:(id )client
configurator:(id )configurator;
@end

View Slide

Property Injection
@interface RCMNetworkService
@property (strong, nonatomic) id emailValidator;
@property (strong, nonatomic) id reachabilityManager;
@end

View Slide

Method Injection
@interface RCMMailboxService
- (void)connectMailBoxWithConfigurator:(id )configurator
completionBlock:(RCMErrorBlock)block;
@end

View Slide

Service Locator

View Slide

Service Locator
@interface MessageViewController
- (instancetype)initWithMessageService:(id )messageService
attachmentService:(id )attachmentService
renderer:(id )renderer;
@end
Было:

View Slide

Service Locator
@interface MessageViewController
- (instancetype)initWithServiceLocator:(id )locator;
@end
Стало:

View Slide

Service Locator
Плюсы:
• Быстро реализуется
• Централизованное управление зависимостями

View Slide

Service Locator
Минусы:
• Приводит к неявным зависимостям
• Видимость хорошего дизайна
• Усложняет тестирование

View Slide

DI container
• Не используется в коде напрямую
• Зависимости всех классов – явные
• Никто не заботится о создании зависимостей

View Slide

Dependency Injection в
проектах Rambler&Co

View Slide

Афиша Рестораны
@interface ARModalTableViewController : UIViewController
- (instancetype)initWithTableViewModel:(id)tableViewModel;
@end
Initializer Injection для UIViewController:

View Slide

Афиша Рестораны
@protocol ARStoredListManager
- (void)setStorage:(id)storage;
@end
Установка зависимости через Setter:

View Slide

Рамблер.Новости
@interface RDNDrawerRouterImplementation ()
……
destinationController.storyboardFactory = sourceController.storyboardFactory;
destinationController.router = [RDNFeedRouterImplementation new];
#warning Заменить fake-адаптер на боевой
destinationController.feedServiceAdapter = [RDNFakeServiceAdapterAssembly
fakeFeedDataServiceAdapterWithTopicIdentifier:topicIdentifier];
……
@end
Почти DI-контейнер:

View Slide

Рамблер.WE
@interface RCIAuthorizationPresenter : NSObject RCIAuthorizationInteractorOutput, RCIAuthorizationRouterOutput>
@property (strong, nonatomic) id view;
@property (strong, nonatomic) id interactor;
@property (strong, nonatomic) id router;
@end
Property Injection в модуле VIPER:

View Slide

Рамблер.Почта
@interface RCMFolderSynchronizationOperation : RCMAsyncOperation
- (instancetype)initWithClient:(id )client
validator:(id )validator
mapper:(id )mapper;
@end
Создание операции с Initializer Injection:

View Slide

Typhoon Framework

View Slide

–Clarke C. Arthur
Any magic, sufficiently analyzed is indistinguishable from
technology.

View Slide

Typhoon Framework
http://typhoonframework.org

View Slide

Typhoon Framework
1.209
124
24 open/260 closed
0 open/60 closed
questions: 246
Последнее обновление: 09.05.15

View Slide

Typhoon Framework
• Полностью нативен
• Поддерживает модульность
• Полная интеграция со Storyboard
• Initializer, Property и Method Injection
• Поддерживает circular dependencies
• Всего 3000 строчек кода

View Slide

Интеграция с проектом
@interface RIAssembly : TyphoonAssembly
- (RIAppDelegate *)appDelegate;
@end
Создаем свою Assembly:

View Slide

@implementation RIAssembly
- (RIAppDelegate *)appDelegate {
return [TyphoonDefinition withClass:[RIAppDelegate class] configuration:^(TyphoonDefinition *definition) {
[definition injectProperty:@selector(startUpConfigurator) with:[self startUpConfigurator]];
}
}
- (id )startUpConfigurator {
return [TyphoonDefinition withClass:[RIStartUpConfiguratorBase class]];
}
@end

View Slide


View Slide

Примеры
Создаем простой инстанс определенного класса:
- (id )addressBookRouter {
return [TyphoonDefinition withClass:[RCMAddressBookRouterBase class]];
}

View Slide

Примеры
Создаем инстанс класса и устанавливаем его зависимости:
- (id )authorizationPopoverBuilder {
return [TyphoonDefinition withClass:[RCMAuthorizationPopoverBuilderBase class]
configuration:^(TyphoonDefinition *definition) {
[definition injectProperty:@selector(storyboardBuilder)
with:[self storyboardBuilder]];
}];
}

View Slide

Примеры
Настраиваем жизненный цикл объекта:
- (id )networkLogger{
return [TyphoonDefinition withClass:[RCMNetworkLoggerBase class]
definition.scope = TyphoonScopeSingleton;
}];
}

View Slide

Примеры
Создаем объект через Initializer:
- (id )settingsService {
return [TyphoonDefinition withClass:[RCMSettingsServiceBase class]
[definition useInitializer:@selector(initWithClient:sessionStorage:)
parameters:^(TyphoonMethod *initializer) {
[initializer injectParameterWith:[self mailXMLRPCClient]];
[initializer injectParameterWith:[self credentialsStorage]];
}];
}];
}

View Slide

Примеры
Используем Method Injection:
- (id )errorService{
return [TyphoonDefinition withClass:[RCMErrorServiceBase class]
[definition injectMethod:@selector(addErrorHandler:)
parameters:^(TyphoonMethod *method) {
[method injectParameterWith:[self sessionErrorHandler]];
}];
}];
}

View Slide

Примеры
Настраиваем базовый Definition для всех ViewController’ов:
- (UIViewController *)baseViewController {
return [TyphoonDefinition withClass:[UIViewController class]
[definition injectProperty:@selector(errorService)
with:[self.serviceComponents errorService]];
[definition injectProperty:@selector(errorHandler)
with:[self baseControllerErrorHandler]];
[definition injectProperty:@selector(router)
with:[self baseRouter]];
}];
}

View Slide

Примеры
Используем базовый Definition:
- (UIViewController *)userNameTableViewController {
return [TyphoonDefinition withClass:[RCMMessageCompositionViewController class]
definition.parent = [self baseViewController];
[definition injectProperty:@selector(router)
with:[self settingsRouter]];
}];
}

View Slide

Жизненный цикл
1. main.m
2. Создание UIApplication
3. Создание UIAppDelegate
4. Вызов [UIApplication setDelegate] -> Встраивается Typhoon
5. Вызов [UIAppDelegate applicationDidFinishLaunching]

View Slide

TyphoonAssembly
Активация:
1. Автоматическая при наличии ключа в Info.plist
2. Ручная с использованием [TyphoonAssembly activate].

View Slide

TyphoonComponentFactory
- (id)componentForKey:(NSString *)key args:(TyphoonRuntimeArguments *)args
{
……
TyphoonDefinition *definition = [self definitionForKey:key];
……
return [self newOrScopeCachedInstanceForDefinition:definition args:args];
}

View Slide

TyphoonComponentFactory
- (id)componentForType:(id)classOrProtocol
{
……
TyphoonDefinition *definition = [self definitionForType:classOrProtocol];
……
return [self newOrScopeCachedInstanceForDefinition:definition args:nil];
}

View Slide

TyphoonDefinition
@interface TyphoonDefinition : NSObject {
Class _type;
NSString *_key;
BOOL _processed;
TyphoonMethod *_initializer;
TyphoonMethod *_beforeInjections;
NSMutableSet *_injectedProperties;
NSMutableSet *_injectedMethods;
TyphoonMethod *_afterInjections;
TyphoonScope _scope;
TyphoonDefinition *_parent;
}

View Slide

Работа со Storyboard
@implementation RCMAssembly
- (RCMMessageListTableViewController *)messageListTableViewController {
return [TyphoonDefinition
withClass:[RCMMessageListTableViewController class]];
}
@end

View Slide

Работа со Storyboard
@interface TyphoonStoryboard : UIStoryboard
+ (TyphoonStoryboard *)storyboardWithName:(NSString *)name
factory:(TyphoonComponentFactory *)factory
bundle:(NSBundle *)bundleOrNil;
@end

View Slide

Memory Management
• TyphoonScopeObjectGraph
• TyphoonScopePrototype
• TyphoonScopeSingleton
• TyphoonScopeLazySingleton
• TyphoonScopeWeakSingleton

View Slide

Autowire
#import "TyphoonAutoInjection.h”
@interface RCINewsDetailsViewController : UIViewController
@property (strong, nonatomic) InjectedProtocol(RCINewsService) newsService;
@property (strong, nonatomic) InjectedClass(RCIThemeManager) themeManager;
@end

View Slide

Autowire
Плюсы:
• Быстро реализуется
• Меньше кода в фабриках
Минусы:
• Сильная привязка к Typhoon
• Архитектура приложения не читается в фабриках

View Slide

Config Injection
- (id)configurer {
return [TyphoonDefinition configDefinitionWithName:@”config.json"];
}
…..
[definition injectProperty:@selector(serviceUrl)
with:TyphoonConfig(@"service.url")];

View Slide

Модульность

View Slide

Модульность
NSArray *assemblies = @[serviceAssembly, networkAssembly];
[uiAssembly activateWithCollaboratingAssemblies:assemblies];

View Slide

Совместная работа
Базовые сервисы:
[uiAssembly activateWithCollaboratingAssemblies:@[
[self serviceAssembly],
networkAssembly]];
Double сервисы:
[uiAssembly activateWithCollaboratingAssemblies:@[
[self doubleServiceAssembly],
networkAssembly]];

View Slide

#ifndef Mail_BaseAssembly_h
#define Mail_BaseAssembly_h
#define SERVICE_COMPONENTS_ASSEMBLY RCMServiceComponentsBase
#endif

View Slide


View Slide

Тестирование
id factory= [RCMServiceComponentsBase new];
TyphoonPatcher *patcher = [[TyphoonPatcher alloc] init];
[patcher patchDefinitionWithSelector:@selector(credentialsStorage) withObject:^id{
id mockCredentialsStorage = OCMProtocolMock(@protocol(RCMCredentialsStorage));
id mockSession = OCMClassMock([RCMSession class]);
OCMStub([mockSession rsid]).andReturn(@"123");
OCMStub([mockCredentialsStorage currentSession]).andReturn(mockSession);
return mockCredentialsStorage;
}];
[factory attachPostProcessor:patcher];
self.pushService = [factory pushService];

View Slide

Мифы
• Высокий порог вхождения
• Очень сложный дебаггинг
• Если Typhoon перестанут поддерживать, из проекта его не
выпилить
• Но… там же свиззлинг!
• Зачем мне Typhoon, когда я могу написать свой велосипед?

View Slide

Рекомендации
• Разбивайте свои фабрики не только вертикально, но и
горизонтально
• Разбивайте фабрики по модулям заранее
• Покрывайте фабрики тестами

View Slide

Другие библиотеки

View Slide

Objection
930
106
13 open/42 closed
1 open/35 closed
By Atomic Object
http://objection-framework.org

View Slide

Objection
@interface Car : NSObject {
Engine *engine;
Brakes *brakes;
}
@property(nonatomic, strong) Engine *engine;
@property(nonatomic, strong) Brakes *brakes;
@implementation Car
objection_requires(@"engine", @"brakes")
@synthesize engine, brakes;
@end

View Slide

Objection
@interface MyAppModule : JSObjectionModule { }
@end
@implementation MyAppModule
- (void)configure {
[self bind:[UIApplication sharedApplication] toClass:[UIApplication class]];
[self bindClass:[MyAPIService class] toProtocol:@protocol(APIService)];
}
@end
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
JSObjectionInjector *injector = [JSObjection createInjector:[[MyAppModule alloc] init]];
[JSObjection setDefaultInjector:injector];
}

View Slide

Objection
Плюсы:
• Легко и просто бьется на модули
• Легковесная
• Простая для освоения

View Slide

Objection
Минусы:
• Все зависимости назначаются практически вручную
• Слишком сильная интеграция с кодом приложения
• Всего два вида объектов: прототип и синглтон

View Slide

BloodMagic
216
30
2 open/6 closed
0 open/12 closed
By AlexDenisov
https://github.com/railsware/BloodMagic

View Slide

BloodMagic
@interface ViewController : UIViewController
@property (nonatomic, strong, bm_injectable) MessageService *messageService;
@end
…..
BMInitializer *initializer = [BMInitializer injectableInitializer];
initializer.propertyClass = [MessageService class];
initializer.initializer = ^id (id sender) {
return [[MessageService alloc] initWithViewController:sender];
};
[initializer registerInitializer];

View Slide

BloodMagic
Плюсы:
• Еще более легковесная библиотека
Минусы:
• Не позволяет создавать и управлять графами объектов
• Нет никаких плюшек DI-фреймворков

View Slide

СПАСИБО!

View Slide

Dependency Injection в iOS

Dependency Injection в iOS

Egor Tolstoy

More Decks by Egor Tolstoy

Other Decks in Technology

Featured

Transcript