java/testing/org/apache/derbyTesting/unitTests/harness/T_MultiIterations.java

/*

   Derby - Class org.apache.derbyTesting.unitTests.harness.T_MultiIterations

   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You 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.apache.derbyTesting.unitTests.harness;

import org.apache.derby.iapi.services.monitor.Monitor;
import org.apache.derby.iapi.services.property.PropertyUtil;

import java.util.Properties;

/**
	Abstract class which executes T_Generic. This splits the running
	of a test into two parts, the test setup and running the test.
	This allows the setup to be performed once, and then the
	test itself to be run for a number of iterations. The number
	iterations is set by the property derby.unittests.iterations
	and defaults to 1.
	<P>
	Statistics are provided about each iteration in the error log. The statistics
	are time for each iteration, used and total memory changes per iteration.

	@see T_Generic
*/
public abstract class T_MultiIterations extends T_Generic
{
	protected T_MultiIterations()
	{
		super();
	}

	/*
	** methods required by T_Generic
	*/

	
	/**
	  Run the test. The test should raise an exception if it
	  fails. runTests should return if the tests pass.

	  @exception T_Fail Test code throws these
	  */
	protected void runTests() throws T_Fail {

		setupTest();

		int	iterations = 1;

		/*
		** The property name for the number of iterations is
		** derby.className.iterations.  For example, if the test
		** class is derby.com.package.to.test.T_Tester,
		** the property name is derby.T_Tester.iterations.
		*/
		String myClass = this.getClass().getName();
		String noPackage = myClass.substring(myClass.lastIndexOf('.') + 1);
		String propertyName = "derby." + noPackage + ".iterations";

		String iter = PropertyUtil.getSystemProperty(propertyName);
		if (iter != null) {
			try {
				iterations = Integer.parseInt(iter);
			} catch (NumberFormatException nfe) {
				// leave at one
			}
			if (iterations <= 0)
				iterations = 1;
		}

		for (int i = 0; i < iterations; i++) {
			Runtime.getRuntime().gc();
			long btm = Runtime.getRuntime().totalMemory();
			long bfm = Runtime.getRuntime().freeMemory();
			long bum = btm - bfm;

			long start = System. currentTimeMillis();

			runTestSet();

			long end = System. currentTimeMillis();

			Runtime.getRuntime().gc();
			long atm = Runtime.getRuntime().totalMemory();
			long afm = Runtime.getRuntime().freeMemory();
			long aum = atm - afm;

			out.println("Iteration " + i + " took " + (end - start) + "ms");
			out.println("Total memory increased by " + (atm - btm) + " is " + atm);
			out.println("Used  memory increased by " + (aum - bum) + " is " + aum);
		}
	}

	/*
	**	  Abstract methods to implement for your test.
	*/

	/**
		Run once to set up the test.

        @exception T_Fail Test code throws these
	*/
	protected abstract void setupTest() throws T_Fail;

	/**
		Run once per-iteration to run the actual test.

        @exception T_Fail Test code throws these
	*/
	protected abstract void runTestSet() throws T_Fail;
}