org.jtool.jxplatform.wrapper.collection
Class JxFieldList

java.lang.Object
  extended byorg.jtool.jxplatform.wrapper.collection.JxFieldList

public class JxFieldList
extends java.lang.Object

A list of JxField wrappers.

Author:
Katsuhsa Maruyama

Constructor Summary
JxFieldList()
          Creates a new, empty list object.
JxFieldList(org.w3c.dom.Element[] elems)
          Creates a new list containing DOM elements of an array.
JxFieldList(JxFieldList list)
          Creates a new list from a list of JxField wrappers.
 
Method Summary
 boolean add(int index, JxField jf)
          Inserts a wrapper at a position in this list.
 boolean add(JxField jf)
          Appends a wrapper to the end of this list.
 void addAll(JxFieldList list)
          Appends all wrappers in a list to the end of this list.
 boolean addFirst(JxField jf)
          Inserts a wrapper at the beginning of this list.
 boolean addLast(JxField jf)
          Appends a wrapper to the end of this list.
 void clear()
          Removes all wrappers from this list.
 boolean contains(JxField jf)
          Tests if this list contains a wrapper.
 boolean containsAll(JxFieldList list)
          Tests if this list contains all wrappers of a list.
 JxField get(int index)
          Returns a wrapper at the position in this list.
 JxField getFirst()
          Returns the first wrapper in this list.
 java.lang.String getInfo()
          Obtains information about this list.
 JxField getJxField(JxField jf)
          Returns a wrapper in this list that indicates the same DOM element of a wrapper.
 JxField getJxField(java.lang.String name)
          Returns a wrapper with a name in this list.
 JxField 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.
 JxField remove(int index)
          Removes a wrapper at a position in this list.
 boolean remove(JxField jf)
          Removes a wrapper from this list.
 void removeAll(JxFieldList list)
          Removes all wrappers in a list from this list.
 JxField removeFirst()
          Removes the first wrapper from this list.
 JxField removeLast()
          Removes the last wrapper from this list.
 boolean retainAll(JxFieldList list)
          Retains only wrappers in this list that are contained in a specified list.
 int size()
          Returns the number of wrappers in this list.
 JxField[] 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

JxFieldList

public JxFieldList()
Creates a new, empty list object.


JxFieldList

public JxFieldList(JxFieldList list)
Creates a new list from a list of JxField wrappers.

Parameters:
list - A list of wrappers.

JxFieldList

public JxFieldList(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(JxField 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,
                   JxField 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(JxFieldList 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(JxField 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(JxFieldList list)
Removes all wrappers in a list from this list.

Parameters:
list - A list of wrappers to be removed.

remove

public JxField remove(int index)
Removes a wrapper at a position in this list.

Parameters:
index - The position where a wrapper is removed.
Returns:
The removed wrapper, null if there is no removed wrapper.

retainAll

public boolean retainAll(JxFieldList 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(JxField 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(JxFieldList 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 JxField 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 JxField getFirst()
Returns the first wrapper in this list.

Returns:
The first wrapper.

getLast

public JxField getLast()
Returns the last wrapper in this list.

Returns:
The last wrapper.

addFirst

public boolean addFirst(JxField 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(JxField 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 JxField removeFirst()
Removes the first wrapper from this list.

Returns:
The removed wrapper, null if no wrapper was removed.

removeLast

public JxField 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.

getJxField

public JxField getJxField(JxField 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.

getJxField

public JxField getJxField(java.lang.String name)
Returns a wrapper with a name in this list.

Parameters:
name - The name of a field to be retrived.
Returns:
The matched wrapper in this list, null if there is no wrapper matched.

toArray

public JxField[] toArray()
Returns an array containing all wrappers in this list in proper sequence.

Returns:
The array of wrappers.July 27

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.