BloodMagic

CocoaHeads, 2014
https://github.com/railsware/BloodMagic

Transcript

1. BloodMagic Custom property attributes CocoaHeads, 2014
2. AlexDenisov 1101_debian WHOAMI Twitter: Github: IRC: AlexDenisov
3. Outline • What BloodMagic is • How to use it • How to extend it • How does it work • Q & A
4. What BloodMagic is
5. Problem @interface ViewController : UIViewController @property (nonatomic) NSMutableArray *resources; @property (nonatomic) ProgressView *progressView; @property (nonatomic) ErrorView *errorView; @property (nonatomic) DataLoader *dataLoader; @end
6. @implementation ViewController - (NSMutableArray *)resources { if (!_resources) { _resources = [NSMutableArray new]; } return _resources; } - (ProgressView *)progressView { if (!_progressView) { _progressView = [ProgressView new]; } return _progressView; } - (ErrorView *)errorView { if (!_errorView) { _errorView = [ErrorView new]; } return _errorView; } - (DataLoader *)dataLoader { if (!_dataLoader) { _dataLoader = [DataLoader new]; } return _dataLoader; } @end Lazy Initialization
7. - (PropertyClass *)propertyName { if (!_propertyName) { _propertyName = [PropertyClass new]; } return _propertyName; } A lot of Boilerplate Code
8. Just add ‘lazy’ attribute @interface ViewController : UIViewController @property (nonatomic, lazy) NSMutableArray *resources; @property (nonatomic, lazy) CenterProgress *centerProgress; @property (nonatomic, lazy) BottomProgress *bottomProgress; @property (nonatomic, lazy) DataLoader *dataLoader; @end
9. Just add ‘lazy’ attribute @interface ViewController : UIViewController @property (nonatomic, lazy) NSMutableArray *resources; @property (nonatomic, lazy) CenterProgress *centerProgress; @property (nonatomic, lazy) BottomProgress *bottomProgress; @property (nonatomic, lazy) DataLoader *dataLoader; @end /tmp/lazy_test ➜ make … error: unknown property attribute 'lazy' @property (nonatomic, lazy) NSMutableArray *resources; ^ …
10. BloodMagic a mechanism for creating custom property attributes based on your code
11. Let’s add magic #import <BloodMagic/Lazy.h> @interface ViewController : UIViewController <BMLazy> @property (nonatomic) NSMutableArray *resources; @property (nonatomic) ProgressView *progressView; @property (nonatomic) ErrorView *errorView; @property (nonatomic) DataLoader *dataLoader; @end
12. Let’s add magic @implementation ViewController @dynamic resources; @dynamic progressView; @dynamic errorView; @dynamic dataLoader; - (void)actOnSomething { [self.dataLoader loadNextPage]; // ^ new object created } @end
13. Magic Happened @implementation ViewController @dynamic resources; @dynamic progressView; @dynamic errorView; @dynamic dataLoader; @end BloodMagic @implementation ViewController - (NSMutableArray *)resources { if (!_resources) { _resources = [NSMutableArray new]; } return _resources; } - (ProgressView *)progressView { if (!_progressView) { _progressView = [ProgressView new]; } return _progressView; } - (ErrorView *)errorView { if (!_errorView) { _errorView = [ErrorView new]; } return _errorView; } - (DataLoader *)dataLoader { if (!_dataLoader) { _dataLoader = [DataLoader new]; } return _dataLoader; } @end
14. How to use BloodMagic
15. Single Custom Attribute #import <BloodMagic/Lazy.h> @interface ViewController : UIViewController <BMLazy> @property (nonatomic, bm_lazy) DataLoader *dataLoader; @end
16. Single Custom Attribute #import "ViewController.h" @implementation ViewController @dynamic dataLoader; - (void)viewDidLoad { [super viewDidLoad]; [self.dataLoader loadNextPage]; } @end
17. Single Custom Attribute #import "ViewController.h" @implementation ViewController @dynamic dataLoader; - (void)viewDidLoad { [super viewDidLoad]; [self.dataLoader loadNextPage]; // ^ new object created } @end
18. Multiple Custom Attributes #import <BloodMagic/Lazy.h> #import <BloodMagic/Partial.h> @interface ViewController : UIViewController <BMLazy, BMPartial> @property (nonatomic, bm_lazy) DataLoader *dataLoader; @property (nonatomic, bm_partial) ErrorView *errorView; @end
19. Multiple Custom Attributes #import "ViewController.h" @implementation ViewController @lazy(dataLoader) @partial(errorView) - (void)viewDidLoad { [super viewDidLoaded]; [self.dataLoader loadNextPage]; [self.view addSubview:self.errorView]; } @end
20. How to extend it
21. @property (nonatomic, bm_preference) NSString *cocoaHeads;
22. Module structure BloodMagic/Sources/Modules/Preference (master ✔) ➜ tree |-- Private | |-- BMPreferenceHook.h | |-- BMPreferenceHook.m | |-- BMPreferenceModuleLoader.h | `-- BMPreferenceModuleLoader.m `-- Public `-- BMPreference.h … |-- BloodMagic/Sources `-- Preference.h
23. Public Protocol @protocol BMPreference <NSObject> @end
24. Public Header #import <BloodMagic/Sources/Modules/Core/Public/BMPublicCoreDefnitions.h> #import <BloodMagic/Sources/Modules/Preference/Public/BMPreference.h> #ifndef bm_preference #define bm_preference #endif #ifndef preference #define preference(property_name) register_module(BMPreference, property_name) #endif
25. Public Header #import <BloodMagic/Sources/Modules/Core/Public/BMPublicCoreDefnitions.h> #import <BloodMagic/Sources/Modules/Preference/Public/BMPreference.h> #ifndef bm_preference #define bm_preference #endif #ifndef preference #define preference(property_name) register_module(BMPreference, property_name) #endif
26. Private Module Loader #import <Foundation/Foundation.h> @interface BMPreferenceModuleLoader : NSObject @end
27. Private Module Loader #import "BMPreferenceModuleLoader.h" #import "BMPreference.h" #import "BMBloodMagicInjector.h" @implementation BMPreferenceModuleLoader + (void)load { @autoreleasepool { BMBloodMagicInjector *injector = [BMBloodMagicInjector new]; [injector injectBloodMagicInto:@protocol(BMPreference)]; } } @end
28. Private Hook #import "BMHook.h" #import "BMPreference.h" @interface BMPreferenceHook : NSObject <BMHook, BMPreference> @end
29. Private Hook #import "BMPreferenceHook.h" #import "BMProperty.h" @implementation BMPreferenceHook static inline NSUserDefaults *bm_defaults() { return [NSUserDefaults standardUserDefaults]; } + (void)accessorHook:(id *)value withProperty:(const BMProperty *)property sender:(__unused id)sender { *value = [bm_defaults() objectForKey:property.name]; } + (void)mutatorHook:(id *)value withProperty:(const BMProperty *)property sender:(__unused id)sender { [bm_defaults() setObject:*value forKey:property.name]; } @end
30. Private Hook Accessor static inline NSUserDefaults *bm_defaults() { return [NSUserDefaults standardUserDefaults]; } + (void)accessorHook:(id *)value withProperty:(const BMProperty *)property sender:(__unused id)sender { *value = [bm_defaults() objectForKey:property.name]; }
31. Private Hook Mutator static inline NSUserDefaults *bm_defaults() { return [NSUserDefaults standardUserDefaults]; } + (void)mutatorHook:(id *)value withProperty:(const BMProperty *)property sender:(__unused id)sender { [bm_defaults() setObject:*value forKey:property.name]; }
32. BMPreference Usage #import <BloodMagic/Preference.h> @interface Settings : NSObject <BMPreference> @property (nonatomic, bm_preference) NSString *name; @property (nonatomic, bm_preference) NSUInteger age; @end
33. BMPreference Usage #import "Settings.h" @implementation Settings @dynamic name; @dynamic age; @end
34. BMPreference Usage Settings *settings = [Settings new]; settings.name = @"AlexDenisov"; settings.age = 26; // … NSLog(@"%@", defaults);
35. BMPreference Usage Settings *settings = [Settings new]; settings.name = @"AlexDenisov"; settings.age = 26; // … NSLog(@"%@", defaults); { … age = 26; name = AlexDenisov; … }
36. How does it work
37. BloodMagic is modular ~/Projects/BloodMagic/Sources (master ✔) ➜ tree -L 2 . `-- Modules |-- Core |-- Final |-- Injectable |-- Initializers |-- Lazy |-- Partial `-- Preference
38. BloodMagic is modular ~/Projects/BloodMagic/Sources (master ✔) ➜ tree -L 2 . `-- Modules |-- Core |-- Final |-- Injectable |-- Initializers |-- Lazy |-- Partial `-- Preference Property attributes implementation
39. BloodMagic is modular ~/Projects/BloodMagic/Sources (master ✔) ➜ tree -L 2 . `-- Modules |-- Core |-- Final |-- Injectable |-- Initializers |-- Lazy |-- Partial `-- Preference Low level logic • hooks • injections • runtime routines
40. Core Module: Hooks @protocol BMHook <NSObject> @optional + (void)mutatorHook:(id *)value withProperty:(const BMProperty *)property sender:(id)sender; + (void)accessorHook:(id *)value withProperty:(const BMProperty *)property sender:(id)sender; @end
41. Core Module: Injections @interface BMBloodMagicInjector : NSObject - (void)injectBloodMagicInto:(Protocol *)protocol; @end
42. Core Module: Injections @implementation BMBloodMagicInjector // pseudocode - (void)injectBloodMagicInto:(Protocol *)protocol { class_list_t classes = collectClasses(protocol); property_list_t properties = collectDynamicProperties(classes); for (Property *property in properties) { Hook *hook = hookForProperty(property); property.accessor = hook.accessor; property.mutator = hook.mutator; } } @end
43. Sources: https://github.com/railsware/BloodMagic Slides: https://speakerdeck.com/alexdenisov/bloodmagic http://l.rw.rw/dibm Blog-post: https://speakerdeck.com/0xc010d/dependency-injection-ftw
44. Questions?