org.assertj.swing.finder.package-info Maven / Gradle / Ivy
Show all versions of assertj-swing Show documentation
/*
* 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 2012-2018 the original author or authors.
*/
/**
*
* Utilities for finding {@code Component}s.
*
*
*
* An example is the main window of an application being shown after the user's credentials have been successfully
* verified. The following are the steps to complete such scenario:
*
*
*
* - User launches the application
* - A login window appears
* - User enters her username and password and clicks the "Login" button
* - User is authenticated and authorized successfully
* - The main window of the application is displayed
*
*
*
* The "tricky" part here is step 4. Authentication/authorization can take some time (depending on network
* traffic, etc). and we need to wait for the main window to appear in order to continue our test. It is possible to
* test this scenario with AssertJ-Swing:
*
*
*
* loginDialog.textBox("username").enterText("yvonne");
* loginDialog.textBox("password").enterText("welcome");
* loginDialog.button("login").click();
*
* // now the interesting part, we need to wait till the main window is shown.
* FrameFixture mainFrame = findFrame("main").using(loginDialog.robot);
*
* // we can continue testing the main window.
*
*
*
* The "{@link org.assertj.swing.finder.WindowFinder#findFrame(String) findFrame}" method (imported statically
* from {@link org.assertj.swing.finder.WindowFinder}) can lookup a {@code Frame} (having "main" as its name)
* with a default timeout of 5 seconds. That means that if in 5 seconds the frame we are looking for is not found, the
* test will fail.
*
*
*
* We can also specify a custom value for the timeout. For example, we can set the timeout to 10 seconds in two ways:
*
*
*
* FrameFixture mainFrame = findFrame("main").withTimeout(10000).using(loginDialog.robot);
* // or
* FrameFixture mainFrame = findFrame("main").withTimeout(10, SECONDS).using(loginDialog.robot);
*
*
*
* We can also look up Frames by type:
*
*
*
* FrameFixture mainFrame = findFrame(MainFrame.class).using(loginDialog.robot);
*
*
*
* Something that you may find weird in the code examples is "{@code using(loginDialog.robot)}." This is
* necessary because, in a given test, only one instance of {@link org.assertj.swing.core.Robot Robot} can be running,
* to prevent GUI tests from blocking each other on the screen. In another words, in a test class you can only use one
* and only one instance of {@code Robot}.
*
*
* @author Alex Ruiz
*/
package org.assertj.swing.finder;