FileTransfer 接口

提供一种机制以便在客户端和 MobiLink 服务器之间传输文件。

语法

public interface FileTransfer

成员

FileTransfer 接口的所有成员，包括所有继承的成员。

名称	说明
downloadFile 方法	下载具有此对象的指定属性的文件。
getAuthenticationParms 方法	返回提供给自定义用户验证脚本的参数。
getAuthStatus 方法	返回上次尝试传输文件时的授权状态码。
getAuthValue 方法	返回自定义用户验证同步脚本中指定的值。
getFileAuthCode 方法	返回在上次尝试传输文件期间来自 authenticate_file_transfer 脚本的返回值。
getLivenessTimeout 方法	返回活动超时长度（以秒为单位）。
getLocalFileName 方法	确定本地文件名。
getLocalPath 方法	指定在本地文件系统内的哪个位置查找或存储文件。
getPassword 方法	返回用 setUserName 方法指定的用户的 MobiLink 口令。
getRemoteKey 方法	确定当前的远程密钥值。
getServerFileName 方法	返回服务器上的文件的名称。
getStreamErrorCode 方法	返回流报告的错误代码。
getStreamErrorMessage 方法	返回流本身报告的错误消息。
getStreamParms 方法	返回用于配置同步流的参数。
getUserName 方法	返回向 MobiLink 服务器唯一标识客户端的 MobiLink 用户名。
getVersion 方法	返回要使用的同步脚本。
isResumePartialTransfer 方法	确定是恢复还是放弃先前的部分传输。
isTransferredFile 方法	检查在上次尝试传输文件期间是否确实下载了文件。
setAuthenticationParms 方法	为自定义用户验证脚本（MobiLink authenticate_parameters 连接事件）指定参数。
setLivenessTimeout 方法	设置活动超时长度（以秒为单位）。
setLocalFileName 方法	指定本地文件名。
setLocalPath 方法	指定在本地文件系统内的哪个位置查找或存储文件。
setPassword 方法	设置用 setUserName 方法指定的用户的 MobiLink 口令。
setRemoteKey 方法	指定远程密钥。
setResumePartialTransfer 方法	指定是恢复还是放弃先前的部分传输。
setServerFileName 方法	指定服务器上的文件的名称。
setUserName 方法	设置向 MobiLink 服务器唯一标识客户端的 MobiLink 用户名。
setVersion 方法	设置要使用的同步脚本。
uploadFile 方法	上载具有此对象的指定属性的文件。

注释

通过调用 DatabaseManager.createFileTransfer 方法或 DatabaseManager.createObjectStoreTransfer [BlackBerry] 方法获取 FileTransfer 对象。

通过 createFileTransfer 方法返回的实例可用于在 MobiLink 和本地文件系统之间传输任何文件。

对于 BlackBerry 设备和模拟器，本地文件系统为介质卡或内部闪存文件系统（如果在设备上可用）。有关文件名限制，请参见 DatabaseManager.createConfigurationFileME 方法的说明。

对于 Android 设备和模拟器，本地文件系统为介质卡或应用程序具有适当权限的内部文件系统。例如 /sdcard/Android/data/your.package.name/files/

通过 createObjectStoreTransfer 方法返回的实例可用于将 UltraLite Java 版数据库文件下载到本地 BlackBerry 对象存储库，反之亦然。

只能传输有效的、未经加密的 UltraLite Java 版数据库文件。尝试下载 UltraLite Java 版数据库以外的任何文件都将导致抛出异常。

注意

应用程序不应向同一个本地文件同时启动两个下载。

另请参见

downloadFile 方法
 getAuthenticationParms 方法
 getAuthStatus 方法
 getAuthValue 方法
 getFileAuthCode 方法
 getLivenessTimeout 方法
 getLocalFileName 方法
 getLocalPath 方法
 getPassword 方法
 getRemoteKey 方法
 getServerFileName 方法
 getStreamErrorCode 方法
 getStreamErrorMessage 方法
 getStreamParms 方法
 getUserName 方法
 getVersion 方法
 isResumePartialTransfer 方法
 isTransferredFile 方法
 setAuthenticationParms 方法
 setLivenessTimeout 方法
 setLocalFileName 方法
 setLocalPath 方法
 setPassword 方法
 setRemoteKey 方法
 setResumePartialTransfer 方法
 setServerFileName 方法
 setUserName 方法
 setVersion 方法
 uploadFile 方法

使用DocCommentXchange讨论此页。