Class COM.odi.DatabaseRootEnumeration

java.lang.Object
   |
   +----COM.odi.DatabaseRootEnumeration

public class DatabaseRootEnumeration
extends Object

The DatabaseRootEnumeration class defines the operations for iterating over the names of the database roots in a database. A DatabaseRootEnumeration object contains a list of the roots in a database. An application can create a DatabaseRootEnumeration object with a call to Database.getRoots(). The DatabaseRootEnumeration object that it creates is valid only until the end of the transaction.

If you create a DatabaseRootEnumeration object and then destroy or modify a database root, PSE/PSE Pro might or might not recognize the change. Consequently, you should not use a DatabaseRootEnumeration object after you make any modification to the database roots in that database.

hasMoreElements(): Determines whether or not there are any more roots in the iteration.
nextElement(): Obtains the next database root name.

hasMoreElements

  public abstract boolean hasMoreElements()

Determines whether or not there are any more roots in the iteration.

Returns:: The true constant if there are more roots to provide. The false constant if all roots have been provided.

nextElement

  public abstract String nextElement()

Obtains the next database root name.

Returns:: The next root name.
Throws: DatabaseNotOpenException: If the database whose roots are being iterated over is not open.
Throws: NoSuchElementException: If there are no more root names.
Throws: NoTransactionInProgressException: If a transaction is not in progress.
Throws: StaleEnumeratorException: If the information for this enumeration has become stale and unusable. This currently occurs at the end of the transaction in which the enumeration was created.