org.springframework.osgi.util.test.ConditionalTestCase.java Source code

Introduction

Here is the source code for org.springframework.osgi.util.test.ConditionalTestCase.java

Source

/*
 * Copyright 2002-2007 the original author or authors.
 *
 * 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.springframework.osgi.util.test;

import junit.framework.TestCase;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

/**
 * Superclass for JUnit 3.8 based tests that allows conditional test execution
 * at the individual test method level. The
 * {@link #isDisabledInThisEnvironment(String) isDisabledInThisEnvironment()}
 * method is invoked before the execution of each test method. Subclasses can
 * override that method to return whether or not the given test should be
 * executed. Note that the tests will still appear to have executed and passed;
 * however, log output will show that the test was not executed.
 *
 * @author Rod Johnson
 * @since 2.0
 * @see #isDisabledInThisEnvironment
 * @deprecated as of Spring 3.0, in favor of using the listener-based test context framework
 * ({@link org.springframework.test.context.junit4.AbstractJUnit4SpringContextTests})
 */
@Deprecated
public abstract class ConditionalTestCase extends TestCase {

    private static int disabledTestCount;

    /**
     * Return the number of tests disabled in this environment.
     */
    public static int getDisabledTestCount() {
        return disabledTestCount;
    }

    /** Logger available to subclasses */
    protected final Log logger = LogFactory.getLog(getClass());

    /**
     * Default constructor for ConditionalTestCase.
     */
    public ConditionalTestCase() {
    }

    /**
     * Constructor for ConditionalTestCase with a JUnit name.
     */
    public ConditionalTestCase(String name) {
        super(name);
    }

    public void runBare() throws Throwable {
        // getName will return the name of the method being run
        if (isDisabledInThisEnvironment(getName())) {
            recordDisabled();
            this.logger.info("**** " + getClass().getName() + "." + getName() + " is disabled in this environment: "
                    + "Total disabled tests = " + getDisabledTestCount());
            return;
        }

        // Let JUnit handle execution
        super.runBare();
    }

    /**
     * Should this test run?
     * @param testMethodName name of the test method
     * @return whether the test should execute in the current environment
     */
    protected boolean isDisabledInThisEnvironment(String testMethodName) {
        return false;
    }

    /**
     * Record a disabled test.
     * @return the current disabled test count
     */
    protected int recordDisabled() {
        return ++disabledTestCount;
    }

}