org.sleuthkit.autopsy.events.AutopsyEventPublisher Class Reference

Public Member Functions
	AutopsyEventPublisher ()
void	addSubscriber (Set< String > eventNames, PropertyChangeListener subscriber)
void	addSubscriber (String eventName, PropertyChangeListener subscriber)
synchronized void	closeRemoteEventChannel ()
synchronized void	openRemoteEventChannel (String channelName) throws AutopsyEventException
void	publish (AutopsyEvent event)
void	publishLocally (AutopsyEvent event)
synchronized void	publishRemotely (AutopsyEvent event)
void	removeSubscriber (Set< String > eventNames, PropertyChangeListener subscriber)
void	removeSubscriber (String eventName, PropertyChangeListener subscriber)

Private Member Functions
synchronized void	stopRemotePublisher ()

Private Attributes
String	currentChannelName
final LocalEventPublisher	localPublisher
RemoteEventPublisher	remotePublisher

Static Private Attributes
static final Logger	logger = Logger.getLogger(AutopsyEventPublisher.class.getName())
static final int	MAX_REMOTE_EVENT_PUBLISH_TRIES = 1

Detailed Description

Provides thread-safe support for publishing events to registered subscribers on both this Autopsy node and other Autopsy nodes. Subscribers are required to be PropertyChangeListeners to integrate with the legacy use of JavaBeans PropertyChangeEvents and PropertyChangeListeners as an application event system.

Definition at line 40 of file AutopsyEventPublisher.java.

Constructor & Destructor Documentation

org.sleuthkit.autopsy.events.AutopsyEventPublisher.AutopsyEventPublisher

(

)

Constructs an object for publishing events to registered subscribers on both this Autopsy node and other Autopsy nodes. Communication with other nodes is not turned on by default - call openRemoteEventChannel() after construction.

Definition at line 56 of file AutopsyEventPublisher.java.

Member Function Documentation

void org.sleuthkit.autopsy.events.AutopsyEventPublisher.addSubscriber	(	Set< String >	eventNames,
		PropertyChangeListener	subscriber
	)

Adds an event subscriber to this publisher.

Parameters

eventNames	The events the subscriber is interested in.
subscriber	The subscriber to add.

Definition at line 101 of file AutopsyEventPublisher.java.

Referenced by org.sleuthkit.autopsy.casemodule.Case.addEventSubscriber(), org.sleuthkit.autopsy.casemodule.Case.addEventTypeSubscriber(), org.sleuthkit.autopsy.ingest.IngestManager.addIngestJobEventListener(), org.sleuthkit.autopsy.ingest.IngestManager.addIngestModuleEventListener(), and org.sleuthkit.autopsy.core.ServicesMonitor.addSubscriber().

void org.sleuthkit.autopsy.events.AutopsyEventPublisher.addSubscriber	(	String	eventName,
		PropertyChangeListener	subscriber
	)

Adds an event subscriber to this publisher.

Parameters

eventName	The event the subscriber is interested in.
subscriber	The subscriber to add.

Definition at line 111 of file AutopsyEventPublisher.java.

synchronized void org.sleuthkit.autopsy.events.AutopsyEventPublisher.closeRemoteEventChannel

(

)

Closes the event channel used for publishing events to and receiving events from other Autopsy nodes.

Definition at line 90 of file AutopsyEventPublisher.java.

References org.sleuthkit.autopsy.events.AutopsyEventPublisher.currentChannelName, and org.sleuthkit.autopsy.events.AutopsyEventPublisher.stopRemotePublisher().

Referenced by org.sleuthkit.autopsy.casemodule.Case.close(), and org.sleuthkit.autopsy.events.AutopsyEventPublisher.openRemoteEventChannel().

synchronized void org.sleuthkit.autopsy.events.AutopsyEventPublisher.openRemoteEventChannel

(

String

channelName

)

throws AutopsyEventException

Opens an event channel used for publishing events to, and receiving events from, other Autopsy nodes. Only one channel may be open at a time.

Parameters

channelName

The name of the event channel.

Exceptions

AutopsyEventException

if the channel was not opened.

Definition at line 68 of file AutopsyEventPublisher.java.

References org.sleuthkit.autopsy.events.AutopsyEventPublisher.closeRemoteEventChannel(), org.sleuthkit.autopsy.events.AutopsyEventPublisher.currentChannelName, org.sleuthkit.autopsy.core.UserPreferences.getMessageServiceConnectionInfo(), and org.sleuthkit.autopsy.events.AutopsyEventPublisher.remotePublisher.

Referenced by org.sleuthkit.autopsy.casemodule.Case.openServices(), and org.sleuthkit.autopsy.events.AutopsyEventPublisher.publishRemotely().

void org.sleuthkit.autopsy.events.AutopsyEventPublisher.publish

(

AutopsyEvent

event

)

Publishes an event to this Autopsy node and other Autopsy nodes.

Parameters

event

The event to publish.

Definition at line 140 of file AutopsyEventPublisher.java.

References org.sleuthkit.autopsy.events.AutopsyEventPublisher.publishLocally(), and org.sleuthkit.autopsy.events.AutopsyEventPublisher.publishRemotely().

Referenced by org.sleuthkit.autopsy.casemodule.Case.addReport(), org.sleuthkit.autopsy.casemodule.Case.deleteReports(), org.sleuthkit.autopsy.casemodule.Case.notifyAddingDataSource(), org.sleuthkit.autopsy.casemodule.Case.notifyBlackBoardArtifactTagAdded(), org.sleuthkit.autopsy.casemodule.Case.notifyBlackBoardArtifactTagDeleted(), org.sleuthkit.autopsy.casemodule.Case.notifyContentTagAdded(), org.sleuthkit.autopsy.casemodule.Case.notifyContentTagDeleted(), org.sleuthkit.autopsy.casemodule.Case.notifyDataSourceAdded(), org.sleuthkit.autopsy.casemodule.Case.notifyFailedAddingDataSource(), org.sleuthkit.autopsy.casemodule.Case.notifyTagDefinitionChanged(), and org.sleuthkit.autopsy.ingest.IngestManager.PublishEventTask.run().

void org.sleuthkit.autopsy.events.AutopsyEventPublisher.publishLocally

(

AutopsyEvent

event

)

Publishes an event to this Autopsy node only.

Parameters

event

The event to publish.

Definition at line 150 of file AutopsyEventPublisher.java.

Referenced by org.sleuthkit.autopsy.casemodule.Case.closeCurrentCase(), org.sleuthkit.autopsy.casemodule.Case.openAsCurrentCase(), org.sleuthkit.autopsy.events.AutopsyEventPublisher.publish(), and org.sleuthkit.autopsy.core.ServicesMonitor.setServiceStatus().

synchronized void org.sleuthkit.autopsy.events.AutopsyEventPublisher.publishRemotely

(

AutopsyEvent

event

)

Publishes an event to other Autopsy nodes only.

Parameters

event

The event to publish.

Definition at line 159 of file AutopsyEventPublisher.java.

References org.sleuthkit.autopsy.events.AutopsyEventPublisher.currentChannelName, org.sleuthkit.autopsy.events.AutopsyEventPublisher.openRemoteEventChannel(), org.sleuthkit.autopsy.events.AutopsyEventPublisher.remotePublisher, and org.sleuthkit.autopsy.events.AutopsyEventPublisher.stopRemotePublisher().

Referenced by org.sleuthkit.autopsy.events.AutopsyEventPublisher.publish().

void org.sleuthkit.autopsy.events.AutopsyEventPublisher.removeSubscriber	(	Set< String >	eventNames,
		PropertyChangeListener	subscriber
	)

Removes an event subscriber from this publisher.

Parameters

eventNames	The events the subscriber is no longer interested in.
subscriber	The subscriber to remove.

Definition at line 121 of file AutopsyEventPublisher.java.

Referenced by org.sleuthkit.autopsy.casemodule.Case.removeEventSubscriber(), org.sleuthkit.autopsy.casemodule.Case.removeEventTypeSubscriber(), org.sleuthkit.autopsy.ingest.IngestManager.removeIngestJobEventListener(), org.sleuthkit.autopsy.ingest.IngestManager.removeIngestModuleEventListener(), and org.sleuthkit.autopsy.core.ServicesMonitor.removeSubscriber().

void org.sleuthkit.autopsy.events.AutopsyEventPublisher.removeSubscriber	(	String	eventName,
		PropertyChangeListener	subscriber
	)

Removes an event subscriber from this publisher.

Parameters

eventName	The event the subscriber is no longer interested in.
subscriber	The subscriber to remove.

Definition at line 131 of file AutopsyEventPublisher.java.

synchronized void org.sleuthkit.autopsy.events.AutopsyEventPublisher.stopRemotePublisher ( )

private

Stops the remote event publisher, but does not reset the current channel name.

Definition at line 184 of file AutopsyEventPublisher.java.

References org.sleuthkit.autopsy.events.AutopsyEventPublisher.currentChannelName, and org.sleuthkit.autopsy.events.AutopsyEventPublisher.remotePublisher.

Referenced by org.sleuthkit.autopsy.events.AutopsyEventPublisher.closeRemoteEventChannel(), and org.sleuthkit.autopsy.events.AutopsyEventPublisher.publishRemotely().

Member Data Documentation

String org.sleuthkit.autopsy.events.AutopsyEventPublisher.currentChannelName

private

Definition at line 48 of file AutopsyEventPublisher.java.

Referenced by org.sleuthkit.autopsy.events.AutopsyEventPublisher.closeRemoteEventChannel(), org.sleuthkit.autopsy.events.AutopsyEventPublisher.openRemoteEventChannel(), org.sleuthkit.autopsy.events.AutopsyEventPublisher.publishRemotely(), and org.sleuthkit.autopsy.events.AutopsyEventPublisher.stopRemotePublisher().

final LocalEventPublisher org.sleuthkit.autopsy.events.AutopsyEventPublisher.localPublisher

private

Definition at line 44 of file AutopsyEventPublisher.java.

final Logger org.sleuthkit.autopsy.events.AutopsyEventPublisher.logger = Logger.getLogger(AutopsyEventPublisher.class.getName())

staticprivate

Definition at line 42 of file AutopsyEventPublisher.java.

final int org.sleuthkit.autopsy.events.AutopsyEventPublisher.MAX_REMOTE_EVENT_PUBLISH_TRIES = 1

staticprivate

Definition at line 43 of file AutopsyEventPublisher.java.

RemoteEventPublisher org.sleuthkit.autopsy.events.AutopsyEventPublisher.remotePublisher

private

Definition at line 46 of file AutopsyEventPublisher.java.

Referenced by org.sleuthkit.autopsy.events.AutopsyEventPublisher.openRemoteEventChannel(), org.sleuthkit.autopsy.events.AutopsyEventPublisher.publishRemotely(), and org.sleuthkit.autopsy.events.AutopsyEventPublisher.stopRemotePublisher().

---

The documentation for this class was generated from the following file:

• /home/carriersleuth/repos/autopsy/Core/src/org/sleuthkit/autopsy/events/AutopsyEventPublisher.java