IRWebAPIKit/IRRemoteResourcesManager.h at develop · iridia/IRWebAPIKit · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
//
//  IRRemoteResourcesManager.h
//  IRWebAPIKit
//
//  Created by Evadne Wu on 12/21/10.
//  Copyright 2010 Iridia Productions. All rights reserved.
//

#import "IRWebAPIKit.h"

#import <objc/runtime.h>
#import <Foundation/Foundation.h>

#if TARGET_OS_IPHONE || TARGET_IPHONE_SIMULATOR
	#import <UIKit/UIKit.h>
	#define IRRemoteResourcesManagerImage UIImage
#else
	#import <Cocoa/Cocoa.h>
	#define IRRemoteResourcesManagerImage NSImage
#endif

enum {
  IRFirstInFirstOutStragery = 0,
  IRPostponeLowerPriorityOperationsStrategy,
}; typedef NSUInteger IRSchedulingStrategy;


@class IRRemoteResourcesManager;
@protocol IRRemoteResourcesManagerDelegate <NSObject>

- (void) remoteResourcesManager:(IRRemoteResourcesManager *)manager didBeginDownloadingResourceAtURL:(NSURL *)anURL;
- (void) remoteResourcesManager:(IRRemoteResourcesManager *)manager didFinishDownloadingResourceAtURL:(NSURL *)anURL;
- (void) remoteResourcesManager:(IRRemoteResourcesManager *)manager didFailDownloadingResourceAtURL:(NSURL *)anURL;

@optional
- (NSURL *) remoteResourcesManager:(IRRemoteResourcesManager *)manager invokedURLForResourceAtURL:(NSURL *)givenURL;

@end


@class IRRemoteResourceDownloadOperation;
@interface IRRemoteResourcesManager : NSObject

+ (IRRemoteResourcesManager *) sharedManager;

@property (nonatomic, readonly, retain) NSOperationQueue *queue;
@property (nonatomic, readwrite, assign) id<IRRemoteResourcesManagerDelegate> delegate;
@property (nonatomic, readwrite, assign) IRSchedulingStrategy schedulingStrategy;	//	Defaults to IRPostponeLowerPriorityOperationsStrategy

@property (nonatomic, readwrite, copy) void (^onRemoteResourceDownloadOperationWillBegin)(IRRemoteResourceDownloadOperation *anOperation);

- (void) retrieveResourceAtURL:(NSURL *)inRemoteURL withCompletionBlock:(void(^)(NSURL *tempFileURLOrNil))aBlock;
- (void) retrieveResourceAtURL:(NSURL *)inRemoteURL usingPriority:(NSOperationQueuePriority)priority forced:(BOOL)forcesReload withCompletionBlock:(void(^)(NSURL *tempFileURLOrNil))aBlock;

@end


@interface IRRemoteResourcesManager (ImageLoading)

- (void) retrieveImageAtURL:(NSURL *)inRemoteURL forced:(BOOL)forcesReload withCompletionBlock:(void(^)(IRRemoteResourcesManagerImage *tempImage))aBlock;

@end