com.sun.enterprise.admin.monitor.stats

Class MutableTimeStatisticImpl

java.lang.Object

com.sun.enterprise.admin.monitor.stats.MutableTimeStatisticImpl

All Implemented Interfaces:

MutableStatistic, MutableTimeStatistic, Serializable, javax.management.j2ee.statistics.Statistic, javax.management.j2ee.statistics.TimeStatistic

public class MutableTimeStatisticImpl
extends Object
implements javax.management.j2ee.statistics.TimeStatistic, MutableTimeStatistic

An implementation of MutableTimeStatistic that eases the various statistical calculations.

Since:

S1AS8.0

Version:

$Revision: 1.2 $

Author:

Kedar Mhaswade

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
MutableTimeStatisticImpl(javax.management.j2ee.statistics.TimeStatistic initial) Constructs an instance of this class from its immutable equivalent.

Method Summary

Modifier and Type	Method and Description
long	getCount()
String	getDescription()
long	getLastSampleTime()
long	getMaxTime()
long	getMinTime()
String	getName()
long	getStartTime()
long	getTotalTime()
String	getUnit()
void	incrementCount(long current) Increments the count of operation execution by 1 and also increases the time consumed.
javax.management.j2ee.statistics.Statistic	modifiableView() Returns an instance of Statistic whose state can be changed by the caller.
void	reset() Resets the Statistic.
void	setDescription(String s)
javax.management.j2ee.statistics.Statistic	unmodifiableView() This method is the essence of this class.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MutableTimeStatisticImpl

public MutableTimeStatisticImpl(javax.management.j2ee.statistics.TimeStatistic initial)

Constructs an instance of this class from its immutable equivalent. Note that there are some constraints on the parameter passed:

• The maxTime, minTime and totTime of param must be same

Parameters:

instance - of (immutable) TimeStatistic

Method Detail

incrementCount

public void incrementCount(long current)

Increments the count of operation execution by 1 and also increases the time consumed. A successful execution of method will have all the data updated as:

• method count ++
• max time, min time and total time are accordingly adjusted

Specified by:

incrementCount in interface MutableTimeStatistic

Parameters:

current - long indicating time in whatever unit this statistic is calculated

reset

public void reset()

Resets the Statistic. Calling this method has following effect:

• Initial state of this Statistic is restored as far as Count, Minimum/Maximum and Total time of execution is considered.

Specified by:

reset in interface MutableStatistic

unmodifiableView

public javax.management.j2ee.statistics.Statistic unmodifiableView()

This method is the essence of this class. Returns the unmodifiable view of this instance.

Specified by:

unmodifiableView in interface MutableStatistic

Returns:

an instance of TimeStatistic

modifiableView

public javax.management.j2ee.statistics.Statistic modifiableView()

Description copied from interface: MutableStatistic

Returns an instance of Statistic whose state can be changed by the caller. It is important to know that caller should not cache the return value from this method. In general, there is a problem in this contract in that, a client would not know from a Stats.getCreateCount() method whether the return value is something that is being modified or is invariant. Hence the caller should not cache the returned value in a collection and then collectively process it. The main idea behind providing this method is to control the number of instances created (per Mahesh's Suggestion).

Specified by:

modifiableView in interface MutableStatistic

Returns:

an instance of Statistic interface that should not be cached.

getCount

public long getCount()

Specified by:

getCount in interface javax.management.j2ee.statistics.TimeStatistic

getDescription

public String getDescription()

Specified by:

getDescription in interface javax.management.j2ee.statistics.Statistic

getLastSampleTime

public long getLastSampleTime()

Specified by:

getLastSampleTime in interface javax.management.j2ee.statistics.Statistic

getMaxTime

public long getMaxTime()

Specified by:

getMaxTime in interface javax.management.j2ee.statistics.TimeStatistic

getMinTime

public long getMinTime()

Specified by:

getMinTime in interface javax.management.j2ee.statistics.TimeStatistic

getName

public String getName()

Specified by:

getName in interface javax.management.j2ee.statistics.Statistic

getStartTime

public long getStartTime()

Specified by:

getStartTime in interface javax.management.j2ee.statistics.Statistic

getTotalTime

public long getTotalTime()

Specified by:

getTotalTime in interface javax.management.j2ee.statistics.TimeStatistic

getUnit

public String getUnit()

Specified by:

getUnit in interface javax.management.j2ee.statistics.Statistic

setDescription

public void setDescription(String s)