ipse.org/index.html) or a reference to a resource that specifies the location of a target file. Implementing providers will determine what protocol schemes are supported (e.g. ftp, http, torrent, file, etc) and the required format of the scheme-specific information. If a protocol is specified that is not supported, or the scheme-specific information is not well-formed, then an IncomingFileTransferException will be thrown. Typically, callers will create IFileID instances via calls such as:
IFileID remoteFileID = FileIDFactory.getDefault().createID( ftc.getRetrieveNamespace(), "http://www.composent.com/index.html");
Must not be
null
.
@param transferListener a listener for file transfer events. Must not be null. Must not be null. See
Note above.
@param options a Map of options associated with sendRetrieveRequest. The particular name/value pairs will be unique to the individual providers. May be
null
.
@throws IncomingFileTransferException if the provider is not connected or is not in the correct state for initiating file transfer