被 com.juphoon.cloud.JCStorageImpl 继承.

Public 成员函数

abstract JCStorageItem uploadFileByExpireTime (String path, int expiredSeconds, long cookie)
 
abstract JCStorageItem downloadFile (String uri, String savePath, long cookie)
 
abstract boolean cancelFile (@NonNull JCStorageItem item)
 
abstract boolean cancelFileByCookie (int cookie)
 

静态 Public 成员函数

static JCStorage create (JCClient client, JCStorageCallback callback)
 
static void destroy ()
 

静态 Public 属性

static final int REASON_NONE = 0
 
static final int REASON_NOT_LOGIN = 1
 
static final int REASON_NETWORK = 2
 
static final int REASON_TOOLARGE = 30
 
static final int REASON_TIMEOUT = 31
 
static final int REASON_EXPIRE = 32
 
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
 

详细描述

用于上传下载文件

成员函数说明

◆ create()

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

创建 JCStorage 对象

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

注解
  • 调用此方法创建 JCStorage 对象后,期间没有调用过 destroy 方法销毁对象,然后又重复调用此方法,会直接返回第一次创建的 JCStorage 对象
  • 调用此方法前确保 JCClient 已完成初始化,即 getState 方法获取的状态值不等于 STATE_NOT_INIT
参数
clientJCClient 对象
callbackJCStorageCallback 对象,用于回调相关通知
返回
JCStorage 对象
异常
JCClient、JCStorageCallback 任意一个参数传空就会出现调用异常

◆ destroy()

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

销毁 JCStorage 对象

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

◆ uploadFileByExpireTime()

abstract JCStorageItem com.juphoon.cloud.JCStorage.uploadFileByExpireTime ( String  path,
int  expiredSeconds,
long  cookie 
)
abstract

上传文件

参数
path文件路径,需精确到文件名及格式,例如:/sdcard/emulated/0/audio.wmv。请确保目录存在。
cookie标志数据
expiredSeconds过期秒数,-1表示永久
返回

◆ downloadFile()

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

下载文件

参数
uri文件地址
savePath本地文件保存地址,由用户自行指定,需精确到文件名及格式,例如:/sdcard/emulated/0/audio.wmv。请确保目录存在且可写。
cookie标志数据
返回

◆ cancelFile()

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

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

参数
itemJCStorageItem 对象,由 @ref downloadFile 方法返回
返回

◆ cancelFileByCookie()

abstract boolean com.juphoon.cloud.JCStorage.cancelFileByCookie ( int  cookie)
abstract

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

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

  • 若能匹配上,则会调用 cancelFile 方法并它提供返回值
  • 若匹配不上,则会直接返回 false
参数
cookie上传下载传入的 cookie
返回
  • true: 成功
  • false: 失败

类成员变量说明

◆ ITEM_STATE_INIT

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

文件初始状态

◆ ITEM_STATE_TRANSFERRING

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

文件传输中状态

◆ ITEM_STATE_OK

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

文件传输成功状态

◆ ITEM_STATE_FAIL

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

文件传输失败状态

◆ ITEM_STATE_CANCEL

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

文件传输取消状态

◆ DIRECTION_UPLOAD

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

上传

◆ DIRECTION_DOWNLOAD

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

下载


该类的文档由以下文件生成:
  • cloud/src/main/im/com/juphoon/cloud/JCStorage.java