Latest 0.2.4
Homepage https://github.com/welcommand/FishBind
License MIT
Platforms ios 7.0, osx 10.9, watchos 2.0, tvos 9.0
Frameworks Foundation
Authors

FishBind

FishBind
FishBind
FishBind
FishBind

介绍

FishBind可以轻松的实现对象间消息的绑定。支持绑定属性、方法、block。支持单向绑定&双向绑定。

用这个做MVVM应该很愉快。

项目处于早期版本,仍在持续开发,如果喜欢这个lun zi,赶快一起来加功能、杀bug ー( ´ ▽ ` )ノ

例子

- (void)viewDidLoad {
    [super viewDidLoad];

    //双向绑定

    TestA *objA = [TestA new];
    TestB *objB = [TestB new];
    TestD *objD = [TestD new];

    [IIFishBind bindFishes:@[
                             [IIFish both:objA property:@"name"
                                 callBack:^(IIFishCallBack *callBack, id deadFish) {
                                     [deadFish setUserName:callBack.args[0]];
                                 }],
                             [IIFish both:objB property:@"bName"
                                 callBack:^(IIFishCallBack *callBack, id deadFish) {
                                     [deadFish setBName:callBack.args[0]];
                                 }],
                             [IIFish both:objD
                                 selector:@selector(setDK_Name:)
                                 callBack:^(IIFishCallBack *callBack, id deadFish) {
                                     [deadFish setDK_Name:[NSString stringWithFormat:@"DK_%@",callBack.args[0]]];
                                 }]
                             ]];

    objA.name = @"json";
    NSLog(@"%@", [NSString stringWithFormat:@"nTestA : name = %@nTestB : bName = %@nTestD : DK_Name = %@",objA.userName, objB.bName, objD.DK_Name]);
    /*
     TestA : name = json
     TestB : bName = json
     TestD : DK_Name = DK_json
     */

    objB.bName = @"GCD";
    NSLog(@"%@", [NSString stringWithFormat:@"nTestA : name = %@nTestB : bName = %@nTestD : DK_Name = %@",objA.userName, objB.bName, objD.DK_Name]);
    /*
    TestA : name = GCD
    TestB : bName = GCD
    TestD : DK_Name = DK_GCD
     */

    objD.DK_Name = @"apple";
    NSLog(@"%@", [NSString stringWithFormat:@"nTestA : name = %@nTestB : bName = %@nTestD : DK_Name = %@",objA.userName, objB.bName, objD.DK_Name]);
    /*
    TestA : name = apple
    TestB : bName = apple
    TestD : DK_Name = apple
     */

    // 绑定block

    CGFloat (^testBlock)(CGFloat i, CGFloat j) = ^(CGFloat i, CGFloat j) {
        return i + j;
    };

    [IIFishBind bindFishes:@[
                             [IIFish postBlock:testBlock],
                             [IIFish observer:self
                                     callBack:^(IIFishCallBack *callBack, id deadFish) {
                                         NSLog(@"%@ + %@ = %@", callBack.args[0], callBack.args[1], callBack.resule);
                                         // 3.1 + 4.1 = 7.199999999999999
                                     }]
                             ]];

    CGFloat value = testBlock (3.1, 4.1);

    NSLog(@"value = %@", @(value));
    // value = 7.199999999999999

    // 单向绑定

    [IIFishBind bindFishes:@[
                             [IIFish post:self selector:@selector(viewDidAppear:)],
                             [IIFish observer:self
                                     callBack:^(IIFishCallBack *callBack, id deadFish) {
                                          NSLog(@"======== 4 ===========");
                                     }]
                             ]];

    [IIFishBind bindFishes:@[
                             [IIFish post:self selector:@selector(viewWillAppear:)],
                             [IIFish observer:self
                                     callBack:^(IIFishCallBack *callBack, id deadFish) {
                                         NSLog(@"======== 2 ===========");
                                     }]
                             ]];

}

- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];
    NSLog(@"======== 1 ===========");
}

- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    NSLog(@"======== 3 ===========");
}

安装

pod 'FishBind'

使用

现阶段,基本上就是搞几个IIFish,然后丢给IIFishBind。根据IIFish的语意不同,实现不同的逻辑。

下面是几种IIFish的初始化方式

// property bind
+ (instancetype)post:(id)object property:(NSString *)property;
+ (instancetype)observer:(id)object property:(NSString *)property;

// method bind
+ (instancetype)post:(id)object selector:(SEL)selector;
+ (instancetype)observer:(id)object callBack:(IIFishCallBackBlock)callBack;

// bind a block,  using observer:callBack: to observe
+ (instancetype)postBlock:(id)blockObject;

// bilateral bind
+ (instancetype)both:(id)object selector:(SEL)selector callBack:(IIFishCallBackBlock)callBack;
+ (instancetype)both:(id)object property:(NSString *)property callBack:(IIFishCallBackBlock)callBack;;

单向绑定

绑定属性

比如,有对象A,希望监控其属性a的变化,则使用

IIFish *fish1 = [IIFish post:A property:@"a"];

然后,如果希望在a变化后,把a的值直接传给对象B的属性b, 则使用

IIFish *fish2 = [IIFish observer:B property:@"b"];

如果,只是希望像KVO一样观察事件,然后做一些复杂的操作,则使用

IIFish *fish2 = [IIFish observer:B callBack:^(IIFishCallBack *callBack, id deadFish) {

}];

IIFishCallBack 会把完整的信息交给你。IIFishCallBack结构如下

@interface IIFishCallBack : NSObject
@property (nonatomic, weak) id tager; //被观察者
@property (nonatomic, copy) NSString *selector; //被调用的方法
@property (nonatomic, strong) NSArray *args; // 该方法的参数的值
@property (nonatomic, strong) id resule; // 方法的返回值
@end

而deadFish是什么呢?在本例中,deadFish可以理解为对象B,即观察者。假设B有一个方法test被C监控,调用[B test],C会收到回调。调用[deadFish test],C不会收到回掉(为什么要设计这个,在下文有介绍)。

最后把两个IIFish对象交给IIFishBind,就完成了绑定,代码如下。

[IIFishBind bindFishes:[fish1,fish2]];

绑定方法

绑定属性其实就是绑定方法。本质上没区别。

在使用上,被监控的对象需要使用

+ (instancetype)post:(id)object selector:(SEL)selector;

观察者也必须使用

+ (instancetype)observer:(id)object callBack:(IIFishCallBackBlock)callBack;

绑定Block

其实就是钩一个block。在block执行后加一些自己的代码。(感觉上可以做block队列,或者block事件发给多个接收者。不过实际上没遇见这种需求,纯粹是为了好玩才写的…..)

流程上和上面一样。使用下面的方法初始化IIFish。

+ (instancetype)postBlock:(id)blockObject;
+ (instancetype)observer:(id)object callBack:(IIFishCallBackBlock)callBack;

最后绑定一下就好了。

[IIFishBind bindFishes:XXXXX];

双向绑定

单向绑定的话,属性可以用KVO,方法可以用Aspects,基本都是现成的方案。写这个的目的主要是为了实现双向绑定。

比如,有对象A、B、C,分别有属性a、b、c。三个属性内容一样,希望这三个属性有一个被更改,其它两个跟着被更改。则代码如下

[IIFishBind bindFishes:@[
    [IIFish both:A property:@"a" callBack:nil],
    [IIFish both:B property:@"b" callBack:nil],
    [IIFish both:C property:@"c" callBack:nil]
]];

如果,对象B的属性b,需要特殊处理,比如是a c的100倍,则如下。

[IIFishBind bindFishes:@[
        [IIFish both:A property:@"a" callBack:^(IIFishCallBack *callBack, id deadFish) {
      deadFish.a = [callback.arg[0] intValue] / 100;
    }],
        [IIFish both:C property:@"c" callBack:^(IIFishCallBack *callBack, id deadFish) {
      deadFish.c = [callback.arg[0] intValue] / 100;
    }],
    [IIFish both:B selector:@selector(setB:) callBack:^(IIFishCallBack *callBack, id deadFish) {
      deadFish.b = 100 * [callback.arg[0] intValue];
    }]
]];

这里,如果调用 B.b则回会造成死循环,所以需要使用deadFish。

双向绑定API的选择问题

+ (instancetype)both:(id)object selector:(SEL)selector callBack:(IIFishCallBackBlock)callBack;

+ (instancetype)both:(id)object property:(NSString *)property callBack:(IIFishCallBackBlock)callBack;

使用Both开头的API初始化的IIFish,表示既可以发送改变也可以接受改变。

一组中, 如果有使用both:selector:callBack:,则这一组都需要实现callBack,来实现回调行为。

绑定的相关注意事项

目前callBack没有优先级,调用顺序不确定,不应该在callBack中直接获取这一组的其他值。

todo

  • [ ] 兼容KVO

Latest podspec

{
    "name": "FishBind",
    "version": "0.2.4",
    "summary": "FishBind supports a simple way to bind messages between objects.",
    "description": "Support binding properties, methods, block. Supports one-way binding & bidirectional binding.",
    "homepage": "https://github.com/welcommand/FishBind",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "WELCommand": "[email protected]"
    },
    "platforms": {
        "ios": "7.0",
        "osx": "10.9",
        "watchos": "2.0",
        "tvos": "9.0"
    },
    "source": {
        "git": "https://github.com/welcommand/FishBind.git",
        "tag": "0.2.4"
    },
    "source_files": "FishBind/*",
    "frameworks": "Foundation",
    "libraries": "objc"
}

Pin It on Pinterest

Share This