add .gitignore

msext/QiniuSDK/Http/QNResponseInfo.h

@@ -0,0 +1,206 @@
+//
+//  QNResponseInfo.h
+//  QiniuSDK
+//
+//  Created by bailong on 14/10/2.
+//  Copyright (c) 2014年 Qiniu. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+/**
+ *    中途取消的状态码
+ */
+extern const int kQNRequestCancelled;
+
+/**
+ *    网络错误状态码
+ */
+extern const int kQNNetworkError;
+
+/**
+ *    错误参数状态码
+ */
+extern const int kQNInvalidArgument;
+
+/**
+ *    0 字节文件或数据
+ */
+extern const int kQNZeroDataSize;
+
+/**
+ *    错误token状态码
+ */
+extern const int kQNInvalidToken;
+
+/**
+ *    读取文件错误状态码
+ */
+extern const int kQNFileError;
+
+/**
+ *    上传完成后返回的状态信息
+ */
+@interface QNResponseInfo : NSObject
+
+/**
+ *    状态码
+ */
+@property (readonly) int statusCode;
+
+/**
+ *    七牛服务器生成的请求ID，用来跟踪请求信息，如果使用过程中出现问题，请反馈此ID
+ */
+@property (nonatomic, copy, readonly) NSString *reqId;
+
+/**
+ *    七牛服务器内部跟踪记录
+ */
+@property (nonatomic, copy, readonly) NSString *xlog;
+
+/**
+ *    cdn服务器内部跟踪记录
+ */
+@property (nonatomic, copy, readonly) NSString *xvia;
+
+/**
+ *    错误信息，出错时请反馈此记录
+ */
+@property (nonatomic, copy, readonly) NSError *error;
+
+/**
+ *    服务器域名
+ */
+@property (nonatomic, copy, readonly) NSString *host;
+
+/**
+ *    请求消耗的时间，单位 秒
+ */
+@property (nonatomic, readonly) double duration;
+
+/**
+ *    服务器IP
+ */
+@property (nonatomic, readonly) NSString *serverIp;
+
+/**
+ *    客户端id
+ */
+@property (nonatomic, readonly) NSString *id;
+
+/**
+ *    时间戳
+ */
+@property (readonly) UInt64 timeStamp;
+
+/**
+ *    网络类型
+ */
+//@property (nonatomic, readonly) NSString *networkType;
+
+/**
+ *    是否取消
+ */
+@property (nonatomic, readonly, getter=isCancelled) BOOL canceled;
+
+/**
+ *    成功的请求
+ */
+@property (nonatomic, readonly, getter=isOK) BOOL ok;
+
+/**
+ *    是否网络错误
+ */
+@property (nonatomic, readonly, getter=isConnectionBroken) BOOL broken;
+
+/**
+ *    是否需要重试，内部使用
+ */
+@property (nonatomic, readonly) BOOL couldRetry;
+
+/**
+ *    是否需要换备用server，内部使用
+ */
+@property (nonatomic, readonly) BOOL needSwitchServer;
+
+/**
+ *    是否为 七牛响应
+ */
+@property (nonatomic, readonly, getter=isNotQiniu) BOOL notQiniu;
+
+/**
+ *    工厂函数，内部使用
+ *
+ *    @return 取消的实例
+ */
++ (instancetype)cancel;
+
+/**
+ *    工厂函数，内部使用
+ *
+ *    @param desc 错误参数描述
+ *
+ *    @return 错误参数实例
+ */
++ (instancetype)responseInfoWithInvalidArgument:(NSString *)desc;
+
+/**
+ *    工厂函数，内部使用
+ *
+ *    @param desc 错误token描述
+ *
+ *    @return 错误token实例
+ */
++ (instancetype)responseInfoWithInvalidToken:(NSString *)desc;
+
+/**
+ *    工厂函数，内部使用
+ *
+ *    @param error 错误信息
+ *    @param host 服务器域名
+ *    @param duration 请求完成时间，单位秒
+ *
+ *    @return 网络错误实例
+ */
++ (instancetype)responseInfoWithNetError:(NSError *)error
+                                    host:(NSString *)host
+                                duration:(double)duration;
+
+/**
+ *    工厂函数，内部使用
+ *
+ *    @param error 错误信息
+ *
+ *    @return 文件错误实例
+ */
++ (instancetype)responseInfoWithFileError:(NSError *)error;
+
+/**
+ *    工厂函数，内部使用
+ *
+ *    @return 文件错误实例
+ */
++ (instancetype)responseInfoOfZeroData:(NSString *)path;
+
+/**
+ *    构造函数
+ *
+ *    @param status 状态码
+ *    @param reqId  七牛服务器请求id
+ *    @param xlog   七牛服务器记录
+ *    @param body   服务器返回内容
+ *    @param host   服务器域名
+ *    @param duration 请求完成时间，单位秒
+ *
+ *    @return 实例
+ */
+- (instancetype)init:(int)status
+           withReqId:(NSString *)reqId
+            withXLog:(NSString *)xlog
+            withXVia:(NSString *)xvia
+            withHost:(NSString *)host
+              withIp:(NSString *)ip
+        withDuration:(double)duration
+            withBody:(NSData *)body;
+
+@end