org.assertj.swing.fixture.ComponentContainerFixture Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of assertj-swing Show documentation
Show all versions of assertj-swing Show documentation
Fluent interface for functional GUI testing
/*
* Created on Jan 13, 2009
*
* 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.
*
* Copyright @2009-2013 the original author or authors.
*/
package org.assertj.swing.fixture;
import java.awt.Component;
import java.awt.Dialog;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.swing.JButton;
import javax.swing.JCheckBox;
import javax.swing.JComboBox;
import javax.swing.JFileChooser;
import javax.swing.JLabel;
import javax.swing.JList;
import javax.swing.JMenuItem;
import javax.swing.JPanel;
import javax.swing.JProgressBar;
import javax.swing.JRadioButton;
import javax.swing.JScrollBar;
import javax.swing.JScrollPane;
import javax.swing.JSlider;
import javax.swing.JSpinner;
import javax.swing.JSplitPane;
import javax.swing.JTabbedPane;
import javax.swing.JTable;
import javax.swing.JToggleButton;
import javax.swing.JToolBar;
import javax.swing.JTree;
import javax.swing.text.JTextComponent;
import org.assertj.swing.annotation.RunsInEDT;
import org.assertj.swing.core.GenericTypeMatcher;
import org.assertj.swing.exception.ComponentLookupException;
import org.assertj.swing.exception.WaitTimedOutError;
import org.assertj.swing.timing.Timeout;
/**
* Looks up AWT or Swing {@code Component}s in a {@code Container}.
*
* @author Alex Ruiz
*/
public interface ComponentContainerFixture {
/**
* Returns a {@link JButton} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JButton} found.
* @throws ComponentLookupException if a {@code JButton} could not be found.
* @throws ComponentLookupException if more than one {@code JButton} is found.
*/
@RunsInEDT
@Nonnull
JButtonFixture button();
/**
* Finds a {@link JButton} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JButton}.
* @return a fixture that manages the {@code JButton} found.
* @throws ComponentLookupException if a {@code JButton} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JButton} that matches the given search criteria is found.
*/
@RunsInEDT
@Nonnull
JButtonFixture button(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@link JButton} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JButton} found.
* @throws ComponentLookupException if a {@code JButton} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JButton} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JButtonFixture button(@Nullable String name);
/**
* Returns a {@code JCheckBox} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JCheckBox} found.
* @throws ComponentLookupException if a {@code JCheckBox} could not be found.
* @throws ComponentLookupException if more than one {@code JCheckBox} is found.
*/
@RunsInEDT
@Nonnull
JCheckBoxFixture checkBox();
/**
* Finds a {@code JCheckBox} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JCheckBox}.
* @return a fixture that manages the {@code JCheckBox} found.
* @throws ComponentLookupException if a {@code JCheckBox} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JCheckBox} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JCheckBoxFixture checkBox(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JCheckBox} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JCheckBox} found.
* @throws ComponentLookupException if a {@code JCheckBox} having a matching name could not be found.
*/
@RunsInEDT
@Nonnull
JCheckBoxFixture checkBox(@Nullable String name);
/**
* Returns a {@code JComboBox} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JComboBox} found.
* @throws ComponentLookupException if a {@code JComboBox} could not be found.
* @throws ComponentLookupException if more than one {@code JComboBox} is found.
*/
@RunsInEDT
@Nonnull
JComboBoxFixture comboBox();
/**
* Finds a {@code JComboBox} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JComboBox}.
* @return a fixture that manages the {@code JComboBox} found.
* @throws ComponentLookupException if a {@code JComboBox} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JComboBox} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JComboBoxFixture comboBox(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JComboBox} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JComboBox} found.
* @throws ComponentLookupException if a {@code JComboBox} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JComboBox} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JComboBoxFixture comboBox(@Nullable String name);
/**
* Returns the only {@code Dialog} currently available (if any.) This method uses the value defined in
* {@link #defaultDialogLookupTimeout()} as the default lookup timeout.
*
* @return a fixture that manages the {@code Dialog} found.
* @throws WaitTimedOutError if a {@code Dialog} could not be found.
* @see #dialog(Timeout)
*/
@RunsInEDT
@Nonnull
DialogFixture dialog();
/**
* Returns the only {@code Dialog} currently available (if any.)
*
* @param timeout the amount of time to wait for a {@code Dialog} to be found.
* @return a fixture that manages the {@code Dialog} found.
* @throws WaitTimedOutError if a {@code Dialog} could not be found.
*/
@RunsInEDT
@Nonnull
DialogFixture dialog(@Nonnull Timeout timeout);
/**
* Finds a {@code Dialog} that matches the specified search criteria. This method uses the value defined in
* {@link #defaultDialogLookupTimeout()} as the default lookup timeout.
*
* @param matcher contains the search criteria for finding a {@code Dialog}.
* @return a fixture that manages the {@code Dialog} found.
* @throws WaitTimedOutError if a {@code Dialog} that matches the given search criteria could not be found.
* @see #dialog(GenericTypeMatcher, Timeout)
*/
@RunsInEDT
@Nonnull
DialogFixture dialog(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code Dialog} that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code Dialog}.
* @param timeout the amount of time to wait for a {@code Dialog} to be found.
* @return a fixture that manages the {@code Dialog} found.
* @throws WaitTimedOutError if a {@code Dialog} that matches the given search criteria could not be found.
*/
@RunsInEDT
@Nonnull
DialogFixture dialog(@Nonnull GenericTypeMatcher matcher, @Nonnull Timeout timeout);
/**
* Finds a {@code Dialog} with a name matching the specified one. This method uses the value defined in
* {@link #defaultDialogLookupTimeout()} as the default lookup timeout.
*
* @param name the name to match.
* @return a fixture that manages the {@code Dialog} found.
* @throws WaitTimedOutError if a {@code Dialog} that a matching name could not be found.
* @see #dialog(String, Timeout)
*/
@RunsInEDT
@Nonnull
DialogFixture dialog(@Nullable String name);
/**
* Finds a {@code Dialog} with a name matching the specified one.
*
* @param name the name to match.
* @param timeout the amount of time to wait for a {@code Dialog} to be found.
* @return a fixture that manages the {@code Dialog} found.
* @throws WaitTimedOutError if a {@code Dialog} that a matching name could not be found.
*/
@RunsInEDT
@Nonnull
DialogFixture dialog(@Nullable String name, @Nonnull Timeout timeout);
/**
* Returns the only {@code JFileChooser} currently available (if any.) This method uses the value defined in
* {@link #defaultDialogLookupTimeout()} as the default lookup timeout.
*
* @return a fixture that manages the {@code JFileChooser} found.
* @throws WaitTimedOutError if a {@code JFileChooser} could not be found.
* @see #fileChooser(Timeout)
*/
@RunsInEDT
@Nonnull
JFileChooserFixture fileChooser();
/**
* Returns the only {@code JFileChooser} currently available (if any.)
*
* @param timeout the amount of time to wait for a {@code JFileChooser} to be found.
* @return a fixture that manages the {@code JFileChooser} found.
* @throws WaitTimedOutError if a {@code JFileChooser} could not be found.
*/
@RunsInEDT
@Nonnull
JFileChooserFixture fileChooser(@Nonnull Timeout timeout);
/**
* Finds a {@code JFileChooser} that matches the specified search criteria. This method uses the value defined in
* {@link #defaultDialogLookupTimeout()} as the default lookup timeout.
*
* @param matcher contains the search criteria for finding a {@code JFileChooser}.
* @return a fixture that manages the {@code JFileChooser} found.
* @throws WaitTimedOutError if a {@code JFileChooser} could not be found.
* @see #fileChooser(GenericTypeMatcher, Timeout)
*/
@RunsInEDT
@Nonnull
JFileChooserFixture fileChooser(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JFileChooser} that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JFileChooser}.
* @param timeout the amount of time to wait for a {@code JFileChooser} to be found.
* @return a fixture that manages the {@code JFileChooser} found.
* @throws WaitTimedOutError if a {@code JFileChooser} could not be found.
*/
@RunsInEDT
@Nonnull
JFileChooserFixture fileChooser(@Nonnull GenericTypeMatcher matcher, @Nonnull Timeout timeout);
/**
* Finds a {@code JFileChooser} with a name matching the specified one. This method uses the value defined in
* {@link #defaultDialogLookupTimeout()} as the default lookup timeout.
*
* @param name the name to match.
* @return a fixture that manages the {@code JFileChooser} found.
* @throws WaitTimedOutError if a {@code JFileChooser} could not be found.
* @see #fileChooser(String, Timeout)
*/
@RunsInEDT
@Nonnull
JFileChooserFixture fileChooser(@Nullable String name);
/**
* Finds a {@code JFileChooser} with a name matching the specified one.
*
* @param name the name to match.
* @param timeout the amount of time to wait for a {@code JFileChooser} to be found.
* @return a fixture that manages the {@code JFileChooser} found.
* @throws WaitTimedOutError if a {@code JFileChooser} could not be found.
*/
@RunsInEDT
@Nonnull
JFileChooserFixture fileChooser(@Nullable String name, @Nonnull Timeout timeout);
/**
* Returns a {@code JLabel} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JLabel} found.
* @throws ComponentLookupException if a {@code JLabel} could not be found.
* @throws ComponentLookupException if more than one {@code JLabel} is found.
*/
@RunsInEDT
@Nonnull
JLabelFixture label();
/**
* Finds a {@code JLabel} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JLabel}.
* @return a fixture that manages the {@code JLabel} found.
* @throws ComponentLookupException if a {@code JLabel} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JLabel} that matches the given search criteria is found.
*/
@RunsInEDT
@Nonnull
JLabelFixture label(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JLabel} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JLabel} found.
* @throws ComponentLookupException if a {@code JLabel} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JLabel} having a matching name could is found.
*/
@RunsInEDT
@Nonnull
JLabelFixture label(@Nullable String name);
/**
* Returns a {@code JList} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JList} found.
* @throws ComponentLookupException if a {@code JList} could not be found.
* @throws ComponentLookupException if more than one {@code JList} is found.
*/
@RunsInEDT
@Nonnull
JListFixture list();
/**
* Finds a {@code JList} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JList}.
* @return a fixture that manages the {@code JList} found.
* @throws ComponentLookupException if a {@code JList} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JList} that matches the given search criteria is found.
*/
@RunsInEDT
@Nonnull
JListFixture list(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JList} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JList} found.
* @throws ComponentLookupException if a {@code JList} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JList} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JListFixture list(@Nullable String name);
/**
* Finds a {@code JMenuItem} in this fixture's {@code Container}, which path matches the given one.
*
* For example, if we are looking for the menu with text "New" contained under the menu with text "File", we can
* simply call
*
*
* JMenuItemFixture menuItem = container.menuItemWithPath("File", "Menu");
*
*
*
*
* @param path the path of the menu to find.
* @return a fixture that manages the {@code JMenuItem} found.
* @throws ComponentLookupException if a {@code JMenuItem} under the given path could not be found.
* @throws AssertionError if the {@code Component} found under the given path is not a {@code JMenuItem}.
*/
@RunsInEDT
@Nonnull
JMenuItemFixture menuItemWithPath(@Nonnull String... path);
/**
* Finds a {@code JMenuItem}, contained in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JMenuItem} found.
* @throws ComponentLookupException if a {@code JMenuItem} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JMenuItem} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JMenuItemFixture menuItem(@Nullable String name);
/**
* Finds a {@code JMenuItem}, contained in this fixture's {@code Container}, that matches the specified search
* criteria.
*
* @param matcher contains the search criteria for finding a {@code JMenuItem}.
* @return a fixture that manages the {@code JMenuItem} found.
* @throws ComponentLookupException if a {@code JMenuItem} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JMenuItem} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JMenuItemFixture menuItem(@Nonnull GenericTypeMatcher matcher);
/**
* Returns the only {@code JOptionPane} currently available (if any.) This method uses the value defined in
* {@link #defaultDialogLookupTimeout()} as the default lookup timeout.
*
* @return a fixture that manages the {@code JOptionPane} found.
* @throws WaitTimedOutError if a {@code JOptionPane} could not be found.
* @see #optionPane(Timeout)
*/
@RunsInEDT
@Nonnull
JOptionPaneFixture optionPane();
/**
* Returns the only {@code JOptionPane} currently available (if any.)
*
* @param timeout the amount of time to wait for a {@code JOptionPane} to be found.
* @return a fixture that manages the {@code JOptionPane} found.
* @throws WaitTimedOutError if a {@code JOptionPane} could not be found.
*/
@RunsInEDT
@Nonnull
JOptionPaneFixture optionPane(@Nonnull Timeout timeout);
/**
* Returns a {@code JPanel} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JPanel} found.
* @throws ComponentLookupException if a {@code JPanel} could not be found.
* @throws ComponentLookupException if more than one {@code JPanel} is found.
*/
@RunsInEDT
@Nonnull
JPanelFixture panel();
/**
* Finds a {@code JPanel} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JPanel}.
* @return a fixture that manages the {@code JPanel} found.
* @throws ComponentLookupException if a {@code JPanel} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JPanel} that matches the given search criteria is found.
*/
@RunsInEDT
@Nonnull
JPanelFixture panel(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JPanel} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JPanel} found.
* @throws ComponentLookupException if a {@code JPanel} having a matching name could not be found.
*/
@RunsInEDT
@Nonnull
JPanelFixture panel(@Nullable String name);
/**
* Returns a {@code JProgressBar} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JProgressBar} found.
* @throws ComponentLookupException if a {@code JProgressBar} could not be found.
* @throws ComponentLookupException if more than one {@code JProgressBar} is found.
*/
@RunsInEDT
@Nonnull
JProgressBarFixture progressBar();
/**
* Finds a {@code JProgressBar} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JProgressBar}.
* @return a fixture that manages the {@code JProgressBar} found.
* @throws ComponentLookupException if a {@code JProgressBar} that matches the given search criteria could not be
* found.
* @throws ComponentLookupException if more than one {@code JProgressBar} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JProgressBarFixture progressBar(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JProgressBar} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JProgressBar} found.
* @throws ComponentLookupException if a {@code JProgressBar} having a matching name could not be found.
*/
@RunsInEDT
@Nonnull
JProgressBarFixture progressBar(@Nullable String name);
/**
* Returns a {@code JRadioButton} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JRadioButton} found.
* @throws ComponentLookupException if a {@code JRadioButton} could not be found.
* @throws ComponentLookupException if more than one {@code JRadioButton} is found.
*/
@RunsInEDT
@Nonnull
JRadioButtonFixture radioButton();
/**
* Finds a {@code JRadioButton} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JRadioButton}.
* @return a fixture that manages the {@code JRadioButton} found.
* @throws ComponentLookupException if a {@code JRadioButton} that matches the given search criteria could not be
* found.
* @throws ComponentLookupException if more than one {@code JRadioButton} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JRadioButtonFixture radioButton(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JRadioButton} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JRadioButton} found.
* @throws ComponentLookupException if a {@code JRadioButton} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JRadioButton} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JRadioButtonFixture radioButton(@Nullable String name);
/**
* Returns a {@code JScrollBar} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JScrollBar} found.
* @throws ComponentLookupException if a {@code JScrollBar} could not be found.
* @throws ComponentLookupException if more than one {@code JScrollBar} is found.
*/
@RunsInEDT
@Nonnull
JScrollBarFixture scrollBar();
/**
* Finds a {@code JScrollBar} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JScrollBar}.
* @return a fixture that manages the {@code JScrollBar} found.
* @throws ComponentLookupException if a {@code JScrollBar} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JScrollBar} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JScrollBarFixture scrollBar(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JScrollBar} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JScrollBar} found.
* @throws ComponentLookupException if a {@code JScrollBar} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JScrollBar} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JScrollBarFixture scrollBar(@Nullable String name);
/**
* Returns a {@code JScrollPane} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JScrollPane} found.
* @throws ComponentLookupException if a {@code JScrollPane} could not be found.
* @throws ComponentLookupException if more than one {@code JScrollPane} is found.
*/
@RunsInEDT
@Nonnull
JScrollPaneFixture scrollPane();
/**
* Finds a {@code JScrollPane} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JScrollPane}.
* @return a fixture that manages the {@code JScrollPane} found.
* @throws ComponentLookupException if a {@code JScrollPane} that matches the given search criteria could not be
* found.
* @throws ComponentLookupException if more than one {@code JScrollPane} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JScrollPaneFixture scrollPane(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JScrollPane} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JScrollPane} found.
* @throws ComponentLookupException if a {@code JScrollPane} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JScrollPane} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JScrollPaneFixture scrollPane(@Nullable String name);
/**
* Returns a {@code JSlider} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JSlider} found.
* @throws ComponentLookupException if a {@code JSlider} could not be found.
* @throws ComponentLookupException if more than one {@code JSlider} is found.
*/
@RunsInEDT
@Nonnull
JSliderFixture slider();
/**
* Finds a {@code JSlider} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JSlider}.
* @return a fixture that manages the {@code JSlider} found.
* @throws ComponentLookupException if a {@code JSlider} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JSlider} that matches the given search criteria is found.
*/
@RunsInEDT
@Nonnull
JSliderFixture slider(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JSlider} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JSlider} found.
* @throws ComponentLookupException if a {@code JSlider} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JSlider} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JSliderFixture slider(@Nullable String name);
/**
* Returns a {@code JSpinner} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JSpinner} found.
* @throws ComponentLookupException if a {@code JSpinner} could not be found.
* @throws ComponentLookupException if more than one {@code JSpinner} is found.
*/
@RunsInEDT
@Nonnull
JSpinnerFixture spinner();
/**
* Finds a {@code JSpinner} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JSpinner}.
* @return a fixture that manages the {@code JSpinner} found.
* @throws ComponentLookupException if a {@code JSpinner} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JSpinner} that matches the given search criteria is found.
*/
@RunsInEDT
@Nonnull
JSpinnerFixture spinner(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JSpinner} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JSpinner} found.
* @throws ComponentLookupException if a {@code JSpinner} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JSpinner} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JSpinnerFixture spinner(@Nullable String name);
/**
* Returns the {@code JSplitPane} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JSplitPane} found.
* @throws ComponentLookupException if a {@code JSplitPane} could not be found.
* @throws ComponentLookupException if more than one {@code JSplitPane} is found.
*/
@RunsInEDT
@Nonnull
JSplitPaneFixture splitPane();
/**
* Finds a {@code JSplitPane} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JSplitPane}.
* @return a fixture that manages the {@code JSplitPane} found.
* @throws ComponentLookupException if a {@code JSplitPane} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JSplitPane} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JSplitPaneFixture splitPane(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JSplitPane} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JSplitPane} found.
* @throws ComponentLookupException if a {@code JSplitPane} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JSplitPane} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JSplitPaneFixture splitPane(@Nullable String name);
/**
* Returns a {@code JTabbedPane} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JTabbedPane} found.
* @throws ComponentLookupException if a {@code JTabbedPane} could not be found.
* @throws ComponentLookupException if more than one {@code JTabbedPane} is found.
*/
@RunsInEDT
@Nonnull
JTabbedPaneFixture tabbedPane();
/**
* Finds a {@code JTabbedPane} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JTabbedPane}.
* @return a fixture that manages the {@code JTabbedPane} found.
* @throws ComponentLookupException if a {@code JTabbedPane} that matches the given search criteria could not be
* found.
* @throws ComponentLookupException if more than one {@code JTabbedPane} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JTabbedPaneFixture tabbedPane(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JTabbedPane} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JTabbedPane} found.
* @throws ComponentLookupException if a {@code JTabbedPane} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JTabbedPane} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JTabbedPaneFixture tabbedPane(@Nullable String name);
/**
* Returns a {@code JTable} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JTable} found.
* @throws ComponentLookupException if a {@code JTable} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JTable} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JTableFixture table();
/**
* Finds a {@code JTable} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JTable}.
* @return a fixture that manages the {@code JTable} found.
* @throws ComponentLookupException if a {@code JTable} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JTable} that matches the given search criteria is found.
*/
@RunsInEDT
@Nonnull
JTableFixture table(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JTable} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JTable} found.
* @throws ComponentLookupException if a {@code JTable} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JTable} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JTableFixture table(@Nullable String name);
/**
* Returns a {@code JTextComponent} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JTextComponent} found.
* @throws ComponentLookupException if a {@code JTextComponent} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JTextComponent} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JTextComponentFixture textBox();
/**
* Finds a {@code JTextComponent} in this fixture's {@code Container} managed by this fixture, that matches the
* specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JTextComponent}.
* @return a fixture that manages the {@code JTextComponent} found.
* @throws ComponentLookupException if a {@code JTextComponent} that matches the given search criteria could not be
* found.
* @throws ComponentLookupException if more than one {@code JTextComponent} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JTextComponentFixture textBox(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JTextComponent} in this fixture's {@code Container} managed by this fixture, which name matches the
* specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JTextComponent} found.
* @throws ComponentLookupException if a {@code JTextComponent} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JTextComponent} having a matching name is found.
*/
JTextComponentFixture textBox(String name);
/**
* Returns a {@code JToggleButton} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JToggleButton} found.
* @throws ComponentLookupException if a {@code JToggleButton} could not be found.
* @throws ComponentLookupException if more than one {@code JToggleButton} is found.
*/
@RunsInEDT
@Nonnull
JToggleButtonFixture toggleButton();
/**
* Finds a {@code JToggleButton} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JToggleButton}.
* @return a fixture that manages the {@code JToggleButton} found.
* @throws ComponentLookupException if a {@code JToggleButton} that matches the given search criteria could not be
* found.
* @throws ComponentLookupException if more than one {@code JToggleButton} that matches the given search criteria is
* found.
*/
@RunsInEDT
@Nonnull
JToggleButtonFixture toggleButton(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JToggleButton} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JToggleButton} found.
* @throws ComponentLookupException if a {@code JToggleButton} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JToggleButton} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JToggleButtonFixture toggleButton(@Nullable String name);
/**
* Returns a {@code JToolBar} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JToolBar} found.
* @throws ComponentLookupException if a {@code JToolBar} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JToolBar} having a matching name could is found.
*/
@RunsInEDT
@Nonnull
JToolBarFixture toolBar();
/**
* Finds a {@code JToolBar} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JToolBar}.
* @return a fixture that manages the {@code JToolBar} found.
* @throws ComponentLookupException if a {@code JToolBar} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JToolBar} that matches the given search criteria is found.
*/
@RunsInEDT
@Nonnull
JToolBarFixture toolBar(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JToolBar} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JToolBar} found.
* @throws ComponentLookupException if a {@code JToolBar} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JToolBar} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JToolBarFixture toolBar(@Nullable String name);
/**
* Returns a {@code JTree} found in this fixture's {@code Container}.
*
* @return a fixture that manages the {@code JTree} found.
* @throws ComponentLookupException if a {@code JTree} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JTree} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JTreeFixture tree();
/**
* Finds a {@code JTree} in this fixture's {@code Container}, that matches the specified search criteria.
*
* @param matcher contains the search criteria for finding a {@code JTree}.
* @return a fixture that manages the {@code JTree} found.
* @throws ComponentLookupException if a {@code JTree} that matches the given search criteria could not be found.
* @throws ComponentLookupException if more than one {@code JTree} that matches the given search criteria is found.
*/
@RunsInEDT
@Nonnull
JTreeFixture tree(@Nonnull GenericTypeMatcher matcher);
/**
* Finds a {@code JTree} in this fixture's {@code Container}, which name matches the specified one.
*
* @param name the name to match.
* @return a fixture that manages the {@code JTree} found.
* @throws ComponentLookupException if a {@code JTree} having a matching name could not be found.
* @throws ComponentLookupException if more than one {@code JTree} having a matching name is found.
*/
@RunsInEDT
@Nonnull
JTreeFixture tree(@Nullable String name);
/**
* Returns a {@link AbstractComponentFixture} managing a component inside this fixture's {@code Container}. This is an
* extension method, to allow implementations of {@link AbstractContainerFixture} handle custom GUI components.
*
* @param extension the {@code ComponentFixtureExtension} that creates the {@code ComponentFixture} to return.
* @return a {@code ComponentFixture} managing a component inside this fixture's {@code Container}.
*/
@RunsInEDT
@Nonnull
> F with(
@Nonnull ComponentFixtureExtension extension);
/**
* @return the timeout to use when looking for a dialog. It's value is 100 ms.
*/
@Nonnull
Timeout defaultDialogLookupTimeout();
}