timoman / apasyncdictionary

Thread safe asynchronous access to NSMutableDictionary

APAsyncDictionary is a wrapper on NSMutableDictionary that performs actions in own dispatch queue and return results to caller's thread. And it could be very useful when application uses dictionary concurrently from different threads.

Features

• Thread safety
• Get object for key asynchronously
• Set object for key
• Set objects and keys from any NSDictionary
• Remove object for key
• Remove objects for NSArray of keys
• Remove all objects for all keys
• Get objects count asynchronously
• Get all keys asynchronously
• Get all objects asynchronously

Installation

Add APAsyncDictionary pod to Podfile

Using

// instantiation
APAsyncDictionary *dictionary = [[APAsyncDictionary alloc] init];
...
// get object for key
__block id someObject;
[dictionary objectForKey:@"key" callback:^(id <NSCopying> key, id object)
{
    someObject = object;
    // do something with object
}];
...
// get object for key synchronously
someObject = [dictionary objectForKeySynchronously:@"key"];
...
// set object
[dictionary setObject:object forKey:@"key"];
...
// set objects and keys from dictionary
[dictionary setObjectsAndKeysFromDictionary:@{@"key1" : object1, @"key2" : object2}];
...
// remove object for key
[dictionary removeObjectForKey:@"key"];
...
// remove objects for keys from array
[dictionary removeObjectsForKeys:@[@"key1", @"key2"]];
...
// remove all objects
[dictionary removeAllObjects];
...
// get objects count
[dictionary objectsCountCallback:^(NSUInteger count)
{
    // do something with count    
}];
...
// get objects count synchronously
NSUInteger count = [dictionary objectsCountSynchronously];
...
// all keys
[dictionary allKeysCallback:^(NSArray *keys)
{
    // do something with keys
}];
...
// all objects
[dictionary allObjectsCallback:^(NSArray *objects)
{
    // do something with objects
}];

History

Version 0.0.6

• Improved read access performance

Version 0.0.5

• Fixed Analyzer warning

Version 0.0.4

• Added method to get object for key synchronously
• Added method to get objects count synchronously

Version 0.0.3

• Public release

If you have improvements or concerns, feel free to post an issue and write details.

Check out all Alterplay's GitHub projects. Email us with other ideas and projects.