// // FlyVerifyCService.h // FlyVerifyCSDK // // Created by flyverify on 15-1-20. // Copyright (c) 2015年 FlyVerify. All rights reserved. // #import @class FlyVerifyCHttpService; /** * GET方式 */ extern NSString *const kFlyVerifyCHttpMethodGet; /** * POST方式 */ extern NSString *const kFlyVerifyCHttpMethodPost; /** * DELETE方式 */ extern NSString *const kFlyVerifyCHttpMethodDelete; /** * HEAD方式 */ extern NSString *const kFlyVerifyCHttpMethodHead; /** * HTTP返回事件 * * @param response 回复对象 * @param responseData 回复数据 */ typedef void(^FlyVerifyCResultEvent) (NSHTTPURLResponse *response, NSData *responseData); /** * HTTP错误事件 * * @param error 错误信息 */ typedef void(^FlyVerifyCFaultEvent) (NSError *error); /** * HTTP上传数据事件 * * @param totalBytes 总字节数 * @param loadedBytes 上传字节数据 */ typedef void(^FlyVerifyCUploadProgressEvent) (int64_t totalBytes, int64_t loadedBytes); /** * HTTP下载数据事件 * * @param totalBytes 总字节数 * @param loadedBytes 上传字节数据 */ typedef void(^FlyVerifyCDownloadProgressEvent) (int64_t totalBytes, int64_t loadedBytes); /** * HTTP服务类 */ @interface FlyVerifyCHttpService : NSObject /** * @brief 提交方式，默认为GET */ @property (nonatomic, copy) NSString *method; /** 超时时间 */ @property (nonatomic) NSTimeInterval timeout; /** * @brief 是否缓存回复对象，默认为YES */ @property (nonatomic) BOOL isCacheResponse; /** * 自动填充请求表单，默认为YES，如果为NO则表示使用自定义的方式发起请求。 */ @property (nonatomic) BOOL autoFillRequestForm; /** * 初始化HTTP服务 * * @param urlString URL地址字符串 * * @return HTTP服务对象 */ - (id)initWithURLString:(NSString *)urlString; /** * 初始化HTTP服务 * * @param URL URL地址对象 * * @return HTTP服务对象 */ - (id)initWithURL:(NSURL *)URL; /** * 初始化HTTP服务 * * @param request 请求对象 * * @return HTTP服务对象 */ - (id)initWithRequest:(NSURLRequest *)request; /** * 添加HTTP头 * * @param header 名称 * @param value 值 */ - (void)addHeader:(NSString *)header value:(NSString *)value; /** * 添加HTTP头集合 * * @param headers 头集合 */ - (void)addHeaders:(NSDictionary *)headers; /** * 添加参数 * * @param value 参数值 * @param key 参数名字 */ - (void)addParameter:(id)value forKey:(NSString *)key; /** * 添加多个参数 * * @param parameters 参数集合 */ - (void)addParameters:(NSDictionary *)parameters; /** * 添加上传文件参数 * * @param fileData 文件数据 * @param fileName 文件名称 * @param mimeType MIME类型 * @param transferEncoding 传输编码 * @param key 参数名字 */ - (void)addFileParameter:(NSData *)fileData fileName:(NSString *)fileName mimeType:(NSString *)mimeType transferEncoding:(NSString *)transferEncoding forKey:(NSString *)key; /** * 设置请求体数据，可以为NSData或者NSInputStream * * @param body 请求体数据 */ - (void)setBody:(id)body; /** * 发送请求 * * @param resultHandler 返回回调 * @param faultHandler 错误回调 * @param uploadProgressHandler 上传数据进度回调 */ - (void)sendRequestOnResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler; /** * 发送请求 * * @param resultHandler 返回回调 * @param faultHandler 错误回调 * @param uploadProgressHandler 上传数据进度回调 * @param asynCompletion 完成回调是否异步 * @param needCallSerial 串行回调 */ - (void)sendRequestOnResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler asynCompletion:(BOOL)asynCompletion needCallSerial:(BOOL)needCallSerial; /** 发送请求 @param resultHandler 返回回调 @param faultHandler 错误回调 @param uploadProgressHandler 上传数据进度回调 @param downloadProgressHandler 下载数据进度回调 */ - (void)sendRequestOnResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler onDownloadProgress:(FlyVerifyCDownloadProgressEvent)downloadProgressHandler; /** 发送请求 @param resultHandler 返回回调 @param faultHandler 错误回调 @param uploadProgressHandler 上传数据进度回调 @param downloadProgressHandler 下载数据进度回调 @param needCallSerial 串行回调 @param asynCompletion 完成回调是否异步 */ - (void)sendRequestOnResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler onDownloadProgress:(FlyVerifyCDownloadProgressEvent)downloadProgressHandler asynCompletion:(BOOL)asynCompletion needCallSerial:(BOOL)needCallSerial; /** * 取消请求 */ - (void)cancelRequest; /** * 发送HTTP请求 * * @param urlString 请求地址 * @param method 请求方式 * @param parameters 请求参数 * @param headers 请求头集合 * @param resultHandler 返回回调 * @param faultHandler 错误回调 * @param uploadProgressHandler 上传数据进度回调 * * @return HTTP服务对象 */ + (FlyVerifyCHttpService *)sendHttpRequestByURLString:(NSString *)urlString method:(NSString *)method parameters:(NSDictionary *)parameters headers:(NSDictionary *)headers onResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler; /** * 发送HTTP请求 * * @param urlString 请求地址 * @param method 请求方式 * @param parameters 请求参数 * @param headers 请求头集合 * @param resultHandler 返回回调 * @param faultHandler 错误回调 * @param uploadProgressHandler 上传数据进度回调 * @param asynCompletion 完成回调是否异步 * @param needCallSerial 串行回调 * * @return HTTP服务对象 */ + (FlyVerifyCHttpService *)sendHttpRequestByURLString:(NSString *)urlString method:(NSString *)method parameters:(NSDictionary *)parameters headers:(NSDictionary *)headers onResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler asynCompletion:(BOOL)asynCompletion needCallSerial:(BOOL)needCallSerial; /** * 发送HTTP请求 * * @param urlString 请求地址 * @param method 请求方式 * @param parameters 请求参数 * @param headers 请求头集合 * @param timeout 请求超时 * @param resultHandler 返回回调 * @param faultHandler 错误回调 * @param uploadProgressHandler 上传数据进度回调 * * @return HTTP服务对象 */ + (FlyVerifyCHttpService *)sendHttpRequestByURLString:(NSString *)urlString method:(NSString *)method parameters:(NSDictionary *)parameters headers:(NSDictionary *)headers timeout:(NSTimeInterval)timeout onResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler; /** * 发送HTTP请求 * * @param urlString 请求地址 * @param method 请求方式 * @param parameters 请求参数 * @param headers 请求头集合 * @param timeout 请求超时 * @param resultHandler 返回回调 * @param faultHandler 错误回调 * @param uploadProgressHandler 上传数据进度回调 * @param asynCompletion 完成回调是否异步 * @param needCallSerial 串行回调 * * @return HTTP服务对象 */ + (FlyVerifyCHttpService *)sendHttpRequestByURLString:(NSString *)urlString method:(NSString *)method parameters:(NSDictionary *)parameters headers:(NSDictionary *)headers timeout:(NSTimeInterval)timeout onResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler asynCompletion:(BOOL)asynCompletion needCallSerial:(BOOL)needCallSerial; /** * 发送HTTP请求 * * @param urlString 请求地址 * @param method 请求方式 * @param parameters 请求参数 * @param headers 请求头集合 * @param timeout 请求超时 * @param resultHandler 返回回调 * @param faultHandler 错误回调 * @param uploadProgressHandler 上传数据进度回调 * @param downloadProgressHandler 下载数据进度回调 * * @return HTTP服务对象 */ + (FlyVerifyCHttpService *)sendHttpRequestByURLString:(NSString *)urlString method:(NSString *)method parameters:(NSDictionary *)parameters headers:(NSDictionary *)headers timeout:(NSTimeInterval)timeout onResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler onDownloadProgress:(FlyVerifyCDownloadProgressEvent)downloadProgressHandler; /** * 发送HTTP请求 * * @param urlString 请求地址 * @param method 请求方式 * @param parameters 请求参数 * @param headers 请求头集合 * @param timeout 请求超时 * @param resultHandler 返回回调 * @param faultHandler 错误回调 * @param uploadProgressHandler 上传数据进度回调 * @param downloadProgressHandler 下载数据进度回调 * @param asynCompletion 完成回调是否异步 * @param needCallSerial 串行回调 * * @return HTTP服务对象 */ + (FlyVerifyCHttpService *)sendHttpRequestByURLString:(NSString *)urlString method:(NSString *)method parameters:(NSDictionary *)parameters headers:(NSDictionary *)headers timeout:(NSTimeInterval)timeout onResult:(FlyVerifyCResultEvent)resultHandler onFault:(FlyVerifyCFaultEvent)faultHandler onUploadProgress:(FlyVerifyCUploadProgressEvent)uploadProgressHandler onDownloadProgress:(FlyVerifyCDownloadProgressEvent)downloadProgressHandler asynCompletion:(BOOL)asynCompletion needCallSerial:(BOOL)needCallSerial; @end