org.jtool.jxplatform.wrapper.collection
Class JxFileList

java.lang.Object
  org.jtool.jxplatform.wrapper.collection.JxFileList

public class JxFileList

extends java.lang.Object

A list of JxFile wrappers.

Author:

Katsuhsa Maruyama

Constructor Summary

JxFileList()
Creates a new, empty list object.

JxFileList(org.w3c.dom.Element[] elems)
Creates a new list containing DOM elements of an array.

JxFileList(JxFileList list)
Creates a new list from a July 27list of JxFile wrappers.

Method Summary

boolean	add(int index, JxFile jf) Inserts a wrapper at a position in this list.
boolean	add(JxFile jf) Appends a wrapper to the end of this list.
void	addAll(JxFileList list) Appends all wrappers in a list to the end of this list.
boolean	addFirst(JxFile jf) Inserts a wrapper at the beginning of this list.
boolean	addLast(JxFile jf) Appends a wrapper to the end of this list.
void	clear() Removes all wrappers from this list.
boolean	contains(JxFile jf) Tests if this list contains a wrapper.
boolean	containsAll(JxFileList list) Tests if this list contains all wrappers of a list.
JxFile	get(int index) Returns a wrapper at the position in this list.
JxFile	getFirst() Returns the first wrapper in this list.
java.lang.String	getInfo() Obtains information about this list.
JxFile	getJxFile(JxFile jf) Returns a wrapper in this list that indicates the same DOM element of a wrapper.
JxFile	getJxFile(java.lang.String pathname) Returns a wrapper with a path name in this list.
JxFile	getLast() Returns the last wrapper in this list.
boolean	isEmpty() Tests if this list contains no wrapper.
java.util.Iterator	iterator() Returns an iterator of this list in proper sequence.
void	print() Displays information about this list.
JxFile	remove(int index) Removes a wrapper at a position in this list.
boolean	remove(JxFile jf) Removes a wrapper from this list.
void	removeAll(JxFileList list) Removes all wrappers in a list from this list.
JxFile	removeFirst() Removes the first wrapper from this list.
JxFile	removeLast() Removes the last wrapper from this list.
boolean	retainAll(JxFileList list) Retains only wrappers in this list that are contained in a specified list.
int	size() Returns the number of wrappers in this list.
JxFile[]	toArray() Returns an array containing all wrappers in this list in proper sequence.

Methods inherited from class java.lang.Object

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

Constructor Detail

JxFileList

public JxFileList()

Creates a new, empty list object.

JxFileList

public JxFileList(JxFileList list)

Creates a new list from a July 27list of JxFile wrappers.

Parameters:

list - A list of wrappers.

JxFileList

public JxFileList(org.w3c.dom.Element[] elems)
           throws JxWrapperException

Creates a new list containing DOM elements of an array.

Parameters:

elems - An array of DOM elements.

Throws:

JxWrapperException - if the array contains elements other than the element.

Method Detail

clear

public void clear()

Removes all wrappers from this list.

add

public boolean add(JxFile jf)

Appends a wrapper to the end of this list.

Parameters:

jf - A wrapper to be appended.

Returns:

true if this list changed as a result of the call.

add

public boolean add(int index,
                   JxFile jf)

Inserts a wrapper at a position in this list.

Parameters:

index - A position where a wrapper is inserted.

jf - A wrapper to be inserted.

Returns:

true if this list changed as a result of the call.

addAll

public void addAll(JxFileList list)

Appends all wrappers in a list to the end of this list.

Parameters:

list - A list of wrappes to be appended.

remove

public boolean remove(JxFile jf)

Removes a wrapper from this list.

Parameters:

jf - A wrapper to be removed.

Returns:

true if this list changed as a result of the call.

removeAll

public void removeAll(JxFileList list)

Removes all wrappers in a list from this list.

Parameters:

list - A list of wrappers to be removed.

remove

public JxFile remove(int index)

Removes a wrapper at a position in this list.

Parameters:

index - A position where a wrapper is removed.

Returns:

The removed wrapper, null if there is no removed wrapper.

retainAll

public boolean retainAll(JxFileList list)

Retains only wrappers in this list that are contained in a specified list.

Parameters:

list - A list of wrappers to be retained.

Returns:

true if this list changed as a result of the call.

contains

public boolean contains(JxFile jf)

Tests if this list contains a wrapper.

Parameters:

jf - A wrapper to be tested.

Returns:

true if the wrapper is present, otherwise false.

containsAll

public boolean containsAll(JxFileList list)

Tests if this list contains all wrappers of a list.

Parameters:

list - A list of wrappers to be tested.

Returns:

true if this list contains all of the wrappers of the list, otherwise false.

get

public JxFile get(int index)

Returns a wrapper at the position in this list.

Parameters:

index - The position where a wrapper is obtained.

Returns:

The wrapper at the position, null if there is no wrapper found.

getFirst

public JxFile getFirst()

Returns the first wrapper in this list.

Returns:

The first wrapper.

getLast

public JxFile getLast()

Returns the last wrapper in this list.

Returns:

The last wrapper.

addFirst

public boolean addFirst(JxFile jf)

Inserts a wrapper at the beginning of this list.

Parameters:

jf - A wrapper to be inserted.

Returns:

true if this list changed as a result of the call.

addLast

public boolean addLast(JxFile jf)

Appends a wrapper to the end of this list.

Parameters:

jf - A wrapper to be append.

Returns:

true if this list changed as a result of the call.

removeFirst

public JxFile removeFirst()

Removes the first wrapper from this list.

Returns:

The removed wrapper, null if no wrapper was removed.

removeLast

public JxFile removeLast()

Removes the last wrapper from this list.

Returns:

The removed wrapper, null if no element was removed.

isEmpty

public boolean isEmpty()

Tests if this list contains no wrapper.

Returns:

true if this list contains no wrapper, otherwise false.

size

public int size()

Returns the number of wrappers in this list.

Returns:

The number of wrappers.

iterator

public java.util.Iterator iterator()

Returns an iterator of this list in proper sequence.

Returns:

The iterator of this list.

getJxFile

public JxFile getJxFile(JxFile jf)

Returns a wrapper in this list that indicates the same DOM element of a wrapper.

Parameters:

jf - A wrapper to be retrived.

Returns:

The matched wrapper in this list, null if there is no wrapper matched.

getJxFile

public JxFile getJxFile(java.lang.String pathname)

Returns a wrapper with a path name in this list.

Parameters:

pathname - The path name of a file to be retrived.

Returns:

The matched wrapper in this list, null if there is no wrapper matched.

toArray

public JxFile[] toArray()

Returns an array containing all wrappers in this list in proper sequence.

Returns:

The array of wrappers.

print

public void print()

Displays information about this list.

getInfo

public java.lang.String getInfo()

Obtains information about this list.

Returns:

The text describing the information.