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

Classes

class  CaseMetadataException
 

Public Member Functions

 CaseMetadata (Path metadataFilePath) throws CaseMetadataException
 
String getCaseDatabaseName ()
 
String getCaseDatabasePath () throws UnsupportedOperationException
 
CaseDetails getCaseDetails ()
 
String getCaseDirectory ()
 
String getCaseDisplayName ()
 
String getCaseName ()
 
String getCaseNotes ()
 
String getCaseNumber ()
 
Case.CaseType getCaseType ()
 
String getCreatedDate ()
 
String getExaminer ()
 
String getExaminerEmail ()
 
String getExaminerPhone ()
 
Path getFilePath ()
 
String getTextIndexName ()
 

Static Public Member Functions

static Path getCaseMetadataFilePath (Path directoryPath)
 
static DateFormat getDateFormat ()
 
static String getFileExtension ()
 

Private Member Functions

void createCaseElements (Document doc, Element caseElement, CaseMetadata metadataToWrite)
 
void createChildElement (Document doc, Element parentElement, String elementName, String elementContent)
 
void createXMLDOM (Document doc)
 
String getElementTextContent (Element parentElement, String elementName, boolean contentIsRequired) throws CaseMetadataException
 
void readFromFile () throws CaseMetadataException
 

Private Attributes

String caseDatabaseName
 
String caseDatabasePath
 
CaseDetails caseDetails
 
String caseName
 
Case.CaseType caseType
 
String createdByVersion
 
String createdDate
 
final Path metadataFilePath
 
CaseMetadata originalMetadata = null
 
String textIndexName
 

Static Private Attributes

static final String AUTOPSY_CREATED_BY_ELEMENT_NAME = "CreatedByAutopsyVersion"
 
static final String AUTOPSY_SAVED_BY_ELEMENT_NAME = "SavedByAutopsyVersion"
 
static final String AUTOPSY_VERSION_ELEMENT_NAME = "AutopsyCreatedVersion"
 
static final String CASE_DATABASE_NAME_ELEMENT_NAME = "DatabaseName"
 
static final String CASE_DB_ABSOLUTE_PATH_ELEMENT_NAME = "Database"
 
static final String CASE_DB_NAME_RELATIVE_ELEMENT_NAME = "CaseDatabase"
 
static final String CASE_DISPLAY_NAME_ELEMENT_NAME = "DisplayName"
 
static final String CASE_ELEMENT_NAME = "Case"
 
static final String CASE_ELEMENT_NOTES = "CaseNotes"
 
static final String CASE_NAME_ELEMENT_NAME = "Name"
 
static final String CASE_NUMBER_ELEMENT_NAME = "Number"
 
static final String CASE_TYPE_ELEMENT_NAME = "CaseType"
 
static final String CREATED_DATE_ELEMENT_NAME = "CreatedDate"
 
static final String CURRENT_SCHEMA_VERSION = SCHEMA_VERSION_FIVE
 
static final DateFormat DATE_FORMAT = new SimpleDateFormat(DATE_FORMAT_STRING, Locale.US)
 
static final String DATE_FORMAT_STRING = "yyyy/MM/dd HH:mm:ss (z)"
 
static final String EXAMINER_ELEMENT_EMAIL = "ExaminerEmail"
 
static final String EXAMINER_ELEMENT_NAME = "Examiner"
 
static final String EXAMINER_ELEMENT_PHONE = "ExaminerPhone"
 
static final String FILE_EXTENSION = ".aut"
 
static final String MODIFIED_DATE_ELEMENT_NAME = "ModifiedDate"
 
static final String ORIGINAL_CASE_ELEMENT_NAME = "OriginalCase"
 
static final String ROOT_ELEMENT_NAME = "AutopsyCase"
 
static final String SCHEMA_VERSION_ELEMENT_NAME = "SchemaVersion"
 
static final String SCHEMA_VERSION_FIVE = "5.0"
 
static final String SCHEMA_VERSION_FOUR = "4.0"
 
static final String SCHEMA_VERSION_ONE = "1.0"
 
static final String SCHEMA_VERSION_THREE = "3.0"
 
static final String SCHEMA_VERSION_TWO = "2.0"
 
static final String TEXT_INDEX_ELEMENT = "TextIndex"
 
static final String TEXT_INDEX_NAME_ELEMENT = "TextIndexName"
 

Detailed Description

Provides access to the case metadata stored in the case metadata file.

Definition at line 55 of file CaseMetadata.java.

Constructor & Destructor Documentation

◆ CaseMetadata()

org.sleuthkit.autopsy.casemodule.CaseMetadata.CaseMetadata ( Path  metadataFilePath) throws CaseMetadataException

Constructs a CaseMetadata object for an existing case. The metadata is read from an existing case metadata file.

Parameters
metadataFilePathThe full path to the case metadata file.
Exceptions
CaseMetadataExceptionIf the new case metadata file cannot be read.

Definition at line 190 of file CaseMetadata.java.

References org.sleuthkit.autopsy.casemodule.CaseMetadata.metadataFilePath, and org.sleuthkit.autopsy.casemodule.CaseMetadata.readFromFile().

Member Function Documentation

◆ createCaseElements()

void org.sleuthkit.autopsy.casemodule.CaseMetadata.createCaseElements ( Document  doc,
Element  caseElement,
CaseMetadata  metadataToWrite 
)
private

◆ createChildElement()

void org.sleuthkit.autopsy.casemodule.CaseMetadata.createChildElement ( Document  doc,
Element  parentElement,
String  elementName,
String  elementContent 
)
private

Creates an XML element for the case metadata XML DOM.

Parameters
docThe document.
parentElementThe parent element of the element to be created.
elementNameThe name of the element to be created.
elementContentThe text content of the element to be created, may be empty.

Definition at line 511 of file CaseMetadata.java.

Referenced by org.sleuthkit.autopsy.casemodule.CaseMetadata.createCaseElements(), and org.sleuthkit.autopsy.casemodule.CaseMetadata.createXMLDOM().

◆ createXMLDOM()

void org.sleuthkit.autopsy.casemodule.CaseMetadata.createXMLDOM ( Document  doc)
private

◆ getCaseDatabaseName()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseDatabaseName ( )

Gets the name of the case database.

Returns
The case database name, may be empty.

Definition at line 316 of file CaseMetadata.java.

References org.sleuthkit.autopsy.casemodule.CaseMetadata.caseDatabaseName.

Referenced by org.sleuthkit.autopsy.casemodule.Case.deleteMultiUserCaseDatabase(), and org.sleuthkit.autopsy.casemodule.Case.openCaseDataBase().

◆ getCaseDatabasePath()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseDatabasePath ( ) throws UnsupportedOperationException

Gets the full path to the case database file if the case is a single-user case.

Returns
The full path to the case database file for a single-user case.
Exceptions
UnsupportedOperationExceptionIf called for a multi-user case.
Deprecated:
Do not use.

Definition at line 669 of file CaseMetadata.java.

References org.sleuthkit.autopsy.casemodule.CaseMetadata.caseType, org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseDirectory(), and org.sleuthkit.autopsy.casemodule.Case.CaseType.SINGLE_USER_CASE.

◆ getCaseDetails()

CaseDetails org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseDetails ( )

Get current values for the case details which are user modifiable.

Returns
the case details

Definition at line 257 of file CaseMetadata.java.

References org.sleuthkit.autopsy.casemodule.CaseMetadata.caseDetails.

Referenced by org.sleuthkit.autopsy.casemodule.Case.getMetadata().

◆ getCaseDirectory()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseDirectory ( )

◆ getCaseDisplayName()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseDisplayName ( )

◆ getCaseMetadataFilePath()

static Path org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseMetadataFilePath ( Path  directoryPath)
static

Locate the case meta data file in the supplied directory. If the file does not exist, null is returned.

Parameters
directoryPathDirectory path to search.
Returns
Case metadata file path or null.

Definition at line 203 of file CaseMetadata.java.

References org.sleuthkit.autopsy.casemodule.CaseMetadata.getFileExtension().

Referenced by org.sleuthkit.autopsy.casemodule.multiusercases.CaseNodeData.getCaseMetadata().

◆ getCaseName()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseName ( )

◆ getCaseNotes()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseNotes ( )

◆ getCaseNumber()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseNumber ( )

Gets the case number.

Returns
The case number, may be empty.

Definition at line 286 of file CaseMetadata.java.

References org.sleuthkit.autopsy.casemodule.CaseDetails.getCaseNumber().

Referenced by org.sleuthkit.autopsy.casemodule.Case.getNumber().

◆ getCaseType()

Case.CaseType org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseType ( )

◆ getCreatedDate()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getCreatedDate ( )

◆ getDateFormat()

static DateFormat org.sleuthkit.autopsy.casemodule.CaseMetadata.getDateFormat ( )
static

◆ getElementTextContent()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getElementTextContent ( Element  parentElement,
String  elementName,
boolean  contentIsRequired 
) throws CaseMetadataException
private

Gets the text content of an XML element.

Parameters
parentElementThe parent element.
elementNameThe element name.
contentIsRequiredWhether or not the content is required.
Returns
The text content, may be empty If not required.
Exceptions
CaseMetadataExceptionIf the element is missing or content is required and it is empty.

Definition at line 630 of file CaseMetadata.java.

Referenced by org.sleuthkit.autopsy.casemodule.CaseMetadata.readFromFile().

◆ getExaminer()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getExaminer ( )

Gets the examiner.

Returns
The examiner, may be empty.

Definition at line 295 of file CaseMetadata.java.

References org.sleuthkit.autopsy.casemodule.CaseDetails.getExaminerName().

Referenced by org.sleuthkit.autopsy.casemodule.Case.getExaminer().

◆ getExaminerEmail()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getExaminerEmail ( )

◆ getExaminerPhone()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getExaminerPhone ( )

◆ getFileExtension()

static String org.sleuthkit.autopsy.casemodule.CaseMetadata.getFileExtension ( )
static

Gets the file extension used for case metadata files.

Returns
The file extension.

Definition at line 130 of file CaseMetadata.java.

References org.sleuthkit.autopsy.casemodule.CaseMetadata.FILE_EXTENSION.

Referenced by org.sleuthkit.autopsy.casemodule.CaseOpenAction.CaseOpenAction(), and org.sleuthkit.autopsy.casemodule.CaseMetadata.getCaseMetadataFilePath().

◆ getFilePath()

Path org.sleuthkit.autopsy.casemodule.CaseMetadata.getFilePath ( )

◆ getTextIndexName()

String org.sleuthkit.autopsy.casemodule.CaseMetadata.getTextIndexName ( )

Gets the text index name. This is a legacy field and will be empty for cases created with Autopsy 4.4.0 and above.

Returns
The name of the text index for the case, may be empty.

Definition at line 344 of file CaseMetadata.java.

References org.sleuthkit.autopsy.casemodule.CaseMetadata.textIndexName.

Referenced by org.sleuthkit.autopsy.casemodule.Case.getTextIndexName().

◆ readFromFile()

void org.sleuthkit.autopsy.casemodule.CaseMetadata.readFromFile ( ) throws CaseMetadataException
private

Member Data Documentation

◆ AUTOPSY_CREATED_BY_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.AUTOPSY_CREATED_BY_ELEMENT_NAME = "CreatedByAutopsyVersion"
staticprivate

Definition at line 81 of file CaseMetadata.java.

◆ AUTOPSY_SAVED_BY_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.AUTOPSY_SAVED_BY_ELEMENT_NAME = "SavedByAutopsyVersion"
staticprivate

Definition at line 110 of file CaseMetadata.java.

◆ AUTOPSY_VERSION_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.AUTOPSY_VERSION_ELEMENT_NAME = "AutopsyCreatedVersion"
staticprivate

Definition at line 68 of file CaseMetadata.java.

◆ CASE_DATABASE_NAME_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CASE_DATABASE_NAME_ELEMENT_NAME = "DatabaseName"
staticprivate

Definition at line 74 of file CaseMetadata.java.

◆ CASE_DB_ABSOLUTE_PATH_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CASE_DB_ABSOLUTE_PATH_ELEMENT_NAME = "Database"
staticprivate

Definition at line 82 of file CaseMetadata.java.

◆ CASE_DB_NAME_RELATIVE_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CASE_DB_NAME_RELATIVE_ELEMENT_NAME = "CaseDatabase"
staticprivate

Definition at line 90 of file CaseMetadata.java.

◆ CASE_DISPLAY_NAME_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CASE_DISPLAY_NAME_ELEMENT_NAME = "DisplayName"
staticprivate

Definition at line 89 of file CaseMetadata.java.

◆ CASE_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CASE_ELEMENT_NAME = "Case"
staticprivate

Definition at line 69 of file CaseMetadata.java.

◆ CASE_ELEMENT_NOTES

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CASE_ELEMENT_NOTES = "CaseNotes"
staticprivate

Definition at line 98 of file CaseMetadata.java.

◆ CASE_NAME_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CASE_NAME_ELEMENT_NAME = "Name"
staticprivate

Definition at line 70 of file CaseMetadata.java.

◆ CASE_NUMBER_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CASE_NUMBER_ELEMENT_NAME = "Number"
staticprivate

Definition at line 71 of file CaseMetadata.java.

◆ CASE_TYPE_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CASE_TYPE_ELEMENT_NAME = "CaseType"
staticprivate

Definition at line 73 of file CaseMetadata.java.

◆ caseDatabaseName

String org.sleuthkit.autopsy.casemodule.CaseMetadata.caseDatabaseName
private

◆ caseDatabasePath

String org.sleuthkit.autopsy.casemodule.CaseMetadata.caseDatabasePath
private

◆ caseDetails

CaseDetails org.sleuthkit.autopsy.casemodule.CaseMetadata.caseDetails
private

◆ caseName

String org.sleuthkit.autopsy.casemodule.CaseMetadata.caseName
private

◆ caseType

Case.CaseType org.sleuthkit.autopsy.casemodule.CaseMetadata.caseType
private

◆ CREATED_DATE_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CREATED_DATE_ELEMENT_NAME = "CreatedDate"
staticprivate

Definition at line 67 of file CaseMetadata.java.

◆ createdByVersion

String org.sleuthkit.autopsy.casemodule.CaseMetadata.createdByVersion
private

◆ createdDate

String org.sleuthkit.autopsy.casemodule.CaseMetadata.createdDate
private

◆ CURRENT_SCHEMA_VERSION

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.CURRENT_SCHEMA_VERSION = SCHEMA_VERSION_FIVE
staticprivate

Definition at line 112 of file CaseMetadata.java.

◆ DATE_FORMAT

final DateFormat org.sleuthkit.autopsy.casemodule.CaseMetadata.DATE_FORMAT = new SimpleDateFormat(DATE_FORMAT_STRING, Locale.US)
staticprivate

◆ DATE_FORMAT_STRING

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.DATE_FORMAT_STRING = "yyyy/MM/dd HH:mm:ss (z)"
staticprivate

Definition at line 58 of file CaseMetadata.java.

◆ EXAMINER_ELEMENT_EMAIL

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.EXAMINER_ELEMENT_EMAIL = "ExaminerEmail"
staticprivate

Definition at line 97 of file CaseMetadata.java.

◆ EXAMINER_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.EXAMINER_ELEMENT_NAME = "Examiner"
staticprivate

Definition at line 72 of file CaseMetadata.java.

◆ EXAMINER_ELEMENT_PHONE

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.EXAMINER_ELEMENT_PHONE = "ExaminerPhone"
staticprivate

Definition at line 96 of file CaseMetadata.java.

◆ FILE_EXTENSION

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.FILE_EXTENSION = ".aut"
staticprivate

◆ metadataFilePath

final Path org.sleuthkit.autopsy.casemodule.CaseMetadata.metadataFilePath
private

◆ MODIFIED_DATE_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.MODIFIED_DATE_ELEMENT_NAME = "ModifiedDate"
staticprivate

Definition at line 109 of file CaseMetadata.java.

◆ ORIGINAL_CASE_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.ORIGINAL_CASE_ELEMENT_NAME = "OriginalCase"
staticprivate

Definition at line 104 of file CaseMetadata.java.

◆ originalMetadata

CaseMetadata org.sleuthkit.autopsy.casemodule.CaseMetadata.originalMetadata = null
private

◆ ROOT_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.ROOT_ELEMENT_NAME = "AutopsyCase"
staticprivate

Definition at line 65 of file CaseMetadata.java.

◆ SCHEMA_VERSION_ELEMENT_NAME

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.SCHEMA_VERSION_ELEMENT_NAME = "SchemaVersion"
staticprivate

Definition at line 66 of file CaseMetadata.java.

◆ SCHEMA_VERSION_FIVE

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.SCHEMA_VERSION_FIVE = "5.0"
staticprivate

Definition at line 103 of file CaseMetadata.java.

◆ SCHEMA_VERSION_FOUR

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.SCHEMA_VERSION_FOUR = "4.0"
staticprivate

Definition at line 95 of file CaseMetadata.java.

◆ SCHEMA_VERSION_ONE

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.SCHEMA_VERSION_ONE = "1.0"
staticprivate

◆ SCHEMA_VERSION_THREE

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.SCHEMA_VERSION_THREE = "3.0"
staticprivate

Definition at line 88 of file CaseMetadata.java.

◆ SCHEMA_VERSION_TWO

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.SCHEMA_VERSION_TWO = "2.0"
staticprivate

◆ TEXT_INDEX_ELEMENT

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.TEXT_INDEX_ELEMENT = "TextIndex"
staticprivate

Definition at line 83 of file CaseMetadata.java.

◆ TEXT_INDEX_NAME_ELEMENT

final String org.sleuthkit.autopsy.casemodule.CaseMetadata.TEXT_INDEX_NAME_ELEMENT = "TextIndexName"
staticprivate

Definition at line 75 of file CaseMetadata.java.

◆ textIndexName

String org.sleuthkit.autopsy.casemodule.CaseMetadata.textIndexName
private

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

Copyright © 2012-2022 Basis Technology. Generated on: Mon Apr 17 2023
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.