1 /*******************************************************************************
2 * Copyright (c) 2009, 2010, 2012 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 * Francois Chouinard - Updated as per TMF Trace Model 1.0
12 *******************************************************************************/
14 package org
.eclipse
.linuxtools
.tmf
.core
.trace
;
17 * <b><u>ITmfContext</u></b>
19 * The basic trace context structure in TMF. The purpose of the context is to
20 * associate a trace location to an event of a specific rank (order).
22 * The context should be sufficient to allow the trace to position itself so
23 * that performing a trace read operation will yield the corresponding event.
25 public interface ITmfContext
extends Cloneable
{
27 // ------------------------------------------------------------------------
29 // ------------------------------------------------------------------------
32 * The unknown event rank
34 public long UNKNOWN_RANK
= -1L;
36 // ------------------------------------------------------------------------
38 // ------------------------------------------------------------------------
41 * @return the rank of the event referred to by the context
43 public long getRank();
46 * @return the location of the event referred to by the context
48 public ITmfLocation
<?
extends Comparable
<?
>> getLocation();
51 * @return indicates if the context rank is valid (!= UNKNOWN_RANK)
53 public boolean hasValidRank();
55 // ------------------------------------------------------------------------
57 // ------------------------------------------------------------------------
60 * @param location the new location
62 public void setLocation(ITmfLocation
<?
extends Comparable
<?
>> location
);
65 * @param rank the new rank
67 public void setRank(long rank
);
70 * Increment the context rank
72 public void increaseRank();
77 public void dispose();
79 // ------------------------------------------------------------------------
81 // ------------------------------------------------------------------------
84 * @return a clone of the context
86 public ITmfContext
clone();
This page took 0.033191 seconds and 5 git commands to generate.