org.globus.ftp

Interface DataSource

All Known Implementing Classes:

DataSourceStream, FileRandomIO, OutputStreamDataSource

public interface DataSource

Data channel uses this interface to read outgoing data. Implement it to provide your own ways of reading data. It must be thread safe; in parallel transfer mode several streams may attempt to read.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes this data source and releases any system resources associated with this source.
Buffer	read() Reads a data buffer from this data source.
long	totalSize() Optional operation.

Method Detail

read

Buffer read()
            throws java.io.IOException

Reads a data buffer from this data source.

Returns:

The data buffer read. Null, if there is no more data to be read.

Throws:

java.io.IOException - if an I/O error occurs.

close

void close()
           throws java.io.IOException

Closes this data source and releases any system resources associated with this source.

Throws:

java.io.IOException - if an I/O error occurs.

totalSize

long totalSize()
               throws java.io.IOException

Optional operation. Returns the total size, in bytes, of the data in this source. If the implementation is not able to provide a total size for the data source, it should return -1

Throws:

java.io.IOException - if an I/O exception occurs