Package ghidra.plugin.importer
Class ImporterUtilities
java.lang.Object
ghidra.plugin.importer.ImporterUtilities
Utilities for importing files.
Note: if a method takes a TaskMonitor
, then that method should only be called
from a background task.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final GhidraFileFilter
File extension filter for well known 'container' files for GhidraFileChoosers.static final GhidraFileFilter
File extension filter for well known 'loadable' files for GhidraFileChoosers. -
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic void
addContentToProgram
(PluginTool tool, Program program, FSRL fsrl, LoadSpec loadSpec, List<Option> options, TaskMonitor monitor) static void
importSingleFile
(PluginTool tool, ProgramManager programManager, FSRL fsrl, DomainFolder destFolder, LoadSpec loadSpec, String programName, List<Option> options, TaskMonitor monitor) Perform file import and open using optional programManagerstatic void
showAddToProgramDialog
(FSRL fsrl, Program program, PluginTool tool, TaskMonitor monitor) static void
showImportDialog
(PluginTool tool, ProgramManager programManager, FSRL fsrl, DomainFolder destinationFolder, String suggestedPath) Displays the appropriate import dialog for the specifiedfile
.static void
showImportDialog
(PluginTool tool, ProgramManager programManager, FSRL fsrl, DomainFolder destinationFolder, String suggestedPath, TaskMonitor monitor) Displays the appropriate import dialog for the specifiedfile
.static void
showImportSingleFileDialog
(FSRL fsrl, DomainFolder destinationFolder, String suggestedPath, PluginTool tool, ProgramManager programManager, TaskMonitor monitor) Constructs aImporterDialog
and shows it in the swing thread.
-
Field Details
-
LOADABLE_FILES_FILTER
File extension filter for well known 'loadable' files for GhidraFileChoosers. TODO: will be refactored to use file_extension_icon.xml file info. -
CONTAINER_FILES_FILTER
File extension filter for well known 'container' files for GhidraFileChoosers. TODO: will be refactored to use file_extension_icon.xml file info.
-
-
Constructor Details
-
ImporterUtilities
public ImporterUtilities()
-
-
Method Details
-
showImportDialog
public static void showImportDialog(PluginTool tool, ProgramManager programManager, FSRL fsrl, DomainFolder destinationFolder, String suggestedPath) Displays the appropriate import dialog for the specifiedfile
.If the file is a container of other files, a batch import dialog will be used, otherwise the normal single file import dialog will be shown.
- Parameters:
tool
-PluginTool
will be used as the parent tool for dialogsprogramManager
- optionalProgramManager
instance to use to open imported binaries with, or nullfsrl
-FSRL
of the file to importdestinationFolder
-DomainFolder
destination folder where the imported file will default to. (the user will be able to choose a different location)suggestedPath
- optional string path that will automatically be pre-pended to the destination filename
-
showImportDialog
public static void showImportDialog(PluginTool tool, ProgramManager programManager, FSRL fsrl, DomainFolder destinationFolder, String suggestedPath, TaskMonitor monitor) Displays the appropriate import dialog for the specifiedfile
.If the file is a container of other files, a batch import dialog will be used, otherwise the normal single file import dialog will be shown.]
If you are not in a monitored task, then call
showImportDialog(PluginTool, ProgramManager, FSRL, DomainFolder, String)
.- Parameters:
tool
-PluginTool
will be used as the parent tool for dialogsprogramManager
- optionalProgramManager
instance to use to open imported binaries with, or nullfsrl
-FSRL
of the file to importdestinationFolder
-DomainFolder
destination folder where the imported file will default to. (the user will be able to choose a different location)suggestedPath
- optional string path that will automatically be pre-pended to the destination filenamemonitor
- the task monitor to use for monitoring; cannot be null
-
showAddToProgramDialog
public static void showAddToProgramDialog(FSRL fsrl, Program program, PluginTool tool, TaskMonitor monitor) -
showImportSingleFileDialog
public static void showImportSingleFileDialog(FSRL fsrl, DomainFolder destinationFolder, String suggestedPath, PluginTool tool, ProgramManager programManager, TaskMonitor monitor) Constructs aImporterDialog
and shows it in the swing thread.- Parameters:
fsrl
- the file system resource locater (can be a simple file or an element of a more complex file such as a zip file)destinationFolder
- the default destination folder for the imported file. Can be nullsuggestedPath
- optional string path that will automatically be pre-pended to the destination filenametool
- the parent UI componentprogramManager
- optionalProgramManager
instance to open the imported file inmonitor
-TaskMonitor
-
importSingleFile
public static void importSingleFile(PluginTool tool, ProgramManager programManager, FSRL fsrl, DomainFolder destFolder, LoadSpec loadSpec, String programName, List<Option> options, TaskMonitor monitor) Perform file import and open using optional programManager- Parameters:
tool
- tool to which popup dialogs should be associatedprogramManager
- program manager to open imported file with or nullfsrl
- import file locationdestFolder
- project destination folderloadSpec
- importLoadSpec
programName
- program nameoptions
- import optionsmonitor
- task monitor
-
addContentToProgram
public static void addContentToProgram(PluginTool tool, Program program, FSRL fsrl, LoadSpec loadSpec, List<Option> options, TaskMonitor monitor)
-