Package modelarium.attributes.results.databases

Class DiskBasedAttributeSetResultsDatabase

java.lang.Object

modelarium.attributes.results.databases.AttributeSetResultsDatabase

modelarium.attributes.results.databases.DiskBasedAttributeSetResultsDatabase

public class DiskBasedAttributeSetResultsDatabase
extends AttributeSetResultsDatabase

Concrete implementation of AttributeSetResultsDatabase that stores results in a temporary SQLite database file.

Each run of the simulation creates a new SQLite database that is deleted on shutdown. Values are serialised to JSON strings to support flexible data types.

This class supports both incremental (`addXValue`) and bulk (`setXColumn`) writes.

Constructor Summary

Constructors

Constructor	Description
DiskBasedAttributeSetResultsDatabase()	Registers this instance for automatic disconnect on JVM shutdown

Method Summary

Modifier and Type	Method	Description
<T> void	addPostEventValue(String postEventName, T postEventValue)	Adds a new post-event value (e.g. trigger status) for the current tick.
<T> void	addPreEventValue(String preEventName, T preEventValue)	Adds a new pre-event value (e.g. trigger status) for the current tick.
<T> void	addPropertyValue(String propertyName, T propertyValue)	Adds a new property value to the results database for the current tick.
void	connect()	Establishes an SQLite connection and creates the required tables.
void	disconnect()	Closes the SQLite connection and deletes the database file.
List<Object>	getPostEventColumnAsList(String postEventName)	Retrieves the full column of recorded values for a post-event.
List<Object>	getPreEventColumnAsList(String preEventName)	Retrieves the full column of recorded values for a pre-event.
List<Object>	getPropertyColumnAsList(String propertyName)	Retrieves the full column of recorded values for a property.
void	setPostEventColumn(String postEventName, List<Object> postEventValues)	Replaces or defines the full column of values for a post-event.
void	setPreEventColumn(String preEventName, List<Object> preEventValues)	Replaces or defines the full column of values for a pre-event.
void	setPropertyColumn(String propertyName, List<Object> propertyValues)	Replaces or defines the entire set of values for a given property.

Methods inherited from class modelarium.attributes.results.databases.AttributeSetResultsDatabase

getDatabasePath, setDatabasePath

Methods inherited from class java.lang.Object

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

Constructor Details

DiskBasedAttributeSetResultsDatabase

public DiskBasedAttributeSetResultsDatabase()

Registers this instance for automatic disconnect on JVM shutdown

Method Details

connect

public void connect()

Establishes an SQLite connection and creates the required tables.

Overrides:

connect in class AttributeSetResultsDatabase

disconnect

public void disconnect()

Closes the SQLite connection and deletes the database file.

Overrides:

disconnect in class AttributeSetResultsDatabase

addPropertyValue

public <T> void addPropertyValue(String propertyName,
 T propertyValue)

Description copied from class: AttributeSetResultsDatabase

Adds a new property value to the results database for the current tick.

Specified by:

addPropertyValue in class AttributeSetResultsDatabase

Type Parameters:

T - the value type

Parameters:

propertyName - the name of the property

propertyValue - the value to record

addPreEventValue

public <T> void addPreEventValue(String preEventName,
 T preEventValue)

Description copied from class: AttributeSetResultsDatabase

Adds a new pre-event value (e.g. trigger status) for the current tick.

Specified by:

addPreEventValue in class AttributeSetResultsDatabase

Type Parameters:

T - the value type

Parameters:

preEventName - the name of the pre-event

preEventValue - the value to record

addPostEventValue

public <T> void addPostEventValue(String postEventName,
 T postEventValue)

Description copied from class: AttributeSetResultsDatabase

Adds a new post-event value (e.g. trigger status) for the current tick.

Specified by:

addPostEventValue in class AttributeSetResultsDatabase

Type Parameters:

T - the value type

Parameters:

postEventName - the name of the post-event

postEventValue - the value to record

setPropertyColumn

public void setPropertyColumn(String propertyName,
 List<Object> propertyValues)

Description copied from class: AttributeSetResultsDatabase

Replaces or defines the entire set of values for a given property.

Specified by:

setPropertyColumn in class AttributeSetResultsDatabase

Parameters:

propertyName - the name of the property

propertyValues - the full list of property values

setPreEventColumn

public void setPreEventColumn(String preEventName,
 List<Object> preEventValues)

Description copied from class: AttributeSetResultsDatabase

Replaces or defines the full column of values for a pre-event.

Specified by:

setPreEventColumn in class AttributeSetResultsDatabase

Parameters:

preEventName - the name of the pre-event

preEventValues - the full list of values

setPostEventColumn

public void setPostEventColumn(String postEventName,
 List<Object> postEventValues)

Description copied from class: AttributeSetResultsDatabase

Replaces or defines the full column of values for a post-event.

Specified by:

setPostEventColumn in class AttributeSetResultsDatabase

Parameters:

postEventName - the name of the post-event

postEventValues - the full list of values

getPropertyColumnAsList

public List<Object> getPropertyColumnAsList(String propertyName)

Description copied from class: AttributeSetResultsDatabase

Retrieves the full column of recorded values for a property.

Specified by:

getPropertyColumnAsList in class AttributeSetResultsDatabase

Parameters:

propertyName - the name of the property

Returns:

a list of recorded property values

getPreEventColumnAsList

public List<Object> getPreEventColumnAsList(String preEventName)

Description copied from class: AttributeSetResultsDatabase

Retrieves the full column of recorded values for a pre-event.

Specified by:

getPreEventColumnAsList in class AttributeSetResultsDatabase

Parameters:

preEventName - the name of the pre-event

Returns:

a list of recorded pre-event values

getPostEventColumnAsList

public List<Object> getPostEventColumnAsList(String postEventName)

Description copied from class: AttributeSetResultsDatabase

Retrieves the full column of recorded values for a post-event.

Specified by:

getPostEventColumnAsList in class AttributeSetResultsDatabase

Parameters:

postEventName - the name of the post-event

Returns:

a list of recorded post-event values