| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368 |
- //
- // EGOCache.m
- // enormego
- //
- // Created by Shaun Harrison.
- // Copyright (c) 2009-2017 enormego.
- //
- // Permission is hereby granted, free of charge, to any person obtaining a copy
- // of this software and associated documentation files (the "Software"), to deal
- // in the Software without restriction, including without limitation the rights
- // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- // copies of the Software, and to permit persons to whom the Software is
- // furnished to do so, subject to the following conditions:
- //
- // The above copyright notice and this permission notice shall be included in
- // all copies or substantial portions of the Software.
- //
- // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- // THE SOFTWARE.
- //
- #import "EGOCache.h"
- #if DEBUG
- # define CHECK_FOR_EGOCACHE_PLIST() if([key isEqualToString:@"EGOCache.plist"]) { \
- NSLog(@"EGOCache.plist is a reserved key and can not be modified."); \
- return; }
- #else
- # define CHECK_FOR_EGOCACHE_PLIST() if([key isEqualToString:@"EGOCache.plist"]) return;
- #endif
- static inline NSString* cachePathForKey(NSString* directory, NSString* key) {
- key = [key stringByReplacingOccurrencesOfString:@"/" withString:@"_"];
- return [directory stringByAppendingPathComponent:key];
- }
- #pragma mark -
- @interface EGOCache () {
- dispatch_queue_t _cacheInfoQueue;
- dispatch_queue_t _frozenCacheInfoQueue;
- dispatch_queue_t _diskQueue;
- NSMutableDictionary* _cacheInfo;
- NSString* _directory;
- BOOL _needsSave;
- }
- @property(nonatomic,copy) NSDictionary* frozenCacheInfo;
- @end
- @implementation EGOCache
- + (instancetype)globalCache {
- static id instance;
-
- static dispatch_once_t onceToken;
- dispatch_once(&onceToken, ^{
- instance = [[[self class] alloc] init];
- });
-
- return instance;
- }
- - (instancetype)init {
- NSString* cachesDirectory = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES)[0];
- NSString* oldCachesDirectory = [[[cachesDirectory stringByAppendingPathComponent:[[NSProcessInfo processInfo] processName]] stringByAppendingPathComponent:@"EGOCache"] copy];
- if([[NSFileManager defaultManager] fileExistsAtPath:oldCachesDirectory]) {
- [[NSFileManager defaultManager] removeItemAtPath:oldCachesDirectory error:NULL];
- }
-
- cachesDirectory = [[[cachesDirectory stringByAppendingPathComponent:[[NSBundle mainBundle] bundleIdentifier]] stringByAppendingPathComponent:@"EGOCache"] copy];
- return [self initWithCacheDirectory:cachesDirectory];
- }
- - (instancetype)initWithCacheDirectory:(NSString*)cacheDirectory {
- if((self = [super init])) {
- _cacheInfoQueue = dispatch_queue_create("com.enormego.egocache.info", DISPATCH_QUEUE_SERIAL);
- dispatch_queue_t priority = dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_HIGH, 0);
- dispatch_set_target_queue(priority, _cacheInfoQueue);
-
- _frozenCacheInfoQueue = dispatch_queue_create("com.enormego.egocache.info.frozen", DISPATCH_QUEUE_SERIAL);
- priority = dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_HIGH, 0);
- dispatch_set_target_queue(priority, _frozenCacheInfoQueue);
-
- _diskQueue = dispatch_queue_create("com.enormego.egocache.disk", DISPATCH_QUEUE_CONCURRENT);
- priority = dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_BACKGROUND, 0);
- dispatch_set_target_queue(priority, _diskQueue);
-
-
- _directory = cacheDirectory;
- _cacheInfo = [[NSDictionary dictionaryWithContentsOfFile:cachePathForKey(_directory, @"EGOCache.plist")] mutableCopy];
-
- if(!_cacheInfo) {
- _cacheInfo = [[NSMutableDictionary alloc] init];
- }
-
- [[NSFileManager defaultManager] createDirectoryAtPath:_directory withIntermediateDirectories:YES attributes:nil error:NULL];
-
- NSTimeInterval now = [[NSDate date] timeIntervalSinceReferenceDate];
- NSMutableArray* removedKeys = [[NSMutableArray alloc] init];
-
- for(NSString* key in _cacheInfo) {
- if([_cacheInfo[key] timeIntervalSinceReferenceDate] <= now) {
- [[NSFileManager defaultManager] removeItemAtPath:cachePathForKey(_directory, key) error:NULL];
- [removedKeys addObject:key];
- }
- }
-
- [_cacheInfo removeObjectsForKeys:removedKeys];
- self.frozenCacheInfo = _cacheInfo;
- [self setDefaultTimeoutInterval:86400];
- }
-
- return self;
- }
- - (void)clearCache {
- dispatch_sync(_cacheInfoQueue, ^{
- for(NSString* key in _cacheInfo) {
- [[NSFileManager defaultManager] removeItemAtPath:cachePathForKey(_directory, key) error:NULL];
- }
-
- [_cacheInfo removeAllObjects];
-
- dispatch_sync(_frozenCacheInfoQueue, ^{
- self.frozenCacheInfo = [_cacheInfo copy];
- });
- [self setNeedsSave];
- });
- }
- - (void)removeCacheForKey:(NSString*)key {
- CHECK_FOR_EGOCACHE_PLIST();
- dispatch_async(_diskQueue, ^{
- [[NSFileManager defaultManager] removeItemAtPath:cachePathForKey(_directory, key) error:NULL];
- });
- [self setCacheTimeoutInterval:0 forKey:key];
- }
- - (BOOL)hasCacheForKey:(NSString*)key {
- NSDate* date = [self dateForKey:key];
- if(date == nil) return NO;
- if([date timeIntervalSinceReferenceDate] < CFAbsoluteTimeGetCurrent()) return NO;
-
- return [[NSFileManager defaultManager] fileExistsAtPath:cachePathForKey(_directory, key)];
- }
- - (NSDate*)dateForKey:(NSString*)key {
- __block NSDate* date = nil;
- dispatch_sync(_frozenCacheInfoQueue, ^{
- date = (self.frozenCacheInfo)[key];
- });
- return date;
- }
- - (NSArray*)allKeys {
- __block NSArray* keys = nil;
- dispatch_sync(_frozenCacheInfoQueue, ^{
- keys = [self.frozenCacheInfo allKeys];
- });
- return keys;
- }
- - (void)setCacheTimeoutInterval:(NSTimeInterval)timeoutInterval forKey:(NSString*)key {
- NSDate* date = timeoutInterval > 0 ? [NSDate dateWithTimeIntervalSinceNow:timeoutInterval] : nil;
-
- // Temporarily store in the frozen state for quick reads
- dispatch_sync(_frozenCacheInfoQueue, ^{
- NSMutableDictionary* info = [self.frozenCacheInfo mutableCopy];
-
- if(date) {
- info[key] = date;
- } else {
- [info removeObjectForKey:key];
- }
-
- self.frozenCacheInfo = info;
- });
-
- // Save the final copy (this may be blocked by other operations)
- dispatch_async(_cacheInfoQueue, ^{
- if(date) {
- _cacheInfo[key] = date;
- } else {
- [_cacheInfo removeObjectForKey:key];
- }
-
- dispatch_sync(_frozenCacheInfoQueue, ^{
- self.frozenCacheInfo = [_cacheInfo copy];
- });
- [self setNeedsSave];
- });
- }
- #pragma mark -
- #pragma mark Copy file methods
- - (void)copyFilePath:(NSString*)filePath asKey:(NSString*)key {
- [self copyFilePath:filePath asKey:key withTimeoutInterval:self.defaultTimeoutInterval];
- }
- - (void)copyFilePath:(NSString*)filePath asKey:(NSString*)key withTimeoutInterval:(NSTimeInterval)timeoutInterval {
- dispatch_async(_diskQueue, ^{
- [[NSFileManager defaultManager] copyItemAtPath:filePath toPath:cachePathForKey(_directory, key) error:NULL];
- });
-
- [self setCacheTimeoutInterval:timeoutInterval forKey:key];
- }
- #pragma mark -
- #pragma mark Data methods
- - (void)setData:(NSData*)data forKey:(NSString*)key {
- [self setData:data forKey:key withTimeoutInterval:self.defaultTimeoutInterval];
- }
- - (void)setData:(NSData*)data forKey:(NSString*)key withTimeoutInterval:(NSTimeInterval)timeoutInterval {
- CHECK_FOR_EGOCACHE_PLIST();
-
- NSString* cachePath = cachePathForKey(_directory, key);
-
- dispatch_async(_diskQueue, ^{
- [data writeToFile:cachePath atomically:YES];
- });
-
- [self setCacheTimeoutInterval:timeoutInterval forKey:key];
- }
- - (void)setNeedsSave {
- dispatch_async(_cacheInfoQueue, ^{
- if(_needsSave) return;
- _needsSave = YES;
-
- double delayInSeconds = 0.5;
- dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, delayInSeconds * NSEC_PER_SEC);
- dispatch_after(popTime, _cacheInfoQueue, ^(void){
- if(!_needsSave) return;
- [_cacheInfo writeToFile:cachePathForKey(_directory, @"EGOCache.plist") atomically:YES];
- _needsSave = NO;
- });
- });
- }
- - (NSData*)dataForKey:(NSString*)key {
- if([self hasCacheForKey:key]) {
- return [NSData dataWithContentsOfFile:cachePathForKey(_directory, key) options:0 error:NULL];
- } else {
- return nil;
- }
- }
- #pragma mark -
- #pragma mark String methods
- - (NSString*)stringForKey:(NSString*)key {
- return [[NSString alloc] initWithData:[self dataForKey:key] encoding:NSUTF8StringEncoding];
- }
- - (void)setString:(NSString*)aString forKey:(NSString*)key {
- [self setString:aString forKey:key withTimeoutInterval:self.defaultTimeoutInterval];
- }
- - (void)setString:(NSString*)aString forKey:(NSString*)key withTimeoutInterval:(NSTimeInterval)timeoutInterval {
- [self setData:[aString dataUsingEncoding:NSUTF8StringEncoding] forKey:key withTimeoutInterval:timeoutInterval];
- }
- #pragma mark -
- #pragma mark Image methds
- #if TARGET_OS_IPHONE
- - (UIImage*)imageForKey:(NSString*)key {
- UIImage* image = nil;
-
- @try {
- image = [NSKeyedUnarchiver unarchiveObjectWithFile:cachePathForKey(_directory, key)];
- } @catch (NSException* e) {
- // Surpress any unarchiving exceptions and continue with nil
- }
-
- return image;
- }
- - (void)setImage:(UIImage*)anImage forKey:(NSString*)key {
- [self setImage:anImage forKey:key withTimeoutInterval:self.defaultTimeoutInterval];
- }
- - (void)setImage:(UIImage*)anImage forKey:(NSString*)key withTimeoutInterval:(NSTimeInterval)timeoutInterval {
- @try {
- // Using NSKeyedArchiver preserves all information such as scale, orientation, and the proper image format instead of saving everything as pngs
- [self setData:[NSKeyedArchiver archivedDataWithRootObject:anImage] forKey:key withTimeoutInterval:timeoutInterval];
- } @catch (NSException* e) {
- // Something went wrong, but we'll fail silently.
- }
- }
- #else
- - (NSImage*)imageForKey:(NSString*)key {
- return [[NSImage alloc] initWithData:[self dataForKey:key]];
- }
- - (void)setImage:(NSImage*)anImage forKey:(NSString*)key {
- [self setImage:anImage forKey:key withTimeoutInterval:self.defaultTimeoutInterval];
- }
- - (void)setImage:(NSImage*)anImage forKey:(NSString*)key withTimeoutInterval:(NSTimeInterval)timeoutInterval {
- [self setData:[[NSBitmapImageRep imageRepWithData:anImage.TIFFRepresentation] representationUsingType:NSPNGFileType properties:@{ }] forKey:key withTimeoutInterval:timeoutInterval];
- }
- #endif
- #pragma mark -
- #pragma mark Property List methods
- - (NSData*)plistForKey:(NSString*)key; {
- NSData* plistData = [self dataForKey:key];
- return [NSPropertyListSerialization propertyListWithData:plistData options:NSPropertyListImmutable format:nil error:nil];
- }
- - (void)setPlist:(id)plistObject forKey:(NSString*)key; {
- [self setPlist:plistObject forKey:key withTimeoutInterval:self.defaultTimeoutInterval];
- }
- - (void)setPlist:(id)plistObject forKey:(NSString*)key withTimeoutInterval:(NSTimeInterval)timeoutInterval; {
- // Binary plists are used over XML for better performance
- NSData* plistData = [NSPropertyListSerialization dataWithPropertyList:plistObject format:NSPropertyListBinaryFormat_v1_0 options:0 error:nil];
- if(plistData != nil) {
- [self setData:plistData forKey:key withTimeoutInterval:timeoutInterval];
- }
- }
- #pragma mark -
- #pragma mark Object methods
- - (id<NSCoding>)objectForKey:(NSString*)key {
- if([self hasCacheForKey:key]) {
- return [NSKeyedUnarchiver unarchiveObjectWithData:[self dataForKey:key]];
- } else {
- return nil;
- }
- }
- - (void)setObject:(id<NSCoding>)anObject forKey:(NSString*)key {
- [self setObject:anObject forKey:key withTimeoutInterval:self.defaultTimeoutInterval];
- }
- - (void)setObject:(id<NSCoding>)anObject forKey:(NSString*)key withTimeoutInterval:(NSTimeInterval)timeoutInterval {
- [self setData:[NSKeyedArchiver archivedDataWithRootObject:anObject] forKey:key withTimeoutInterval:timeoutInterval];
- }
- @end
|