org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel Class Reference

Inherits org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.

Public Member Functions
	GeolocationPanel ()
	GeolocationPanel (GeolocationSummary whereUsedData)
void	close ()

Protected Member Functions
void	fetchInformation (DataSource dataSource)
void	fetchInformation (List< DataFetchComponents< DataSource,?>> dataFetchComponents, DataSource dataSource)
CellModelTableCellRenderer.MenuItem	getArtifactNavigateItem (BlackboardArtifact artifact)
synchronized DataSource	getDataSource ()
CellModelTableCellRenderer.MenuItem	getFileNavigateItem (String path)
CellModelTableCellRenderer.MenuItem	getFileNavigateItem (AbstractFile file)
void	notifyParentClose ()
void	onNewDataSource (DataSource dataSource)
void	onNewDataSource (List< DataFetchComponents< DataSource,?>> dataFetchComponents, List<?extends LoadableComponent<?>> loadableComponents, DataSource dataSource)
void	submit (List<?extends SwingWorker<?,?>> workers)

Private Member Functions
void	commonViewInGeolocationBtnActionPerformed (java.awt.event.ActionEvent evt)
void	disableNavButtons ()
List< Pair< String, Integer > >	formatList (CityCountsList countsList)
Pair< String, Integer >	formatRecord (CityRecordCount cityCount)
void	handleData (DataFetchResult< CityData > result)
void	initComponents ()
void	openGeolocationWindow (DataSource dataSource, Integer daysLimit)
void	recentViewInGeolocationBtnActionPerformed (java.awt.event.ActionEvent evt)
void	showCityContent (DataFetchResult< CityCountsList > result, JTablePanel< Pair< String, Integer >> table, JButton goToGeolocation)

Static Private Member Functions
static String	getCityName (CityRecord record)

Private Attributes
javax.swing.JButton	commonViewInGeolocationBtn
final List< DataFetchComponents< DataSource,?> >	dataFetchComponents
final IngestRunningLabel	ingestRunningLabel = new IngestRunningLabel()
final Logger	logger = Logger.getLogger(GeolocationPanel.class.getName())
final JTablePanel< Pair< String, Integer > >	mostCommonTable
final JTablePanel< Pair< String, Integer > >	mostRecentTable
javax.swing.JButton	recentViewInGeolocationBtn
final List< JTablePanel<?> >	tables = Arrays.asList(mostCommonTable, mostRecentTable)
final GeolocationSummary	whereUsedData

Static Private Attributes
static final ColumnModel< Pair< String, Integer > >	CITY_COL
static final ColumnModel< Pair< String, Integer > >	COUNT_COL
static final int	DAYS_COUNT = 30
static final int	MAX_COUNT = 10
static final long	serialVersionUID = 1L

Detailed Description

A tab shown in data source summary displaying information about a data source's geolocation data.

Definition at line 63 of file GeolocationPanel.java.

Constructor & Destructor Documentation

org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.GeolocationPanel

(

)

Main constructor.

Definition at line 105 of file GeolocationPanel.java.

org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.GeolocationPanel

(

GeolocationSummary

whereUsedData

)

Main constructor.

Parameters

whereUsedData

The GeolocationSummary instance to use.

Definition at line 114 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.datamodel.GeolocationSummary.getCityCounts().

Member Function Documentation

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.close

(

)

Definition at line 283 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.uiutils.IngestRunningLabel.unregister().

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.commonViewInGeolocationBtnActionPerformed ( java.awt.event.ActionEvent  evt )

private

Definition at line 411 of file GeolocationPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.disableNavButtons ( )

private

Disables navigation buttons.

Definition at line 265 of file GeolocationPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.fetchInformation ( DataSource  dataSource )

protected

Definition at line 271 of file GeolocationPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.fetchInformation ( List< DataFetchComponents< DataSource,?>>  dataFetchComponents, DataSource  dataSource  )

protectedinherited

Utility method to be called when solely updating information (not showing a loading screen) that creates swing workers from the data source argument and data fetch components and then submits them to run.

Parameters

dataFetchComponents	The components to be run.
dataSource	The data source argument.

Definition at line 418 of file BaseDataSourceSummaryPanel.java.

List<Pair<String, Integer> > org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.formatList ( CityCountsList  countsList )

private

Formats a list of records to be displayed in a table (specifically, includes the count of points where no closest city could be determined as 'unknown').

Parameters

countsList

The CityCountsList object representing the data to be displayed in the table.

Returns

The list of city/count tuples to be displayed as a row.

Definition at line 189 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.datamodel.GeolocationSummary.CityCountsList.getCounts(), and org.sleuthkit.autopsy.datasourcesummary.datamodel.GeolocationSummary.CityCountsList.getOtherCount().

Pair<String, Integer> org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.formatRecord ( CityRecordCount  cityCount )

private

Formats one record to be displayed as a row in the table (specifically, formats the city name).

Parameters

cityCount

The CityRecordCount representing a row.

Returns

The city/count pair to be displayed as a row.

Definition at line 170 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.datamodel.GeolocationSummary.CityRecordCount.getCityRecord(), and org.sleuthkit.autopsy.datasourcesummary.datamodel.GeolocationSummary.CityRecordCount.getCount().

CellModelTableCellRenderer.MenuItem org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.getArtifactNavigateItem ( BlackboardArtifact  artifact )

protectedinherited

Given the relevant artifact, navigates to the artifact in the tree and closes data source summary dialog if open.

Parameters

artifact

The artifact.

Returns

The menu item for a go to artifact menu item.

Definition at line 247 of file BaseDataSourceSummaryPanel.java.

static String org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.getCityName ( CityRecord  record )

staticprivate

Retrieves the city name to display from the record.

Parameters

record

The record for the city to display.

Returns

The display name (city, country).

Definition at line 143 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.datamodel.CityRecord.getCityName(), org.sleuthkit.autopsy.datasourcesummary.datamodel.CityRecord.getCountry(), and org.sleuthkit.autopsy.datasourcesummary.datamodel.CityRecord.getState().

synchronized DataSource org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.getDataSource ( )

protectedinherited

Returns

The current data source.

Definition at line 378 of file BaseDataSourceSummaryPanel.java.

CellModelTableCellRenderer.MenuItem org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.getFileNavigateItem ( String  path )

protectedinherited

Creates a menu item to navigate to a file.

Parameters

path	The path to the file.

Returns

The menu item or null if file cannot be found in data source.

Definition at line 295 of file BaseDataSourceSummaryPanel.java.

CellModelTableCellRenderer.MenuItem org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.getFileNavigateItem ( AbstractFile  file )

protectedinherited

Given the relevant file, navigates to the file in the tree and closes data source summary dialog if open.

Parameters

file

The file.

Returns

The menu item list for a go to artifact menu item.

Definition at line 323 of file BaseDataSourceSummaryPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.handleData ( DataFetchResult< CityData >  result )

private

Means of rendering data to be shown in the tables.

Parameters

result

The result of fetching data for a data source.

Definition at line 132 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.uiutils.DataFetchResult< R >.getSubResult().

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.initComponents ( )

private

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 295 of file GeolocationPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.notifyParentClose ( )

protectedinherited

Sends event that parent should close.

Definition at line 360 of file BaseDataSourceSummaryPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.onNewDataSource ( DataSource  dataSource )

protected

Definition at line 277 of file GeolocationPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.onNewDataSource ( List< DataFetchComponents< DataSource,?>>  dataFetchComponents, List<?extends LoadableComponent<?>>  loadableComponents, DataSource  dataSource  )

protectedinherited

Utility method that shows a loading screen with loadable components, create swing workers from the datafetch components and data source argument and submits them to be executed.

Parameters

dataFetchComponents	The components to register.
loadableComponents	The components to set to a loading screen.
dataSource	The data source argument.

Definition at line 452 of file BaseDataSourceSummaryPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.openGeolocationWindow ( DataSource  dataSource, Integer  daysLimit  )

private

Action to open the geolocation window.

Parameters

dataSource	The data source for which the window should filter.
daysLimit	The limit for how recently the waypoints should be (for most recent table) or null for most recent filter to not be set (for most common table).

Definition at line 233 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.datamodel.GeolocationSummary.getGeoTypes(), org.sleuthkit.autopsy.geolocation.OpenGeolocationAction.performAction(), and org.sleuthkit.autopsy.geolocation.GeolocationTopComponent.setFilterState().

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.recentViewInGeolocationBtnActionPerformed ( java.awt.event.ActionEvent  evt )

private

Definition at line 407 of file GeolocationPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.showCityContent ( DataFetchResult< CityCountsList >  result, JTablePanel< Pair< String, Integer >>  table, JButton  goToGeolocation  )

private

Shows data in a particular table.

Parameters

result	The result to be displayed in the table.
table	The table where the data will be displayed.
goToGeolocation	The corresponding geolocation navigation button.

Definition at line 216 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.uiutils.DataFetchResult< R >.getData(), org.sleuthkit.autopsy.datasourcesummary.uiutils.DataFetchResult< R >.getResultType(), org.sleuthkit.autopsy.datasourcesummary.uiutils.DataFetchResult< R >.getSubResult(), and org.sleuthkit.autopsy.datasourcesummary.uiutils.DataFetchResult< R >.ResultType.SUCCESS.

void org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.submit ( List<?extends SwingWorker<?,?>>  workers )

protectedinherited

Submits the following swing workers for execution in sequential order. If there are any previous workers, those workers are cancelled.

Parameters

workers

The workers to submit for execution.

Definition at line 388 of file BaseDataSourceSummaryPanel.java.

Member Data Documentation

final ColumnModel<Pair<String, Integer> > org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.CITY_COL

staticprivate

Initial value:

= new ColumnModel<>(
            Bundle.GeolocationPanel_cityColumn_title(),
            (pair) -> new DefaultCellModel(pair.getLeft()),
            300
    )

Definition at line 70 of file GeolocationPanel.java.

javax.swing.JButton org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.commonViewInGeolocationBtn

private

Definition at line 417 of file GeolocationPanel.java.

final ColumnModel<Pair<String, Integer> > org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.COUNT_COL

staticprivate

Initial value:

= new ColumnModel<>(
            Bundle.GeolocationPanel_countColumn_title(),
            (pair) -> new DefaultCellModel(Integer.toString(pair.getRight())),
            100
    )

Definition at line 77 of file GeolocationPanel.java.

final List<DataFetchComponents<DataSource, ?> > org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.dataFetchComponents

private

Definition at line 96 of file GeolocationPanel.java.

final int org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.DAYS_COUNT = 30

staticprivate

Definition at line 66 of file GeolocationPanel.java.

final IngestRunningLabel org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.ingestRunningLabel = new IngestRunningLabel()

private

Definition at line 98 of file GeolocationPanel.java.

final Logger org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.logger = Logger.getLogger(GeolocationPanel.class.getName())

private

Definition at line 93 of file GeolocationPanel.java.

final int org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.MAX_COUNT = 10

staticprivate

Definition at line 67 of file GeolocationPanel.java.

final JTablePanel<Pair<String, Integer> > org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.mostCommonTable

private

Initial value:

= JTablePanel.getJTablePanel(Arrays.asList(CITY_COL, COUNT_COL))
            .setKeyFunction((pair) -> pair.getLeft())

Definition at line 84 of file GeolocationPanel.java.

final JTablePanel<Pair<String, Integer> > org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.mostRecentTable

private

Initial value:

= JTablePanel.getJTablePanel(Arrays.asList(CITY_COL, COUNT_COL))
            .setKeyFunction((pair) -> pair.getLeft())

Definition at line 87 of file GeolocationPanel.java.

javax.swing.JButton org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.recentViewInGeolocationBtn

private

Definition at line 418 of file GeolocationPanel.java.

final long org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.serialVersionUID = 1L

staticprivate

Definition at line 65 of file GeolocationPanel.java.

final List<JTablePanel<?> > org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.tables = Arrays.asList(mostCommonTable, mostRecentTable)

private

Definition at line 91 of file GeolocationPanel.java.

final GeolocationSummary org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.whereUsedData

private

Definition at line 100 of file GeolocationPanel.java.

---

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

• /home/carriersleuth/repos/autopsy/Core/src/org/sleuthkit/autopsy/datasourcesummary/ui/GeolocationPanel.java