public final class BaseRecordManager extends java.lang.Object implements RecordManager
Operations are synchronized, so that only one of them will happen concurrently even if you hammer away from multiple threads. Operations are made atomic by keeping a transaction log which is recovered after a crash, so the operations specified by this interface all have ACID properties.
You identify a file by just the name. The package attaches .db for the database file, and .lg for the transaction log. The transaction log is synchronized regularly and then restarted, so don't worry if you see the size going up and down.
Modifier and Type | Field and Description |
---|---|
static boolean |
DEBUG
Static debugging flag
|
static int |
NAME_DIRECTORY_ROOT
Reserved slot for name directory.
|
Constructor and Description |
---|
BaseRecordManager(java.lang.String filename)
Creates a record manager for the indicated file
|
Modifier and Type | Method and Description |
---|---|
void |
close()
Closes the record manager.
|
void |
commit()
Commit (make persistent) all changes since beginning of transaction.
|
void |
delete(long recid)
Deletes a record.
|
void |
disableTransactions()
Switches off transactioning for the record manager.
|
java.lang.Object |
fetch(long recid)
Fetches a record using standard java object serialization.
|
java.lang.Object |
fetch(long recid,
Serializer serializer)
Fetches a record using a custom serializer.
|
long |
getNamedObject(java.lang.String name)
Obtain the record id of a named object.
|
long |
getRoot(int id)
Returns the indicated root rowid.
|
int |
getRootCount()
Returns the number of slots available for "root" rowids.
|
TransactionManager |
getTransactionManager()
Get the underlying Transaction Manager
|
long |
insert(java.lang.Object obj)
Inserts a new record using standard java object serialization.
|
long |
insert(java.lang.Object obj,
Serializer serializer)
Inserts a new record using a custom serializer.
|
void |
rollback()
Rollback (cancel) all changes since beginning of transaction.
|
void |
setNamedObject(java.lang.String name,
long recid)
Set the record id of a named object.
|
void |
setRoot(int id,
long rowid)
Sets the indicated root rowid.
|
void |
update(long recid,
java.lang.Object obj)
Updates a record using standard java object serialization.
|
void |
update(long recid,
java.lang.Object obj,
Serializer serializer)
Updates a record using a custom serializer.
|
public static final int NAME_DIRECTORY_ROOT
public static final boolean DEBUG
public BaseRecordManager(java.lang.String filename) throws java.io.IOException
java.io.IOException
- when the file cannot be opened or is not
a valid file content-wise.public TransactionManager getTransactionManager()
public void disableTransactions()
Only call this method directly after opening the file, otherwise the results will be undefined.
public void close() throws java.io.IOException
close
in interface RecordManager
java.io.IOException
- when one of the underlying I/O operations fails.public long insert(java.lang.Object obj) throws java.io.IOException
insert
in interface RecordManager
obj
- the object for the new record.java.io.IOException
- when one of the underlying I/O operations fails.public long insert(java.lang.Object obj, Serializer serializer) throws java.io.IOException
insert
in interface RecordManager
obj
- the object for the new record.serializer
- a custom serializerjava.io.IOException
- when one of the underlying I/O operations fails.public void delete(long recid) throws java.io.IOException
delete
in interface RecordManager
recid
- the rowid for the record that should be deleted.java.io.IOException
- when one of the underlying I/O operations fails.public void update(long recid, java.lang.Object obj) throws java.io.IOException
update
in interface RecordManager
recid
- the recid for the record that is to be updated.obj
- the new object for the record.java.io.IOException
- when one of the underlying I/O operations fails.public void update(long recid, java.lang.Object obj, Serializer serializer) throws java.io.IOException
update
in interface RecordManager
recid
- the recid for the record that is to be updated.obj
- the new object for the record.serializer
- a custom serializerjava.io.IOException
- when one of the underlying I/O operations fails.public java.lang.Object fetch(long recid) throws java.io.IOException
fetch
in interface RecordManager
recid
- the recid for the record that must be fetched.java.io.IOException
- when one of the underlying I/O operations fails.public java.lang.Object fetch(long recid, Serializer serializer) throws java.io.IOException
fetch
in interface RecordManager
recid
- the recid for the record that must be fetched.serializer
- a custom serializerjava.io.IOException
- when one of the underlying I/O operations fails.public int getRootCount()
getRootCount
in interface RecordManager
public long getRoot(int id) throws java.io.IOException
getRoot
in interface RecordManager
java.io.IOException
getRootCount()
public void setRoot(int id, long rowid) throws java.io.IOException
setRoot
in interface RecordManager
java.io.IOException
getRootCount()
public long getNamedObject(java.lang.String name) throws java.io.IOException
getNamedObject
in interface RecordManager
java.io.IOException
public void setNamedObject(java.lang.String name, long recid) throws java.io.IOException
setNamedObject
in interface RecordManager
java.io.IOException
public void commit() throws java.io.IOException
commit
in interface RecordManager
java.io.IOException
public void rollback() throws java.io.IOException
rollback
in interface RecordManager
java.io.IOException
Cees de Groot (C) 2000-2001. All rights reserved http://jdbm.sourceforge.net