https://github.com/sschmid/floc-dispatcher
An alternative to NSNotificationCenter.
https://github.com/sschmid/floc-dispatcher
Last synced: over 1 year ago
JSON representation
An alternative to NSNotificationCenter.
- Host: GitHub
- URL: https://github.com/sschmid/floc-dispatcher
- Owner: sschmid
- License: mit
- Created: 2013-07-09T17:43:47.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2013-07-17T20:13:05.000Z (almost 13 years ago)
- Last Synced: 2025-02-28T16:18:05.486Z (over 1 year ago)
- Language: Objective-C
- Homepage:
- Size: 254 KB
- Stars: 6
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Floc Dispatcher
[](https://travis-ci.org/sschmid/Floc-Dispatcher)
## Description
An alternative to NSNotificationCenter.
## Features
* Dispatch any object (no NSNotification like in NSNotificationCenter)
* Add observers with priority
* Add observers that get removed after execution (add once)
## How to use Floc Dispatcher
#### Get a dispatcher
```objective-c
// Create your own dispatcher
GDDispatcher *dispatcher = [[GDDispatcher alloc] init];
// or use the shared dispatcher
GDDispatcher *dispatcher = [GDDispatcher sharedDispatcher];
```
#### Add observers
```objective-c
[dispatcher addObserver:self forObject:[Greeting class]
withSelector:@selector(doSthLast:) priority:-5];
[dispatcher addObserver:self forObject:[Greeting class]
withSelector:@selector(doSthFirst:) priority:10];
```
You can add observers that get removed after execution
```objective-c
[dispatcher addObserverOnce:self forObject:[Greeting class]
withSelector:@selector(doSthLast:) priority:-5];
[dispatcher addObserverOnce:self forObject:[Greeting class]
withSelector:@selector(doSthFirst:) priority:10];
```
#### Dispatch objects
```objective-c
[dispatcher dispatchObject:[[Greeting alloc] initWithString:@"Hello"]];
// Logs
// Got greeting first: Hello
// Got greeting last: Hello
```
```objective-c
- (void)doSthFirst:(Greeting *)greeting {
NSLog(@"Got greeting first: %@", greeting.string);
}
- (void)doSthLast:(Greeting *)greeting {
NSLog(@"Got greeting last: %@", greeting.string);
}
```
## Example
In this example a fake service simulates fetching some data from a remote server. It dispatches the response. An other class
is observing objects of type `User`. If an `User` gets dispatched somewhere in the application, the observer gets
notified and the target selector gets performed. `fl_dispatcher_add`, `fl_dispatcher_remove` and `fl_dispatcher_dispatch`
are some convenience macros available in Floc Dispatcher.
```objective-c
@interface Example ()
@property(nonatomic, strong) Service *service;
@end
@implementation Example
- (id)init {
self = [super init];
if (self) {
fl_dispatcher_add(self, [User class], @selector(updateWithUser:));
self.service = [[Service alloc] init];
[self.service login];
}
return self;
}
- (void)updateWithUser:(User *)user {
NSLog(@"user.name = %@", user.name);
NSLog(@"user.age = %u", user.age);
}
- (void)dealloc {
fl_dispatcher_remove(self);
}
@end
```
```objective-c
@implementation Service
- (void)login {
[self performSelector:@selector(remoteServerResponded) withObject:nil afterDelay:0.5];
}
- (void)remoteServerResponded {
User *user = [[User alloc] init];
user.name = @"Joe";
user.age = 28;
fl_dispatcher_dispatch(user);
}
@end
```
## Install Floc Dispatcher
You find the source files you need in Floc-Dispatcher/Classes.
## CocoaPods
Install [CocoaPods] (http://cocoapods.org) and add the Floc Dispatcher reference to your Podfile
```
platform :ios, '5.0'
pod 'Floc-Dispatcher'
end
```
#### Install Floc Dispatcher
```
$ cd path/to/project
$ pod install
```
Open the created Xcode Workspace file.