Logo Search packages:      
Sourcecode: mysql-connector-java version File versions  Download package

BasePerfTest.java

/*
 Copyright (C) 2002-2004 MySQL AB

 This program is free software; you can redistribute it and/or modify
 it under the terms of version 2 of the GNU General Public License as 
 published by the Free Software Foundation.

 There are special exceptions to the terms and conditions of the GPL 
 as it is applied to this software. View the full text of the 
 exception in file EXCEPTIONS-CONNECTOR-J in the directory of this 
 software distribution.

 This program 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 General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA



 */
package testsuite.perf;

import testsuite.BaseTestCase;

import java.text.NumberFormat;

import java.util.ArrayList;
import java.util.List;

/**
 * Base class for performance test cases. Handles statistics.
 * 
 * @author Mark Matthews
 */
00039 public abstract class BasePerfTest extends BaseTestCase {
      // ~ Static fields/initializers
      // ---------------------------------------------

      /**
       * Confidence interval lookup table, indexed by degrees of freedom at 95%.
       */
00046       private static final double[] T95 = { 12.706, 4.303, 3.182, 2.776, 2.571,
                  2.447, 2.365, 2.306, 2.262, 2.228, 2.201, 2.179, 2.160, 2.145,
                  2.131, 2.120, 2.110, 2.101, 2.093, 2.086, 2.080, 2.074, 2.069,
                  2.064, 2.060, 2.056, 2.052, 2.048, 2.045, 2.042 };

      /**
       * Confidence interval lookup table, indexed by degrees of freedom at 99%.
       */
00054       private static final double[] T99 = { 63.657, 9.925, 5.841, 4.604, 4.032,
                  3.707, 3.499, 3.355, 3.250, 3.169, 3.106, 3.055, 3.012, 2.977,
                  2.947, 2.921, 2.898, 2.878, 2.861, 2.845, 2.831, 2.819, 2.807,
                  2.797, 2.787, 2.779, 2.771, 2.763, 2.756, 2.750 };

      static NumberFormat numberFormatter = NumberFormat.getInstance();

      static {
            numberFormatter.setMaximumFractionDigits(4);
            numberFormatter.setMinimumFractionDigits(4);
      }

      // ~ Instance fields
      // --------------------------------------------------------

      /**
       * List of values for each iteration
       */
00072       private List testValuesList = new ArrayList();

      private double confidenceLevel = 95; // 95% by default

      private double confidenceValue = 0;

      private double intervalWidth = 0.1;

      private double meanValue = 0;

      private double squareSumValue = 0;

      private double sumValue = 0;

      private double variationValue = 0;

      /**
       * The number of iterations that we have performed
       */
00091       private int numIterations = 0;

      // ~ Constructors
      // -----------------------------------------------------------

      /**
       * Creates a new BasePerfTest object.
       * 
       * @param name
       *            the testcase name to perform.
       */
00102       public BasePerfTest(String name) {
            super(name);
      }

      // ~ Methods
      // ----------------------------------------------------------------

      /**
       * Returns the meanValue.
       * 
       * @return double
       */
00114       public double getMeanValue() {
            return this.meanValue;
      }

      /**
       * Sub-classes should override this to perform the operation to be measured.
       * 
       * @throws Exception
       *             if an error occurs.
       */
      protected abstract void doOneIteration() throws Exception;

      /**
       * Returns the current confidence level.
       * 
       * @return the current confindence level.
       */
00131       protected double getCurrentConfidence() {
            return (this.intervalWidth - this.confidenceValue) * 100;
      }

      /**
       * Returns the current margin of error.
       * 
       * @return the current margin of error.
       */
00140       protected double getMarginOfError() {
            return getConfidenceLookup()
                        * (getStandardDeviationP() / Math.sqrt(this.numIterations));
      }

      /**
       * Returns the current STDDEV.
       * 
       * @return the current STDDEV
       */
00150       protected double getStandardDeviationP() {
            if (this.numIterations < 1) {
                  return 0;
            }

            return Math
                        .sqrt(((this.numIterations * this.squareSumValue) - (this.sumValue * this.sumValue))
                                    / (this.numIterations * this.numIterations));
      }

      /**
       * Adds one test result to the statistics.
       * 
       * @param value
       *            a single result representing the value being measured in the
       *            test.
       */
00167       protected void addResult(double value) {
            this.numIterations++;
            this.testValuesList.add(new Double(value));

            this.sumValue += value;
            this.squareSumValue += (value * value);
            this.meanValue = this.sumValue / this.numIterations;
            this.variationValue = (this.squareSumValue / this.numIterations)
                        - (this.meanValue * this.meanValue);

            // Can only have confidence when more than one test
            // has been completed
            if (this.numIterations > 1) {
                  this.confidenceValue = this.intervalWidth
                              - ((2.0 * getConfidenceLookup() * Math
                                          .sqrt(this.variationValue
                                                      / (this.numIterations - 1.0))) / this.meanValue);
            }
      }

      /**
       * Calls doIteration() the <code>numIterations</code> times, displaying
       * the mean, std, margin of error and confidence level.
       * 
       * @param numIterations
       *            the number of iterations to perform ( < 30)
       * @throws Exception
       *             if an error occurs.
       */
00196       protected void doIterations(int numIterations) throws Exception {
            for (int i = 0; i < numIterations; i++) {
                  doOneIteration();
            }
      }

      /**
       * Reports the current results to STDOUT, preceeded by
       * <code>additionalMessage</code> if not null.
       * 
       * @param additionalMessage
       *            the additional message to print, or null if no message.
       */
00209       protected synchronized void reportResults(String additionalMessage) {
            StringBuffer messageBuf = new StringBuffer();

            if (additionalMessage != null) {
                  messageBuf.append(additionalMessage);
                  messageBuf.append(": ");
            }

            messageBuf.append(" mean: ");
            messageBuf.append(numberFormatter.format(this.meanValue));
            messageBuf.append(" stdevp: ");
            messageBuf.append(numberFormatter.format(getStandardDeviationP()));
            messageBuf.append(" m-o-e: ");
            messageBuf.append(numberFormatter.format(getMarginOfError()));

            System.out.println(messageBuf.toString());
      }

      private double getConfidenceLookup() {
            if (this.confidenceLevel == 95) {
                  return T95[this.numIterations - 1];
            } else if (this.confidenceLevel == 99) {
                  return T99[this.numIterations - 1];
            } else {
                  throw new IllegalArgumentException(
                              "Confidence level must be 95 or 99");
            }
      }
}

Generated by  Doxygen 1.6.0   Back to index