/*
* Created on Nov 17, 2007
*
* 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 @2007-2009 the original author or authors.
*/
package org.fest.swing.junit.v4_3_1.runner;
import static org.junit.runner.Description.createSuiteDescription;
import static org.junit.runner.Description.createTestDescription;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.List;
import org.fest.swing.junit.runner.FailureScreenshotTaker;
import org.fest.swing.junit.runner.ImageFolderCreator;
import org.junit.Test;
import org.junit.internal.runners.*;
import org.junit.runner.Description;
import org.junit.runner.Runner;
import org.junit.runner.notification.RunNotifier;
/**
* Understands a JUnit 4.3.1 test runner that takes a screenshot of a failed GUI test.
*
* @author Alex Ruiz
* @author Yvonne Wang
*/
public class GUITestRunner extends Runner {
private final List<Method> testMethods;
private final Class<?> testClass;
private final FailureScreenshotTaker screenshotTaker;
/**
* Creates a new <code>{@link GUITestRunner}</code>.
* @param testClass the class containing the tests to run.
* @throws InitializationError if something goes wrong when creating this runner.
*/
public GUITestRunner(Class<?> testClass) throws InitializationError {
this.testClass = testClass;
testMethods = new TestIntrospector(testClass).getTestMethods(Test.class);
validate();
screenshotTaker = new FailureScreenshotTaker(new ImageFolderCreator().createImageFolder());
}
private void validate() throws InitializationError {
MethodValidator methodValidator = new MethodValidator(testClass);
methodValidator.validateMethodsForDefaultRunner();
methodValidator.assertValid();
}
/**
* Run the tests for this runner, taking screenshots of failing tests.
* @param notifier will be notified of events while tests are being run, started, finishing, and failing.
*/
@Override
public void run(RunNotifier notifier) {
new InnerRunner(this, notifier).runProtected();
}
// called by InnerRunner
void doRun(RunNotifier notifier) {
if (testMethods.isEmpty()) notifier.testAborted(getDescription(), new Exception("No runnable methods"));
for (Method method : testMethods)
invokeTestMethod(method, notifier);
}
private void invokeTestMethod(Method method, RunNotifier notifier) {
Object test;
try {
test = testClass.getConstructor().newInstance();
} catch (InvocationTargetException e) {
notifier.testAborted(descriptionOf(method), e.getCause());
return;
} catch (Exception e) {
notifier.testAborted(descriptionOf(method), e);
return;
}
createMethodRunner(test, method, notifier).run();
}
private MethodRunner createMethodRunner(Object test, Method method, RunNotifier notifier) {
return new MethodRunner(new TestInfo(test, testClass, method), notifier, screenshotTaker);
}
final Class<?> testClass() {
return testClass;
}
/**
* Returns a <code>{@link Description}</code> showing the tests to be run by the receiver.
* @return a <code>Description</code> showing the tests to be run by the receiver.
*/
public Description getDescription() {
Description spec = createSuiteDescription(testClass.getName());
for (Method method : testMethods)
spec.addChild(descriptionOf(method));
return spec;
}
private Description descriptionOf(Method method) {
return createTestDescription(testClass, method.getName());
}
}