FTPFileIterator

Method Summary

Returns a list of FTPFile objects for ALL files listed in the server's LIST output.

getNext(int quantityRequested)

Returns an array of at most quantityRequested FTPFile objects starting at this iterator's current position within its associated list.

FTPFile[]

getPrevious(int quantityRequested)

Returns an array of at most quantityRequested FTPFile objects starting at the position preceding this iterator's current position within its associated list.

boolean

hasNext()

Method for determining whether getNext() will successfully return a non-null value.

boolean

hasPrevious()

Method for determining whether getPrevious() will successfully return a non-null value.

FTPFile

next()

Returns a single parsed FTPFile object corresponding to the raw input line at this iterator's current position.

FTPFile

previous()

Returns a single parsed FTPFile object corresponding to the raw input line at the position preceding that of the internal iterator over the list of raw lines maintained by this object After this method is called the internal iterator is retreated by one element (unless it is already at beginning of list).

Method Details

getFiles

public FTPFile[] getFiles()

Returns a list of FTPFile objects for ALL files listed in the server's LIST output.

Returns:

a list of FTPFile objects for ALL files listed in the server's LIST output.

getNext

public FTPFile[] getNext(int quantityRequested)

Returns an array of at most quantityRequested FTPFile objects starting at this iterator's current position within its associated list. If fewer than quantityRequested such elements are available, the returned array will have a length equal to the number of entries at and after after the current position. If no such entries are found, this array will have a length of 0. After this method is called the current position is advanced by either quantityRequested or the number of entries available after the iterator, whichever is fewer.

Parameters:

quantityRequested - the maximum number of entries we want to get.

Returns:

an array of at most quantityRequested FTPFile objects starting at the current position of this iterator within its list and at least the number of elements which exist in the list at and after its current position.

getPrevious

public FTPFile[] getPrevious(int quantityRequested)

Returns an array of at most quantityRequested FTPFile objects starting at the position preceding this iterator's current position within its associated list. If fewer than quantityRequested such elements are available, the returned array will have a length equal to the number of entries after the iterator. If no such entries are found, this array will have a length of 0. The entries will be ordered in the same order as the list, not reversed. After this method is called the current position is moved back by either quantityRequested or the number of entries available before the current position, whichever is fewer.

Parameters:

quantityRequested - the maximum number of entries we want to get.

Returns:

an array of at most quantityRequested FTPFile objects starting at the position preceding the current position of this iterator within its list and at least the number of elements which exist in the list prior to its current position.

hasNext

public boolean hasNext()

Method for determining whether getNext() will successfully return a non-null value.

Returns:

true if there exist any files after the one currently pointed to by the internal iterator, false otherwise.

hasPrevious

public boolean hasPrevious()

Method for determining whether getPrevious() will successfully return a non-null value.

Returns:

true if there exist any files before the one currently pointed to by the internal iterator, false otherwise.

public FTPFile next()

Returns a single parsed FTPFile object corresponding to the raw input line at this iterator's current position. After this method is called the internal iterator is advanced by one element (unless already at end of list).

Returns:

a single FTPFile object corresponding to the raw input line at the position of the internal iterator over the list of raw input lines maintained by this object or null if no such object exists.

public FTPFile previous()

Returns a single parsed FTPFile object corresponding to the raw input line at the position preceding that of the internal iterator over the list of raw lines maintained by this object After this method is called the internal iterator is retreated by one element (unless it is already at beginning of list).

Returns:

a single FTPFile object corresponding to the raw input line at the position immediately preceding that of the internal iterator over the list of raw input lines maintained by this object.

FTPFile[]	getFiles() Returns a list of FTPFile objects for ALL files listed in the server's LIST output.
FTPFile[]	getNext(int quantityRequested) Returns an array of at most quantityRequested FTPFile objects starting at this iterator's current position within its associated list.
FTPFile[]	getPrevious(int quantityRequested) Returns an array of at most quantityRequested FTPFile objects starting at the position preceding this iterator's current position within its associated list.
boolean	hasNext() Method for determining whether getNext() will successfully return a non-null value.
boolean	hasPrevious() Method for determining whether getPrevious() will successfully return a non-null value.
FTPFile	next() Returns a single parsed FTPFile object corresponding to the raw input line at this iterator's current position.
FTPFile	previous() Returns a single parsed FTPFile object corresponding to the raw input line at the position preceding that of the internal iterator over the list of raw lines maintained by this object After this method is called the internal iterator is retreated by one element (unless it is already at beginning of list).

Class FTPFileIterator

Method Summary

Method Details

getFiles

getNext

getPrevious

hasNext

hasPrevious

next

previous