diff -r 14dc2103a631 -r ed1c9f64298a trace/tracebuilder/com.nokia.tracebuilder/src/com/nokia/tracebuilder/engine/source/SourceLocationRule.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/trace/tracebuilder/com.nokia.tracebuilder/src/com/nokia/tracebuilder/engine/source/SourceLocationRule.java Wed Jun 23 14:35:40 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.tracebuilder.engine.source; + +import com.nokia.tracebuilder.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 TraceBuilder restarts. + * + * @return true if this should be removed after insertion + */ + public boolean isRemovedAfterInsert(); + +}