Inherits org.sleuthkit.autopsy.events.AutopsyEvent.

Public Member Functions
List< U >	getNewValue ()

List< T >	getOldValue ()

Object	getSource ()

SourceType	getSourceType ()

Protected Member Functions
	TskDataModelChangedEvent (String eventName, List< T > oldValueObjects, Function< T, Long > oldValueGetIdMethod, List< U > newValueObjects, Function< U, Long > newValueGetIdMethod)

List< U >	getNewValueObjects (SleuthkitCase caseDb, List< Long > ids) throws TskCoreException

List< T >	getOldValueObjects (SleuthkitCase caseDb, List< Long > ids) throws TskCoreException

Private Attributes
final boolean	hasNewValue

final boolean	hasOldValue

final List< Long >	newValueIds

transient List< U >	newValueObjects

final List< Long >	oldValueIds

transient List< T >	oldValueObjects

Static Private Attributes
static final Logger	logger = Logger.getLogger(TskDataModelChangedEvent.class.getName())

static final long	serialVersionUID = 1L

Detailed Description

An abstract base class for application events published when one or more Sleuth Kit Data Model objects for a case change in some way.

This class extends AutopsyEvent. The AutopsyEvent class extends PropertyChangeEvent to integrate with legacy use of JavaBeans PropertyChangeEvents and PropertyChangeListeners as an application event publisher-subcriber mechanism. Subclasses need to decide what constitutes "old" and "new" objects for them and are encouraged to provide getters for these values that do not require clients to cast the return values.

The AutopsyEvent class implements Serializable to allow local event instances to be published to other Autopsy nodes over a network in serialized form. TSK Data Model objects are generally not serializable because they encapsulate a reference to a SleuthkitCase object that represents the case database and which has local JDBC Connection objects. For this reason, this class supports serialization of the unique numeric IDs (TSK object IDs, case database row IDs, etc.) of the subject TSK Data Model objects and the "reconstruction" of those objects on other Autopsy nodes by querying the case database by unique ID.

Parameters

<T>	The Sleuth Kit Data Model object type of the "old" data model objects.
<U>	The Sleuth Kit Data Model object type of the "new" data model objects.

Definition at line 60 of file TskDataModelChangedEvent.java.

Constructor & Destructor Documentation

org.sleuthkit.autopsy.casemodule.events.TskDataModelChangedEvent< T, U >.TskDataModelChangedEvent	(	String	eventName,
		List< T >	oldValueObjects,
		Function< T, Long >	oldValueGetIdMethod,
		List< U >	newValueObjects,
		Function< U, Long >	newValueGetIdMethod
	)

protected

Constructs the base class part for application events published when one or more Sleuth Kit Data Model objects for a case change in some way.

Parameters

eventName	The event name.
oldValueObjects	A list of he Data Model objects that have been designated as the "old" objects in the event. May be null.
oldValueGetIdMethod	A method that can be applied to the "old" data model objects to get their unique numeric IDs (TSK object IDs, case database row IDs, etc.). May be null if there are no "old" objects.
newValueObjects	A list of he Data Model objects that have been designated as the "new" objects in the event. May be null.
newValueGetIdMethod	A method that can be applied to the "new" data model objects to get their unique numeric IDs (TSK object IDs, case database row IDs, etc.). May be null if there are no "new" objects.

Definition at line 91 of file TskDataModelChangedEvent.java.

Member Function Documentation

List<U> org.sleuthkit.autopsy.casemodule.events.TskDataModelChangedEvent< T, U >.getNewValue ( )

Gets a list of the Data Model objects that have been designated as the "new" objects in the event.

Returns: The list of the "new" data model objects. May be empty.

Definition at line 149 of file TskDataModelChangedEvent.java.

List<U> org.sleuthkit.autopsy.casemodule.events.TskDataModelChangedEvent< T, U >.getNewValueObjects	(	SleuthkitCase	caseDb,
		List< Long >	ids
	)		throws TskCoreException

protected

Reconstructs the "new" Sleuth Kit Data Model objects associated with this application event, if any, using the given unique numeric IDs (TSK object IDs, case database row IDs, etc.) to query the given case database.

Parameters

caseDb	The case database.
ids	The unique, numeric IDs (TSK object IDs, case database row IDs, etc.) of the Sleuth Kit Data Model objects.

Returns: The objects.

Exceptions

org.sleuthkit.datamodel.TskCoreException If there is an error getting the Sleuth Kit Data Model objects.

Definition at line 201 of file TskDataModelChangedEvent.java.

Referenced by org.sleuthkit.autopsy.casemodule.events.TskDataModelChangedEvent< TagSet, TagSet >.getNewValue().

List<T> org.sleuthkit.autopsy.casemodule.events.TskDataModelChangedEvent< T, U >.getOldValue ( )

Gets a list of the Data Model objects that have been designated as the "old" objects in the event.

Returns: The list of the "old" data model objects. May be empty.

Definition at line 124 of file TskDataModelChangedEvent.java.

List<T> org.sleuthkit.autopsy.casemodule.events.TskDataModelChangedEvent< T, U >.getOldValueObjects	(	SleuthkitCase	caseDb,
		List< Long >	ids
	)		throws TskCoreException

protected

Reconstructs the "old" Sleuth Kit Data Model objects associated with this application event, if any, using the given unique numeric IDs (TSK object IDs, case database row IDs, etc.) to query the given case database.

Parameters