Kieker 1.7

kieker.common.record
Interface IMonitoringRecord

All Superinterfaces:
Comparable<IMonitoringRecord>, Serializable
All Known Subinterfaces:
ICallObjectRecord, ICallRecord, IEventRecord, IExceptionRecord, IFlowRecord, IObjectRecord, IOperationRecord, ITraceRecord
All Known Implementing Classes:
AbstractEvent, AbstractMonitoringRecord, AbstractOperationEvent, AbstractTraceEvent, AfterConstructorEvent, AfterConstructorFailedEvent, AfterOperationEvent, AfterOperationFailedEvent, AfterOperationFailedObjectEvent, AfterOperationObjectEvent, BeforeConstructorEvent, BeforeOperationEvent, BeforeOperationObjectEvent, BranchingRecord, CallConstructorEvent, CallOperationEvent, CallOperationObjectEvent, ConstructionEvent, CPUUtilizationRecord, EmptyRecord, KiekerMetadataRecord, MemSwapUsageRecord, OperationExecutionRecord, RegistryRecord, ResourceUtilizationRecord, SplitEvent, TimestampRecord, Trace

public interface IMonitoringRecord
extends Serializable, Comparable<IMonitoringRecord>

All Kieker monitoring records have to implement this minimal interface.

Warning: Objects within records should not contain ';', '\n', or '\r' in their respective toString() representation.

Since:
1.2
Author:
Andre van Hoorn, Jan Waller
See Also:
IMonitoringRecord.Factory

Nested Class Summary
static interface IMonitoringRecord.Factory
          Any record that implements this interface has to conform to certain specifications.
 
Method Summary
 long getLoggingTimestamp()
          Delivers the current timestamp of the record.
 Class<?>[] getValueTypes()
          This method should deliver an array with the classes of the single values for the record.
 void initFromArray(Object[] values)
          This method should initialize the record based on the given values.
 void setLoggingTimestamp(long timestamp)
          Sets the logging timestamp to a new value.
 Object[] toArray()
          This method should deliver an array containing the content of the record.
 String toString()
          Creates a string representation of this record.

This method should not be used for serialization purposes since this is not the purpose of Object's toString method.
 
Methods inherited from interface java.lang.Comparable
compareTo
 

Method Detail

getLoggingTimestamp

long getLoggingTimestamp()
Delivers the current timestamp of the record.

Returns:
The timestamp.
Since:
1.2

setLoggingTimestamp

void setLoggingTimestamp(long timestamp)
Sets the logging timestamp to a new value.

Parameters:
timestamp - The new timestamp for the record.
Since:
1.2

toArray

Object[] toArray()
This method should deliver an array containing the content of the record. It should be possible to convert this array later into a record again.

Returns:
An array with the values of the record.
Since:
1.2

toString

String toString()
Creates a string representation of this record.

This method should not be used for serialization purposes since this is not the purpose of Object's toString method.

Overrides:
toString in class Object
Returns:
A (human readable) string of this record.
Since:
1.5

initFromArray

void initFromArray(Object[] values)
This method should initialize the record based on the given values. The array should be one of those resulting from a call to toArray().

Parameters:
values - The values for the record.
Since:
1.2

getValueTypes

Class<?>[] getValueTypes()
This method should deliver an array with the classes of the single values for the record.

Returns:
The types of the values.
Since:
1.2
See Also:
toArray()

Kieker 1.7

Copyright 2013 Kieker Project, http://kieker-monitoring.net