IRRemoteResourceDownloadOperation.h

//
//  IRRemoteResourceDownloadOperation.h
//  IRWebAPIKit
//
//  Created by Evadne Wu on 9/16/11.
//  Copyright (c) 2011 Iridia Productions. All rights reserved.
//

#import "IRWebAPIKit.h"

#import <TargetConditionals.h>

#if TARGET_OS_IPHONE
	#import <MobileCoreServices/MobileCoreServices.h>
#else
	#import <ApplicationServices/ApplicationServices.h>
#endif


@class IRRemoteResourceDownloadOperation;
@protocol IRRemoteResourceDownloadOperationDelegate <NSObject>

- (void) remoteResourceDownloadOperationWillBegin:(IRRemoteResourceDownloadOperation *)anOperation;

//	@optional
//	- (void) remoteResourceDownloadOperation:(IRRemoteResourceDownloadOperation *)anOperation didChangeProgress:(float_t)currentProgress;
//	- (void) remoteResourceDownloadOperationDidEnd:(IRRemoteResourceDownloadOperation *)anOperation successfully:(BOOL)wasCompleted;

@end

@interface IRRemoteResourceDownloadOperation : NSOperation

+ (IRRemoteResourceDownloadOperation *) operationWithURL:(NSURL *)aRemoteURL path:(NSString *)aLocalPath prelude:(void(^)(void))aPrelude completion:(void(^)(void))aBlock;

@property (nonatomic, readonly, copy) NSString *path;
@property (nonatomic, readonly, copy) NSString *mimeType;
@property (nonatomic, readonly, retain) NSURL *url;
@property (nonatomic, readonly, assign) long long processedBytes;
@property (nonatomic, readonly, assign) long long totalBytes;
@property (nonatomic, readonly, assign) long long preferredByteOffset;
@property (nonatomic, readonly, assign, getter=isExecuting) BOOL executing;
@property (nonatomic, readonly, assign, getter=isFinished) BOOL finished;
@property (nonatomic, readonly, assign, getter=isCancelled) BOOL cancelled;
@property (nonatomic, readonly, assign) float_t progress; // Convenience

@property (nonatomic, readwrite, assign) id<IRRemoteResourceDownloadOperationDelegate> delegate;

- (void) appendCompletionBlock:(void(^)(void))aBlock;
- (void) invokeCompletionBlocks;

- (IRRemoteResourceDownloadOperation *) continuationOperationCancellingCurrentOperation:(BOOL)cancelsCurrentOperation;

//	The appended completion blocks will only be invoked if the operation finishes successfully; otherwise, as in cases where [anOperation continuationOperationCancellingCurrentOperation:YES] is invoked,
//	The blocks will be transferred to the continuation operation, and the original operation will be cancelled.


- (NSURLConnection *) underlyingConnection;
- (NSMutableURLRequest *) underlyingRequest;

//	may be nil if nothing, but usually there after -remoteResourceDownloadOperationWillBegin

@end


extern NSString * const kIRRemoteResourceDownloadOperationDidReceiveDataNotification;
extern NSString * const kIRRemoteResourceDownloadOperationURL;	//	user info key pointing to NSURL