tests/org.eclipse.ui.tests/Eclipse UI Tests/org/eclipse/ui/tests/api/IActionDelegateTest.java

package org.eclipse.ui.tests.api;

import org.eclipse.jface.action.*;
import org.eclipse.ui.*;
import org.eclipse.jdt.junit.util.*;


/**
 * Test the lifecycle of an action delegate.
 */
public abstract class IActionDelegateTest extends UITestCase {

	protected IWorkbenchWindow fWindow;
	protected IWorkbenchPage fPage;
	
	/**
	 * Constructor for IActionDelegateTest
	 */
	public IActionDelegateTest(String testName) {
		super(testName);
	}
	
	public void setUp() {
		fWindow = openTestWindow();
		fPage = fWindow.getActivePage();
	}
	
	public void testRun() throws Throwable {
		// Create the action.
		Object obj = createActionWidget();
		
		// Run the action delegate.
		// The selectionChanged and run methods should be called, in that order.
		runAction(obj);
		MockActionDelegate delegate = getDelegate();
		assertNotNull(delegate);
		assertTrue(delegate.callHistory.verifyOrder(
			new String[] {"selectionChanged", "run" } ));
	}
	
	public void testSelectionChanged() throws Throwable {
		// Create the delegate by running it.
		Object obj = createActionWidget();
		runAction(obj);
		MockActionDelegate delegate = getDelegate();
		assertNotNull(delegate);
		
		// Fire a selection.
		// The selectionChanged method should be invoked.
		delegate.callHistory.clear();		
		fireSelection(obj);
		assertTrue(delegate.callHistory.contains("selectionChanged"));
	}
	
	/**
	 * Returns the last mock action delegate which was created.
	 */
	protected MockActionDelegate getDelegate() throws Throwable {
		MockActionDelegate delegate = MockActionDelegate.lastDelegate;
		assertNotNull(delegate);
		return delegate;
	}

	/**
	 * Creates the widget for an action, and adds the action.
	 * 
	 * @returns an object which will be passed to runAction and 
	 * fireSelection.
	 */
	protected abstract Object createActionWidget() throws Throwable;
	
	/**
	 * Adds and runs the action delegate.  Subclasses should override.
	 * 
	 * @param obj the object returned from createActionWidget.
	 */
	protected abstract void runAction(Object widget) throws Throwable;
	
	/**
	 * Fires a selection from the source.  Subclasses should override.
	 * 
	 * @param obj the object returned from createActionWidget.
	 */
	protected abstract void fireSelection(Object widget) throws Throwable;
}