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.

Author:

Alex Ruiz, Yvonne Wang

Field Summary

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

robot

Constructor Summary

AbstractButtonDriver(Robot robot)
Creates a new AbstractButtonDriver.

Method Summary

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, Pattern pattern) Asserts that the text in the given button matches the given regular expression pattern.
void	requireText(AbstractButton button, String expected) Asserts that the text in the given button is equal to or matches the specified String.
void	select(AbstractButton button) Selects the given button only it is not already selected.
String	textOf(AbstractButton button) Returns the text of the given button.
void	unselect(AbstractButton button) Unselects the given button only if it is selected.

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

Constructor Detail

AbstractButtonDriver

public AbstractButtonDriver(Robot robot)

Creates a new AbstractButtonDriver.

Parameters:

robot - the robot to use to simulate user input.

Method Detail

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.

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.