Skip to content

Ghidra is a software reverse engineering (SRE) framework

6.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.widgets.table;

import static org.junit.Assert.*;

import java.awt.BorderLayout;

import javax.swing.JFrame;
import javax.swing.JScrollPane;

import org.junit.*;

import docking.widgets.AutoLookup;
import docking.widgets.table.model.TestDataModel;
import ghidra.test.AbstractGhidraHeadedIntegrationTest;
import ghidra.util.Msg;
import ghidra.util.table.GhidraTable;

public class GTableTest extends AbstractGhidraHeadedIntegrationTest {
	private TestDataModel model;
	private GhidraTable table;
	private JFrame frame;

	private boolean timeoutTriggered;

	@Before
	public void setUp() throws Exception {
		model = new TestDataModel();
		table = new GhidraTable(model);

		installTestAutoLookupTimeout();

		frame = new JFrame("Ghidra Table Test");
		frame.getContentPane().setLayout(new BorderLayout());
		frame.getContentPane().add(new JScrollPane(table));
		frame.pack();
		frame.setVisible(true);

		// showing the table will trigger a call to sort; wait for sorting to finish
		waitForSort();
	}

	private void installTestAutoLookupTimeout() {
		// note: this call will not work due to the unpredictable timing of event
		//       processing in the various test environments
		// table.setAutoLookupTimeout(testKeyTimeout);

		AutoLookup al = table.getAutoLookup();
		al.setTimeoutPredicate(elapsed -> timeoutTriggered);
		timeout(); // start fresh with an active timeout
	}

	@After
	public void tearDown() throws Exception {
		frame.dispose();
	}

	@Test
	public void testAutoLookup() throws Exception {

		table.setAutoLookupColumn(4);

		setSelectedRow(table, 0);

		type("a");
		assertSelectedRow(11, "a");
		pauseTimeout();

		type("c");
		assertSelectedRow(12, "c"); // matches 'access'
		timeout();

		type("ad");
		assertSelectedRow(24, "ad");
		timeout();

		type("av");
		assertSelectedRow(70, "av");
		timeout();

		type("x");
		assertSelectedRow(1920, "x");
		timeout();

		type("a");
		assertSelectedRow(11, "a");

		// test the case where no match is found
		pauseTimeout();
		type("zed");
		assertSelectedRow(11, "zed"); // no change
	}

	@Test
	public void testAutoLookup_SortDescending() throws Exception {

		int column = 4;
		sortDescending(column);

		table.setAutoLookupColumn(column);

		setSelectedRow(table, 0);

		type("a");
		assertSelectedRow(1846, "a");
		pauseTimeout();

		type("c");
		assertSelectedRow(1902, "c");  // matches 'access'

		timeout();
		type("ad");
		assertSelectedRow(1885, "ad");

		timeout();
		type("av");
		assertSelectedRow(1848, "av");

		timeout();
		type("x");
		assertSelectedRow(0, "x");

		timeout();
		type("a");
		assertSelectedRow(1846, "a");

		// test the case where no match is found
		table.setAutoLookupTimeout(1000); // longer timeout needed for multiple keys
		type("zed");
		assertSelectedRow(1846, "zed"); // no change
	}

	@Test
	public void testAutoLookup_WhenColumnIsNotSorted() throws Exception {

		int column = 4;
		removeSortColumn(column);

		table.setAutoLookupColumn(column);

		setSelectedRow(table, 0);

		// note: the order checked here is the same as the sorted order, since we did not move
		//       any rows after disabling the sort
		type("a");
		assertSelectedRow(11, "a");
		pauseTimeout();

		type("c");
		assertSelectedRow(12, "c"); // matches 'access'
		timeout();

		type("ad");
		assertSelectedRow(24, "ad");
		timeout();

		type("av");
		assertSelectedRow(70, "av");
		timeout();

		type("x");
		assertSelectedRow(1920, "x");
		timeout();

		type("a");
		assertSelectedRow(11, "a");

		// test the case where no match is found
		table.setAutoLookupTimeout(1000); // longer timeout needed for multiple keys
		type("zed");
		assertSelectedRow(11, "zed"); // no change
	}

	@Test
	public void testSetActionsEnabled() throws Exception {

		table.setAutoLookupColumn(4);
		assertFalse(table.areActionsEnabled());
		setSelectedRow(table, 0);

		type("a");
		assertSelectedRow(11);
		timeout();

		enableKeyBindingsActions(); // this will disable 'auto lookup'

		select(0);
		type("a");
		assertSelectedRow(0);
		timeout();

		disableKeyBindingsActions();

		select(0);
		type("a");
		assertSelectedRow(11);
		timeout();

		enableKeyBindingsActions(); // this will disable 'auto lookup'

		select(0);
		type("a");
		assertSelectedRow(0);
		timeout();

		table.setAutoLookupColumn(4); // this disables the key binding actions too
		select(0);

		type("a");
		assertSelectedRow(11);
	}

	private void disableKeyBindingsActions() {
		table.setActionsEnabled(false);
	}

	private void enableKeyBindingsActions() {
		table.setActionsEnabled(true);
	}

	private void select(int row) throws Exception {
		setSelectedRow(table, row);
	}

	private void type(String chars) {

		if (chars.length() == 1) {
			triggerText(table, chars);
			waitForSwing();
			return;
		}

		// multiple characters is a signal to type rapidly, meaning the timeout will not pass
		chars.chars().forEach(c -> {
			triggerText(table, Character.toString(c));
			pauseTimeout();
			waitForSwing();
		});
	}

	private void assertSelectedRow(int row) {
		assertEquals(row, table.getSelectedRow());
	}

	private void assertSelectedRow(int row, String lookupText) {

		int actual = runSwing(() -> table.getSelectedRow());
		if (row != actual) {

			int col = 4; // String 'Name' column
			String expectedString = (String) table.getValueAt(row, col);
			String actualString = (String) table.getValueAt(actual, col);
			String message = "Auto-lookup row not selected for '" + lookupText + "'.\n\t" +
				"Expected text: '" + expectedString + "'; Actual text: '" + actualString + "'";
			Msg.error(this, message);
			assertEquals(message, row, actual);
		}
	}

	private void removeSortColumn(int column) {
		waitForSwing();
		runSwing(() -> TableUtils.columnAlternativelySelected(table, column));
		waitForSort();
	}

	private void waitForSort() {
		// the call to sort may be run in an invokeLater()
		waitForSwing();
		waitForCondition(() -> !model.isSortPending());
		waitForSwing();
	}

	private void sortDescending(int column) {

		TableSortState descendingSortState = TableSortState.createDefaultSortState(column, false);
		runSwing(() -> model.setTableSortState(descendingSortState));
		waitForSort();
	}

	private void pauseTimeout() {
		runSwing(() -> timeoutTriggered = false);
	}

	private void timeout() {
		runSwing(() -> timeoutTriggered = true);
	}

	private void setSelectedRow(final GhidraTable table, final int i) throws Exception {
		runSwing(() -> table.setRowSelectionInterval(i, i));
		waitForSwing();
	}

}