org.eclipse.ecf.filetransfer.events
Interface IIncomingFileTransferReceiveStartEvent

All Superinterfaces:
Event, IFileTransferEvent, IIncomingFileTransferEvent

public interface IIncomingFileTransferReceiveStartEvent
extends IIncomingFileTransferEvent

Event sent to IFileTransferListener associated with IIncomingFileTransfer instances


Method Summary
 void cancel()
          Cancel incoming file transfer
 IFileID getFileID()
          Get IFileID for incoming file
 java.util.Map getResponseHeaders()
          Get response headers.
 IIncomingFileTransfer receive(java.io.File localFileToSave)
          Get incoming file transfer object by specifying a local File instance to save the received contents to.
 IIncomingFileTransfer receive(java.io.File localFileToSave, FileTransferJob fileTransferJob)
          Just like receive(File) but this method also give the caller a chance to provide a factory that creates the job that will perform the actual file transfer.
 IIncomingFileTransfer receive(java.io.OutputStream streamToStore)
          Get incoming file transfer by specifying an OutputStream instance to save the received contents to.
 IIncomingFileTransfer receive(java.io.OutputStream streamToStore, FileTransferJob fileTransferJob)
          Just like receive(OutputStream) but this method also give the caller a chance to provide a factory that creates the job that will perform the actual file transfer.
 
Methods inherited from interface org.eclipse.ecf.filetransfer.events.IIncomingFileTransferEvent
getSource
 

Method Detail

getFileID

IFileID getFileID()
Get IFileID for incoming file

Returns:
IFileID for this file transfer event. Will not be null.

receive

IIncomingFileTransfer receive(java.io.File localFileToSave)
                              throws java.io.IOException
Get incoming file transfer object by specifying a local File instance to save the received contents to.

Parameters:
localFileToSave - the file on the local file system to receive and save the remote file. Must not be null. If the file already exists, its content will be overwritten by any data received.
Returns:
IIncomingFileTransfer the incoming file transfer object. Will not be null.
Throws:
java.io.IOException - if localFileToSave cannot be opened for writing

receive

IIncomingFileTransfer receive(java.io.File localFileToSave,
                              FileTransferJob fileTransferJob)
                              throws java.io.IOException
Just like receive(File) but this method also give the caller a chance to provide a factory that creates the job that will perform the actual file transfer. The intended use for this is when the user of the framework needs more elaborate control over such jobs such as waiting for a group of parallel file transfers to complete. Such functionality can for instance exploit the Eclipse runtime concept of Job families.

Parameters:
localFileToSave - the file on the local file system to receive and save the remote file. Must not be null. If the file already exists, its content will be overwritten by any data received.
fileTransferJob - A subclass of FileTransferJob to use to run the actual transfer. If null, provider will create default implementation. NOTE: the given job should *not* be scheduled/started prior to being provided as a parameter to this method.
Returns:
IIncomingFileTransfer the incoming file transfer object. NOTE: the caller is responsible for calling OutputStream.close() on the OutputStream provided. If the stream provided is buffered, then BufferedOutputStream.flush() should be called to guaranteed that the data received is actually written to the given OutputStream.
Throws:
java.io.IOException - if streamToStore cannot be opened for writing
Since:
2.0

receive

IIncomingFileTransfer receive(java.io.OutputStream streamToStore)
                              throws java.io.IOException
Get incoming file transfer by specifying an OutputStream instance to save the received contents to. NOTE: the caller is responsible for calling OutputStream.close() on the OutputStream provided. If the stream provided is buffered, then BufferedOutputStream.flush() should be called to guaranteed that the data received is actually written to the given OutputStream.

Parameters:
streamToStore - the output stream to store the incoming file. Must not be null.
Returns:
IIncomingFileTransfer the incoming file transfer object. NOTE: the caller is responsible for calling OutputStream.close() on the OutputStream provided. If the stream provided is buffered, then BufferedOutputStream.flush() should be called to guaranteed that the data received is actually written to the given OutputStream.
Throws:
java.io.IOException - if streamToStore cannot be opened for writing

receive

IIncomingFileTransfer receive(java.io.OutputStream streamToStore,
                              FileTransferJob fileTransferJob)
                              throws java.io.IOException
Just like receive(OutputStream) but this method also give the caller a chance to provide a factory that creates the job that will perform the actual file transfer. The intended use for this is when the user of the framework needs more elaborate control over such jobs such as waiting for a group of parallel file transfers to complete. Such functionality can for instance exploit the Eclipse runtime concept of Job families.

Parameters:
streamToStore - the output stream to store the incoming file. Must not be null.
fileTransferJob - A subclass of FileTransferJob to use to run the actual transfer. If null, provider will create default implementation. NOTE: the given job should *not* be scheduled/started prior to being provided as a parameter to this method.
Returns:
IIncomingFileTransfer the incoming file transfer object. NOTE: the caller is responsible for calling OutputStream.close() on the OutputStream provided. If the stream provided is buffered, then BufferedOutputStream.flush() should be called to guaranteed that the data received is actually written to the given OutputStream.
Throws:
java.io.IOException - if streamToStore cannot be opened for writing
Since:
2.0

cancel

void cancel()
Cancel incoming file transfer


getResponseHeaders

java.util.Map getResponseHeaders()
Get response headers.

Returns:
Map of response headers. null if no headers available.
Since:
4.0