org.odmg
Interface DList

All Superinterfaces:

java.util.Collection, DCollection, java.util.List

All Known Implementing Classes:

DListImpl

public interface DList

extends DCollection, java.util.List

The ODMG List collection. A DList collection is an ordered collection that provides efficient insertion and removal of elements at arbitrary positions in the list, but it also supports indexed access. The beginning index value is 0. When an element is added at a given position in the list, the index of all subsequent elements is increased by 1. Similarly, when an element is removed from the list, the index of all subsequent elements is decreased by 1.

All of the operations defined by the JavaSoft List interface are supported by an ODMG implementation of DList, the exception UnsupportedOperationException is not thrown when a call is made to any of the List methods.

Version:

ODMG 3.0

Author:

David Jordan (as Java Editor of the Object Data Management Group)

Method Summary

DList

concat(DList otherList) Creates a new DList object that contains the contents of this DList object concatenated with the contents of the otherList object.

Methods inherited from interface org.odmg.DCollection

existsElement, query, select, selectElement

Methods inherited from interface java.util.Collection

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, retainAll, set, size, subList, toArray, toArray

Method Detail

concat

public DList concat(DList otherList)

Creates a new DList object that contains the contents of this DList object concatenated with the contents of the otherList object.

Parameters:

otherList - The list whose elements are placed at the end of the list returned by this method.

Returns:

A new DList that is the concatenation of this list and the list referenced by otherList.