DCollection

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> org >> [ odmg overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.odmg
Interface DCollection

All Superinterfaces:: java.util.Collection, java.lang.Iterable

All Known Subinterfaces:: DArray, DBag, DList, DSet

public interface DCollection
extends java.util.Collection

The base interface for all ODMG collections. The ODMG collections are based on JavaSoft’s collection interfaces. All of the operations defined by the JavaSoft Collection interface are supported by an ODMG implementation of DCollection; the exception UnsupportedOperationException is not thrown when a call is made to any of the Collection methods.

DCollection contains methods used to perform queries on the collection. The OQL query predicate is given as a string with the syntax of the where clause of OQL. The predefined OQL variable this is used inside the predicate to denote the current element of the collection.

Version:: ODMG 3.0

Method Summary

boolean existsElement(java.lang.String predicate)
          Determines whether there is an element of the collection that evaluates to true for the predicate.

DCollection query(java.lang.String predicate)
          Evaluate the boolean query predicate for each element of the collection and return a new collection that contains each element that evaluated to true.

java.util.Iterator select(java.lang.String predicate)
          Access all of the elements of the collection that evaluate to true for the provided query predicate.

java.lang.Object selectElement(java.lang.String predicate)
          Selects the single element of the collection for which the provided OQL query predicate is true.

Methods inherited from interface java.util.Collection

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

Method Detail

selectElement

public java.lang.Object selectElement(java.lang.String predicate)
                               throws QueryInvalidException

Selects the single element of the collection for which the provided OQL query predicate is true.

select

public java.util.Iterator select(java.lang.String predicate)
                          throws QueryInvalidException

Access all of the elements of the collection that evaluate to true for the provided query predicate.

query

public DCollection query(java.lang.String predicate)
                  throws QueryInvalidException

Evaluate the boolean query predicate for each element of the collection and return a new collection that contains each element that evaluated to true.

existsElement

public boolean existsElement(java.lang.String predicate)
                      throws QueryInvalidException

Determines whether there is an element of the collection that evaluates to true for the predicate.