27349c22d988767ba248b2022c7000983f2721e1
1 /*******************************************************************************
2 * Copyright (c) 2012, 2014 Ericsson
4 * All rights reserved. This program and the accompanying materials are
5 * made available under the terms of the Eclipse Public License v1.0 which
6 * accompanies this distribution, and is available at
7 * http://www.eclipse.org/legal/epl-v10.html
10 * Francois Chouinard - Initial API and implementation
11 *******************************************************************************/
13 package org
.eclipse
.tracecompass
.tmf
.core
.trace
.indexer
;
15 import org
.eclipse
.tracecompass
.tmf
.core
.event
.ITmfEvent
;
16 import org
.eclipse
.tracecompass
.tmf
.core
.timestamp
.ITmfTimestamp
;
17 import org
.eclipse
.tracecompass
.tmf
.core
.timestamp
.TmfTimeRange
;
18 import org
.eclipse
.tracecompass
.tmf
.core
.trace
.ITmfContext
;
19 import org
.eclipse
.tracecompass
.tmf
.core
.trace
.ITmfTrace
;
22 * The generic trace indexer in TMF with support for incremental indexing.
27 * @author Francois Chouinard
29 public interface ITmfTraceIndexer
{
32 * Start an asynchronous index building job and waits for the job completion
33 * if required. Typically, the indexing job sends notifications at regular
34 * intervals to indicate its progress.
36 * <b>Example 1</b>: Index a whole trace asynchronously
39 * trace.getIndexer().buildIndex(0, TmfTimeRange.ETERNITY, false);
42 * <b>Example 2</b>: Index a whole trace synchronously
45 * trace.getIndexer().buildIndex(0, TmfTimeRange.ETERNITY, true);
48 * <b>Example 3</b>: Index a trace asynchronously, starting at rank 100
51 * trace.getIndexer().buildIndex(100, TmfTimeRange.ETERNITY, false);
54 * <b>Example 4</b>: Index a trace asynchronously, starting at rank 100 for
55 * events between T1 and T2 (inclusive). This is used for incremental
59 * TmfTimeRange range = new TmfTimeRange(T1, T2);
60 * trace.getIndexer().buildIndex(100, range, false);
64 * The offset of the first event to consider
66 * The time range to consider
67 * @param waitForCompletion
68 * Should we block the calling thread until the build is
71 void buildIndex(long offset
, TmfTimeRange range
, boolean waitForCompletion
);
74 * Indicates that the indexer is busy indexing the trace.
75 * Will always return false if the indexing is done synchronously.
77 * @return the state of the indexer (indexing or not)
82 * Adds an entry to the trace index.
84 * @param context The trace context to save
85 * @param timestamp The timestamp matching this context
87 void updateIndex(ITmfContext context
, ITmfTimestamp timestamp
);
90 * Returns the context of the checkpoint immediately preceding the requested
91 * timestamp (or at the timestamp if it coincides with a checkpoint).
93 * @param timestamp the requested timestamp
94 * @return the checkpoint context
96 ITmfContext
seekIndex(ITmfTimestamp timestamp
);
99 * Returns the context of the checkpoint immediately preceding the requested
100 * rank (or at rank if it coincides with a checkpoint).
102 * @param rank the requested event rank
103 * @return the checkpoint context
105 ITmfContext
seekIndex(long rank
);
108 * Perform cleanup when the indexer is no longer required.
This page took 0.048056 seconds and 4 git commands to generate.