DataHandler

A data handler contains a number of callback methods, mostly related to CLOB and BLOB handling. The most important implementing class is a database.

Methods
void checkPowerOff()
Check if the simulated power failure occurred.
void checkPowerOff() throws DbException
Check if the simulated power failure occurred. This call will decrement the countdown.
Throws:
DbException - if the simulated power failure occurred
void checkWritingAllowed()
Check if writing is allowed.
void checkWritingAllowed() throws DbException
Check if writing is allowed.
Throws:
DbException - if it is not allowed
CompareMode getCompareMode()
Return compare mode.
CompareMode getCompareMode()
Return compare mode.
Returns:
Compare mode.
String getDatabasePath()
Get the database path.
String getDatabasePath()
Get the database path.
Returns:
the database path
JavaObjectSerializer getJavaObjectSerializer()
Return the serializer to be used for java objects being stored in column of type OTHER.
JavaObjectSerializer getJavaObjectSerializer()
Return the serializer to be used for java objects being stored in column of type OTHER.
Returns:
the serializer to be used for java objects being stored in column of type OTHER
String getLobCompressionAlgorithm(int type)
Get the compression algorithm used for large objects.
String getLobCompressionAlgorithm(int type)
Get the compression algorithm used for large objects.
Parameters:
type - the data type (CLOB or BLOB)
Returns:
the compression algorithm, or null
SmallLRUCache getLobFileListCache()
Get the lob file list cache if it is used.
SmallLRUCache getLobFileListCache()
Get the lob file list cache if it is used.
Returns:
the cache or null
LobStorageInterface getLobStorage()
Get the lob storage mechanism to use.
LobStorageInterface getLobStorage()
Get the lob storage mechanism to use.
Returns:
the lob storage mechanism
Object getLobSyncObject()
Get the synchronization object for lob operations.
Object getLobSyncObject()
Get the synchronization object for lob operations.
Returns:
the synchronization object
int getMaxLengthInplaceLob()
Get the maximum length of a in-place large object
int getMaxLengthInplaceLob()
Get the maximum length of a in-place large object
Returns:
the maximum size
TempFileDeleter getTempFileDeleter()
Get the temp file deleter mechanism.
TempFileDeleter getTempFileDeleter()
Get the temp file deleter mechanism.
Returns:
the temp file deleter
FileStore openFile(String name, String mode, boolean mustExist)
Open a file at the given location.
FileStore openFile(String name, String mode, boolean mustExist)
Open a file at the given location.
Parameters:
name - the file name
mode - the mode
mustExist - whether the file must already exist
Returns:
the file
int readLob(long lobId, byte[] hmac, long offset, byte[] buff, int off, int length)
Read from a lob.
int readLob(long lobId, byte[] hmac, long offset, byte[] buff, int off, int length)
Read from a lob.
Parameters:
lobId - the lob id
hmac - the message authentication code
offset - the offset within the lob
buff - the target buffer
off - the offset within the target buffer
length - the number of bytes to read
Returns:
the number of bytes read