sysperfana/memspyext/com.nokia.s60tools.memspy/src/com/nokia/s60tools/memspy/interfaces/IMemSpyTraceListener.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/sysperfana/memspyext/com.nokia.s60tools.memspy/src/com/nokia/s60tools/memspy/interfaces/IMemSpyTraceListener.java Wed Apr 21 20:01:08 2010 +0300
@@ -0,0 +1,115 @@
+/*
+* Copyright (c) 2009 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:
+*
+*/
+
+
+
+package com.nokia.s60tools.memspy.interfaces;
+
+import com.nokia.s60tools.memspy.containers.SWMTLogInfo;
+
+
+/**
+ * interface MemSpyTraceListener
+ * MemSpy trace listener interface that all MemSpy Trace listeners implement
+ *
+ */
+
+public interface IMemSpyTraceListener {
+
+ /**
+ * MemSpy Launchers actions.
+ */
+ public enum LauncherAction{
+ START_MEMSPY_THREAD_LIST,
+ GET_THREAD_LIST,
+ GET_HEAP_DUMP,
+ SWMT_UPDATE,
+ TIMED_SWMT_UPDATE
+ };
+
+ /**
+ * Launch error types.
+ */
+ public enum LauncherErrorType{
+
+ // The order of 4 first launcher error enumerators should not be changed because the error codes
+ // sent from launcher side must match enumerator ordinals.
+
+ GENERAL_LAUNCHER_ERROR, // This is general launcher error when there is no error code, only error description.
+ MEMSPY_NOT_RUNNING, // error code/ordinal=1, MemSpy is not running on device as should have been at the state of execution
+ MEMSPY_NOT_FOUND, // error code/ordinal=2, MemSpywas not installed on device
+ HEAP_NOT_FOUND, // error code/ordinal=3, Requested heap was not found from device
+
+ // Ordinals of other errors are not used as error codes at launcher side,
+ // and therefore they can be freely re-organized if needed.
+
+ HEAP_TYPE_WRONG, //
+ NO_ANSWER_FROM_DEVICE, //
+ DUMPED_TRACES, //
+ ACTIVATION, // Activation of MemSpy functionality via MemSpyLauncher has failed
+ FILE, //
+ CATEGORIES_NOT_SUPPORTED, // MemSpy installed on the device does not support setting of custom categories
+ TOO_OLD_MEMSPY_LAUNCHER_DATAVERSION // MemSpyLauncher installed supports only older data version
+ };
+
+ public final static String ERROR_HEAP_TYPE = "Selected heap's heap type is wrong(needs to be Symbian OS RHeap).";
+ public final static String ERROR_NO_RESPONSE = "MemSpy extension was unable to receive response from MemSpy S60-application.";
+ public final static String ERROR_POSSIBLE_REASONS = "Following reason(s) might be causing this problem: ";
+ public final static String ERROR_MEMSPY = "MemSpy Error";
+ public final static String ERROR_USB_TRACE_ENABLED = "\n- Trace data sending is not activated from your TraceSwitch application.";
+ public final static String ERROR_INSTALL_MEMSPY_LAUNCHER = "\n- MemSpy Launcher application is not installed in your device, or the installed launcher version is not up-to-date.\n\n(Installing MemSpy Launcher requires that Nokia PC suite is found from this computer and device is connected with usb-cable.) ";
+ public final static String ERROR_CONNECTION_BROKEN = "\n- Network connection between workstation and Musti box does not work properly.";
+ public final static String ERROR_MEMSPY_NOT_RUNNING = "MemSpy is not running on device. MemSpy will be restarted when you perform next operation. ";
+ public final static String ERROR_MEMSPY_NOT_FOUND = "MemSpy s60-application was not found from your device.";
+ public final static String ERROR_HEAP_NOT_FOUND = "Requested heap not found from device.( Perhaps thread has been terminated after loading of thread list, try reloading thread list. )";
+ public final static String ERROR_DUMPED_TRACES = "Received Heap Dump/SWMT-log is corrupted. See help for more information.";
+ public final static String ERROR_SWMT_NEEDS_RESET = "\n\nSince last imported log was missed, logs cannot be imported anymore before removing all logs.";
+ public final static String ERROR_ACTIVATION_NOT_SUCCESFUL = "Unable to send activation messages to TraceCore. Check connection settings.";
+ public final static String ERROR_FILE_OPERATIONS_NOT_SUCCESSFUL= "MemSpy was unable to write data to hard drive. Please make sure that MemSpy has sufficient user rights to Carbide's workspace.";
+ public final static String ERROR_CONNECTION = "Cannot connect to trace. Check connection settings.";
+ public final static String ERROR_CATEGORIES_NOT_SUPPORTED = "SWMT category setting feature is not supported by the MemSpy installed on the device and will be disabled for the rest of the session. Re-run the operation without category support.";
+ public final static String ERROR_TOO_OLD_MEMSPY_LAUNCHER_VERSION = "Installed launcher version is not up-to-date.\n\n(Installing MemSpy Launcher requires that Nokia PC suite is found from this computer and device is connected with usb-cable.";
+ public static final String ERROR_GENERAL_LAUNCHER_ERROR = "An unexpected error occurred in launcher component. See console log for detailed error information.";
+ public final static String ERROR_SEE_CONSOLE_LOG = "\n\nSee console log for additional error information.";
+ public final static String ERROR_LAUNCHER_ERROR_DETAILS = "S60 MemSpy Launcher error details: ";
+
+ /**
+ * deviceError.
+ * method that is called whenever errors occur.
+ * @param error error code
+ */
+ public void deviceError( LauncherErrorType error );
+
+ /**
+ * operationFinished.
+ * @param action which action was finished
+ */
+ public void operationFinished( LauncherAction action );
+
+ /**
+ * operationFinished.
+ * @param action which action was finished
+ * @param swmtLog that was received
+ */
+ public void operationFinished( LauncherAction action, SWMTLogInfo swmtLogInfo, boolean timerRunning );
+
+ /**
+ * startedReceivingSWMTLog.
+ * notification that is sent to interface when swmtReceiving is started.
+ */
+ public void startedReceivingSWMTLog();
+}