de.ipcon.db

Class DBManLocalBOLoader

java.lang.Object

de.ipcon.db.DBManLocalBOLoader

All Implemented Interfaces:

BLOBLoaderI, BackendBOLoaderI, BackendBOLoaderWithPersistenceHandlerI, BackendQueryAnsweringBOLoaderI, BOLoaderI, BOQueryLoaderI, GrooqlBOLoaderI, SchemaProviderI

public class DBManLocalBOLoader
extends java.lang.Object
implements BackendQueryAnsweringBOLoaderI, BackendBOLoaderWithPersistenceHandlerI

A specialized BOLoaderI implementation for handling backend queries with persistence capabilities.

This class extends the functionality of BOLoaderI to provide specific features for processing backend queries. It implements both BackendQueryAnsweringBOLoaderI and BackendBOLoaderWithPersistenceHandlerI, allowing it to be aware of its backend query context and manage backend-local persistence operations efficiently.

This loader is typically used within the server-side environment to handle queries originating from backend processes or services. It provides optimized handling for such queries, including the ability to serialize non-persistent attributes and manage backend-local database transactions effectively.

Nested Class Summary

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

BOQueryLoaderI.InternalHelper

Field Summary

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

rootPaneToLockOnConnectionInterrupt

Constructor Summary

Constructors

Constructor and Description
DBManLocalBOLoader(DBManLocalI _dbman)
DBManLocalBOLoader(DBManLocalI _dbman, BackendSessionI _session)
DBManLocalBOLoader(DBManLocalI _dbman, BackendSessionI _session, boolean _intendedForSaving)

Method Summary

Modifier and Type	Method and Description
void	clearPersistenceHandler()
void	drain() If this BOLoader has a cache, we request it to empty it.
void	execute(BatchedBackendRequestI[] srs)
boolean	exists(java.lang.Long id) wrapper for exists(id, null).
boolean	exists(java.lang.Long id, java.lang.Class<? extends BOI> classtip) Returns true if a BO with the given id exists.
BO	frapFromCache(BO bo) Put a BO instance to further use in this BOLoader, cloning it in case it's unknown, giving back a cached instance in case it's cached, in any way returning an instance without making further reloads (which would make the effort of caching it useless).
byte[]	getBLOB(java.lang.Long id) get the BLOB belonging to BO[id].
long	getBLOB(java.lang.Long id, java.io.DataOutput os) Writes the BLOB belonging to BO[id] to the passed DataOutput.
long	getBLOB(java.lang.Long id, java.io.DataOutput os, boolean closeOS) Writes the BLOB belonging to BO[id] to the passed DataOutput.
long	getBLOB(java.lang.Long id, java.io.DataOutput os, boolean closeOS, java.lang.Long backuppingBPId) Writes the BLOB belonging to BO[id] to the passed DataOutput.
byte[]	getBLOB(java.lang.Long id, java.lang.Long backuppingBPId) get the BLOB belonging to BO[id].
long	getBLOB(java.lang.Long id, java.io.OutputStream os) Writes the BLOB belonging to BO[id] to the passed OutputStream.
long	getBLOB(java.lang.Long id, java.io.OutputStream os, boolean closeOS) Writes the BLOB belonging to BO[id] to the passed OutputStream.
long	getBLOB(java.lang.Long id, java.io.OutputStream os, boolean closeOS, java.lang.Long backuppingBPId) Writes the BLOB belonging to BO[id] to the passed OutputStream.
VFile	getBLOBInfo(java.lang.Long id) gathers information about the BLOB belonging to BO[i].
VFile	getBLOBInfo(java.lang.Long id, java.lang.Long backuppingBPId) gathers information about the BLOB belonging to BO[i].
BO	getBO(java.lang.Long id) wrapper for getBO(id, null).
BO	getBO(java.lang.Long id, java.lang.Class<? extends BOI> classtip) Returns the BO with the given id.
BO[]	getBOs(long[] ids) wrapper for getBOs(ids, null)
BO[]	getBOs(java.lang.Long[] ids) wrapper for getBOs(ids, null)
BO[]	getBOs(long[] ids, java.lang.Class<? extends BOI> classtip) returns the BOs with the given ids.
BO[]	getBOs(java.lang.Long[] ids, java.lang.Class<? extends BOI> classtip) returns the BOs with the given ids.
BOT	getBOT(java.lang.Class<? extends BOI> clazz)
BO	getBOUncached(java.lang.Long id)
BO	getBOUncached(java.lang.Long id, java.lang.Class<? extends BOI> classtip) Loads and returns the BO with this Id with a non caching BOLoader.
CryptoHandlerI	getCryptoHandler() get a reference to the CryptoHandler used.
DBManEventProviderI	getEventProvider() Returns the DBManEventProviderI of this BOLoader, if any.
FeatureManagerI	getFeatureManager()
FileVaultI	getFileVault()
java.lang.Long	getNextId() get a unique Long id from the backend.
BOLoaderI	getParentLoader() returns the BOLoader which this BOLoader uses to load its objects.
PersistenceHandlerI	getPersistenceHandler()
PersistenceHandlerI	getPh()
BO[]	getRelationBOs(java.lang.Long id, java.lang.Class<? extends BOI> classtip, java.lang.String attName) this method is used by the lazy loading map/list implementation to load related objects when needed.
BOLoaderI	getRootLoader() Returns the root BOLoader of this BOLoader or this if there is no more parent loader.
SchemaI	getSchema() gets a reference to the schema which is used by this BOLoader.
BackendSessionI	getSession()
TransactionBuilderI	getTransactionBuilder() Deprecated. please use a ServerLocalTransactionI instead, built via DBManLocalI::getServerLocalTransaction
TransactionProviderI	getTransactionProvider() Deprecated. please use a ServerLocalTransactionI instead, built via DBManLocalI::getServerLocalTransaction
boolean	hasBLOB(java.lang.Long id)
boolean	hasBLOB(java.lang.Long id, java.lang.Long backuppingBPId)
java.util.BitSet	haveBLOB(long[] ids)
boolean	isAnsweringBackendQuery() Checks if this loader is currently answering a backend query.
boolean	isCaching() If true, then this BOLoaderI uses an internal cache, holding all BOs hat were loaded or frapped into it.
java.lang.Boolean	isLoggedIn(Benutzer user) Tells if the given Benutzer is currently logged in.
boolean	isLoggedInNN(Benutzer user) Tells if the given Benutzer is currently logged in.
boolean	isRecording() Returns true if this BOLoaderI records changes.
java.lang.Long	nextTempId() Generates the next temporary Id, using the current session as the Id supplier if available.
BatchedBackendRequestI	prepareQuery(java.lang.String s)
BatchedBackendRequestI	prepareQuery(java.lang.String s, java.lang.Object[] o)
de.ipcon.db.core.QueryResultsI	query(BOQuery boQuery) query objects in an iterative way to hide backend processing time.
de.ipcon.db.core.QueryResultsI	query(java.lang.String query) wrapper for query(t, Object[0])
de.ipcon.db.core.QueryResultsI	query(java.lang.String query, java.lang.Object[] params) query objects in an iterative way to hide backend processing time.
java.util.List	queryBO(BOQuery boQuery) query objects and block until all objects are transferred, returns Objects as a List.
java.util.List	queryBO(java.lang.String query) wrapper for queryBO(String, Object[0])
java.util.List	queryBO(java.lang.String query, java.lang.Object[] params) query objects and block until all objects are transferred, returns Objects as a List.
de.ipcon.db.core.QueryResultsI	queryRelation(long id, java.lang.Class<? extends BOI> classtip, java.lang.String attributeName) does the same as @see #getRelationBOs, but returns a QueryResultsI like @see #query.
void	setPh(PersistenceHandlerI persistenceHandler) Sets the persistence handler for this loader.
void	setSchema(SchemaI _schema)
void	setSession(BackendSessionI s)
java.lang.Long	testAuth(Anmeldung a) Tests wether given credentials can be verified.
boolean	testAuth(de.ipcon.db.core.PasswortUeberpruefung a) Tests wether given credentials can be verified.

Methods inherited from class java.lang.Object

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

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

find

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

isServerSide

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

frapBOArrayFromCache, frapBOIArrayFromCache, frapBOsFromCache, frapFromCache, isAncestorOf, isRootLoader, isServerSide, isTesting, prepareQuery

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

haveBLOB, haveBLOB

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

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

Constructor Detail

DBManLocalBOLoader

public DBManLocalBOLoader(DBManLocalI _dbman)

DBManLocalBOLoader

public DBManLocalBOLoader(DBManLocalI _dbman,
                          BackendSessionI _session)

DBManLocalBOLoader

public DBManLocalBOLoader(DBManLocalI _dbman,
                          BackendSessionI _session,
                          boolean _intendedForSaving)

Method Detail

getPersistenceHandler

public PersistenceHandlerI getPersistenceHandler()

Specified by:

getPersistenceHandler in interface BackendBOLoaderWithPersistenceHandlerI

clearPersistenceHandler

public void clearPersistenceHandler()

Specified by:

clearPersistenceHandler in interface BackendBOLoaderWithPersistenceHandlerI

getSession

public BackendSessionI getSession()

setSession

public void setSession(BackendSessionI s)

getTransactionProvider

@Deprecated
public TransactionProviderI getTransactionProvider()

Deprecated. please use a ServerLocalTransactionI instead, built via DBManLocalI::getServerLocalTransaction

getTransactionBuilder

@Deprecated
public TransactionBuilderI getTransactionBuilder()

Deprecated. please use a ServerLocalTransactionI instead, built via DBManLocalI::getServerLocalTransaction

isAnsweringBackendQuery

public boolean isAnsweringBackendQuery()

Description copied from interface: BackendQueryAnsweringBOLoaderI

Checks if this loader is currently answering a backend query.

Specified by:

isAnsweringBackendQuery in interface BackendQueryAnsweringBOLoaderI

Returns:

true if the loader is answering a backend query, false otherwise.

nextTempId

public java.lang.Long nextTempId()

Generates the next temporary Id, using the current session as the Id supplier if available.

This method overrides the nextTempId method from the BackendQueryAnsweringBOLoaderI interface to provide a consistent way of generating temporary Ids within a backend query session. If a session is active, it is used as the Id supplier; otherwise, a local Id counter is used.

Specified by:

nextTempId in interface BackendQueryAnsweringBOLoaderI

Returns:

The next temporary Id.

setPh

public void setPh(PersistenceHandlerI persistenceHandler)

Description copied from interface: BackendQueryAnsweringBOLoaderI

Sets the persistence handler for this loader.

Specified by:

setPh in interface BackendQueryAnsweringBOLoaderI

Parameters:

persistenceHandler - The persistence handler to set.

getSchema

public SchemaI getSchema()

Description copied from interface: BOLoaderI

gets a reference to the schema which is used by this BOLoader. Within the schema, you can find methods to set/get values, gather information about available entities and their attributes and many other things, too.

Specified by:

getSchema in interface BOLoaderI

Specified by:

getSchema in interface SchemaProviderI

Returns:

the schema of this BOLoader instance.

setSchema

public void setSchema(SchemaI _schema)

getCryptoHandler

public CryptoHandlerI getCryptoHandler()

Description copied from interface: BOLoaderI

get a reference to the CryptoHandler used. On the server side, this will be a a ServerCryptoHandler, on the client side a ClientCryptoHandler. The main difference between these two is that the server side can calculate hashes, whereas the client side cannot.

Specified by:

getCryptoHandler in interface BOLoaderI

Returns:

the cryptohandler used by this BOLoader instance.

getFileVault

public FileVaultI getFileVault()

Specified by:

getFileVault in interface BOLoaderI

getFeatureManager

public FeatureManagerI getFeatureManager()

Specified by:

getFeatureManager in interface BOLoaderI

getBOT

public BOT getBOT(java.lang.Class<? extends BOI> clazz)

Specified by:

getBOT in interface BOLoaderI

exists

public boolean exists(java.lang.Long id)

Description copied from interface: BOLoaderI

wrapper for exists(id, null).

Specified by:

exists in interface BOLoaderI

See Also:

BOLoaderI.exists(Long, Class)

exists

public boolean exists(java.lang.Long id,
                      java.lang.Class<? extends BOI> classtip)

Description copied from interface: BOLoaderI

Returns true if a BO with the given id exists. The class tip is just what the name suggests, just a tip and will only have performance consequences if wrong or null.

Specified by:

exists in interface BOLoaderI

Parameters:

id - the id of the BO

classtip - a guess which class the object has. May be null.

Returns:

true if a BO with the given id exists

getBO

public BO getBO(java.lang.Long id)

Description copied from interface: BOLoaderI

wrapper for getBO(id, null). FIXME!! TT 2023-05-11: This method can probably return null in a few cases but I have no information what exactly these might be and it also depends on the actual implementing class. Also some implementations (DBMan for example) will throw ObjectNotPersistentException if no matching BO is found, while other implementations will not. Some classes - for example Mandant from crm-accounts module - will rely in ObjectNotPersistentException being thrown.

Specified by:

getBO in interface BOLoaderI

See Also:

BOLoaderI.getBO(Long, Class)

getBO

public BO getBO(java.lang.Long id,
                java.lang.Class<? extends BOI> classtip)

Description copied from interface: BOLoaderI

Returns the BO with the given id. If the BOLoader instance has an instance cache (like the Transaction class), then multiple calls to this method with the same id will return the exact same object, which means getBO(id,...)==getBO(id,...). The class tip is just what the name suggests, just a tip and will only have performance consequences if a wrong or null value is passed. FIXME!! TT 2023-05-11: This method can probably return null in a few cases but I have no information what exactly these might be and it also depends on the actual implementing class. Also some implementations (DBMan for example) will throw ObjectNotPersistentException if no matching BO is found, while other implementations will not. Some classes - for example Mandant from crm-accounts module - will rely in ObjectNotPersistentException being thrown.

Specified by:

getBO in interface BOLoaderI

Parameters:

id - the id of the BO

classtip - a guess which class the object has. May be null.

Returns:

BO with the given id.

getBOUncached

public BO getBOUncached(java.lang.Long id)

Specified by:

getBOUncached in interface BOLoaderI

getBOUncached

public BO getBOUncached(java.lang.Long id,
                        java.lang.Class<? extends BOI> classtip)

Description copied from interface: BOLoaderI

Loads and returns the BO with this Id with a non caching BOLoader. The BOLoader of the returned BO can (but doesn't have to) be different than the BOLoader this method was called on, e.g. BOLoaderI.isCaching() BOLoaderI instances.

Specified by:

getBOUncached in interface BOLoaderI

getBOs

public BO[] getBOs(java.lang.Long[] ids)

Description copied from interface: BOLoaderI

wrapper for getBOs(ids, null)

Specified by:

getBOs in interface BOLoaderI

See Also:

BOLoaderI.getBOs(Long[],Class)

getBOs

public BO[] getBOs(java.lang.Long[] ids,
                   java.lang.Class<? extends BOI> classtip)

Description copied from interface: BOLoaderI

returns the BOs with the given ids. If the BOLoader instance has an instance cache (like the Transaction class), then multiple calls to this method will return an array with the exact same objects. The class tip is common for all objects within this call and may be null.

Specified by:

getBOs in interface BOLoaderI

Parameters:

ids - array of Longs with ids for the requested BOs.

classtip - guess for classes which the BOs belong to, may be null.

Returns:

BO[] with the requested BOs.

See Also:

Transaction

getBOs

public BO[] getBOs(long[] ids)

Description copied from interface: BOLoaderI

wrapper for getBOs(ids, null)

Specified by:

getBOs in interface BOLoaderI

See Also:

BOLoaderI.getBOs(long[],Class)

getBOs

public BO[] getBOs(long[] ids,
                   java.lang.Class<? extends BOI> classtip)

Description copied from interface: BOLoaderI

returns the BOs with the given ids. If the BOLoader instance has an instance cache (like the Transaction class), then multiple calls to this method will return an array with the exact same objects. The class tip is common for all objects within this call and may be null.

Specified by:

getBOs in interface BOLoaderI

Parameters:

ids - array of longs with ids for the requested BOs.

classtip - guess for classes which the BOs belong to, may be null.

Returns:

BO[] with the requested BOs.

See Also:

Transaction

getRelationBOs

public BO[] getRelationBOs(java.lang.Long id,
                           java.lang.Class<? extends BOI> classtip,
                           java.lang.String attName)

Description copied from interface: BOLoaderI

this method is used by the lazy loading map/list implementation to load related objects when needed. It's not thought for day to day use.

Specified by:

getRelationBOs in interface BOLoaderI

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.

queryRelation

public de.ipcon.db.core.QueryResultsI queryRelation(long id,
                                                    java.lang.Class<? extends BOI> classtip,
                                                    java.lang.String attributeName)

Description copied from interface: BOLoaderI

does the same as @see #getRelationBOs, but returns a QueryResultsI like @see #query.

Specified by:

queryRelation in interface BOLoaderI

query

public de.ipcon.db.core.QueryResultsI query(java.lang.String query)

Description copied from interface: BOLoaderI

wrapper for query(t, Object[0])

Specified by:

query in interface BOLoaderI

Specified by:

query in interface BOQueryLoaderI

See Also:

BOLoaderI.query(String, Object[])

query

public de.ipcon.db.core.QueryResultsI query(java.lang.String query,
                                            java.lang.Object[] params)

Description copied from interface: BOLoaderI

query objects in an iterative way to hide backend processing time. The QueryResults interface "feels" like the standard iterator interface from the collections framework and it's thought to be used like this: This sample shows how to query bla BOs though this method do it = bol.query("bla from pack.bo bla where not Ldel limit 2") loop while it.hasNext() bo = BO it.getCurrentObject() -- hopefully this IS a BO, depends on the query. -- do whatever you have to do with the bo finally it.close() end The finally clause is very important to free up database and backend resources, so please don't forget this step!

Specified by:

query in interface BOLoaderI

Specified by:

query in interface BOQueryLoaderI

Specified by:

query in interface GrooqlBOLoaderI

Parameters:

query - the query to fetch, written in OQL

params - an object array corresponding with $n entries, $1 is pvals[0] and so forth. Must not be null.

Returns:

QueryResults iterator through the query results.

queryBO

public java.util.List queryBO(java.lang.String query)

Description copied from interface: BOLoaderI

wrapper for queryBO(String, Object[0])

Specified by:

queryBO in interface BOLoaderI

Specified by:

queryBO in interface BOQueryLoaderI

See Also:

BOLoaderI.queryBO(String, Object[])

queryBO

public java.util.List queryBO(java.lang.String query,
                              java.lang.Object[] params)

Description copied from interface: BOLoaderI

query objects and block until all objects are transferred, returns Objects as a List. If at all possible, use query() instead of this, as it's a resource hogger and rather slow - except if you need a complete and rather small set of objects in this or an equivalent form and no further processing.

Specified by:

queryBO in interface BOLoaderI

Specified by:

queryBO in interface BOQueryLoaderI

Specified by:

queryBO in interface GrooqlBOLoaderI

Parameters:

query - the query to fetch, written in OQL

params - an object array corresponding with $n entries, $1 is pvals[0] and so forth. Must not be null.

Returns:

List with the requested objects.

See Also:

BOLoaderI.query(String, Object[])

query

public de.ipcon.db.core.QueryResultsI query(BOQuery boQuery)

Description copied from interface: BOLoaderI

query objects in an iterative way to hide backend processing time.

Specified by:

query in interface BOLoaderI

Parameters:

boQuery - the query to fetch, written in OQL

Returns:

QueryResults iterator through the query results.

queryBO

public java.util.List queryBO(BOQuery boQuery)

Description copied from interface: BOLoaderI

query objects and block until all objects are transferred, returns Objects as a List.

Specified by:

queryBO in interface BOLoaderI

Parameters:

boQuery - the query to fetch, written in OQL

Returns:

List with the requested objects.

getBLOB

public byte[] getBLOB(java.lang.Long id)

Description copied from interface: BLOBLoaderI

get the BLOB belonging to BO[id]. Gives back a byte array of the BLOB.

Specified by:

getBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB belongs to.

Returns:

a byte array containing the data of the BLOB.

getBLOB

public byte[] getBLOB(java.lang.Long id,
                      java.lang.Long backuppingBPId)

Description copied from interface: BLOBLoaderI

get the BLOB belonging to BO[id]. Gives back a byte array of the BLOB.

Specified by:

getBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB belongs to.

backuppingBPId - instead of the current BLOB get and stream the backup-BLOB that was stored because of this BP-Id from the backup-dir

Returns:

a byte array containing the data of the BLOB.

getBLOB

public long getBLOB(java.lang.Long id,
                    java.io.OutputStream os)

Description copied from interface: BLOBLoaderI

Writes the BLOB belonging to BO[id] to the passed OutputStream. writes to the given OutputStream

Specified by:

getBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB belongs to

os - the OutputStream to write the BLOB-bytes to

Returns:

the written bytecount / length of BLOB

getBLOB

public long getBLOB(java.lang.Long id,
                    java.io.OutputStream os,
                    boolean closeOS)

Description copied from interface: BLOBLoaderI

Writes the BLOB belonging to BO[id] to the passed OutputStream. writes to the given OutputStream

Specified by:

getBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB belongs to

os - the OutputStream to write the BLOB-bytes to

closeOS - a boolean designating if the OutputStream shall be closed afterwards or not.

Returns:

the written bytecount / length of BLOB

getBLOB

public long getBLOB(java.lang.Long id,
                    java.io.OutputStream os,
                    boolean closeOS,
                    java.lang.Long backuppingBPId)

Description copied from interface: BLOBLoaderI

Writes the BLOB belonging to BO[id] to the passed OutputStream. writes to the given OutputStream

Specified by:

getBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB belongs to

os - the OutputStream to write the BLOB-bytes to

closeOS - a boolean designating if the OutputStream shall be closed afterwards or not.

backuppingBPId - instead of the current BLOB get and stream the backup-BLOB that was stored because of this BP-Id from the backup-dir

Returns:

the written bytecount / length of BLOB

getBLOB

public long getBLOB(java.lang.Long id,
                    java.io.DataOutput os)

Description copied from interface: BLOBLoaderI

Writes the BLOB belonging to BO[id] to the passed DataOutput. writes to the given DataOutput

Specified by:

getBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB belongs to

os - the DataOutput to write the BLOB-bytes to

Returns:

the written bytecount / length of BLOB

getBLOB

public long getBLOB(java.lang.Long id,
                    java.io.DataOutput os,
                    boolean closeOS)

Description copied from interface: BLOBLoaderI

Writes the BLOB belonging to BO[id] to the passed DataOutput. writes to the given DataOutput

Specified by:

getBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB belongs to

os - the DataOutput to write the BLOB-bytes to

closeOS - a boolean designating if the DataOutput shall be closed afterwards or not.

Returns:

the written bytecount / length of BLOB

getBLOB

public long getBLOB(java.lang.Long id,
                    java.io.DataOutput os,
                    boolean closeOS,
                    java.lang.Long backuppingBPId)

Description copied from interface: BLOBLoaderI

Writes the BLOB belonging to BO[id] to the passed DataOutput. writes to the given DataOutput

Specified by:

getBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB belongs to

os - the DataOutput to write the BLOB-bytes to

closeOS - a boolean designating if the DataOutput shall be closed afterwards or not.

backuppingBPId - instead of the current BLOB get and stream the backup-BLOB that was stored because of this BP-Id from the backup-dir

Returns:

the written bytecount / length of BLOB

getBLOBInfo

public VFile getBLOBInfo(java.lang.Long id)

Description copied from interface: BLOBLoaderI

gathers information about the BLOB belonging to BO[i].

Specified by:

getBLOBInfo in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB-info belongs to.

Returns:

VFile object containing information about lastmodification and size.

getBLOBInfo

public VFile getBLOBInfo(java.lang.Long id,
                         java.lang.Long backuppingBPId)

Description copied from interface: BLOBLoaderI

gathers information about the BLOB belonging to BO[i].

Specified by:

getBLOBInfo in interface BLOBLoaderI

Parameters:

id - the id of the BO the BLOB-info belongs to.

backuppingBPId - instead of the current BLOB get the VFile for the backup-BLOB that was stored because of this BP-Id from the backup-dir

Returns:

VFile object containing information about lastmodification and size.

hasBLOB

public boolean hasBLOB(java.lang.Long id)

Specified by:

hasBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the check for existence of a BLOB on the server.

Returns:

true if a BLOB for the BO with the passed Id exists on the server.

hasBLOB

public boolean hasBLOB(java.lang.Long id,
                       java.lang.Long backuppingBPId)

Specified by:

hasBLOB in interface BLOBLoaderI

Parameters:

id - the id of the BO the check for existence of a BLOB on the server.

backuppingBPId - instead of the current BLOB get the VFile for the backup-BLOB that was stored because of this BP-Id from the backup-dir

Returns:

true if a BLOB for the BO with the passed Id exists on the server.

haveBLOB

public java.util.BitSet haveBLOB(long[] ids)

Specified by:

haveBLOB in interface BLOBLoaderI

Parameters:

ids - an array of ids of BOs the check for existence of a BLOB on the server.

Returns:

a BitSet with the bit at the corresponding index set to true if a BLOB for the BO with the Id at that index of the passed array exists on the server, false if no BO or no BLOB for that BO exists on the server.

getNextId

public java.lang.Long getNextId()

Description copied from interface: BOLoaderI

get a unique Long id from the backend. Please note that the ids drawn here are considered 'consumed'. An intentional delay in the backend safeguards that the process of consuming all usable ids from an instance will take at least about 29247120867 years.

Specified by:

getNextId in interface BOLoaderI

Returns:

Long id which is guaranteed to be unique within the whole cluster.

testAuth

public java.lang.Long testAuth(Anmeldung a)

Description copied from interface: BOLoaderI

Tests wether given credentials can be verified. Returns long denoting the internal BO object in case the verification succeeded.

Specified by:

testAuth in interface BOLoaderI

Returns:

Long id of the Benutzer object in case the verification succeeded, null otherwise (aside a server-dependent lag).

testAuth

public boolean testAuth(de.ipcon.db.core.PasswortUeberpruefung a)

Description copied from interface: BOLoaderI

Tests wether given credentials can be verified. Returns true in case the verification succeeded.

Specified by:

testAuth in interface BOLoaderI

Returns:

true in case the verification succeeded, false otherwise.

prepareQuery

public BatchedBackendRequestI prepareQuery(java.lang.String s)

Specified by:

prepareQuery in interface BOLoaderI

prepareQuery

public BatchedBackendRequestI prepareQuery(java.lang.String s,
                                           java.lang.Object[] o)

Specified by:

prepareQuery in interface BOLoaderI

execute

public void execute(BatchedBackendRequestI[] srs)

Specified by:

execute in interface BOLoaderI

isLoggedIn

public java.lang.Boolean isLoggedIn(Benutzer user)

Description copied from interface: BOLoaderI

Tells if the given Benutzer is currently logged in.

Specified by:

isLoggedIn in interface BOLoaderI

Parameters:

user - the Benutzer for which the logged in state should be checked

Returns:

Boolean.TRUE if Benutzer is currently logged in, Boolean.FALSE if not and null if this info is not available

isLoggedInNN

public boolean isLoggedInNN(Benutzer user)

Description copied from interface: BOLoaderI

Tells if the given Benutzer is currently logged in.

Specified by:

isLoggedInNN in interface BOLoaderI

Parameters:

user - the Benutzer for which the logged in state should be checked

Returns:

true if Benutzer is currently logged in, false if not or if this info is not available

drain

public void drain()

Description copied from interface: BOLoaderI

If this BOLoader has a cache, we request it to empty it. The BOLoader should make every effort to keep valuable data though, but objects not "nailed" (=included in a transaction) should be reloaded or removed from the cache so that a further request will fetch them again. If BOLoaderI.isCaching() returns false, this is a nop.

Specified by:

drain in interface BOLoaderI

isCaching

public boolean isCaching()

Description copied from interface: BOLoaderI

If true, then this BOLoaderI uses an internal cache, holding all BOs hat were loaded or frapped into it. In this case, the BOLoader should not be expected to handle automatic cache eviction (some might). A BOLoader that is caching can be expected to deduplicate BOs with the same Id from different sources to create a stable, self contained BO graph. Caching BOLoaders should not be expected to always hold the most up to date version of a BO, even after frapping a newer BO with it, i.e. an already cached BO is might always be preferred. If false, then this BOLoader will not hold references to loaded BOs, allowing them to be garbage collected as soon as they're no longer referenced outside of this class. As a result, this Interface makes no guarantees regarding deduplication of BOs in the returned graph.

Specified by:

isCaching in interface BOLoaderI

Returns:

true if this BOLoaderI uses a cache, false if loaded BOs aren't cached.

isRecording

public boolean isRecording()

Description copied from interface: BOLoaderI

Returns true if this BOLoaderI records changes.

Specified by:

isRecording in interface BOLoaderI

frapFromCache

public BO frapFromCache(BO bo)

Description copied from interface: BOLoaderI

Put a BO instance to further use in this BOLoader, cloning it in case it's unknown, giving back a cached instance in case it's cached, in any way returning an instance without making further reloads (which would make the effort of caching it useless).

Specified by:

frapFromCache in interface BOLoaderI

getParentLoader

public BOLoaderI getParentLoader()

Description copied from interface: BOLoaderI

returns the BOLoader which this BOLoader uses to load its objects. If this is a Root BOLoader, then null is returned.

Specified by:

getParentLoader in interface BOLoaderI

getRootLoader

public BOLoaderI getRootLoader()

Description copied from interface: BOLoaderI

Returns the root BOLoader of this BOLoader or this if there is no more parent loader.

Specified by:

getRootLoader in interface BOLoaderI

getEventProvider

public DBManEventProviderI getEventProvider()

Description copied from interface: BOLoaderI

Returns the DBManEventProviderI of this BOLoader, if any.

Specified by:

getEventProvider in interface BOLoaderI

getPh

public PersistenceHandlerI getPh()