| Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
| ICondition |
|
| 1.0;1 |
| 1 | /******************************************************************************* | |
| 2 | * Copyright (c) 2008 Ketan Padegaonkar and others. | |
| 3 | * All rights reserved. This program and the accompanying materials | |
| 4 | * are made available under the terms of the Eclipse Public License v1.0 | |
| 5 | * which accompanies this distribution, and is available at | |
| 6 | * http://www.eclipse.org/legal/epl-v10.html | |
| 7 | * | |
| 8 | * Contributors: | |
| 9 | * Ketan Padegaonkar - initial API and implementation | |
| 10 | *******************************************************************************/ | |
| 11 | package org.eclipse.swtbot.swt.finder.waits; | |
| 12 | ||
| 13 | import org.eclipse.swtbot.swt.finder.SWTBot; | |
| 14 | ||
| 15 | /** | |
| 16 | * @author Ketan Padegaonkar <KetanPadegaonkar [at] gmail [dot] com> | |
| 17 | * @see Conditions | |
| 18 | * @version $Id$ | |
| 19 | * @since 1.2 | |
| 20 | */ | |
| 21 | public interface ICondition { | |
| 22 | ||
| 23 | /** | |
| 24 | * Tests if the condition has been met. | |
| 25 | * | |
| 26 | * @return <code>true</code> if the condition is satisfied, <code>false</code> otherwise. | |
| 27 | * @throws Exception if the test encounters an error while processing the check. | |
| 28 | */ | |
| 29 | boolean test() throws Exception; | |
| 30 | ||
| 31 | /** | |
| 32 | * Initializes the condition with the given {@link SWTBot} instance. This should never be <code>null</code>. | |
| 33 | * | |
| 34 | * @param bot the SWTBot instance that this instance may use to evaluate the test. | |
| 35 | */ | |
| 36 | void init(SWTBot bot); | |
| 37 | ||
| 38 | /** | |
| 39 | * Gets the failure message when a test fails (returns <code>false</code>). | |
| 40 | * | |
| 41 | * @return the failure message to show in case the test fails. | |
| 42 | */ | |
| 43 | String getFailureMessage(); | |
| 44 | } |