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

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

Classes
class	GeolocationViewModel

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

Protected Member Functions
void	fetchInformation (DataSource dataSource)
void	fetchInformation (List< DataFetchComponents< DataSource,?>> dataFetchComponents, DataSource dataSource)
MenuItem	getArtifactNavigateItem (BlackboardArtifact artifact)
synchronized DataSource	getDataSource ()
MenuItem	getFileNavigateItem (String path)
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)

Static Protected Member Functions
static< T > T	getFetchResult (DataFetcher< DataSource, T > dataFetcher, String sheetName, DataSource ds)

Private Member Functions
void	commonViewInGeolocationBtnActionPerformed (java.awt.event.ActionEvent evt)
GeolocationViewModel	convertToViewModel (CityData cityData)
void	disableNavButtons ()
List< Pair< String, Integer > >	formatList (CityCountsList countsList)
Pair< String, Integer >	formatRecord (CityRecordCount cityCount)
void	handleData (DataFetchResult< GeolocationViewModel > result)
void	initComponents ()
void	openGeolocationWindow (DataSource dataSource, Integer daysLimit)
void	recentViewInGeolocationBtnActionPerformed (java.awt.event.ActionEvent evt)
void	showCityContent (DataFetchResult< List< Pair< String, Integer >>> 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 DataFetcher< DataSource, GeolocationViewModel >	geolocationFetcher
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 GeolocationSummaryGetter	whereUsedData

Static Private Attributes
static final ColumnModel< Pair< String, Integer >, DefaultCellModel<?> >	CITY_COL
static final ColumnModel< Pair< String, Integer >, DefaultCellModel<?> >	COUNT_COL
static final int	DAYS_COUNT = 30
static final List< ColumnModel< Pair< String, Integer >, DefaultCellModel<?> > >	DEFAULT_TEMPLATE
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 66 of file GeolocationPanel.java.

Constructor & Destructor Documentation

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

(

)

Main constructor.

Definition at line 155 of file GeolocationPanel.java.

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

(

GeolocationSummaryGetter

whereUsedData

)

Main constructor.

Parameters

whereUsedData

The GeolocationSummaryGetter instance to use.

Definition at line 164 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationSummaryGetter.getCityCounts().

Member Function Documentation

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

(

)

Definition at line 355 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 483 of file GeolocationPanel.java.

GeolocationViewModel org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.convertToViewModel ( CityData  cityData )

private

Converts CityData from GeolocationSummaryGetter into data that can be directly put into table in this panel.

Parameters

cityData

The city data.

Returns

The view model data.

Definition at line 274 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.datamodel.GeolocationSummary.CityData.getMostCommon(), and org.sleuthkit.autopsy.datasourcesummary.datamodel.GeolocationSummary.CityData.getMostRecent().

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

private

Disables navigation buttons.

Definition at line 337 of file GeolocationPanel.java.

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

protected

Definition at line 343 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 426 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 246 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 226 of file GeolocationPanel.java.

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

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 255 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 198 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 386 of file BaseDataSourceSummaryPanel.java.

static <T> T org.sleuthkit.autopsy.datasourcesummary.ui.BaseDataSourceSummaryPanel.getFetchResult ( DataFetcher< DataSource, T >  dataFetcher, String  sheetName, DataSource  ds  )

staticprotectedinherited

Runs a data fetcher and returns the result handling any possible errors with a log message.

Parameters

dataFetcher	The means of fetching the data.
sheetName	The name of the sheet.
ds	The data source.

Returns

The fetched data.

Definition at line 460 of file BaseDataSourceSummaryPanel.java.

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 303 of file BaseDataSourceSummaryPanel.java.

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 331 of file BaseDataSourceSummaryPanel.java.

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

private

Means of rendering data to be shown in the tables.

Parameters

result

The result of fetching data for a data source and processing into view model data.

Definition at line 186 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 367 of file GeolocationPanel.java.

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

protectedinherited

Sends event that parent should close.

Definition at line 368 of file BaseDataSourceSummaryPanel.java.

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

protected

Definition at line 349 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 484 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 305 of file GeolocationPanel.java.

References org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationSummaryGetter.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 479 of file GeolocationPanel.java.

void org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.showCityContent ( DataFetchResult< List< Pair< String, Integer >>>  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 289 of file GeolocationPanel.java.

References 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 396 of file BaseDataSourceSummaryPanel.java.

Member Data Documentation

final ColumnModel<Pair<String, Integer>, DefaultCellModel<?> > 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 113 of file GeolocationPanel.java.

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

private

Definition at line 489 of file GeolocationPanel.java.

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

staticprivate

Initial value:

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

Definition at line 120 of file GeolocationPanel.java.

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

private

Definition at line 144 of file GeolocationPanel.java.

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

staticprivate

Definition at line 109 of file GeolocationPanel.java.

final List<ColumnModel<Pair<String, Integer>, DefaultCellModel<?> > > org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.DEFAULT_TEMPLATE

staticprivate

Initial value:

= Arrays.asList(
            CITY_COL,
            COUNT_COL
    )

Definition at line 126 of file GeolocationPanel.java.

final DataFetcher<DataSource, GeolocationViewModel> org.sleuthkit.autopsy.datasourcesummary.ui.GeolocationPanel.geolocationFetcher

private

Definition at line 150 of file GeolocationPanel.java.

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

private

Definition at line 146 of file GeolocationPanel.java.

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

private

Definition at line 141 of file GeolocationPanel.java.

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

staticprivate

Definition at line 110 of file GeolocationPanel.java.

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

private

Initial value:

= JTablePanel.getJTablePanel(DEFAULT_TEMPLATE)
            .setKeyFunction((pair) -> pair.getLeft())

Definition at line 132 of file GeolocationPanel.java.

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

private

Initial value:

= JTablePanel.getJTablePanel(DEFAULT_TEMPLATE)
            .setKeyFunction((pair) -> pair.getLeft())

Definition at line 135 of file GeolocationPanel.java.

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

private

Definition at line 490 of file GeolocationPanel.java.

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

staticprivate

Definition at line 108 of file GeolocationPanel.java.

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

private

Definition at line 139 of file GeolocationPanel.java.

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

private

Definition at line 148 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