Package ghidra.app.merge

Class MergeManagerPlugin

java.lang.Object

ghidra.framework.plugintool.Plugin

ghidra.app.merge.MergeManagerPlugin

All Implemented Interfaces:

ProgramaticUseOnly, DomainObjectListener, PluginEventListener, ServiceListener, ExtensionPoint, java.util.EventListener

Direct Known Subclasses:

DataTypeArchiveMergeManagerPlugin, ProgramMergeManagerPlugin

public abstract class MergeManagerPlugin
extends Plugin
implements ProgramaticUseOnly, DomainObjectListener

Plugin that provides a merge component provider.

Nested Class Summary

Nested classes/interfaces inherited from interface ghidra.util.classfinder.ExtensionPoint

ExtensionPoint.Exclude, ExtensionPoint.Util

Field Summary

Fields

Change	Modifier and Type	Field	Description
NEW	protected UndoableDomainObject	currentDomainObject
NEW	protected MergeManager	mergeManager
NEW	protected ghidra.app.merge.MergeManagerProvider	provider

Fields inherited from class ghidra.framework.plugintool.Plugin

name, pluginDescription, tool

Constructor Summary

Constructors

Change	Constructor	Description
MergeManagerPlugin(PluginTool tool, MergeManager mergeManager, UndoableDomainObject domainObject)	Constructor for plugin that handles multi-user merge of programs.

Method Summary

Change	Modifier and Type	Method	Description
NEW	protected boolean	canClose()	Called to force this plugin to terminate any tasks it has running and apply any unsaved data to domain objects or files.
	boolean	closeAllDomainObjects(boolean ignoreChanges)
	boolean	closeDomainObject()
	boolean	closeDomainObject(UndoableDomainObject domainObject, boolean ignoreChanges)
	abstract ghidra.app.merge.MergeManagerProvider	createProvider()	Creates the provider that will be displayed in the merge tool.
NEW	protected void	dispose()	Tells a plugin that it is no longer needed.
	void	domainObjectChanged(DomainObjectChangedEvent ev)	Method called when a change is made to the domain object.
	UndoableDomainObject[]	getAllOpenDomainObjects()
	static java.lang.String	getCategory()
	UndoableDomainObject	getCurrentDomainObject()
	static java.lang.String	getDescription()
	static java.lang.String	getDescriptiveName()
	int	getSearchPriority(UndoableDomainObject domainObject)
	boolean	isVisible(UndoableDomainObject domainObject)
	Program	openDomainObject(DomainFile domainFile)
	Program	openDomainObject(DomainFile df, int version)
	Program	openDomainObject(DomainFile domainFile, int version, int state)
	void	openDomainObject(UndoableDomainObject domainObject)
	void	openDomainObject(UndoableDomainObject domainObject, boolean current)
	void	openDomainObject(UndoableDomainObject domainObject, int state)
	abstract void	processEvent(PluginEvent event)	Method called to process a plugin event.
	void	releaseDomainObject(UndoableDomainObject domainObject, java.lang.Object persistentOwner)
	void	setCurrentDomainObject(UndoableDomainObject domainObject)
	boolean	setPersistentOwner(UndoableDomainObject domainObject, java.lang.Object owner)
	void	setSearchPriority(UndoableDomainObject domainObject, int priority)

Methods inherited from class ghidra.framework.plugintool.Plugin

acceptData, canCloseDomainObject, cleanup, close, dataStateRestoreCompleted, dependsUpon, deregisterService, equals, eventSent, firePluginEvent, getData, getMissingRequiredServices, getName, getPluginDescription, getPluginName, getServicesRequired, getSupportedDataTypes, getTool, getTransientState, getUndoRedoState, hashCode, hasMissingRequiredService, hasUnsaveData, init, isDisposed, prepareToSave, readConfigState, readDataState, registerDynamicEventConsumed, registerDynamicServiceProvided, registerEventConsumed, registerEventProduced, registerServiceProvided, registerServiceUsed, restoreTransientState, restoreUndoRedoState, saveData, serviceAdded, serviceRemoved, writeConfigState, writeDataState

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

mergeManager NEW

protected MergeManager mergeManager

provider NEW

protected ghidra.app.merge.MergeManagerProvider provider

currentDomainObject NEW

protected UndoableDomainObject currentDomainObject

Constructor Detail

MergeManagerPlugin

public MergeManagerPlugin(PluginTool tool,
                          MergeManager mergeManager,
                          UndoableDomainObject domainObject)

Constructor for plugin that handles multi-user merge of programs.

Parameters:

tool - the tool with the active program to be merged

mergeManager - the merge manager that will control the merge process

program - the current program

Method Detail

createProvider

public abstract ghidra.app.merge.MergeManagerProvider createProvider()

Creates the provider that will be displayed in the merge tool. This shows the merge progress to the user and lets the user resolve conflicts. Any class that extends this plugin must provide its own MergeManagerProvider here that will be shown to the user for the merge.

Returns:

the merge provider associated with this plugin.

processEvent

public abstract void processEvent(PluginEvent event)

Description copied from class: Plugin

Method called to process a plugin event. Plugins should override this method if the plugin processes PluginEvents;

Overrides:

processEvent in class Plugin

Parameters:

event - plugin to process

dispose NEW

protected void dispose()

Description copied from class: Plugin

Tells a plugin that it is no longer needed. The plugin should release any resources that it has. All actions, components, services will automatically be cleaned up.

Overrides:

dispose in class Plugin

getDescription

public static java.lang.String getDescription()

getDescriptiveName

public static java.lang.String getDescriptiveName()

getCategory

public static java.lang.String getCategory()

canClose NEW

protected boolean canClose()

Description copied from class: Plugin

Called to force this plugin to terminate any tasks it has running and apply any unsaved data to domain objects or files. If it can't do this or the user cancels then this returns false.

Overrides:

canClose in class Plugin

Returns:

true if this plugin can close.

domainObjectChanged

public void domainObjectChanged(DomainObjectChangedEvent ev)

Description copied from interface: DomainObjectListener

Method called when a change is made to the domain object.

Specified by:

domainObjectChanged in interface DomainObjectListener

Parameters:

ev - event containing the change record and type of change that was made

closeAllDomainObjects

public boolean closeAllDomainObjects(boolean ignoreChanges)

closeDomainObject

public boolean closeDomainObject()

closeDomainObject

public boolean closeDomainObject(UndoableDomainObject domainObject,
                                 boolean ignoreChanges)

getAllOpenDomainObjects

public UndoableDomainObject[] getAllOpenDomainObjects()

getCurrentDomainObject

public UndoableDomainObject getCurrentDomainObject()

getSearchPriority

public int getSearchPriority(UndoableDomainObject domainObject)

isVisible

public boolean isVisible(UndoableDomainObject domainObject)

openDomainObject

public Program openDomainObject(DomainFile domainFile)

openDomainObject

public Program openDomainObject(DomainFile df,
                                int version)

openDomainObject

public Program openDomainObject(DomainFile domainFile,
                                int version,
                                int state)

openDomainObject

public void openDomainObject(UndoableDomainObject domainObject)

openDomainObject

public void openDomainObject(UndoableDomainObject domainObject,
                             boolean current)

openDomainObject

public void openDomainObject(UndoableDomainObject domainObject,
                             int state)

releaseDomainObject

public void releaseDomainObject(UndoableDomainObject domainObject,
                                java.lang.Object persistentOwner)

setCurrentDomainObject

public void setCurrentDomainObject(UndoableDomainObject domainObject)

setPersistentOwner

public boolean setPersistentOwner(UndoableDomainObject domainObject,
                                  java.lang.Object owner)

setSearchPriority

public void setSearchPriority(UndoableDomainObject domainObject,
                              int priority)