com.j_spaces.core.admin
Interface StatisticsAdmin

All Superinterfaces:
Remote

public interface StatisticsAdmin
extends Remote

Provides a space statistics API.


Method Summary
 Map<Integer,StatisticsContext> getStatistics()
          Returns statistics repository that contains a map of operation codes to StatisticsContext objects for all filter operation codes.
 StatisticsContext getStatistics(Integer operationCode)
          Returns a StatisticsContext for specific filter operation code.
 Long getStatisticsSamplingRate()
          Checks statistics sampling rate.
 String[] getStatisticsStringArray()
          Returns a string array contains statistics values for each operation.
 boolean isStatisticsAvailable()
          Checks if space statistics is available.
 void setStatisticsSamplingRate(Long rate)
          Set statistics sampling rate.
 

Method Detail

isStatisticsAvailable

boolean isStatisticsAvailable()
                              throws RemoteException
Checks if space statistics is available.

Returns:
true if space statistics is available
Throws:
RemoteException - if a communication error occurs

getStatisticsStringArray

String[] getStatisticsStringArray()
                                  throws StatisticsNotAvailable,
                                         RemoteException
Returns a string array contains statistics values for each operation. For example: WRITE count: 10000, average time for last 2 seconds is 4293.1 READ count: 10000, average time for last 2 seconds is 4293.1

Returns:
array of Strings that represents the space statistics
Throws:
StatisticsNotAvailable - when space statistics are not available
RemoteException - if a communication error occurs

setStatisticsSamplingRate

void setStatisticsSamplingRate(Long rate)
                               throws StatisticsNotAvailable,
                                      RemoteException
Set statistics sampling rate.

Parameters:
rate - the rate to sample the space for statistics
Throws:
StatisticsNotAvailable - when space statistics are not available
RemoteException - if a communication error occurs

getStatisticsSamplingRate

Long getStatisticsSamplingRate()
                               throws StatisticsNotAvailable,
                                      RemoteException
Checks statistics sampling rate.

Returns:
the statistics sampling rate
Throws:
StatisticsNotAvailable - when space statistics are not available
RemoteException - if a communication error occurs

getStatistics

StatisticsContext getStatistics(Integer operationCode)
                                throws StatisticsNotAvailable,
                                       RemoteException
Returns a StatisticsContext for specific filter operation code.

Parameters:
operationCode - filter operation code defined in FilterOperationCodes
Returns:
StatisticsContext for the given operation code
Throws:
StatisticsNotAvailable - when space statistics are not available
RemoteException - if a communication error occurs
See Also:
FilterOperationCodes

getStatistics

Map<Integer,StatisticsContext> getStatistics()
                                             throws StatisticsNotAvailable,
                                                    RemoteException
Returns statistics repository that contains a map of operation codes to StatisticsContext objects for all filter operation codes.

Returns:
map of operation codes to StatisticsContext
Throws:
StatisticsNotAvailable - when space statistics are not available
RemoteException - if a communication error occurs