org.evosuite.testcase.execution.ExecutionObserver Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of evosuite-client Show documentation
The newest version!
/**
 * Copyright (C) 2010-2018 Gordon Fraser, Andrea Arcuri and EvoSuite
 * contributors
 *
 * This file is part of EvoSuite.
 *
 * EvoSuite is free software: you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as published
 * by the Free Software Foundation, either version 3.0 of the License, or
 * (at your option) any later version.
 *
 * EvoSuite is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with EvoSuite. If not, see .
 */
package org.evosuite.testcase.execution;

import java.util.Arrays;
import java.util.HashSet;
import java.util.Set;

import org.evosuite.testcase.statements.Statement;
import org.evosuite.testcase.TestCase;
import org.evosuite.testcase.variable.VariableReference;

/**
 * Abstract base class of all execution observers
 * 
 * @author Gordon Fraser
 */
public abstract class ExecutionObserver {

	/** The test case being monitored and executed */
	protected static TestCase currentTest = null;

	/** Constant WRAPPER_TYPES */
	protected static final Set> WRAPPER_TYPES = new HashSet>(
	        Arrays.asList(Boolean.class, Character.class, Byte.class, Short.class,
	                      Integer.class, Long.class, Float.class, Double.class,
	                      Void.class));

	/**
	 * 
	 * isWrapperType
	 * 
	 * 
	 * @param clazz
	 *            a {@link java.lang.Class} object.
	 * @return a boolean.
	 */
	protected static boolean isWrapperType(Class clazz) {
		return WRAPPER_TYPES.contains(clazz);
	}

	/**
	 * Setter method for current test case
	 * 
	 * @param test
	 *            a {@link org.evosuite.testcase.TestCase} object.
	 */
	public static void setCurrentTest(TestCase test) {
		currentTest = test;
	}

	/**
	 * Getter method for current test case
	 * 
	 * @return a {@link org.evosuite.testcase.TestCase} object.
	 */
	public static TestCase getCurrentTest() {
		return currentTest;
	}

	/**
	 * This is called with the console output of each statement
	 * 
	 * @param position
	 *            a int.
	 * @param output
	 *            a {@link java.lang.String} object.
	 */
	public abstract void output(int position, String output);

	/**
	 * Called immediately before a statement is executed
	 * 
	 * @param statement
	 * @param scope
	 */
	public abstract void beforeStatement(Statement statement, Scope scope);

	/**
	 * After execution of a statement, the result is passed to the observer
	 * 
	 * @param statement
	 *            a {@link org.evosuite.testcase.statements.Statement} object.
	 * @param scope
	 *            a {@link org.evosuite.testcase.execution.Scope} object.
	 * @param exception
	 *            a {@link java.lang.Throwable} object.
	 */
	public abstract void afterStatement(Statement statement, Scope scope,
	        Throwable exception);

	/**
	 * Allow observers to update the execution result at the end the execution of a test.
	 */
	public abstract void testExecutionFinished(ExecutionResult r, Scope s);
	
	/**
	 * Need a way to clear previously produced results
	 */
	public abstract void clear();

	/**
	 * Determine the set of variables that somehow lead to this statement
	 * 
	 * @param statement
	 *            a {@link org.evosuite.testcase.statements.Statement} object.
	 * @return a {@link java.util.Set} object.
	 */
	protected Set getDependentVariables(Statement statement) {
		Set dependencies = new HashSet();
		for (VariableReference var : statement.getVariableReferences()) {
			dependencies.add(var);
			dependencies.addAll(currentTest.getDependencies(var));
		}
		return dependencies;
	}
}