libcore/tools/runner/java/dalvik/runner/TestRun.java

/*
 * Copyright (C) 2009 The Android Open Source Project
 *
 * 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.
 */

package dalvik.runner;

import java.io.File;
import java.io.PrintWriter;
import java.io.StringWriter;
import java.util.Arrays;
import java.util.List;

/**
 * A test run and its outcome. This class tracks the complete lifecycle of a
 * single test run:
 * <ol>
 *   <li>the test source code (test directory, java file, test class)
 *   <li>the test identity (suite name, test name, qualified name)
 *   <li>the code to execute (test classes, user dir)
 *   <li>the result of execution (expected result, result, output lines)
 * </ol>
 */
public final class TestRun {

    private final File testDirectory;
    private final File javaFile;
    private final String testClass;
    private final Class<? extends TestRunner> testRunner;

    private final String suiteName;
    private final String testName;
    private final String qualifiedName;
    private final String description;

    private Classpath testClasspath;
    private File userDir = new File(System.getProperty("user.dir"));

    private ExpectedResult expectedResult = ExpectedResult.SUCCESS;
    private Result result;
    private List<String> outputLines;

    public TestRun(File testDirectory, File javaFile, String testClass,
            String suiteName, String testName, String qualifiedName,
            String description, Class<? extends TestRunner> testRunner) {
        this.qualifiedName = qualifiedName;
        this.suiteName = suiteName;
        this.testName = testName;
        this.testDirectory = testDirectory;
        this.javaFile = javaFile;
        this.description = description;
        this.testClass = testClass;
        this.testRunner = testRunner;
    }

    /**
     * Returns the local directory containing this test's java file.
     */
    public File getTestDirectory() {
        return testDirectory;
    }

    public File getJavaFile() {
        return javaFile;
    }

    /**
     * Returns the executable test's classname, such as java.lang.IntegerTest
     * or BitTwiddle.
     */
    public String getTestClass() {
        return testClass;
    }

    /**
     * Returns the test suite name, such as java.lang.Integer or
     * java.lang.IntegerTest.
     */
    public String getSuiteName() {
        return suiteName;
    }

    /**
     * Returns the specific test name, such as BitTwiddle or testBitTwiddle.
     */
    public String getTestName() {
        return testName;
    }

    /**
     * Returns a unique identifier for this test.
     */
    public String getQualifiedName() {
        return qualifiedName;
    }

    /**
     * Returns an English description of this test, or null if no such
     * description is known.
     */
    public String getDescription() {
        return description;
    }

    public void setExpectedResult(ExpectedResult expectedResult) {
        this.expectedResult = expectedResult;
    }

    /**
     * Initializes the path to the jar file or directory containing test
     * classes.
     */
    public void setTestClasspath(Classpath classpath) {
        this.testClasspath = classpath;
    }

    public Classpath getTestClasspath() {
        return testClasspath;
    }

    /**
     * Initializes the directory from which local files can be read by the test.
     */
    public void setUserDir(File base) {
        this.userDir = base;
    }

    public File getUserDir() {
        return userDir;
    }

    /**
     * Returns true if this test is ready for execution. Such tests have their
     * classpath prepared and have not yet been assigned a result.
     */
    public boolean isRunnable() {
        return testClasspath != null && result == null;
    }

    public void setResult(Result result, Throwable e) {
        setResult(result, throwableToLines(e));
    }

    public void setResult(Result result, List<String> outputLines) {
        if (this.result != null) {
            throw new IllegalStateException();
        }

        this.result = result;
        this.outputLines = outputLines;
    }

    private static List<String> throwableToLines(Throwable t) {
        StringWriter writer = new StringWriter();
        PrintWriter out = new PrintWriter(writer);
        t.printStackTrace(out);
        return Arrays.asList(writer.toString().split("\\n"));
    }

    public Result getResult() {
        return result;
    }

    public List<String> getOutputLines() {
        return outputLines;
    }

    public ExpectedResult getExpectedResult() {
        return expectedResult;
    }

    public Class<? extends TestRunner> getTestRunner() {
        return testRunner;
    }
}