Skip to content

Ghidra is a software reverse engineering (SRE) framework

14.9 KB
Raw Blame
/* ###
 * IP: GHIDRA
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package docking;

import java.awt.*;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

import javax.swing.*;

import org.apache.commons.lang3.StringUtils;

import docking.action.DockingAction;
import docking.action.DockingActionIf;
import generic.timer.ExpiringSwingTimer;
import ghidra.util.exception.AssertException;

/**
 * Class to hold information about a dockable component with respect to its position within the
 * windowing system.  It also holds identification information about the provider so that its
 * location can be reused when the provider is re-opened.
 * <p>
 * The placeholder will be used to link previously saved position information.  The tool will
 * initially construct plugins and their component providers with default position information.
 * Then, any existing xml data will be restored, which may have provider position information.
 * The restoring of the xml will create placeholders with this saved information.  Finally, the
 * restored placeholders will be linked with existing component providers.
 */
public class ComponentPlaceholder {
	private String name;
	private String owner;
	private String group;
	private String title;
	private String subTitle;
	private String tabText;
	private Icon icon;
	private ComponentProvider componentProvider;
	private List<DockingActionIf> actions;
	private boolean isShowing;
	private ComponentNode compNode;
	private DockableComponent comp;
	private boolean showHeader = true;
	private boolean disposed = false;

	/** Set to a default value if this class' provider is not duplicatable; a unique value otherwise */
	private long instanceID = 0;

	ComponentPlaceholder(ComponentProvider provider) {
		this.componentProvider = provider;
		updateInfo(provider);
		this.actions = new ArrayList<>();
		this.instanceID = provider.getInstanceID();
	}

	/**
	 * XML Constructor!!!!!
	 * 
	 * @param name the name of the component
	 * @param owner the owner of the component
	 * @param group the window group
	 * @param title the title
	 * @param show whether or not the component is showing
	 * @param node componentNode that has this placeholder
	 * @param instanceID the instance ID
	 */
	ComponentPlaceholder(String name, String owner, String group, String title, boolean show,
			ComponentNode node, long instanceID) {

		this.name = name;
		this.owner = owner;
		this.title = title;
		this.isShowing = show;
		this.group = group;
		this.compNode = node;
		this.instanceID = instanceID;
		this.actions = new ArrayList<>();
	}

	long getInstanceID() {
		return instanceID;
	}

	/**
	 * Sets the componentNode containing this placeholder
	 * @param node the component node containing this placeholder.
	 */
	void setNode(ComponentNode node) {
		compNode = node;
	}

	/**
	 * {@return the componentNode containing this placeholder}
	 */
	ComponentNode getNode() {
		return compNode;
	}

	void showHeader(boolean b) {
		this.showHeader = b;
		invalidateComponentNode();
	}

	boolean isHeaderShowing() {
		return showHeader;
	}

	boolean isParented() {
		return compNode != null;
	}

	/**
	 * Returns true if the component is showing and visible to the user.
	 * @return true if showing
	 * @see #isActive()
	 */
	boolean isShowing() {
		return isShowing && comp != null && comp.isShowing();
	}

	/**
	 * Returns true if this provider wants to be showing and has a component provider, regardless 
	 * of whether the provider is showing to the user.
	 * @return true if active
	 * @see #isShowing()
	 */
	boolean isActive() {
		return isShowing && componentProvider != null;
	}

	/**
	 * True signals that the showing state of the placeholder is true.  This is used to re-show
	 * providers after restoring from XML.
	 * @return True signals that the showing state of the placeholder is true
	 */
	boolean wantsToBeShowing() {
		return isShowing;
	}

	private void invalidateComponentNode() {
		if (compNode != null) {
			compNode.invalidate();
		}
	}

	String getGroup() {
		if (componentProvider != null) {
			group = getGroup(componentProvider);
		}
		return group;
	}

	DetachedWindowNode getDetachedWindowNode() {
		Node node = compNode.parent;
		while (node != null) {
			if (node instanceof DetachedWindowNode) {
				return (DetachedWindowNode) node;
			}
			node = node.parent;
		}
		return null;
	}

	WindowNode getWindowNode() {
		Node node = compNode.parent;
		while (node != null) {
			if (node instanceof WindowNode) {
				return (WindowNode) node;
			}
			node = node.parent;
		}
		return null;
	}

	WindowNode getTopLevelNode() {
		if (compNode == null) {
			return null;
		}
		return compNode.getTopLevelNode();
	}

	/**
	 * Call to signal that this placeholder is not being used.  This is needed when placeholders
	 * are restored from XML as being visible, but then no provider can be found for them.
	 */
	void reset() {
		show(false);
	}

	/**
	 * Sets the active state.
	 * @param doShow true to show the component, false to hide it.
	 */
	void show(boolean doShow) {
		if (doShow == isShowing) {
			return;
		}

		isShowing = doShow;

		invalidate();
	}

	private void hideComponent() {
		if (componentProvider == null) {
			return;
		}

		JComponent component = componentProvider.getComponent();
		if (component == null) {
			return; // can happen during initialization
		}

		Container parent = component.getParent();
		if (parent != null) {
			parent.remove(component);
		}
	}

	private void invalidate() {
		// Hide the component provider's component before clearing the UI.  If we later dispose the
		// component provider and the component is still visible, it may get repainted after being
		// disposed, which can trigger exceptions.
		hideComponent();
		invalidateComponentNode();
		disposeDockableComponent();
		notifyProviderVisibilityIsChanging();
	}

	private void notifyProviderVisibilityIsChanging() {
		if (componentProvider == null) {
			return;
		}

		if (isShowing) {
			componentProvider.componentShown();
		}
		else {
			componentProvider.componentHidden();
		}
	}

	public boolean isDisposed() {
		return disposed;
	}

	void dispose() {
		disposed = true;
		disposeDockableComponent();
		disposeNode();
	}

	/**
	 * Performs a final removal of this placeholder from its {@link ComponentNode}.
	 */
	private void disposeNode() {
		if (compNode == null) {
			return;
		}

		WindowNode windowNode = compNode.getTopLevelNode();
		if (windowNode != null) {
			windowNode.componentRemoved(this);
		}

		compNode.remove(this);
		compNode = null;
	}

	/**
	 * Disposes the active {@link DockableComponent}.  The component may later get recreated in the
	 * call to {@link #getComponent()}.
	 */
	private void disposeDockableComponent() {
		if (comp == null) {
			return;
		}

		comp.dispose();
		comp = null;
	}

	/**
	 * {@return true if this placeholder has a component that can take focus.  This placeholder 
	 * cannot take focus if it does not yet have a DockableComponent.}
	 */
	boolean canTakeFocus() {
		return comp != null;
	}

	void toFront() {
		if (comp != null) {
			compNode.makeSelectedTab(this);
		}
	}

	/**
	 * Requests focus for the component associated with this placeholder.
	 */
	void requestFocusWhenReady() {
		DockableComponent tmp = comp;// put in temp variable in case another thread deletes it
		if (tmp == null) {
			return;
		}

		compNode.makeSelectedTab(this);
		activateWindow();

		// make sure the tab has time to become active before trying to request focus
		ExpiringSwingTimer.runWhen(this::isShowing, () -> {
			doRequestFocus(tmp);
		});
	}

	private void doRequestFocus(DockableComponent dockableComponent) {
		KeyboardFocusManager kfm = KeyboardFocusManager.getCurrentKeyboardFocusManager();
		Window activeWindow = kfm.getActiveWindow();
		if (activeWindow == null) {
			return; // our application isn't focused--don't do anything
		}

		dockableComponent.requestFocus();
		contextChanged();
	}

	// makes sure that the given window is not in an iconified state
	private void activateWindow() {
		DetachedWindowNode windowNode = getDetachedWindowNode();
		if (windowNode != null) {
			Window window = getDetachedWindowNode().getWindow();
			if (window instanceof Frame) {
				Frame frame = (Frame) window;
				frame.setState(Frame.NORMAL);
			}
		}
	}

	/**
	 * Hides the component associated with this placeholder and notifies the provider that
	 * the component has been hidden.
	 *
	 */
	void close() {
		if (componentProvider != null) {
			componentProvider.closeComponent();
		}
	}

	/**
	 * Returns a Dockable component that wraps the component for this placeholder
	 * @return the component
	 */
	public DockableComponent getComponent() {
		if (disposed) {
			throw new AssertException(
				"Attempted to get a component for a disposed placeholder - " + this);
		}

		boolean isDocking = true;
		if (compNode != null) {
			isDocking = compNode.winMgr.isDocking();
		}

		if (comp == null && isShowing) {
			comp = new DockableComponent(this, isDocking);
		}
		return comp;
	}

	void setIcon(Icon icon) {
		icon = DockingUtils.scaleIconAsNeeded(icon);

		this.icon = icon;
		if (comp != null) {
			comp.setIcon(icon);
		}
		if (compNode != null) {
			compNode.iconChanged(this);
		}
	}

	Icon getIcon() {
		return icon;
	}

	/**
	 * Returns the title for this component
	 * @return the title for this component
	 */
	public String getTitle() {
		return title;
	}

	/**
	 * Returns the subtitle for the component
	 * @return the subtitle for the component
	 */
	public String getSubTitle() {
		return subTitle;
	}

	/**
	 * The text for display on the tab of a tabbed component.
	 * @return The text for display on the tab of a tabbed component.
	 */
	public String getTabText() {
		return tabText;
	}

	/**
	 * Returns the name of this component.
	 * @return the name of this component.
	 */
	public String getName() {
		return name;
	}

	/**
	 * Returns the owner for the component
	 * @return the owner
	 */
	String getOwner() {
		return owner;
	}

	/**
	 * Returns the component associated with this placeholder
	 * @return the component
	 */
	JComponent getProviderComponent() {
		if (componentProvider != null) {
			return componentProvider.doGetComponent();
		}
		return new JPanel();
	}

	/**
	 * Returns true if this placeholder's component is in a tabbed pane with other components
	 * @return true if in a tabbed pane
	 */
	boolean isStacked() {
		if (compNode != null) {
			return compNode.isStacked();
		}
		return false;
	}

	/**
	 * Returns true if this placeholder is currently associated with a component. If it is not,
	 * then it exists as a place holder.
	 * @return true if this placeholder is currently associated with a component
	 */
	boolean hasProvider() {
		return componentProvider != null;
	}

	/**
	 * Sets the component provider for this placeholder
	 * @param newProvider the new provider
	 */
	void setProvider(ComponentProvider newProvider) {

		this.componentProvider = newProvider;
		actions.clear();
		if (newProvider != null) {
			updateInfo(newProvider);
		}

		disposeDockableComponent();
	}

	public void update() {
		updateInfo(componentProvider);
	}

	private void updateTitle(ComponentProvider provider) {
		title = provider.getTitle();
		subTitle = provider.getSubTitle();
		tabText = provider.getTabText();
		tabText = tabText == null ? title : tabText;

		if (comp != null) {
			comp.setTitle(getFullTitle());
		}
		if (compNode != null) {
			compNode.titleChanged(this);
		}
	}

	private void updateInfo(ComponentProvider updatedProvider) {
		if (updatedProvider == null) {
			return;
		}

		updateTitle(updatedProvider);

		owner = updatedProvider.getOwner();
		name = updatedProvider.getName();
		group = getGroup(updatedProvider);
		setIcon(updatedProvider.getIcon());

		instanceID = componentProvider.getInstanceID();
	}

	private String getGroup(ComponentProvider provider) {
		String providerGroup = provider.getWindowGroup();
		if (providerGroup == null || providerGroup.isEmpty()) {
			return ComponentProvider.DEFAULT_WINDOW_GROUP;
		}
		return providerGroup;
	}

	/**
	 * Returns the component provider for this placeholder.
	 * @return the component provider for this placeholder.
	 */
	public ComponentProvider getProvider() {
		return componentProvider;
	}

	/**
	 * Adds an action to this component
	 * @param action the action to be added.
	 */
	void addAction(DockingActionIf action) {
		if (actions.contains(action)) {
			throw new RuntimeException("Duplicate action added");
		}
		actions.add(action);
		if (comp != null) {
			comp.actionAdded(action);
		}
	}

	void removeAllActions() {
		if (comp != null) {
			for (DockingActionIf action : actions) {
				comp.actionRemoved(action);
			}
		}

		actions.clear();
	}

	/**
	 * Removes an action from this component
	 * @param action the action to be removed.
	 */
	void removeAction(DockingActionIf action) {
		if (actions.remove(action)) {
			if (comp != null) {
				comp.actionRemoved(action);
			}
		}
	}

	/** Updates local actions for providers */
	void contextChanged() {
		if (componentProvider == null) {
			return; // disposed
		}

		ActionContext context = componentProvider.getActionContext(null);
		if (context == null) {
			context = new DefaultActionContext(componentProvider, null);
		}

		context.setContextProvider(componentProvider);

		for (DockingActionIf a : actions) {
			boolean enabled = a.isValidContext(context) && a.isEnabledForContext(context);
			a.setEnabled(enabled);
		}
	}

	boolean hasAction(DockingAction action) {
		return actions.contains(action);
	}

	/**
	 * Return iterator over all the local actions defined for this component
	 * @return the actions
	 */
	Iterator<DockingActionIf> getActions() {
		return actions.iterator();
	}

	/**
	 * Notifies the node that this component has focus
	 * @param state the state
	 */
	void setSelected(boolean state) {
		if (comp != null) {
			comp.setSelected(state);
			setProviderActivated(state);
		}
	}

	/**
	 * Signals to use the GUI to make this provider stand out from the rest.
	 */
	void emphasize() {
		if (comp != null) {
			comp.emphasize();
		}
	}

	private void setProviderActivated(boolean activated) {
		if (componentProvider == null) {
			return;
		}

		if (activated) {
			componentProvider.componentActivated();
		}
		else {
			componentProvider.componentDeactived();
		}
	}

	/**
	 * Returns the full title for this component (title + subtitle)
	 * @return the full title for this component (title + subtitle)
	 */
	public String getFullTitle() {
		String text = title;
		if (!StringUtils.isBlank(subTitle)) {
			text += " - " + subTitle;
		}
		return text;
	}

	@Override
	public String toString() {
		return "name=\"" + name + "\", fullTitle=\"" + getFullTitle() + "\"";
	}
}