JCStorage类 参考

#import <JCStorage.h>

构造函数
(JCStorageItem *)	- uploadFile:
(JCStorageItem *)	- downloadFile:savePath:
(bool)	- cancelFile:

类方法
(JCStorage *)	+ create:callback:
(void)	+ destroy

详细描述

文件存储类

上传文件：将文件上传至服务器，上传成功后服务器会返回文件地址，地址一般会有一定的有效期

下载文件：通过上传文件服务器返回的地址来下载该文件

函数文档

cancelFile:

- (bool) cancelFile:

(JCStorageItem *)

item

取消正在进行的文件上传下载

参数

item	JCStorageItem 对象，由downloadFile返回

返回

• true: 成功，会收到 onFileResult 回调
• false: 失败，不会收到回调

create:callback:

+ (JCStorage *) create:		(JCClient *)	client
callback:		(id<JCStorageCallback>)	callback

创建 JCStorage 对象

JCStorage 的所有接口函数，如无特殊说明，都建议在主线程调用

注解

• 调用此方法创建 JCStorage 对象后，期间没有调用过 destroy 方法销毁对象，然后又重复调用此方法，会直接返回第一次创建的 JCStorage 对象
• 调用此方法前确保 JCClient 已完成初始化，即 state 获取的状态值不等于 JCClientStateNotInit

参数

client	JCClient 对象
callback	JCStorageCallback 对象，用于回调相关通知

返回

返回 JCStorage 对象

异常

JCClient、JCStorageCallback 任意一个参数传空就会出现调用异常

destroy

+ (void) destroy

销毁对象

注解

此方法为异步调用，所以在调用此方法后不能马上调用 create 方法去重新创建 JCStorage 对象

downloadFile:savePath:

- (JCStorageItem *) downloadFile:		(NSString *)	uri
savePath:		(NSString *)	savePath

下载文件

参数

uri	文件地址
savePath	本地文件保存地址，由用户自行指定，需精确到文件名及格式，例如：/Documents/JuphoonCloud/audio.wmv。请确保目录存在且可写。 JCStorageItem 对象： 调用底层接口成功，返回的 JCStorageItem 对象的状态为 JCStorageItemStateTransfering ，并且会收到 onFileUpdate 回调 调用底层接口失败，返回的 JCStorageItem 对象的状态为 JCStorageItemStateFail ，并且会收到 onFileResult 回调 null：异常调用，不会收到回调

uploadFile:

- (JCStorageItem *) uploadFile:

(NSString *)

path

上传文件

参数

path	文件路径，需精确到文件名及格式，例如：/Documents/JuphoonCloud/audio.wmv。请确保目录存在。

返回

• JCStorageItem 对象：
  • 调用底层接口成功，返回的 JCStorageItem 对象的状态为 JCStorageItemStateTransfering ，并且会收到 onFileUpdate 回调
  • 调用底层接口失败，返回的 JCStorageItem 对象的状态为 JCStorageItemStateFail ，并且会收到 onFileResult 回调
• null：异常调用，不会收到回调