Package javax.jdo
Interface Extent<E>
-
- All Superinterfaces:
java.lang.Iterable<E>
public interface Extent<E> extends java.lang.Iterable<E>
Instances of theExtent
class represent the entire collection of instances in the data store of the candidate class or interface possibly including its subclasses or subinterfaces.The
Extent
instance has two possible uses:- to iterate all instances of a particular class or interface
- to execute a
Query
in the data store over all instances of a particular class or interface
- Version:
- 2.1
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
close(java.util.Iterator<E> it)
Close anIterator
associated with thisExtent
instance.void
closeAll()
Close allIterator
s associated with thisExtent
instance.java.lang.Class<E>
getCandidateClass()
AnExtent
contains all instances of a particular class or interface in the data store; this method returns theClass
of the instances represented by this Extent.FetchPlan
getFetchPlan()
Get the fetch plan associated with this Extent.PersistenceManager
getPersistenceManager()
AnExtent
is managed by aPersistenceManager
; this method gives access to the owningPersistenceManager
.boolean
hasSubclasses()
Returns whether thisExtent
was defined to contain subclasses.java.util.Iterator<E>
iterator()
Returns an iterator over all the instances in theExtent
.
-
-
-
Method Detail
-
iterator
java.util.Iterator<E> iterator()
Returns an iterator over all the instances in theExtent
. The behavior of the returned iterator might depend on the setting of theignoreCache
flag in the owningPersistenceManager
.- Specified by:
iterator
in interfacejava.lang.Iterable<E>
- Returns:
- an iterator over all instances in the
Extent
-
hasSubclasses
boolean hasSubclasses()
Returns whether thisExtent
was defined to contain subclasses.- Returns:
- true if this
Extent
was defined to contain instances that are of a subclass type.
-
getCandidateClass
java.lang.Class<E> getCandidateClass()
AnExtent
contains all instances of a particular class or interface in the data store; this method returns theClass
of the instances represented by this Extent.- Returns:
- the
Class
of instances of thisExtent
.
-
getPersistenceManager
PersistenceManager getPersistenceManager()
AnExtent
is managed by aPersistenceManager
; this method gives access to the owningPersistenceManager
.- Returns:
- the owning
PersistenceManager
-
closeAll
void closeAll()
Close allIterator
s associated with thisExtent
instance.Iterator
s closed by this method will returnfalse
tohasNext()
and will throwNoSuchElementException
onnext()
. TheExtent
instance can still be used as a parameter ofQuery.setExtent
, and to get anIterator
.
-
close
void close(java.util.Iterator<E> it)
Close anIterator
associated with thisExtent
instance.Iterator
s closed by this method will returnfalse
tohasNext()
and will throwNoSuchElementException
onnext()
. TheExtent
instance can still be used as a parameter ofQuery.setExtent
, and to get anIterator
.- Parameters:
it
- anIterator
obtained by the methoditerator()
on thisExtent
instance.
-
getFetchPlan
FetchPlan getFetchPlan()
Get the fetch plan associated with this Extent.- Returns:
- the fetch plan
- Since:
- 2.0
-
-