JCStorage类 参考

构造函数
(JCStorageItem *)	- uploadFileByExpireTime:expiredSeconds:cookie:
(JCStorageItem *)	- downloadFile:savePath:cookie:
(bool)	- cancelFile:
(bool)	- cancelFileByCookie:

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

详细描述

文件存储类

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

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

函数文档

cancelFile:

- (bool) cancelFile:

(JCStorageItem *)

item

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

参数

item	JCStorageItem 对象，由 uploadFileByExpireTime ，downloadFile 返回

返回

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

cancelFileByCookie:

- (bool) cancelFileByCookie:

(id)

cookie

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

通过 cookie 来匹配缓存中的 JCStorageItem 对象

• 若能匹配上，则会调用 cancelFile 方法并它提供返回值
• 若匹配不上，则会直接返回 false

参数

cookie

上传下载传入的 cookie

返回

• true: 成功
• 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

销毁 JCStorage 对象

该方法为同步调用，需要等待 JCStorage 实例资源释放后才能执行其他操作，调用此方法后，你将无法再使用 JCStorage 的其它方法和回调。
我们 不建议 在 JCSDK 的回调中调用此方法销毁 JCStorage 对象，否则会出现崩溃。
如需在销毁后再次创建 JCStorage 实例，需要等待 destroy 方法执行结束后再创建实例。

downloadFile:savePath:cookie:

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

下载文件

参数

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

uploadFileByExpireTime:expiredSeconds:cookie:

- (JCStorageItem*) uploadFileByExpireTime:		(NSString *)	path
expiredSeconds:		(int)	expiredSeconds
cookie:		(id)	cookie

上传文件

参数

path	文件路径，需精确到文件名及格式，例如：/Documents/JuphoonCloud/audio.wmv。请确保目录存在。
cookie	标志数据
expiredSeconds	过期秒数，-1表示永久

返回

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

---

该类的文档由以下文件生成:

• JCSDKOC/JCSDKOC/JCStorage/JCStorage.h