Package ghidra.program.model.data
Class BuiltInDataTypeManager
java.lang.Object
ghidra.program.database.data.DataTypeManagerDB
ghidra.program.model.data.StandAloneDataTypeManager
ghidra.program.model.data.BuiltInDataTypeManager
- All Implemented Interfaces:
DataTypeManager
Data type manager for built in types that do not live anywhere except
in memory.
-
Field Summary
Fields inherited from class ghidra.program.model.data.StandAloneDataTypeManager
name
Fields inherited from class ghidra.program.database.data.DataTypeManagerDB
addrMap, dataOrganization, dbHandle, defaultListener, errHandler, lock, sourceArchiveAdapter, universalID
Fields inherited from interface ghidra.program.model.data.DataTypeManager
BAD_DATATYPE_ID, BUILT_IN_ARCHIVE_KEY, BUILT_IN_ARCHIVE_UNIVERSAL_ID, BUILT_IN_DATA_TYPES_NAME, DEFAULT_DATATYPE_ID, LOCAL_ARCHIVE_KEY, LOCAL_ARCHIVE_UNIVERSAL_ID, NULL_DATATYPE_ID
-
Method Summary
Modifier and TypeMethodDescriptionaddDataType
(DataType originalDataType, DataTypeConflictHandler handler) Returns a data type after adding it to this data manager.void
associateDataTypeWithArchive
(DataType datatype, SourceArchive archive) Change the given data type so that its source archive is the given archivevoid
close()
Closes this dataType managercreateCategory
(CategoryPath path) Create a category for the given path; returns the current category if it already exitsvoid
endTransaction
(int transactionID, boolean commit) Ends the current transactionstatic BuiltInDataTypeManager
Returns shared instance of built-in data type manager.getType()
Returns this manager's archive typeprotected void
Add the built in data types to the default built in folder if they were not found in any other category.boolean
remove
(DataType dataType, TaskMonitor monitor) Remove the given datatype from this managerreplaceDataType
(DataType existingDt, DataType replacementDt, boolean updateCategoryPath) Replace an existing dataType with another.resolve
(DataType dataType, DataTypeConflictHandler handler) Returns a dataType that is "in" (ie suitable implementation) this Manager, creating a new one if necessary.protected UniversalID
resolveSourceArchiveID
(DataType dataType) void
Sets this data type manager's nameint
startTransaction
(String description) Starts a transaction for making changes in this data type manager.Methods inherited from class ghidra.program.model.data.StandAloneDataTypeManager
deleteDataTypeIDs, finalize, flushEvents, getDataOrganization, getDomainFileID, getName, getPath, replaceDataTypeIDs
Methods inherited from class ghidra.program.database.data.DataTypeManagerDB
addDataTypeManagerListener, addDataTypes, addDataTypeToDelete, addInvalidatedListener, allowsDefaultBuiltInSettings, allowsDefaultComponentSettings, categoryCreated, categoryMoved, categoryRemoved, categoryRenamed, contains, containsCategory, dataTypeAdded, dataTypeChanged, dataTypeDeleted, dataTypeMoved, dataTypeNameChanged, dataTypeReplaced, dataTypeSettingsChanged, dbError, disassociate, dispose, doSourceArchiveUpdates, favoritesChanged, findDataType, findDataTypeForID, findDataTypes, findDataTypes, findEnumValueNames, fixupComposites, getAllComposites, getAllDataTypes, getAllDataTypes, getAllStructures, getCategory, getCategory, getCategoryCount, getDataMap, getDataType, getDataType, getDataType, getDataType, getDataType, getDataTypeCount, getDataTypes, getDataTypes, getDataTypesContaining, getFavorites, getID, getLastChangeTimeForMyManager, getLocalSourceArchive, getPointer, getPointer, getResolvedID, getRootCategory, getSourceArchive, getSourceArchive, getSourceArchives, getUniqueName, getUniversalID, getUnusedConflictName, initializeOtherAdapters, invalidateCache, isChanged, isCreatingDataType, isFavorite, isTransactionActive, isUpdatable, migrateOldFlexArrayComponentsIfRequired, removeDataTypeManagerListener, removeInvalidatedListener, removeSourceArchive, replaceSourceArchive, resolveSourceArchive, setFavorite, sourceArchiveAdded, sourceArchiveChanged, updateID, updateSourceArchiveName, updateSourceArchiveName
-
Method Details
-
getDataTypeManager
Returns shared instance of built-in data type manager.- Returns:
- the manager
-
startTransaction
Description copied from interface:DataTypeManager
Starts a transaction for making changes in this data type manager.- Specified by:
startTransaction
in interfaceDataTypeManager
- Overrides:
startTransaction
in classStandAloneDataTypeManager
- Parameters:
description
- a short description of the changes to be made.- Returns:
- the transaction ID
-
endTransaction
public void endTransaction(int transactionID, boolean commit) Description copied from interface:DataTypeManager
Ends the current transaction- Specified by:
endTransaction
in interfaceDataTypeManager
- Overrides:
endTransaction
in classStandAloneDataTypeManager
- Parameters:
transactionID
- id of the transaction to endcommit
- true if changes are committed, false if changes in transaction are revoked
-
createCategory
Description copied from interface:DataTypeManager
Create a category for the given path; returns the current category if it already exits- Specified by:
createCategory
in interfaceDataTypeManager
- Overrides:
createCategory
in classDataTypeManagerDB
- Parameters:
path
- the path- Returns:
- the category
-
populateBuiltInTypes
protected void populateBuiltInTypes()Add the built in data types to the default built in folder if they were not found in any other category. -
resolveSourceArchiveID
-
getType
Description copied from interface:DataTypeManager
Returns this manager's archive type- Specified by:
getType
in interfaceDataTypeManager
- Overrides:
getType
in classStandAloneDataTypeManager
- Returns:
- the type
-
resolve
Description copied from interface:DataTypeManager
Returns a dataType that is "in" (ie suitable implementation) this Manager, creating a new one if necessary. Also the returned dataType will be in a category in this dataTypeManager that is equivalent to the category of the passed in dataType.- Specified by:
resolve
in interfaceDataTypeManager
- Overrides:
resolve
in classDataTypeManagerDB
- Parameters:
dataType
- the dataType to be resolved.handler
- used to resolve conflicts with existing dataTypes.- Returns:
- an equivalent dataType that "belongs" to this dataTypeManager.
-
addDataType
Description copied from interface:DataTypeManager
Returns a data type after adding it to this data manager. The returned dataType will be in a category in this dataTypeManager that is equivalent to the category of the passed in dataType.- Specified by:
addDataType
in interfaceDataTypeManager
- Overrides:
addDataType
in classDataTypeManagerDB
- Parameters:
originalDataType
- the dataType to be resolved.handler
- used to resolve conflicts with existing dataTypes.- Returns:
- an equivalent dataType that "belongs" to this dataTypeManager.
-
setName
Description copied from interface:DataTypeManager
Sets this data type manager's name- Specified by:
setName
in interfaceDataTypeManager
- Overrides:
setName
in classStandAloneDataTypeManager
- Parameters:
name
- the new name- Throws:
InvalidNameException
- if the given name is invalid (such as when null or empty)
-
associateDataTypeWithArchive
Description copied from interface:DataTypeManager
Change the given data type so that its source archive is the given archive- Specified by:
associateDataTypeWithArchive
in interfaceDataTypeManager
- Overrides:
associateDataTypeWithArchive
in classDataTypeManagerDB
- Parameters:
datatype
- the typearchive
- the archive
-
remove
Description copied from interface:DataTypeManager
Remove the given datatype from this manager- Specified by:
remove
in interfaceDataTypeManager
- Overrides:
remove
in classDataTypeManagerDB
- Parameters:
dataType
- the dataType to be removedmonitor
- the task monitor- Returns:
- true if the data type existed and was removed
-
replaceDataType
public DataType replaceDataType(DataType existingDt, DataType replacementDt, boolean updateCategoryPath) throws DataTypeDependencyException Description copied from interface:DataTypeManager
Replace an existing dataType with another. All instances and references will be updated to use the replacement dataType.- Specified by:
replaceDataType
in interfaceDataTypeManager
- Overrides:
replaceDataType
in classDataTypeManagerDB
- Parameters:
existingDt
- the dataType to be replaced.replacementDt
- the dataType to use as the replacement.updateCategoryPath
- if true, the replacementDt will have its categoryPath changed to the exitingDt's path.- Returns:
- the resolved replacement dataType.
- Throws:
DataTypeDependencyException
- if the replacement datatype depends on the existing dataType;
-
close
public void close()Description copied from interface:DataTypeManager
Closes this dataType manager- Specified by:
close
in interfaceDataTypeManager
- Overrides:
close
in classStandAloneDataTypeManager
-