Package kieker.tools.trace.analysis.systemModel

Class ExecutionTrace

java.lang.Object
kieker.tools.trace.analysis.systemModel.AbstractTrace
kieker.tools.trace.analysis.systemModel.ExecutionTrace
@Deprecated
public class ExecutionTrace
extends AbstractTrace
Deprecated.
1.15 moved to kieker-model
This class is a container for a whole trace of executions (represented as instances of Execution). Note that no assumptions about the TimeUnit used for the timestamps are made.
Since:
0.95a
Author:
Andre van Hoorn

  • Field Summary

    Fields inherited from class kieker.tools.trace.analysis.systemModel.AbstractTrace

    DEFAULT_SESSION_ID, NO_TRACE_ID

  • Constructor Summary

    Constructors 
    Constructor Description
    ExecutionTrace​(long traceId)
    Deprecated.
    Creates a new instance of this class using the given parameters.
    ExecutionTrace​(long traceId, java.lang.String sessionId)
    Deprecated.
    Creates a new instance of this class using the given parameters.

  • Method Summary

    Modifier and Type Method Description
    void add​(Execution execution)
    Deprecated.
    Adds an execution to the trace.
    static java.util.Comparator<Execution> createExecutionTraceComparator()
    Deprecated.
    Returns an instance of the Comparator used by the internal TreeSet to compare Executions.
    boolean equals​(java.lang.Object obj)
    Deprecated.
    Returns whether this Execution Trace and the passed Object are equal.
    long getDuration()
    Deprecated.
    Returns the duration of this (possibly incomplete) trace.
    long getEndTimestamp()
    Deprecated.
    Returns this trace's end timestamp.
    int getLength()
    Deprecated.
    Returns the length of this trace in terms of the number of contained executions.
    int getMaxEoi()
    Deprecated.
    Returns the maximum execution order index (eoi) value within the trace.
    int getMaxEss()
    Deprecated.
    Returns the maximum execution stack size (ess) value, i.e., the maximum stack depth, within the trace.
    long getMaxTout()
    Deprecated.
    Returns the maximum timestamp value of an execution return in this trace.
    int getMinEoi()
    Deprecated.
    Returns the minimum execution order index (eoi) value within the trace.
    long getMinTin()
    Deprecated.
    Returns the minimum timestamp of an execution start in this trace.
    long getStartTimestamp()
    Deprecated.
    Returns this trace's start timestamp.
    java.util.SortedSet<Execution> getTraceAsSortedExecutionSet()
    Deprecated.
    Returns a sorted set (unmodifiable) of Executions in this trace.
    int hashCode()
    Deprecated.
    MessageTrace toMessageTrace​(Execution rootExecution)
    Deprecated.
    Returns the message trace representation for this trace.
    The transformation to a message trace is only computed during the first execution of this method.
    java.lang.String toString()
    Deprecated.
     

    Methods inherited from class kieker.tools.trace.analysis.systemModel.AbstractTrace

    getSessionId, getTraceId, getTraceInformation

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • ExecutionTrace

      public ExecutionTrace​(long traceId)
      Deprecated.
      Creates a new instance of this class using the given parameters.
      Parameters:
      traceId - The ID of this trace.

    • ExecutionTrace

      public ExecutionTrace​(long traceId, java.lang.String sessionId)
      Deprecated.
      Creates a new instance of this class using the given parameters.
      Parameters:
      traceId - The ID of this trace.
      sessionId - The ID of the current session.

  • Method Details

    • add

      public void add​(Execution execution) throws InvalidTraceException
      Deprecated.
      Adds an execution to the trace.
      Parameters:
      execution - The execution object which will be added to this trace.
      Throws:
      InvalidTraceException - If the traceId of the passed Execution object is not the same as the traceId of this ExecutionTrace object.

    • toMessageTrace

      public MessageTrace toMessageTrace​(Execution rootExecution) throws InvalidTraceException
      Deprecated.
      Returns the message trace representation for this trace.
      The transformation to a message trace is only computed during the first execution of this method. After this, the stored reference is returned --- unless executions are added to the trace afterwards.
      Parameters:
      rootExecution - The root execution object.
      Returns:
      The resulting message trace.
      Throws:
      InvalidTraceException - If the given execution is somehow inconsistent or invalid.

    • getTraceAsSortedExecutionSet

      public final java.util.SortedSet<Execution> getTraceAsSortedExecutionSet()
      Deprecated.
      Returns a sorted set (unmodifiable) of Executions in this trace. Note that the returned data structure is the (wrapped )internal data structure of this ExecutionTrace object, to which further elements may be added by the add(Execution) method. Consider to create a copy of the returned list, while synchronizing on this (i.e., the ExecutionTrace) object.
      Returns:
      the sorted set of Executions in this trace

    • getLength

      public final int getLength()
      Deprecated.
      Returns the length of this trace in terms of the number of contained executions.
      Returns:
      the length of this trace.

    • toString

      public java.lang.String toString()
      Deprecated.
      Overrides:
      toString in class java.lang.Object

    • getMaxEss

      public int getMaxEss()
      Deprecated.
      Returns the maximum execution stack size (ess) value, i.e., the maximum stack depth, within the trace.
      Returns:
      the maximum ess; -1 if the trace contains no executions.

    • getMaxEoi

      public int getMaxEoi()
      Deprecated.
      Returns the maximum execution order index (eoi) value within the trace.
      Returns:
      the maximum eoi; -1 if the trace contains no executions.

    • getMinEoi

      public int getMinEoi()
      Deprecated.
      Returns the minimum execution order index (eoi) value within the trace.
      Returns:
      the minimum eoi; -1 if the trace contains no executions.

    • getDuration

      public long getDuration()
      Deprecated.
      Returns the duration of this (possibly incomplete) trace. This value is the difference between the maximum tout and the minimum tin value. Note that no specific assumptions about the TimeUnit are made.
      Returns:
      the duration of this trace.

    • getMaxTout

      public long getMaxTout()
      Deprecated.
      Returns the maximum timestamp value of an execution return in this trace. Notice that you should need use this value to reason about the control flow --- particularly in distributed scenarios.
      Returns:
      the maxmum timestamp value; -1 if the trace contains no executions.

    • getMinTin

      public long getMinTin()
      Deprecated.
      Returns the minimum timestamp of an execution start in this trace. Notice that you should need use this value to reason about the control flow --- particularly in distributed scenarios.
      Returns:
      the minimum timestamp value; -1 if the trace contains no executions.

    • getStartTimestamp

      public long getStartTimestamp()
      Deprecated.
      Description copied from class: AbstractTrace
      Returns this trace's start timestamp.
      Specified by:
      getStartTimestamp in class AbstractTrace
      Returns:
      See above

    • getEndTimestamp

      public long getEndTimestamp()
      Deprecated.
      Description copied from class: AbstractTrace
      Returns this trace's end timestamp.
      Specified by:
      getEndTimestamp in class AbstractTrace
      Returns:
      See above

    • hashCode

      public int hashCode()
      Deprecated.
      Description copied from class: AbstractTrace
      Overrides:
      hashCode in class AbstractTrace

    • equals

      public boolean equals​(java.lang.Object obj)
      Deprecated.
      Returns whether this Execution Trace and the passed Object are equal. Two execution traces are equal if the set of contained executions is equal.
      Specified by:
      equals in class AbstractTrace
      Parameters:
      obj - The object to be compared for equality with this.
      Returns:
      true if and only if the two objects are equal.

    • createExecutionTraceComparator

      public static final java.util.Comparator<Execution> createExecutionTraceComparator()
      Deprecated.
      Returns an instance of the Comparator used by the internal TreeSet to compare Executions.
      Returns:
      A comparator instance to compare execution objects.