public class IncomingFileTransfer extends FileTransfer
FileTransferManager.createIncomingFileTransfer(FileTransferRequest)
method is invoked. It is a file being sent to the local user from another
user on the jabber network. There are two stages of the file transfer to be
concerned with and they can be handled in different ways depending upon the
method that is invoked on this class.
The first way that a file is recieved is by calling the
recieveFile()
method. This method, negotiates the appropriate stream
method and then returns the InputStream to read the file
data from.
The second way that a file can be recieved through this class is by invoking
the recieveFile(File)
method. This method returns immediatly and
takes as its parameter a file on the local file system where the file
recieved from the transfer will be put.FileTransfer.Error, FileTransfer.Status
amountWritten, negotiator, streamID
Modifier | Constructor and Description |
---|---|
protected |
IncomingFileTransfer(FileTransferRequest request,
FileTransferNegotiator transferNegotiator) |
Modifier and Type | Method and Description |
---|---|
void |
cancel()
Cancels the file transfer.
|
InputStream |
recieveFile()
Negotiates the stream method to transfer the file over and then returns
the negotiated stream.
|
void |
recieveFile(File file)
This method negotitates the stream and then transfer's the file over the negotiated stream.
|
getAmountWritten, getError, getException, getFileName, getFilePath, getFileSize, getPeer, getProgress, getStatus, getStreamID, isDone, setError, setException, setFileInfo, setFileInfo, setStatus, updateStatus, writeToStream
protected IncomingFileTransfer(FileTransferRequest request, FileTransferNegotiator transferNegotiator)
public InputStream recieveFile() throws SmackException, XMPPException.XMPPErrorException
SmackException
XMPPException.XMPPErrorException
- If there is an error in the negotiation process an exception
is thrown.public void recieveFile(File file) throws SmackException
file
- The location to save the file.SmackException
- when the file transfer failsIllegalArgumentException
- This exception is thrown when the the provided file is
either null, or cannot be written to.public void cancel()
FileTransfer
cancel
in class FileTransfer