de.ipcon.db.tools

Class CachingBOLoaderExtended

java.lang.Object

de.ipcon.db.core.BOLoaderWrapper

de.ipcon.db.core.CachingBOLoader

de.ipcon.db.tools.CachingBOLoaderExtended

All Implemented Interfaces:

BLOBLoaderI, BOLoaderI, BOLoaderWithCacheI, BOQueryLoaderI, SaveBOListenerI, DBManEventListenerI, GrooqlBOLoaderI, SchemaProviderI, java.io.Closeable, java.lang.AutoCloseable

public class CachingBOLoaderExtended
extends CachingBOLoader
implements java.io.Closeable

This is an extension to the normal caching BOLoader with the added ability to automatically do some automatic unlazies for all loaded BOs, if possible already as part of a query. Expects a special subclass of the CachingBOLoaderUpdateStrategyI that provides these unlazy information.

Nested Class Summary

Nested classes/interfaces inherited from interface de.ipcon.db.core.BOQueryLoaderI

BOQueryLoaderI.InternalHelper

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Set<java.lang.Class>	DEFAULT_IGNORE_CLASSES_FOR_UPDATING A list of internal classes that should be unmodifiable anyway and can be safely ignored when listening for changes

Fields inherited from class de.ipcon.db.core.CachingBOLoader

bpQuery

Fields inherited from interface de.ipcon.db.core.BOLoaderI

rootPaneToLockOnConnectionInterrupt

Constructor Summary

Constructors

Constructor and Description
CachingBOLoaderExtended(BOLoaderI realBOLoader)

Method Summary

Modifier and Type	Method and Description
void	close() Closes the 'cache', dropping all cached values, stopping any update and gc collection threads.
<U extends BO> java.util.List<U>	getBOsByQuery(java.lang.Long[] ids, java.lang.Class<U> clazz)
BO[]	getRelationBOs(java.lang.Long id, java.lang.Class classtip, java.lang.String attName) Makes unlazies from LazyRelationMap automatically loaded if possible
<U extends BO> java.util.List<U>	queryBO(java.lang.Class<U> clazz, java.lang.String whereClause, java.lang.Object[] params) Convenience query method with an explicit class tip of the super class that will be returned.
java.util.List<? extends BO>	queryBO(EntityI entity, java.lang.String whereClause, java.lang.Object[] params)
void	setUnlazyUpdateStrategy(UnlazyUpdateStrategy strategy) Updates the updatestrategy for unlazies and the generic updatestrategy of the CachingBOLoader
void	setUpdateStrategy(CachingBOLoaderUpdateStrategyI strategy)

Methods inherited from class de.ipcon.db.core.CachingBOLoader

addBOCacheListener, assureInstrumentedSchema, coerceBOLoader, drain, frapBO, frapEntries, frapFromCache, gc, gc, getBO, getBO, getBOs, getBOs, getBOT, getDrainCount, getInstrumentedInstance, getKnown, getKnown, getMiniDesc, getSchema, isCaching, isKnown, processDBManEvent, removeBOCacheListener, replayProc, rescheduleGC, setGCStrategy, setRealBOLoader, stopAutoGC, subscribeForUpdatesViaEvents, transactionSaveSuccess, unsubscribeForUpdatesViaEvents, updateCache, updateCache, updateStrategies

Methods inherited from class de.ipcon.db.core.BOLoaderWrapper

coerceBOLoader, coerceBOLoader, coerceBOLoader, coerceBOLoader, execute, exists, exists, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOBInfo, getBLOBInfo, getBOs, getBOs, getBOUncached, getBOUncached, getCryptoHandler, getEventProvider, getFeatureManager, getFileVault, getNextId, getParentLoader, getRootLoader, getRootPaneToLockOnConnectionInterrupt, hasBLOB, hasBLOB, haveBLOB, isLoggedIn, isLoggedInNN, isRecording, prepareQuery, prepareQuery, query, query, query, queryBO, queryBO, queryBO, queryRelation, setRootPaneToLockOnConnectionInterrupt, testAuth, testAuth

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.ipcon.db.core.BOLoaderWithCacheI

isKnown

Methods inherited from interface de.ipcon.db.core.BOLoaderI

execute, exists, exists, frapBOArrayFromCache, frapBOIArrayFromCache, frapBOsFromCache, frapFromCache, getBOs, getBOs, getBOUncached, getBOUncached, getCryptoHandler, getEventProvider, getFeatureManager, getFileVault, getNextId, getParentLoader, getRootLoader, isAncestorOf, isLoggedIn, isLoggedInNN, isRecording, isRootLoader, isServerSide, isTesting, prepareQuery, prepareQuery, prepareQuery, query, query, query, queryBO, queryBO, queryBO, queryRelation, testAuth, testAuth

Methods inherited from interface de.ipcon.db.blob.BLOBLoaderI

getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOB, getBLOBInfo, getBLOBInfo, hasBLOB, hasBLOB, haveBLOB, haveBLOB, haveBLOB

Methods inherited from interface de.ipcon.db.core.BOQueryLoaderI

getBOByAttr, getBOByAttr, getBOByAttr, getBOByAttrs, getBOByAttrs, getBOByAttrs, getBOsByAttrs, getBOsByAttrs, getBOsByAttrs, getBOsByAttrs, getOneBOByAttr, getUniqueBOByAttr

Field Detail

DEFAULT_IGNORE_CLASSES_FOR_UPDATING

public static final java.util.Set<java.lang.Class> DEFAULT_IGNORE_CLASSES_FOR_UPDATING

A list of internal classes that should be unmodifiable anyway and can be safely ignored when listening for changes

Constructor Detail

CachingBOLoaderExtended

public CachingBOLoaderExtended(BOLoaderI realBOLoader)

Method Detail

close

public void close()

Description copied from class: CachingBOLoader

Closes the 'cache', dropping all cached values, stopping any update and gc collection threads. A closed cache cannot be used anymore

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class CachingBOLoader

setUpdateStrategy

public void setUpdateStrategy(CachingBOLoaderUpdateStrategyI strategy)

Overrides:

setUpdateStrategy in class CachingBOLoader

setUnlazyUpdateStrategy

public void setUnlazyUpdateStrategy(UnlazyUpdateStrategy strategy)

Updates the updatestrategy for unlazies and the generic updatestrategy of the CachingBOLoader

getRelationBOs

public BO[] getRelationBOs(java.lang.Long id,
                           java.lang.Class classtip,
                           java.lang.String attName)

Makes unlazies from LazyRelationMap automatically loaded if possible

Specified by:

getRelationBOs in interface BOLoaderI

Overrides:

getRelationBOs in class BOLoaderWrapper

Parameters:

id - id of the BO which the requested BOs has a relation to

classtip - common superclass of the requested bos

attName - name of the relation from the BO to the requested ones

Returns:

bo[id].attributeName as array.

queryBO

public <U extends BO> java.util.List<U> queryBO(java.lang.Class<U> clazz,
                                                java.lang.String whereClause,
                                                java.lang.Object[] params)

Convenience query method with an explicit class tip of the super class that will be returned. Automatically adds Prefetch-clauses is some unlazies are possible.

queryBO

public java.util.List<? extends BO> queryBO(EntityI entity,
                                            java.lang.String whereClause,
                                            java.lang.Object[] params)

getBOsByQuery

public <U extends BO> java.util.List<U> getBOsByQuery(java.lang.Long[] ids,
                                                      java.lang.Class<U> clazz)