Package com.tangosol.util

Interface QueryRecord.PartialResult.TraceStep

All Superinterfaces:

QueryRecord.PartialResult.RecordableStep, QueryRecord.PartialResult.Step

All Known Implementing Classes:

SimpleQueryRecord.PartialResult.TraceStep

Enclosing interface:

QueryRecord.PartialResult

public static interface QueryRecord.PartialResult.TraceStep
extends QueryRecord.PartialResult.RecordableStep

A QueryRecord.TraceStep is a QueryRecord.PartialResult.RecordableStep that provides the ability to record the information associated with the actual cost of evaluating a filter as part of a query operation.

Method Summary

Modifier and Type	Method	Description
QueryRecord.PartialResult.TraceStep	ensureStep(Filter filter)	Ensure an inner nested trace step for the given filter.
void	recordDuration(long cMillis)	Record the time spent evaluating the filter or applying an index.
void	recordPostFilterKeys(int cKeys)	Record the number of keys remaining after filter evaluation.

Methods inherited from interface com.tangosol.util.QueryRecord.PartialResult.RecordableStep

recordExtractor, recordPreFilterKeys

Methods inherited from interface com.tangosol.util.QueryRecord.PartialResult.Step

getDuration, getEfficiency, getFilterDescription, getIndexLookupRecords, getPostFilterKeySetSize, getPreFilterKeySetSize, getSteps

Method Detail

recordPostFilterKeys

void recordPostFilterKeys(int cKeys)

Record the number of keys remaining after filter evaluation. This method may be called repeatedly on the same step instance during the scan phase of a query trace plan operation. Each call will add to the total recorded post-evaluation key set size for this step.

During the scan phase of a query trace plan operation, each entry is evaluated against the filter individually. Each call to trace should record a key set count of 1 and a result key set count of fResult ? 1 : 0 where fResult is the result of a call to EntryFilter.evaluateEntry(Map.Entry).

Parameters:

cKeys - the number of keys remaining after filter evaluation

recordDuration

void recordDuration(long cMillis)

Record the time spent evaluating the filter or applying an index. This method may be called repeatedly on the same step instance during the scan phase of a query trace plan operation. Calling this method repeatedly will add to the total duration recorded for this step.

Parameters:

cMillis - the number of milliseconds spent evaluating the filter

ensureStep

QueryRecord.PartialResult.TraceStep ensureStep(Filter filter)

Ensure an inner nested trace step for the given filter. If there is no inner nested step associated with the given filter then a new step is created.

Parameters:

filter - the filter to associate the new step with

Returns:

the inner nested step associated with the given filter