Autopsy  4.19.3
Graphical digital forensics platform for The Sleuth Kit and other tools.
Public Member Functions | Static Public Member Functions | Protected Member Functions | Private Member Functions | Static Private Member Functions | Private Attributes | Static Private Attributes | List of all members
org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent Class Reference

Inherits TopComponent, org.sleuthkit.autopsy.corecomponentinterfaces.DataExplorer, and Provider.

Public Member Functions

void addOnFinishedListener (PropertyChangeListener l)
boolean canClose ()
void componentClosed ()
void componentOpened ()
Action[] getActions ()
DataResultTopComponent getDirectoryListing ()
ExplorerManager getExplorerManager ()
int getPersistenceType ()
Node getSelectedNode ()
boolean getShowRejectedResults ()
TopComponent getTopComponent ()
boolean hasMenuOpenAction ()
void openDirectoryListing ()
void propertyChange (PropertyChangeEvent event)
void refreshContentTreeSafe ()
void setDirectoryListingActive ()
void setShowRejectedResults (boolean showRejectedResults)
void viewArtifact (final BlackboardArtifact art)
void viewArtifactContent (BlackboardArtifact art)
void viewOsAccount (OsAccount osAccount)

Static Public Member Functions

static synchronized DirectoryTreeTopComponent findInstance ()
static synchronized DirectoryTreeTopComponent getDefault ()

Protected Member Functions

String preferredID ()

Private Member Functions

 DirectoryTreeTopComponent ()
void backButtonActionPerformed (java.awt.event.ActionEvent evt)
void forwardButtonActionPerformed (java.awt.event.ActionEvent evt)
Node getAccountNode (Children typesChildren, BlackboardArtifact art)
Optional< Node > getCategoryNode (Category category, BlackboardArtifact art)
Optional< Node > getCategoryNodeChild (Children children, Category category)
Node getCreditCardAccountNode (Children accountRootChildren, String ccNumberName)
Node getEmailNode (Children typesChildren, BlackboardArtifact art)
Node getHashsetNode (Children typesChildren, final BlackboardArtifact art)
List< Node > getHostNodesAndParents (Node node)
Node getInterestingItemNode (Children typesChildren, BlackboardArtifact.Type artifactType, BlackboardArtifact art)
Node getKeywordHitNode (Children typesChildren, BlackboardArtifact art)
Optional< Node > getOsAccountListNode (Node node, OsAccount osAccount, Set< Host > hosts)
Optional< BlackboardArtifact.Type > getType (long artifactTypeId)
void initComponents ()
void openViewPreferencesButtonActionPerformed (java.awt.event.ActionEvent evt)
void preExpandNodes (Children rootChildren)
void promptForDataSourceGrouping (int dataSourceCount)
void readPropertiesImpl (java.util.Properties p)
void rebuildTree ()
void refreshTagsTree ()
void resetHistory ()
Optional< Node > searchForCategoryNode (Node node, long dataSourceId, Category category)
void setSelectedNode (final String[] previouslySelectedNodePath, final String rootNodeName)
void subscribeToChangeEvents ()
void updateHistory (Node[] selectedNodes)

Static Private Member Functions

static boolean caseHasData (Case currentCase)

Private Attributes

Accounts accounts
AutopsyTreeChildFactory autopsyTreeChildFactory
Children autopsyTreeChildren
javax.swing.JButton backButton
final LinkedList< String[]> backList
final DataResultTopComponent dataResult = new DataResultTopComponent(Bundle.DirectoryTreeTopComponent_resultsView_title())
final transient ExplorerManager em = new ExplorerManager()
javax.swing.JButton forwardButton
final LinkedList< String[]> forwardList
javax.swing.JButton openViewPreferencesButton
boolean showRejectedResults
javax.swing.JScrollPane treeView
final ViewPreferencesPanel viewPreferencesPanel = new ViewPreferencesPanel(true)
javax.swing.JPopupMenu viewPreferencesPopupMenu

Static Private Attributes

static final String GROUPING_THRESHOLD_NAME = "GroupDataSourceThreshold"
static DirectoryTreeTopComponent instance
static final Logger LOGGER = Logger.getLogger(DirectoryTreeTopComponent.class.getName())
static final Set< String > NODES_TO_EXPAND
static final String PREFERRED_ID = "DirectoryTreeTopComponent"
static final String SETTINGS_FILE = ""

Detailed Description

Top component which displays something.

Definition at line 112 of file

Constructor & Destructor Documentation

org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.DirectoryTreeTopComponent ( )

the constructor

Definition at line 137 of file

Member Function Documentation

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.addOnFinishedListener ( PropertyChangeListener  l)

Definition at line 1668 of file

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.backButtonActionPerformed ( java.awt.event.ActionEvent  evt)

Definition at line 388 of file

boolean org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.canClose ( )
static boolean org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.caseHasData ( Case  currentCase)

Identify if the specified case has data.

currentCaseThe case you are checking for data.
True if the case exists and has data, false otherwise.

Definition at line 1057 of file

References org.sleuthkit.autopsy.casemodule.Case.hasData.

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.componentClosed ( )

Called only when top component was closed so that now it is closed on all workspaces in the system. The intent is to provide subclasses information about TopComponent's life cycle across workspaces. Subclasses will usually perform cleaning tasks here.

Definition at line 681 of file

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.componentOpened ( )

Called only when top component was closed on all workspaces before and now is opened for the first time on some workspace. The intent is to provide subclasses information about TopComponent's life cycle across all existing workspaces. Subclasses will usually perform initializing tasks here.

to override the right click action in the white blank space area on the directory tree window

Definition at line 529 of file

References org.sleuthkit.autopsy.coreutils.ModuleSettings.getConfigSetting(), org.sleuthkit.autopsy.casemodule.Case.getCurrentCaseThrows(), org.sleuthkit.autopsy.casemodule.Case.getDataSources(), org.sleuthkit.autopsy.casemodule.CasePreferences.getGroupItemsInTreeByDataSource(), org.sleuthkit.autopsy.casemodule.Case.getName(), org.sleuthkit.autopsy.coreutils.ModuleSettings.MAIN_SETTINGS,, org.sleuthkit.autopsy.core.RuntimeProperties.runningWithGUI, org.sleuthkit.autopsy.coreutils.ModuleSettings.setConfigSetting(), and org.sleuthkit.autopsy.coreutils.ModuleSettings.settingExists().

static synchronized DirectoryTreeTopComponent org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.findInstance ( )
void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.forwardButtonActionPerformed ( java.awt.event.ActionEvent  evt)

Definition at line 417 of file

Node org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getAccountNode ( Children  typesChildren,
BlackboardArtifact  art 

Returns the account artifact's parent node or null if cannot be found.

typesChildrenThe children object of the same category as the account.
artThe artifact.
The account artifact's parent node or null if cannot be found.

Definition at line 1578 of file

Action [] org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getActions ( )

Right click action for this top component window

actions the list of actions

Definition at line 747 of file

Optional<Node> org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getCategoryNode ( Category  category,
BlackboardArtifact  art 

Finds the category node (i.e. Data Artifacts / Analysis Results) for the specific artifact and category.

categoryThe category of the artifact.
artThe artifact to find the relevant Results Node.
The category node or empty.

Definition at line 1202 of file

Optional<Node> org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getCategoryNodeChild ( Children  children,
Category  category 

Returns the node matching the given category that is an immediate child of the provided Children object or empty if no immediate child matches the given category.

childrenThe children to search.
categoryThe category to find.
The node matching the given category

Definition at line 1140 of file

References org.sleuthkit.autopsy.datamodel.DataArtifacts.getName(), and org.sleuthkit.autopsy.datamodel.AnalysisResults.getName().

Node org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getCreditCardAccountNode ( Children  accountRootChildren,
String  ccNumberName 

Returns the credit card artifact's parent node or null if cannot be found.

The credit card artifact's parent node or null if cannot be found.

Definition at line 1620 of file

References org.sleuthkit.autopsy.datamodel.CreditCards.getBINInfo().

static synchronized DirectoryTreeTopComponent org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getDefault ( )
DataResultTopComponent org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getDirectoryListing ( )

Definition at line 273 of file

Node org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getEmailNode ( Children  typesChildren,
BlackboardArtifact  art 

Returns the email artifact's parent node or null if cannot be found.

typesChildrenThe children object of the same category as email.
artThe artifact.
The email artifact's parent node or null if cannot be found.

Definition at line 1544 of file

References org.sleuthkit.autopsy.datamodel.EmailExtracted.parsePath().

ExplorerManager org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getExplorerManager ( )

Gets the explorer manager.

the explorer manager

Definition at line 737 of file

Referenced by org.sleuthkit.autopsy.directorytree.ViewContextAction.actionPerformed().

Node org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getHashsetNode ( Children  typesChildren,
final BlackboardArtifact  art 

Returns the hashset hit artifact's parent node or null if cannot be found.

typesChildrenThe children object of the same category as hashset hits.
artThe artifact.
The hashset hit artifact's parent node or null if cannot be found.

Definition at line 1406 of file

List<Node> org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getHostNodesAndParents ( Node  node)

Returns all nodes including provided node that are parents of or are hosts.

nodeThe parent or possible host node.
The descendant host nodes.

Definition at line 213 of file

References org.sleuthkit.autopsy.datamodel.PersonNode.getUnknownPersonId().

Node org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getInterestingItemNode ( Children  typesChildren,
BlackboardArtifact.Type  artifactType,
BlackboardArtifact  art 

Returns the interesting item artifact's parent node or null if cannot be found.

typesChildrenThe children object of the same category as interesting item.
artifactTypeThe type of the artifact (interesting hit or artifact).
artThe artifact.
The interesting item artifact's parent node or null if cannot be found.

Definition at line 1501 of file

Node org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getKeywordHitNode ( Children  typesChildren,
BlackboardArtifact  art 

Returns the keyword hit artifact's parent node or null if cannot be found.

typesChildrenThe children object of the same category as keyword hits.
artThe artifact.
The keyword hit artifact's parent node or null if cannot be found.

Definition at line 1436 of file

Optional<Node> org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getOsAccountListNode ( Node  node,
OsAccount  osAccount,
Set< Host >  hosts 

Does depth-first search to find os account list node where the provided os account is a child.

nodeThe node.
osAccountThe os account.
hostsList of hosts.
The parent list node of the os account if found or empty if not.

Definition at line 1236 of file

References org.sleuthkit.autopsy.datamodel.OsAccounts.getListName(), and org.sleuthkit.autopsy.datamodel.PersonNode.getUnknownPersonId().

int org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getPersistenceType ( )

Overwrite when you want to change default persistence type. Default persistence type is PERSISTENCE_ALWAYS


Definition at line 495 of file

Node org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getSelectedNode ( )

Gets the original selected node on the explorer manager

node the original selected Node

Definition at line 756 of file

Referenced by org.sleuthkit.autopsy.directorytree.ViewContextAction.setNodeSelection().

boolean org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getShowRejectedResults ( )

Show rejected results?

True if showing rejected results; otherwise false.

Definition at line 282 of file

Referenced by org.sleuthkit.autopsy.corecomponents.ViewPreferencesPanel.load().

TopComponent org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getTopComponent ( )

Gets the TopComponent for rendering this DateExplorer

the DataExplorer's TopComponent

Implements org.sleuthkit.autopsy.corecomponentinterfaces.DataExplorer.

Definition at line 1121 of file

Referenced by org.sleuthkit.autopsy.corecomponentinterfaces.CoreComponentControl.openCoreWindows().

Optional<BlackboardArtifact.Type> org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.getType ( long  artifactTypeId)

Attempts to retrieve the artifact type for the given artifact type id.

artifactTypeIdThe artifact type id.
The artifact type if present or empty if not found.

Definition at line 1313 of file

References org.sleuthkit.autopsy.casemodule.Case.getCurrentCaseThrows(), and org.sleuthkit.autopsy.casemodule.Case.getSleuthkitCase().

boolean org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.hasMenuOpenAction ( )
void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.initComponents ( )

This method is called from within the constructor to initialize the form. WARNING: Do NOT modify this code. The content of this method is always regenerated by the Form Editor.

Definition at line 305 of file

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.openDirectoryListing ( )
void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.openViewPreferencesButtonActionPerformed ( java.awt.event.ActionEvent  evt)
void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.preExpandNodes ( Children  rootChildren)

Pre-expands the Views node, the Results node, and all of the children of the Results node.

rootChildrenChildren node containing Results node and Views node.

Definition at line 183 of file

References org.sleuthkit.autopsy.casemodule.CasePreferences.getGroupItemsInTreeByDataSource().

String org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.preferredID ( )

Returns the unique ID of this TopComponent

PREFERRED_ID the unique ID of this TopComponent

Definition at line 712 of file

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.promptForDataSourceGrouping ( int  dataSourceCount)

Ask the user if they want to group by data source when opening a large case.

dataSourceCountThe number of data sources in the case.

Definition at line 505 of file

References org.sleuthkit.autopsy.casemodule.CasePreferences.getGroupItemsInTreeByDataSource(), and org.sleuthkit.autopsy.casemodule.CasePreferences.setGroupItemsInTreeByDataSource().

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.propertyChange ( PropertyChangeEvent  event)

The "listener" that monitors changes made in the Case class. This serves the purpose of keeping the UI in sync with the data as it changes.

eventThe property change event.

Checking for a current case is a stop gap measure until a different way of handling the closing of cases is worked out. Currently, remote events may be received for a case that is already closed.

Case is closed, do nothing.

Definition at line 773 of file

References org.sleuthkit.autopsy.casemodule.Case.Events.CURRENT_CASE, org.sleuthkit.autopsy.casemodule.Case.Events.DATA_SOURCE_ADDED, org.sleuthkit.autopsy.casemodule.Case.getCurrentCaseThrows(), org.sleuthkit.autopsy.casemodule.Case.getName(), org.sleuthkit.autopsy.corecomponentinterfaces.CoreComponentControl.openCoreWindows(), and org.sleuthkit.autopsy.core.RuntimeProperties.runningWithGUI.

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.readPropertiesImpl ( java.util.Properties  p)

Definition at line 701 of file

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.rebuildTree ( )

Rebuilds the autopsy tree.

Does nothing if there is no open case.

Definition at line 1011 of file

References org.sleuthkit.autopsy.casemodule.Case.getCurrentCaseThrows(), and org.sleuthkit.autopsy.datamodel.AutopsyTreeChildFactory.refreshChildren().

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.refreshContentTreeSafe ( )

Refresh the content node part of the dir tree safely in the EDT thread

Definition at line 975 of file

Referenced by org.sleuthkit.autopsy.casemodule.CasePreferences.setGroupItemsInTreeByDataSource().

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.refreshTagsTree ( )
void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.resetHistory ( )

Resets the back and forward list, and also disable the back and forward buttons.

Definition at line 955 of file

Optional<Node> org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.searchForCategoryNode ( Node  node,
long  dataSourceId,
Category  category 

Does depth first search of node while nodes are Host, Person, or DataSourcesByType looking for the appropriate category Node (i.e. the Data Artifacts or Analysis Results nodes).

nodeThe node.
dataSourceIdThe data source id.
categoryThe artifact type category.
The child nodes that are at the data source level.

Definition at line 1163 of file

References org.sleuthkit.autopsy.datamodel.PersonNode.getUnknownPersonId().

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.setDirectoryListingActive ( )
void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.setSelectedNode ( final String[]  previouslySelectedNodePath,
final String  rootNodeName 

Set the selected node using a path to a previously selected node.

previouslySelectedNodePathPath to a previously selected node.
rootNodeNameName of the root node to match, may be null.

Definition at line 1075 of file

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.setShowRejectedResults ( boolean  showRejectedResults)

Setter to determine if rejected results should be shown or not.

showRejectedResultsTrue if showing rejected results; otherwise false.

Definition at line 292 of file

References org.sleuthkit.autopsy.datamodel.accounts.Accounts.setShowRejected().

Referenced by org.sleuthkit.autopsy.corecomponents.ViewPreferencesPanel.hideRejectedResultsCheckboxActionPerformed(), and

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.subscribeToChangeEvents ( )
void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.updateHistory ( Node[]  selectedNodes)

Definition at line 916 of file

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.viewArtifact ( final BlackboardArtifact  art)

Navigates to artifact and shows in view.

NOTE: This code will likely need updating in the event that the structure of the nodes is changed (i.e. adding parent levels). Places to look when changing node structure include:

DirectoryTreeTopComponent.viewArtifact, ViewContextAction

artThe artifact.

("deprecation") - we need to support already existing interesting file and artifact hits.

Definition at line 1339 of file

References org.sleuthkit.autopsy.datamodel.DisplayableItemNode.setChildNodeSelectionInfo().

Referenced by org.sleuthkit.autopsy.actions.ViewArtifactAction.actionPerformed(), org.sleuthkit.autopsy.contentviewers.contextviewer.ContextSourcePanel.jSourceGoToResultButtonActionPerformed(), and org.sleuthkit.autopsy.contentviewers.contextviewer.ContextUsagePanel.jUsageGoToResultButtonActionPerformed().

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.viewArtifactContent ( BlackboardArtifact  art)

Definition at line 1662 of file

void org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.viewOsAccount ( OsAccount  osAccount)

Member Data Documentation

Accounts org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.accounts

Definition at line 124 of file

AutopsyTreeChildFactory org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.autopsyTreeChildFactory

Definition at line 122 of file

Children org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.autopsyTreeChildren

Definition at line 123 of file

javax.swing.JButton org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.backButton

Definition at line 443 of file

final LinkedList<String[]> org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.backList

Definition at line 118 of file

final DataResultTopComponent org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.dataResult = new DataResultTopComponent(Bundle.DirectoryTreeTopComponent_resultsView_title())

Definition at line 116 of file

final long org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.DEFAULT_DATASOURCE_GROUPING_THRESHOLD = 5

Definition at line 126 of file

final transient ExplorerManager org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.em = new ExplorerManager()

Definition at line 114 of file

javax.swing.JButton org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.forwardButton

Definition at line 444 of file

final LinkedList<String[]> org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.forwardList

Definition at line 119 of file

final String org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.GROUPING_THRESHOLD_NAME = "GroupDataSourceThreshold"

Definition at line 127 of file

DirectoryTreeTopComponent org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.instance

Definition at line 115 of file

final Logger org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.LOGGER = Logger.getLogger(DirectoryTreeTopComponent.class.getName())

Definition at line 121 of file

final Set<String> org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.NODES_TO_EXPAND
Initial value:
= Stream.of(AnalysisResults.getName(), DataArtifacts.getName(), ViewsNode.NAME)

Definition at line 131 of file

javax.swing.JButton org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.openViewPreferencesButton

Definition at line 445 of file

final String org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.PREFERRED_ID = "DirectoryTreeTopComponent"

Definition at line 120 of file

final String org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.SETTINGS_FILE = ""

Definition at line 128 of file

boolean org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.showRejectedResults

Definition at line 125 of file

javax.swing.JScrollPane org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.treeView

Definition at line 446 of file

final ViewPreferencesPanel org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.viewPreferencesPanel = new ViewPreferencesPanel(true)

Definition at line 117 of file

javax.swing.JPopupMenu org.sleuthkit.autopsy.directorytree.DirectoryTreeTopComponent.viewPreferencesPopupMenu

Definition at line 447 of file

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

Copyright © 2012-2022 Basis Technology. Generated on: Thu Sep 29 2022
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.