Objection 是一个轻量级的Objective-C依赖注入框架,可同时用于MacOS X 或者iOS.对于那些使用过 Guice (一个Java依赖注入框架)的开发者,会感觉Objection 似曾相识.Objection用来以一种相对容易接受的方式来使你尽可能地不需要管理一个庞大的XML容器或者手动创建对象.
注意podfile中需要指明Objection的版本号,否则无法安装成功.
pod 'Objection', '1.6.1' # 依赖注入.
然后在需要的地方导入即可头文件即可:
#import <Objection/Objection.h>
一个类可以使用宏 objection_register (可选)或 objection_register_singleton 注册到 objection. objection_requires 宏用来声明objection应该为此类的所有实例提供的依赖. objection_requires 在类的继承体系中也可以安全使用.
@class Engine, Brakes; @interface Car : NSObject // 将会通过依赖注入赋值. @property(nonatomic, strong) Engine *engine; // 将会通过依赖注入赋值. @property(nonatomic, strong) Brakes *brakes; @property(nonatomic) BOOL awake; @implementation Car objection_requires(@"engine", @"brakes") @synthesize engine, brakes, awake; @end
你也可以使用选择器来定义依赖.如果给定的选择器在当前作用域看不见或无法找到,编译器会产生一个警告.
@implementation Car objection_requires_sel(@selector(engine), @selector(brakes)) @synthesize engine, brakes, awake; @end
可以创建一个注射器,然后从这个注射器中获取指定类或协议的一个实例.注射器各自管理自己的对象上下文.这意味着:Objection中的单例指的是一个注射器中只存在一个某个类的实例,并不一定是真正意义上的单例(即那种应用程序全局唯一的类的实例对象).
- (void)someMethod { JSObjectionInjector *injector = [JSObjection createInjector]; id car = [injector getObject:[Car class]]; }
一个给Objection设置一个默认的注射器.这个设置器可以在你的应用或库内,全局可用.
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { JSObjectionInjector *injector = [JSObjection createInjector]; [JSObjection setDefaultInjector:injector]; } - (void)viewDidLoad { id myModel = [[JSObjection defaultInjector] getObject:[MyModel class]]; }
有可能类的实例对象并不是通过注射器创建的,此时如果不做特殊处理,依赖不会被正确处理,相关属性可能为nil.但是如果对于使用 objection_requires 宏指定依赖的情况,你可以通过 injectDependencies: 方法来实现:即使不使用注射器也能保证依赖被满足.
@implementation JSTableModel objection_requires(@"RESTClient") - (void)awakeFromNib { [[JSObjection defaultInjector] injectDependencies:self]; } @end
Objection 已经支持使用下标操作来从注射器上下文来获取对象.
- (void)someMethod { JSObjectionInjector *injector = [JSObjection createInjector]; id car = injector[[Car class]]; }
如果一个对象需要知道它使合适被objection完全初始化的,可以实现方法 awakeFromObjection .注意:对象被Objection完全初始化时会调用awakeFromObjection方法,你在这里可以加入自定义的一些操作;而awake只是一个例子中的自定义标记属性而已,并不是Objection的一部分.
@implementation Car //... objection_register_singleton(Car) - (void)awakeFromObjection { self.awake = YES; } @end
一个对象可以通过对象工厂来从注射器上下文来获取对象.
自定义JSObjectFactory属性,需要使用 objection_requires 宏来指明依赖,如 objection_requires(@"objectFactory") .这样当从注射器中获取这个类的实例时,会自动获取与此注射器相关的JSObjectFactory对象工厂实例.
@interface RequestDispatcher @property(nonatomic, strong) JSObjectFactory *objectFactory @end @implementation RequestDispatcher objection_requires(@"objectFactory") - (void)dispatch:(NSDictionary *)params { Request *request = [self.objectFactory getObject:[Request class]]; request.params = params; [request send]; } @end
一个模块就是一组绑定信息.这些绑定信息用来给注射器增加额外的配置信息.它在整合外部依赖和绑定协议到类或实例时特别有用.
@interface MyAppModule : JSObjectionModule { } @end @implementation MyAppModule - (void)configure { [self bind:[UIApplication sharedApplication] toClass:[UIApplication class]]; [self bind:[UIApplication sharedApplication].delegate toProtocol:@protocol(UIApplicationDelegate)]; [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]; }
有时候,我们仅仅是想使用依赖的某个类的类方法.Objection可以通过协议显示地支持元类的绑定.这样就不用再创建一个包装类来传递类方法.要注意的是,它需要定义一个协议来让Objection知道如何绑定元类到注射器的对象上下文.
@protocol ExternalUtility - (void)doSomething; //!< 注意此处,确实是`-`减号.通常是不支持让元类直接支持协议的.此处是以类本身作为对象,来取执行协议,而不是使用该类的某一个实例. @end @interface ExternalUtility + (void)doSomething; @end @implementation ExternalUtility + (void)doSomething {...} @end // Module Configuration - (void)configure { [self bindMetaClass:[ExternalUtility class] toProtocol:@protocol(ExternalUtility)]; } @interface SomeClass { ... } // 使用 'assign' 是因为一个元类不受通常的 retain/release声明周期限制. // 它将会一直存在,直到应用程序终止(类初始化 -> 应用终止),不管运行时有多少指向它的对象引用. // @property (nonatomic, assign) id<ExternalUtility> externalUtility @end
偶尔你可能想要在Objection内部手动构造一个对象.提供者允许你使用自定义的机制来创建某个类型的对象.你可以创建一个 遵守 ObjectionProvider 协议的对象,或者你可以使用一个 block 来创建对象.
如果使用了对像提供者,则原类中的 -awakeFromObjection
方法在此类的实例通过注射器创建完成后,不会再被调用.
@interface CarProvider : NSObject <JSObjectionProvider> @end @implementation CarProvider - (id)provide:(JSObjectionInjector *)context arguments:(NSArray *)arguments { // 手动创建对象的代码 return car; } @end @implementation MyAppModule - (void)configure { [self bindProvider:[[CarProvider alloc] init] toClass:[Car class]]; [self bindBlock:^(JSObjectionInjector *context) { // 手动创建对象. return car; } toClass:[Car class]]; } @end
一个类被用作模块作用域内的单例.相反,一个已经注册的单例在也可以被降级为注射器上下文中一个普通声明周期的实例对象.
也就是说,你有两种方式来指定类实例在注射器上下文是单例对象还是普通对象.一种是在类实现中使用 objection_register_singleton 宏,一种是在模块配置方法中指定作用域为JSObjectionScopeSingleton.
@implementation MyAppModule - (void)configure { [self bindClass:[Singleton class] inScope:JSObjectionScopeNormal]; [self bindClass:[Car class] inScope:JSObjectionScopeSingleton]; } @end
同一个类或协议的依赖可以使用 objection_requires_names 宏标记,这个宏使用属性别名字典作为参数.
@interface ShinyCar : NSObject @property (nonatomic, strong) Headlight *leftHeadlight; @property (nonatomic, strong) Headlight *rightHeadlight; @end @implementation ShinyCar objection_register(ShinyCar) objection_requires_names((@{@"LeftHeadlight":@"leftHeadlight", @"RightHeadlight":@"rightHeadlight"})) @synthesize leftHeadlight, rightHeadlight; @end @implementation NamedModule - (void)configure { [self bind:[[Headlight alloc]init] toClass:[Headlight class] named:@"RightHeadlight"]; [self bindClass:[HIDHeadlight class] toClass:[Headlight class] named:@"LeftHeadlight"]; } @end
你可以将已经注册的单例用作及早初始化的单例.及早初始化的单例,在注射器创建时创建,而不再是懒加载.
注意:如果将一个未注册为单例的类设置为及早初始化的单例,会引起崩溃.
@implementation MyAppModule - (void)configure { [self registerEagerSingleton:[Car class]]; } @end
一个新的注射器可以使用 withModule: 方法从一个已经存在的注射器创建.这个新的注射器将会和派生它的注射器拥有同样的绑定信息.
与之相反,如果使用 withoutModuleOfType: ,新注射器就不会包含被标记为不包含的模块.
injector = [otherInjector withModule:[[Level18Module alloc] init]] withoutModuleOfType:[Level17Module class]];
默认地,Objection 使用默认的初始化方法 init
创建对象.如果你想使用其他的初始化方法来初始化对象,可以借助 objection_initializer
宏.这个宏支持传递默认参数(暂时不支持标量参数,即基本类型参数,如数字).
@implementation ViewController objection_initializer(initWithNibName:bundle:, @"ViewController") @end
@implementation ConfigurableCar objection_requires(@"engine", @"brakes") objection_initializer(initWithMake:model:) @synthesize make; @synthesize model; - (instancetype)initWithMake:(NSString *)make model:(NSString *)model { ... } @end - (void)buildCar { ConfigurableCar *car = [self.objectFactory getObjectWithArgs:[ConfigurableCar class], @"VW", @"Passat", nil]; NSLog(@"Make: %@ Model: %@", car.make, car.model); }
@implementation Truck objection_requires(@"engine", @"brakes") objection_initializer(truckWithMake:model:) + (instancetype)truckWithMake:(NSString *) make model: (NSString *)model { ... } @end
@implementation ConfigurableCar - (instancetype) initWithModel:(NSString *)model { //.... } @end - (void)buildCar { ConfigurableCar *car = [self.objectFactory getObject:[ConfigurableCar class], initializer: @selector(initWithModel:) withArgumentList:@[@"Passat"]]; }
如果你正在使用 Kiwi 来进行应用的测试, 请检出 MSSpec .它提供了一种把虚拟数据注入到你的测试标准中的便利方式.