org.vectomatic.file

Class FileList

java.lang.Object

org.vectomatic.file.FileList

All Implemented Interfaces:

Iterable<File>

public class FileList
extends Object
implements Iterable<File>

An object of this type is returned by the files property of the HTML input element; this lets you access the list of files selected with the <input type="file"> element. It's also used for a list of files dropped into web content when using the drag and drop API; see the DataTransferExt object for details on this usage.

Constructor Summary

Constructors

Constructor and Description
FileList(FileListImpl impl) Constructor.

Method Summary

Modifier and Type	Method and Description
File	getItem(int index) Returns the indexth item in the collection.
int	getLength() The number of nodes in the list.
Iterator<File>	iterator() Returns an iterator over the File elements in this list in proper sequence.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

FileList

public FileList(FileListImpl impl)

Constructor. Do not call this constructor directly new FileList are generated automatically where needed in the API.

Parameters:

impl - the underlying implementation object.

Method Detail

iterator

public Iterator<File> iterator()

Returns an iterator over the File elements in this list in proper sequence.

This implementation returns a straightforward implementation of the iterator interface, relying on the backing list's getLength(), and getItem(int) methods.

Note that the iterator returned by this method will throw an UnsupportedOperationException in response to its remove method.

Specified by:

iterator in interface Iterable<File>

Returns:

an iterator over the File elements in this list in proper sequence

getItem

public final File getItem(int index)

Returns the indexth item in the collection. If index is greater than or equal to the number of nodes in the list, this returns null.

Parameters:

index - Index into the collection.

Returns:

The node at the indexth position in the FileList, or null if that is not a valid index.

getLength

public final int getLength()

The number of nodes in the list. The range of valid child node indices is 0 to length-1 inclusive.