207 lines
4.0 KiB
Objective-C
Executable File
207 lines
4.0 KiB
Objective-C
Executable File
//
|
||
// 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
|