FileTransfer interface

Provides a mechanism to transfer files between the client and a MobiLink server.

Syntax

public interface FileTransfer

Members

All members of FileTransfer interface, including all inherited members.

Name	Description
downloadFile method	Downloads the file with the specified properties of this object.
getAuthenticationParms method	Returns parameters provided to a custom user authentication script.
getAuthStatus method	Returns the authorization status code of the last file transfer attempt.
getAuthValue method	Returns the value specified in custom user authentication synchronization scripts.
getFileAuthCode method	Returns the return value from the authenticate_file_transfer script for the last file transfer attempt.
getLivenessTimeout method	Returns the liveness timeout length, in seconds.
getLocalFileName method	Determines the local file name.
getLocalPath method	Specifies where to find or store the file in the local file system.
getPassword method	Returns the MobiLink password for the user specified with the setUserName method.
getRemoteKey method	Determines the current remote key value.
getServerFileName method	Returns the name of the file on the server.
getStreamErrorCode method	Returns the error code reported by the stream.
getStreamErrorMessage method	Returns the error message reported by the stream itself.
getStreamParms method	Returns the parameters used to configure the synchronization stream.
getUserName method	Returns the MobiLink user name that uniquely identifies the client to the MobiLink server.
getVersion method	Returns the synchronization script to use.
isResumePartialTransfer method	Determines whether to resume or discard a previous partial transfer.
isTransferredFile method	Checks whether the file was actually downloaded during the last file transfer attempt.
setAuthenticationParms method	Specifies parameters for a custom user authentication script (MobiLink authenticate_parameters connection event).
setLivenessTimeout method	Sets the liveness timeout length, in seconds.
setLocalFileName method	Specifies the local file name.
setLocalPath method	Specifies where to find or store the file in the local file system.
setPassword method	Sets the MobiLink password for the user specified with the setUserName method.
setRemoteKey method	Specifies the remote key.
setResumePartialTransfer method	Specifies whether to resume or discard a previous partial transfer.
setServerFileName method	Specifies the name of the file on the server.
setUserName method	Sets the MobiLink user name that uniquely identifies the client to the MobiLink server.
setVersion method	Sets the synchronization script to use.
uploadFile method	Uploads the file with the specified properties of this object.

Remarks

A FileTransfer object is obtained by calling the DatabaseManager.createFileTransfer or DatabaseManager.createObjectStoreTransfer [BlackBerry] methods.

The instance returned by the createFileTransfer method can be used to transfer any files between MobiLink and the local file system.

For the BlackBerry devices and simulators, the local file system is either a media card or internal flash file system (if available on the device). For file name restrictions, see the description of the DatabaseManager.createConfigurationFileME method.

For Android devices and simulators, the local file system is either a media card or the internal file system where the application has appropriate permissions. Eg. /sdcard/Android/data/your.package.name/files/

The instance returned by the createObjectStoreTransfer method can be used to download UltraLite Java edition database files to the local BlackBerry object store, or vice versa.

Only valid, unencrypted UltraLite Java edition database files can be transferred. Attempting to download any files other than UltraLite Java edition databases result in exceptions being thrown.

Note

The application should not simultaneously start two downloads to the same local file.