org.apache.openjpa.kernel
Class DelegatingExtent<T>

java.lang.Object
  org.apache.openjpa.kernel.DelegatingExtent<T>

All Implemented Interfaces:

Extent<T>

public class DelegatingExtent<T>
extends Object
implements Extent<T>

Delegating extent that also can perform exception translation for use in facades.

Since:

0.4.0

Author:

Abe White

Constructor Summary

DelegatingExtent(Extent<T> extent)
Constructor; supply delegate.

DelegatingExtent(Extent<T> extent, RuntimeExceptionTranslator trans)
Constructor; supply delegate and exception translator.

Method Summary

void	closeAll() Close all open iterators.
boolean	equals(Object other)
Broker	getBroker() The broker that generated the extent.
Extent<T>	getDelegate() Return the direct delegate.
Class<T>	getElementType() The class of extent elements.
FetchConfiguration	getFetchConfiguration() Return the (mutable) fetch configuration for this extent.
boolean	getIgnoreChanges() Whether this extent will ignore changes made in the current transaction.
Extent<T>	getInnermostDelegate() Return the native delegate.
int	hashCode()
boolean	hasSubclasses() Whether the extent includes subclasses.
Iterator<T>	iterator() Return an iterator over the extent members.
List<T>	list() Returns a list of all objects represented by this extent.
void	lock() Synchronizes on an internal lock.
void	setIgnoreChanges(boolean ignoreCache) Whether this extent will ignore changes made in the current transaction.
protected RuntimeException	translate(RuntimeException re) Translate the OpenJPA exception.
void	unlock() Release the internal lock.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DelegatingExtent

public DelegatingExtent(Extent<T> extent)

Constructor; supply delegate.

DelegatingExtent

public DelegatingExtent(Extent<T> extent,
                        RuntimeExceptionTranslator trans)

Constructor; supply delegate and exception translator.

Method Detail

getDelegate

public Extent<T> getDelegate()

Return the direct delegate.

getInnermostDelegate

public Extent<T> getInnermostDelegate()

Return the native delegate.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object other)

Overrides:

equals in class Object

translate

protected RuntimeException translate(RuntimeException re)

Translate the OpenJPA exception.

getElementType

public Class<T> getElementType()

Description copied from interface: Extent

The class of extent elements.

Specified by:

getElementType in interface Extent<T>

hasSubclasses

public boolean hasSubclasses()

Description copied from interface: Extent

Whether the extent includes subclasses.

Specified by:

hasSubclasses in interface Extent<T>

getBroker

public Broker getBroker()

Description copied from interface: Extent

The broker that generated the extent.

Specified by:

getBroker in interface Extent<T>

getFetchConfiguration

public FetchConfiguration getFetchConfiguration()

Description copied from interface: Extent

Return the (mutable) fetch configuration for this extent.

Specified by:

getFetchConfiguration in interface Extent<T>

getIgnoreChanges

public boolean getIgnoreChanges()

Description copied from interface: Extent

Whether this extent will ignore changes made in the current transaction.

Specified by:

getIgnoreChanges in interface Extent<T>

setIgnoreChanges

public void setIgnoreChanges(boolean ignoreCache)

Description copied from interface: Extent

Whether this extent will ignore changes made in the current transaction.

Specified by:

setIgnoreChanges in interface Extent<T>

list

public List<T> list()

Description copied from interface: Extent

Returns a list of all objects represented by this extent. This method creates a List by traversing the entire iterator returned by a call to Extent.iterator(). This means that Collection.size() will work correctly, but if the extent represents a large data set, this method may be quite slow and may consume quite a bit of memory.

Specified by:

list in interface Extent<T>

iterator

public Iterator<T> iterator()

Description copied from interface: Extent

Return an iterator over the extent members.

Specified by:

iterator in interface Extent<T>

closeAll

public void closeAll()

Description copied from interface: Extent

Close all open iterators.

Specified by:

closeAll in interface Extent<T>

lock

public void lock()

Description copied from interface: Extent

Synchronizes on an internal lock.

Specified by:

lock in interface Extent<T>

unlock

public void unlock()

Description copied from interface: Extent

Release the internal lock.

Specified by:

unlock in interface Extent<T>