org.testifyproject.TestContext Maven / Gradle / Ivy

Go to download
/*
 * Copyright 2016-2017 Testify 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 org.testifyproject;

import java.util.Map;
import java.util.Optional;
import org.testifyproject.trait.LoggingTrait;
import org.testifyproject.trait.PropertiesTrait;

/**
 * A small context class that contains reference to the test testInstance, the
 * test testDescriptor, and helper methods.
 *
 * @author saden
 */
public interface TestContext extends LoggingTrait, PropertiesTrait {

    /**
     * Get a unique name to identify the test context.
     *
     * @return a unique test context name
     */
    String getName();

    /**
     * Get the simple name of the test class.
     *
     * @return the test class simple name
     */
    String getTestName();

    /**
     * Get the name of the test method associated with the test context.
     *
     * @return test method name
     */
    String getMethodName();

    /**
     * Get test class associated with the test context.
     *
     * @return the test class instance
     */
    Class getTestClass();

    /**
     * Get the test class descriptor.
     *
     * @return the test class descriptor.
     */
    TestDescriptor getTestDescriptor();

    /**
     * Get the class under test descriptor.
     *
     * @return an optional with cut descriptor, empty optional otherwise
     */
    Optional getCutDescriptor();

    /**
     * Get the test class instance.
     *
     * @return an instance of the test class.
     */
    Object getTestInstance();

    /**
     * get the cut class instance.
     *
     * @param  cut instance type
     * @return an instance of the cut class.
     */
     Optional getCutInstance();

    /**
     * Get the test runner associated with the test context.
     *
     * @return test runner instance
     */
    TestRunner getTestRunner();

    /**
     * Get the test reifier associated with the test context.
     *
     * @return test reifier instance
     */
    TestReifier getTestReifier();

    /**
     * Get the mock provider associated with the test context.
     *
     * @return mock provider instance
     */
    MockProvider getMockProvider();

    /**
     * Get the service instance associated with the test context.
     *
     * @return an optional with service instance, empty optional otherwise
     */
    Optional getServiceInstance();

    /**
     * Get dependencies required to run the tests. The fully qualified name of
     * the class required in the classpath is the key and human readable
     * description is the value.
     *
     * @return a map that contains required dependencies
     */
    Map getDependencies();

    /**
     * Indicates whether test resources such as required or container resources
     * should be eagerly started. Note that during integration tests required
     * resources and containers can be started right before the test case is
     * executed but in system tests the start of resources and containers must
     * be delayed until the application server is running.
     *
     * @return resource start strategy
     */
    StartStrategy getResourceStartStrategy();

}