Add properties/methods to sender header (testing)

This commit is contained in:
Christoph Wendt 2015-09-10 18:53:44 -07:00
parent a04b5ccf9d
commit 2bcb4d8e53

View File

@ -7,6 +7,7 @@
@class BITPersistence;
NS_ASSUME_NONNULL_BEGIN
/**
* Utility class that's responsible for sending a bundle of data to the server
*/
@ -25,16 +26,16 @@ NS_ASSUME_NONNULL_BEGIN
*/
- (instancetype)initWithPersistence:(BITPersistence *)persistence serverURL:(NSURL *)serverURL;
/**
* Access to the internal operation queue
*/
@property (nonatomic, strong) NSOperationQueue *operationQueue;
/**
* A queue which is used to handle BITHTTPOperation completion blocks.
*/
@property (nonatomic, strong) dispatch_queue_t senderQueue;
/**
* A queue for processing http operations (iOS < 7)
*/
@property (nonatomic, strong) NSOperationQueue *operationQueue;
/**
* The endpoint url of the telemetry server.
*/
@ -65,19 +66,49 @@ NS_ASSUME_NONNULL_BEGIN
///-----------------------------------------------------------------------------
/**
* Triggers sending the saved data. Does nothing if nothing has been persisted, yet. This method should be called by BITTelemetryManager on app start.
* Creates a request for the given data and forwards that in order to send it out.
*
* @param data the telemetry data which should be sent
* @param path a reference of path to the file which should be sent (needed to delete it after sending)
*/
- (void)sendData:(NSData * __nonnull)data withPath:(NSString * __nonnull)path;
/**
* Triggers sending the saved data on a background thread. Does nothing if nothing has been persisted, yet. This method should be called by BITTelemetryManager on app start.
*/
- (void)sendSavedDataAsync;
/**
* Triggers sending the saved data.
*/
- (void)sendSavedData;
/**
* Creates a HTTP operation and puts it to the queue.
* Creates a HTTP operation/session task and puts it to the queue.
*
* @param request a request for sending a data object to the telemetry server
* @param path path to the file which should be sent
* @param urlSessionSupported a flag which determines whether to use NSURLConnection or NSURLSession for sending out data
* @param isUrlSessionSupported a flag which determines whether to use NSURLConnection or NSURLSession for sending out data
*/
- (void)sendRequest:(NSURLRequest * __nonnull)request path:(NSString * __nonnull)path urlSessionSupported:(BOOL)isUrlSessionSupported;
/**
* Resumes the given NSURLSessionDataTask instance.
*
* @param sessionDataTask the task which should be resumed
*/
- (void)resumeSessionDataTask:(NSURLSessionDataTask *)sessionDataTask;
/**
* Deletes or unblocks sent file according to the given response code.
*
* @param statusCode the status code of the response
* @param responseCode the data of the response
* @param filePath the path of the file which content has been sent to the server
* @param error an error object sent from the server
*/
- (void)handleResponseWithStatusCode:(NSInteger)statusCode responseData:(NSData *)responseData filePath:(NSString *)filePath error:(NSError *)error;
///-----------------------------------------------------------------------------
/// @name Helper
///-----------------------------------------------------------------------------