diff -r 07b41fa8d1dd -r ca8a1b6995f6 tracefw/tracecompiler/src/com.nokia.tracecompiler/src/com/nokia/tracecompiler/engine/source/SourceLocationRule.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/tracefw/tracecompiler/src/com.nokia.tracecompiler/src/com/nokia/tracecompiler/engine/source/SourceLocationRule.java Tue Aug 31 16:45:49 2010 +0300 @@ -0,0 +1,65 @@ +/* +* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +* Rules for mapping trace model entries into source code +* +*/ +package com.nokia.tracecompiler.engine.source; + +import com.nokia.tracecompiler.model.TraceObjectRule; + +/** + * Rules for relocating traces in source code + * + */ +public interface SourceLocationRule extends TraceObjectRule { + + /** + * Rule type for context-relative location + */ + int CONTEXT_RELATIVE = 1; + + /** + * Rule type for absolute location + */ + int ABSOLUTE = 2; + + /** + * Gets the rule type + * + * @return rule type + */ + public int getLocationType(); + + /** + * Gets the offset where the trace is inserted + * + * @return the offset + */ + public int getLocationOffset(); + + /** + * Flag which determines whether this locator should be removed from the + * trace after the trace has been inserted to source. If this is left to the + * trace, the trace is relocated every time it is inserted. + *

+ * Note that if this returns false, the extension should also be persistent + * so that the relocations work over TraceCompiler restarts. + * + * @return true if this should be removed after insertion + */ + public boolean isRemovedAfterInsert(); + +}