tracefw/tracecompiler/src/com.nokia.tracecompiler/src/com/nokia/tracecompiler/engine/source/TraceFormattingRule.java
author hgs
Mon, 23 Aug 2010 15:29:36 +0300
changeset 41 838cdffd57ce
permissions -rw-r--r--
201031
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
41
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). 
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
* Formatting rules are provided by Trace objects
hgs
parents:
diff changeset
    17
*
hgs
parents:
diff changeset
    18
*/
hgs
parents:
diff changeset
    19
package com.nokia.tracecompiler.engine.source;
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
import com.nokia.tracecompiler.model.Trace;
hgs
parents:
diff changeset
    22
import com.nokia.tracecompiler.model.TraceObjectRule;
hgs
parents:
diff changeset
    23
import com.nokia.tracecompiler.plugin.TraceAPIFormatter.TraceFormatType;
hgs
parents:
diff changeset
    24
hgs
parents:
diff changeset
    25
/**
hgs
parents:
diff changeset
    26
 * Formatting rules are stored into traces as extension. When inserting a trace
hgs
parents:
diff changeset
    27
 * to source the formatting rules are used to convert the trace into source file
hgs
parents:
diff changeset
    28
 * representation.
hgs
parents:
diff changeset
    29
 * 
hgs
parents:
diff changeset
    30
 */
hgs
parents:
diff changeset
    31
public interface TraceFormattingRule extends TraceObjectRule {
hgs
parents:
diff changeset
    32
hgs
parents:
diff changeset
    33
	/**
hgs
parents:
diff changeset
    34
	 * Gets the format for given trace
hgs
parents:
diff changeset
    35
	 * 
hgs
parents:
diff changeset
    36
	 * @param trace
hgs
parents:
diff changeset
    37
	 *            the trace
hgs
parents:
diff changeset
    38
	 * @param formatType
hgs
parents:
diff changeset
    39
	 *            the type of the format requested
hgs
parents:
diff changeset
    40
	 * @return the format
hgs
parents:
diff changeset
    41
	 */
hgs
parents:
diff changeset
    42
	public String getFormat(Trace trace, TraceFormatType formatType);
hgs
parents:
diff changeset
    43
hgs
parents:
diff changeset
    44
	/**
hgs
parents:
diff changeset
    45
	 * Maps the trace name to name shown in source
hgs
parents:
diff changeset
    46
	 * 
hgs
parents:
diff changeset
    47
	 * @param trace
hgs
parents:
diff changeset
    48
	 *            the trace to be mapped
hgs
parents:
diff changeset
    49
	 * @return the name shown in source
hgs
parents:
diff changeset
    50
	 */
hgs
parents:
diff changeset
    51
	public String mapNameToSource(Trace trace);
hgs
parents:
diff changeset
    52
hgs
parents:
diff changeset
    53
	/**
hgs
parents:
diff changeset
    54
	 * Maps the parameter count to source.
hgs
parents:
diff changeset
    55
	 * 
hgs
parents:
diff changeset
    56
	 * @param trace
hgs
parents:
diff changeset
    57
	 *            the trace
hgs
parents:
diff changeset
    58
	 * @param count
hgs
parents:
diff changeset
    59
	 *            the parameter count
hgs
parents:
diff changeset
    60
	 * @return mapped parameter count
hgs
parents:
diff changeset
    61
	 */
hgs
parents:
diff changeset
    62
	public String mapParameterCountToSource(Trace trace, int count);
hgs
parents:
diff changeset
    63
hgs
parents:
diff changeset
    64
}