Objection 技术文档

1. 安装指南

Objection 是一个轻量级的依赖注入框架，适用于 Objective-C 的 MacOS X 和 iOS 平台。要使用 Objection，首先需要将其集成到你的项目中。

使用 CocoaPods 安装

1. 在你的 Podfile 中添加以下内容：

   pod 'Objection', '~> 1.0'
   

2. 运行 pod install 命令来安装 Objection。

手动安装

1. 从 GitHub 下载 Objection 的源代码。
2. 将源代码文件添加到你的项目中。
3. 确保你的项目中包含 Objection.h 和 Objection.m 文件。

2. 项目的使用说明

基本用法

Objection 通过宏 objection_register 或 objection_register_singleton 注册类，并通过 objection_requires 宏声明依赖关系。

示例

@class Engine, Brakes;

@interface Car : NSObject
{
  Engine *engine;
  Brakes *brakes;
  BOOL awake;  
}

@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

获取对象

通过创建注入器并请求特定类或协议的实例来从 Objection 中获取对象。

- (void)someMethod {
  JSObjectionInjector *injector = [JSObjection createInjector];
  id car = [injector getObject:[Car class]];
}

注入依赖

如果对象在注入器生命周期之外分配，可以使用 injectDependencies: 方法来满足其依赖关系。

@implementation JSTableModel
objection_requires(@"RESTClient")
- (void)awakeFromNib {
  [[JSObjection defaultInjector] injectDependencies:self];
}
@end

3. 项目 API 使用文档

注册类

• objection_register: 注册一个类，Objection 会自动创建该类的实例。
• objection_register_singleton: 注册一个单例类，Objection 只会创建一个实例。

声明依赖

• objection_requires: 声明类所需的依赖项。
• objection_requires_sel: 使用选择器声明依赖项。

获取对象

• [JSObjection createInjector]: 创建一个新的注入器。
• [injector getObject:[Class class]]: 从注入器中获取指定类的实例。
• [JSObjection setDefaultInjector:injector]: 设置默认注入器。

注入依赖

• [injector injectDependencies:object]: 为对象注入依赖项。

对象工厂

• JSObjectFactory: 通过对象工厂从注入器上下文中获取对象。

模块

• JSObjectionModule: 配置注入器的绑定关系。

4. 项目安装方式

使用 CocoaPods

在 Podfile 中添加 pod 'Objection'，然后运行 pod install。

手动安装

将 Objection 的源代码文件添加到项目中，并确保包含 Objection.h 和 Objection.m 文件。

通过以上步骤，你可以成功安装并使用 Objection 框架，轻松实现依赖注入。