org.assertj.swing.fixture

Class JFileChooserFixture

java.lang.Object

org.assertj.swing.fixture.AbstractComponentFixture<S,T,D>

org.assertj.swing.fixture.AbstractJComponentFixture<JFileChooserFixture,JFileChooser,JFileChooserDriver>

org.assertj.swing.fixture.JFileChooserFixture

All Implemented Interfaces:

JComponentFixture<JFileChooserFixture>, MouseInputSimulationFixture<JFileChooserFixture>

public class JFileChooserFixture
extends AbstractJComponentFixture<JFileChooserFixture,JFileChooser,JFileChooserDriver>

Supports functional testing of JFileChoosers.

Author:

Yvonne Wang, Alex Ruiz

Field Summary

Fields inherited from class org.assertj.swing.fixture.AbstractComponentFixture

BACKGROUND_PROPERTY, FONT_PROPERTY, FOREGROUND_PROPERTY

Constructor Summary

Constructors

Constructor and Description
JFileChooserFixture(Robot robot) Creates a new JFileChooserFixture.
JFileChooserFixture(Robot robot, JFileChooser target) Creates a new JFileChooserFixture.
JFileChooserFixture(Robot robot, String fileChooserName) Creates a new JFileChooserFixture.

Method Summary

Modifier and Type	Method and Description
void	approve() Simulates a user pressing the "Approve" button in this fixture's JFileChooser.
JButtonFixture	approveButton() Finds the "Approve" button in this fixture's JFileChooser.
void	cancel() Simulates a user pressing the "Cancel" button in this fixture's JFileChooser.
JButtonFixture	cancelButton() Finds the "Cancel" button in this fixture's JFileChooser.
protected JFileChooserDriver	createDriver(Robot robot)
JTextComponentFixture	fileNameTextBox() Returns a fixture that manages the field where the user can enter the name of the file to select in this fixture's JFileChooser.
JFileChooserFixture	selectFile(File file) Selects the given file in this fixture's JFileChooser.
JFileChooserFixture	selectFiles(File... files) Selects the given files in this fixture's JFileChooser.
JFileChooserFixture	setCurrentDirectory(File dir) Sets the current directory of this fixture's JFileChooser to the given one.

Methods inherited from class org.assertj.swing.fixture.AbstractJComponentFixture

clientProperty, requireToolTip, requireToolTip

Methods inherited from class org.assertj.swing.fixture.AbstractComponentFixture

background, click, click, click, doubleClick, driver, drop, equals, focus, font, foreground, hashCode, isEnabled, myself, pressAndReleaseKey, pressAndReleaseKeys, pressKey, pressKeyWhileRunning, releaseKey, replaceDriverWith, requireDisabled, requireEnabled, requireEnabled, requireFocused, requireNotVisible, requireShowing, requireVisible, rightClick, robot, target, targetCastedTo

Methods inherited from class java.lang.Object

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

Constructor Detail

JFileChooserFixture

public JFileChooserFixture(@Nonnull
                           Robot robot)

Creates a new JFileChooserFixture.

Parameters:

robot - performs simulation of user events on a JFileChooser.

Throws:

NullPointerException - if robot is null.

ComponentLookupException - if a matching JFileChooser could not be found.

ComponentLookupException - if more than one matching JFileChooser is found.

JFileChooserFixture

public JFileChooserFixture(@Nonnull
                           Robot robot,
                           @Nonnull
                           JFileChooser target)

Creates a new JFileChooserFixture.

Parameters:

robot - performs simulation of user events on the given JFileChooser.

target - the JFileChooser to be managed by this fixture.

Throws:

NullPointerException - if robot is null.

NullPointerException - if target is null.

JFileChooserFixture

public JFileChooserFixture(@Nonnull
                           Robot robot,
                           @Nullable
                           String fileChooserName)

Creates a new JFileChooserFixture.

Parameters:

robot - performs simulation of user events on a JFileChooser.

fileChooserName - the name of the JFileChooser to find using the given RobotFixture.

Throws:

NullPointerException - if robot is null.

ComponentLookupException - if a matching JFileChooser could not be found.

ComponentLookupException - if more than one matching JFileChooser is found.

Method Detail

createDriver

@Nonnull
protected JFileChooserDriver createDriver(@Nonnull
                                                   Robot robot)

Specified by:

createDriver in class AbstractComponentFixture<JFileChooserFixture,JFileChooser,JFileChooserDriver>

approve

public void approve()

Simulates a user pressing the "Approve" button in this fixture's JFileChooser.

Throws:

ComponentLookupException - if the "Approve" button cannot be found.

IllegalStateException - if the "Approve" button is disabled.

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

approveButton

@Nonnull
public JButtonFixture approveButton()

Finds the "Approve" button in this fixture's JFileChooser.

Returns:

the found "Approve" button.

Throws:

ComponentLookupException - if the "Approve" button cannot be found.

cancel

public void cancel()

Simulates a user pressing the "Cancel" button in this fixture's JFileChooser.

Throws:

ComponentLookupException - if the "Cancel" button cannot be found.

IllegalStateException - if the "Cancel" button is disabled.

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

cancelButton

@Nonnull
public JButtonFixture cancelButton()

Finds the "Cancel" button in this fixture's JFileChooser.

Returns:

the found "Cancel" button.

Throws:

ComponentLookupException - if the "Cancel" button cannot be found.

fileNameTextBox

@Nonnull
public JTextComponentFixture fileNameTextBox()

Returns a fixture that manages the field where the user can enter the name of the file to select in this fixture's JFileChooser.

Returns:

the created fixture.

Throws:

ComponentLookupException - if a matching textToMatch field could not be found.

selectFile

@Nonnull
public JFileChooserFixture selectFile(@Nonnull
                                               File file)

Selects the given file in this fixture's JFileChooser.

Parameters:

file - the file to select.

Returns:

this fixture.

Throws:

NullPointerException - if the given file is null.

IllegalStateException - if this fixture's JFileChooser is disabled.

IllegalStateException - if this fixture's JFileChooser is not showing on the screen.

IllegalArgumentException - if this fixture's JFileChooser can select directories only and the file to select is not a directory.

IllegalArgumentException - if this fixture's JFileChooser cannot select directories and the file to select is a directory.

selectFiles

@Nonnull
public JFileChooserFixture selectFiles(@Nonnull
                                                File... files)

Selects the given files in this fixture's JFileChooser.

Parameters:

files - the files to select.

Returns:

this fixture.

Throws:

NullPointerException - if the given array of files is null.

IllegalArgumentException - if the given array of files is empty.

IllegalStateException - if this fixture's JFileChooser is disabled.

IllegalStateException - if this fixture's JFileChooser is not showing on the screen.

IllegalStateException - if this fixture's JFileChooser does not support multiple selection and there is more than one file to select.

IllegalArgumentException - if this fixture's JFileChooser can select directories only and any of the files to select is not a directory.

IllegalArgumentException - if this fixture's JFileChooser cannot select directories and any of the files to select is a directory.

setCurrentDirectory

@Nonnull
public JFileChooserFixture setCurrentDirectory(@Nonnull
                                                        File dir)

Sets the current directory of this fixture's JFileChooser to the given one.

Parameters:

dir - the directory to set as current.

Returns:

this fixture.

Throws:

IllegalStateException - if this fixture's JFileChooser is disabled.

IllegalStateException - if this fixture's JFileChooser is not showing on the screen.