/*
 *                         OpenSplice DDS
 *
 *   This software and documentation are Copyright 2006 to TO_YEAR PrismTech
 *   Limited, its affiliated companies and licensors. All rights reserved.
 *
 *   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.
 *
 */
/**
 * This class defines some simple common utility functions for use in Vortex
 * Cafe examples.
 */
class ExampleUtilities {
    public static final long NS_IN_ONE_US = 1000;
    public static final long US_IN_ONE_MS = 1000;
    public static final long US_IN_ONE_SEC = 1000000;

    /**
     * Returns the current time in microseconds
     * 
     * @return the current time in microseconds
     */
    public static long GetTime() {
        return System.nanoTime() / NS_IN_ONE_US;
    }

    /**
     * Class to keep a running average time as well as recording the minimum and
     * maximum times
     */
    public static class TimeStats {
        public java.util.ArrayList<Long> values = new java.util.ArrayList<Long>();
        public double average;
        public long min;
        public long max;
        public long count;

        /**
         * Resets stats variables to zero
         */
        public void Reset() {
            values.clear();
            average = 0;
            min = 0;
            max = 0;
            count = 0;
        }

        /**
         * Updates stats with new time data, keeps a running average as well as
         * recording the minimum and maximum times
         * 
         * @param microseconds
         *            A time in microseconds to add to the stats
         * @return The updated stats
         */
        public TimeStats AddMicroseconds(long microseconds) {
            values.add(microseconds);
            average = (count * average + microseconds) / (count + 1);
            min = count == 0 || microseconds < min ? microseconds : min;
            max = count == 0 || microseconds > max ? microseconds : max;
            count++;
            return this;
        }

        /**
         * Calculates the median time from the stats
         * 
         * @return the median time
         */
        public double GetMedian() {
            double median;

            java.util.Collections.sort(values);

            if (values.size() % 2 == 0) {
                median = (double) (values.get(values.size() / 2 - 1) + values
                        .get(values.size() / 2)) / 2;
            } else {
                median = (double) values.get(values.size() / 2);
            }

            return median;
        }
    }
}
