[Ejtools-cvs] CVS: thirdparty/sun/jsr77/src/main/javax/management/j2ee/statistics BoundaryStatistic.java,NONE,1.1 BoundedRangeStatistic.java,NONE,1.1 CountStatistic.java,NONE,1.1 RangeStatistic.java,NONE,1.1 Statistic.java,NONE,1.1 TimeStatistic.java,NONE,1.1

[Laurent E. <let...@us...>]

Update of /cvsroot/ejtools/thirdparty/sun/jsr77/src/main/javax/management/j2ee/statistics
In directory usw-pr-cvs1:/tmp/cvs-serv31212/sun/jsr77/src/main/javax/management/j2ee/statistics

Added Files:
	BoundaryStatistic.java BoundedRangeStatistic.java 
	CountStatistic.java RangeStatistic.java Statistic.java 
	TimeStatistic.java 
Log Message:
Initial Import

--- NEW FILE: BoundaryStatistic.java ---
package javax.management.j2ee.statistics;

/**
 *  The BoundaryStatistic interface specifies standard measurements of the upper
 *  and lower limits of the value of an attribute.
 *
 * @author     letiembl
 * @created    13 mars 2002
 */
public interface BoundaryStatistic extends Statistic
{
   /**
    *  Returns the lower limit of the value of this attribute.
    *
    * @return    the lower limit
    */
   public long getLowerBound();


   /**
    *  Returns the upper limit of the value of this attribute.
    *
    * @return    the upper limit
    */
   public long getUpperBound();
}


--- NEW FILE: BoundedRangeStatistic.java ---
package javax.management.j2ee.statistics;

/**
 *  The BoundedRangeStatistic interface extends the RangeStatistic and
 *  BoundaryStatistic interfaces and provides standard measurements of a range
 *  that has fixed limits.
 *
 * @author     letiembl
 * @created    13 mars 2002
 */
public interface BoundedRangeStatistic extends BoundaryStatistic, RangeStatistic
{
}


--- NEW FILE: CountStatistic.java ---
package javax.management.j2ee.statistics;

/**
 *  The CountStatistic interface specifies standard count measurements.
 *
 * @author     letiembl
 * @created    13 mars 2002
 */
public interface CountStatistic extends Statistic
{
   /**
    *  Returns the count since the measurement started.
    *
    * @return    the count value
    */
   public long getCount();
}


--- NEW FILE: RangeStatistic.java ---
package javax.management.j2ee.statistics;

/**
 *  Specifies standard measurements of the lowest and highest values an
 *  attribute has held as well as its current value.
 *
 * @author     letiembl
 * @created    13 mars 2002
 */
public interface RangeStatistic extends Statistic
{
   /**
    *  Returns the lowest value this attribute has held since the beginning of
    *  the measurement.
    *
    * @return    the value
    */
   public long getLowWaterMark();


   /**
    *  Returns the highest value this attribute has held since the beginning of
    *  the measurement.
    *
    * @return    the value
    */
   public long getHighWaterMark();


   /**
    *  Returns the current value of this attribute.
    *
    * @return    the value
    */
   public long getCurrent();
}


--- NEW FILE: Statistic.java ---
package javax.management.j2ee.statistics;

/**
 *  The Statistic interface and its subinterfaces specify the required accessors
 *  which provide the performance data described by the specific attributes in
 *  the Stats interfaces. The Statistic subinterfaces specify accessors which
 *  provide statistical data about count, time, and both bounded and unbounded
 *  ranges.
 *
 * @author     letiembl
 * @created    13 mars 2002
 */
public interface Statistic
{
   /**
    *  Returns the name of this Statistic. The name must always correspond to
    *  the name of the Stats accessor that is providing the data for this
    *  statistic.
    *
    * @return    the name of this Statistic
    */
   public String getName();


   /**
    *  Returns the unit of measurement for this Statistic. Valid values for
    *  TimeStatistic measurements are HOUR , MINUTE , SECOND , MILLISECOND ,
    *  MICROSECOND and NANOSECOND.
    *
    * @return    the unit of measurement
    */
   public String getUnit();


   /**
    *  Returns a human-readable description of the Statistic.
    *
    * @return    a description
    */
   public String getDescription();


   /**
    *  Returns the time the first measurment was taken represented as a long,
    *  whose value is the number of milliseconds since January 1, 1970,
    *  00:00:00.
    *
    * @return    the time of the first measurment
    */
   public long getStartTime();


   /**
    *  Returns the time the most recent measurment was taken represented as a
    *  long, whose value is the number of milliseconds since January 1, 1970,
    *  00:00:00.
    *
    * @return    the time of the most recent measurment
    */
   public long getLastSampleTime();
}


--- NEW FILE: TimeStatistic.java ---
package javax.management.j2ee.statistics;

/**
 *  Specifies standard timing measurements for a given operation.
 *
 * @author     letiembl
 * @created    13 mars 2002
 */
public interface TimeStatistic extends Statistic
{
   /**  Description of the Field */
   public final static String HOUR = "HOUR";
   /**  Description of the Field */
   public final static String MINUTE = "MINUTE";
   /**  Description of the Field */
   public final static String SECOND = "SECOND";
   /**  Description of the Field */
   public final static String MILLISECOND = "MILLISECOND";
   /**  Description of the Field */
   public final static String MICROSECOND = "MICROSECOND";
   /**  Description of the Field */
   public final static String NANOSECOND = "NANOSECOND";


   /**
    *  Returns the number of times the operation was invoked since the beginning
    *  of this measurement.
    *
    * @return    the value
    */
   public long getCount();


   /**
    *  Returns the minimum amount of time taken to complete one invocation of
    *  this operation since the beginning of this measurement.
    *
    * @return    the value
    */
   public long getMinTime();


   /**
    *  Returns the maximum amount of time taken to complete one invocation of
    *  this operation since the beginning of this measurement.
    *
    * @return    the value
    */
   public long getMaxTime();


   /**
    *  Returns the sum total of time taken to complete every invocation of this
    *  operation since the beginning of this measurement. Dividing totalTime by
    *  count will give you the average execution time for this operation.
    *
    * @return    the value
    */
   public long getTotalTime();
}