Package org.fest.swing.driver

Class AbstractButtonDriver

java.lang.Object

org.fest.swing.driver.ComponentDriver

org.fest.swing.driver.ContainerDriver

org.fest.swing.driver.JComponentDriver

org.fest.swing.driver.AbstractButtonDriver

All Implemented Interfaces:

TextDisplayDriver<AbstractButton>

public class AbstractButtonDriver
extends JComponentDriver
implements TextDisplayDriver<AbstractButton>

Understands functional testing of AbstractButtons:

• user input simulation
• state verification
• property value query

This class is intended for internal use only. Please use the classes in the package org.fest.swing.fixture in your tests.

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	SELECTED_PROPERTY
private static final String	TEXT_PROPERTY

Fields inherited from class org.fest.swing.driver.ComponentDriver

robot

Constructor Summary

Constructors

Constructor	Description
AbstractButtonDriver(Robot robot)	Creates a new AbstractButtonDriver.

Method Summary

Modifier and Type	Method	Description
private void	assertThatButtonIsSelected(AbstractButton button, boolean selected)
void	requireNotSelected(AbstractButton button)	Verifies that the button is not selected.
void	requireSelected(AbstractButton button)	Verifies that the button is selected.
void	requireText(AbstractButton button, String expected)	Asserts that the text in the given button is equal to or matches the specified String.
void	requireText(AbstractButton button, Pattern pattern)	Asserts that the text in the given button matches the given regular expression pattern.
void	select(AbstractButton button)	Selects the given button only it is not already selected.
private static org.fest.assertions.Description	selectedProperty(AbstractButton button)
String	textOf(AbstractButton button)	Returns the text of the given button.
void	unselect(AbstractButton button)	Unselects the given button only if it is selected.
private static boolean	validateAndFindIsSelected(AbstractButton button)

Methods inherited from class org.fest.swing.driver.JComponentDriver

clientProperty, invokeAction, isVisible, isVisible, requireToolTip, requireToolTip, scrollToVisible

Methods inherited from class org.fest.swing.driver.ContainerDriver

move, resize, resizeHeight, resizeWidth

Methods inherited from class org.fest.swing.driver.ComponentDriver

assertIsEnabledAndShowing, click, click, click, click, click, doubleClick, drag, dragOver, drop, focus, focusAndWaitForFocusGain, invokePopupMenu, invokePopupMenu, moveMouseIgnoringAnyError, moveMouseIgnoringAnyError, performAccessibleActionOf, pressAndReleaseKey, pressAndReleaseKey, pressAndReleaseKeys, pressKey, propertyName, releaseKey, requireDisabled, requireEnabled, requireEnabled, requireFocused, requireNotVisible, requireSize, requireVisible, rightClick, settings, waitForShowing

Methods inherited from class java.lang.Object

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

Field Details

SELECTED_PROPERTY

private static final String SELECTED_PROPERTY

See Also:

• Constant Field Values

TEXT_PROPERTY

private static final String TEXT_PROPERTY

See Also:

• Constant Field Values

Constructor Details

AbstractButtonDriver

public AbstractButtonDriver(Robot robot)

Creates a new AbstractButtonDriver.

Parameters:

robot - the robot to use to simulate user input.

Method Details

requireText

@RunsInEDT
public void requireText(AbstractButton button,
 String expected)

Asserts that the text in the given button is equal to or matches the specified String.

Specified by:

requireText in interface TextDisplayDriver<AbstractButton>

Parameters:

button - the given button.

expected - the text to match. It can be a regular expression.

Throws:

AssertionError - if the text of the button is not equal to or does not match the given one.

requireText

public void requireText(AbstractButton button,
 Pattern pattern)

Asserts that the text in the given button matches the given regular expression pattern.

Specified by:

requireText in interface TextDisplayDriver<AbstractButton>

Parameters:

button - the given button.

pattern - the regular expression pattern to match.

Throws:

NullPointerException - if the given regular expression pattern is null.

AssertionError - if the text of the button does not match the given regular expression pattern.

Since:

1.2

textOf

@RunsInEDT
public String textOf(AbstractButton button)

Returns the text of the given button.

Specified by:

textOf in interface TextDisplayDriver<AbstractButton>

Parameters:

button - the given button.

Returns:

the text of the given button.

select

@RunsInEDT
public void select(AbstractButton button)

Selects the given button only it is not already selected.

Parameters:

button - the target button.

Throws:

IllegalStateException - if the button is disabled.

IllegalStateException - if the button is not showing on the screen.

unselect

@RunsInEDT
public void unselect(AbstractButton button)

Unselects the given button only if it is selected.

Parameters:

button - the target button.

Throws:

IllegalStateException - if the button is disabled.

IllegalStateException - if the button is not showing on the screen.

validateAndFindIsSelected

@RunsInEDT
private static boolean validateAndFindIsSelected(AbstractButton button)

requireSelected

@RunsInEDT
public void requireSelected(AbstractButton button)

Verifies that the button is selected.

Parameters:

button - the given button.

Throws:

AssertionError - if the button is not selected.

requireNotSelected

@RunsInEDT
public void requireNotSelected(AbstractButton button)

Verifies that the button is not selected.

Parameters:

button - the given button.

Throws:

AssertionError - if the button is selected.

assertThatButtonIsSelected

@RunsInEDT
private void assertThatButtonIsSelected(AbstractButton button,
 boolean selected)

selectedProperty

@RunsInEDT
private static org.fest.assertions.Description selectedProperty(AbstractButton button)