com.juphoon.cloud.JCStorage类 参考

类
interface	ItemDirection
interface	ItemState
interface	StorageReason

Public 成员函数
abstract JCStorageItem	uploadFile (String path)
abstract JCStorageItem	downloadFile (String uri, String savePath)
abstract boolean	cancelFile (JCStorageItem item)

静态 Public 成员函数
static JCStorage	create (JCClient client, JCStorageCallback callback)
static void	destroy ()

静态 Public 属性
static final int	REASON_NONE = 0
static final int	REASON_TIMEOUT = 2
static final int	REASON_NETWORK = 3
static final int	REASON_TOOLARGE = 4
static final int	REASON_EXPIRE = 5
static final int	REASON_INVALID_PARAM = 97
static final int	REASON_CALL_FUNCATION_ERROR = 98
static final int	REASON_NOT_LOGINED = 99
static final int	REASON_OTHER = 100
static final int	ITEM_STATE_INIT = 0
static final int	ITEM_STATE_TRANSFERRING = 1
static final int	ITEM_STATE_OK = 2
static final int	ITEM_STATE_FAIL = 3
static final int	ITEM_STATE_CANCEL = 4
static final int	DIRECTION_UPLOAD = 0
static final int	DIRECTION_DOWNLOAD = 1

Protected 成员函数
abstract void	destroyObj ()
abstract void	addCallback (JCStorageCallback callback)
abstract void	removeCallback (JCStorageCallback callback)

详细描述

用于上传下载文件

成员函数说明

addCallback()

abstract void com.juphoon.cloud.JCStorage.addCallback ( JCStorageCallback  callback )

abstractprotected

添加回调

参数

callback

回调对象

cancelFile()

abstract boolean com.juphoon.cloud.JCStorage.cancelFile ( JCStorageItem  item )

abstract

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

参数

item	JCStorageItem对象，由 uploadFile，downloadFile 返回

返回

调用接口是否成功

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

create()

static JCStorage com.juphoon.cloud.JCStorage.create ( JCClient  client, JCStorageCallback  callback  )

static

创建 JCStorage 对象

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

注解

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

参数

client	JCClient 对象
callback	JCStorageCallback 回调接口，用于接收 JCStorage 相关通知

返回

返回 JCStorage 对象

异常

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

destroy()

static void com.juphoon.cloud.JCStorage.destroy ( )

static

销毁 JCStorage 对象

注解

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

destroyObj()

abstract void com.juphoon.cloud.JCStorage.destroyObj ( )

abstractprotected

销毁对象

downloadFile()

abstract JCStorageItem com.juphoon.cloud.JCStorage.downloadFile ( String  uri, String  savePath  )

abstract

下载文件

参数

uri	文件地址
savePath	本地文件保存地址，由用户自行指定，需精确到文件名及格式，例如：/sdcard/emulated/0/audio.wmv。请确保目录存在且可写。

返回

返回 JCStorageItem 对象，异常返回 null

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

removeCallback()

abstract void com.juphoon.cloud.JCStorage.removeCallback ( JCStorageCallback  callback )

abstractprotected

移除回调

参数

callback

回调对象

uploadFile()

abstract JCStorageItem com.juphoon.cloud.JCStorage.uploadFile ( String  path )

abstract

上传文件

参数

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

返回

返回 JCStorageItem 对象, 文件大小不要超过100MB，异常返回 null

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

类成员变量说明

DIRECTION_DOWNLOAD

final int com.juphoon.cloud.JCStorage.DIRECTION_DOWNLOAD = 1

static

下载

DIRECTION_UPLOAD

final int com.juphoon.cloud.JCStorage.DIRECTION_UPLOAD = 0

static

上传

ITEM_STATE_CANCEL

final int com.juphoon.cloud.JCStorage.ITEM_STATE_CANCEL = 4

static

文件传输取消状态

ITEM_STATE_FAIL

final int com.juphoon.cloud.JCStorage.ITEM_STATE_FAIL = 3

static

文件传输失败状态

ITEM_STATE_INIT

final int com.juphoon.cloud.JCStorage.ITEM_STATE_INIT = 0

static

文件初始状态

ITEM_STATE_OK

final int com.juphoon.cloud.JCStorage.ITEM_STATE_OK = 2

static

文件传输成功状态

ITEM_STATE_TRANSFERRING

final int com.juphoon.cloud.JCStorage.ITEM_STATE_TRANSFERRING = 1

static

文件传输中状态

---

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

• JCStorage.java