diff -r 000000000000 -r 818e61de6cd1 crashanalysercmd/PerfToolsSharedLibraries/Engine/SymbianDebugLib/PluginAPI/DbgPluginEngine.cs --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/crashanalysercmd/PerfToolsSharedLibraries/Engine/SymbianDebugLib/PluginAPI/DbgPluginEngine.cs Thu Feb 11 15:50:58 2010 +0200 @@ -0,0 +1,125 @@ +/* +* 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: +* +*/ +using System; +using System.Collections.Generic; +using System.Text; +using SymbianUtils; +using SymbianUtils.Tracer; +using SymbianDebugLib.Engine; +using SymbianDebugLib.Entity; + +namespace SymbianDebugLib.PluginAPI +{ + public abstract class DbgPluginEngine : DisposableObject, ITracer + { + #region Constructors + protected DbgPluginEngine( DbgEngine aEngine ) + { + iEngine = aEngine; + } + #endregion + + #region API + public void Clear() + { + foreach ( DbgPluginView view in iViews ) + { + view.Dispose(); + } + System.Diagnostics.Debug.Assert( iViews.Count == 0 ); + iViews.Clear(); + // + DoClear(); + } + + public bool IsSupported( string aFileName ) + { + string notNeeded; + return IsSupported( aFileName, out notNeeded ); + } + + public DbgPluginView CreateView( string aName ) + { + DbgPluginView ret = this.DoCreateView( aName ); + return ret; + } + #endregion + + #region API - framework + public abstract bool IsReady + { + get; + } + + public abstract string Name + { + get; + } + + public abstract DbgPluginPrimer CreatePrimer(); + + public abstract bool IsSupported( string aFileName, out string aType ); + + public virtual object CustomOperation( string aName, object aParam1, object aParam2 ) + { + throw new NotSupportedException(); + } + + public virtual void PrepareToPrime( DbgEntityList aEntities ) + { + } + + protected abstract DbgPluginView DoCreateView( string aName ); + + protected abstract void DoClear(); + #endregion + + #region API - views + internal void CloseView( DbgPluginView aView ) + { + iViews.Remove( aView ); + } + #endregion + + #region Properties + public DbgEngine Engine + { + get { return iEngine; } + } + #endregion + + #region Internal methods + #endregion + + #region ITracer Members + public void Trace( string aMessage ) + { + iEngine.Trace( aMessage ); + } + + public void Trace( string aFormat, params object[] aParams ) + { + iEngine.Trace( aFormat, aParams ); + } + #endregion + + #region Data members + private readonly DbgEngine iEngine; + private List iViews = new List(); + #endregion + } +}