[Ejtools-cvs] CVS: thirdparty/sun/jsr77/src/main/javax/management/j2ee/statistics BoundaryStatistic.
Brought to you by:
letiemble
|
From: Laurent E. <let...@us...> - 2002-04-18 20:45:57
|
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();
}
|