contextframework/cfw/src/cfserver/cfstarter.cpp
author William Roberts <williamr@symbian.org>
Fri, 23 Apr 2010 14:37:17 +0100
branchRCL_3
changeset 22 c82a39b81a38
parent 0 2e3d3ce01487
permissions -rw-r--r--
Rework addition of Symbian splash screen to reduce the source impact (uses SVG from Bug 2414) Notes: by using the OPTION SOURCEDIR parameter in the mifconv extension instructions, I can arrange to use the same source file name in sfimage, without having to export over the original Nokia file. This means that the name inside splashscreen.mbg is the same, which removes the need for the conditional compilation in SplashScreen.cpp, and gets rid of sf_splashscreen.mmp.

/*
* Copyright (c) 2006-2008 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:  CFStarter class implementation.
*
*/


#include "cfstarter.h"
#include "cfstarterobserver.h"
#include "cfphasedevicestarting.h"
#include "cfphasedevicestarted.h"
#include "cfphaseloadingplugins.h"
#include "cfphaseloadingrules.h"
#include "cfphasecfwready.h"
#include "cfwcontextdef.h"
#include "cfcontextinterface.h"
#include "cftrace.h"

// CONSTANTS

#ifdef _DEBUG

// Panic category
_LIT( KPanicCat, "CFStarter" );

// Panic codes
enum TPanicReason
    {
    EInvalidObserver,
    EAlreadyStarted,
    EInvalidState
    };

// Local panic function
LOCAL_C void Panic( TInt aCode )
    {
    User::Panic( KPanicCat, aCode );
    }

#endif

// MEMBER FUNCTIONS

CCFStarter* CCFStarter::NewL( MCFContextInterface& aCF )
    {
    FUNC_LOG;
    
    CCFStarter* self = CCFStarter::NewLC( aCF );
    CleanupStack::Pop( self );

    return self;
    }

CCFStarter* CCFStarter::NewLC( MCFContextInterface& aCF )
    {
    FUNC_LOG;
    
    CCFStarter* self = new ( ELeave ) CCFStarter( aCF );
    CleanupStack::PushL( self );
    self->ConstructL();

    return self;
    }

CCFStarter::~CCFStarter()
    {
    FUNC_LOG;
    
    Cancel();
    iPhases.ResetAndDestroy();
    iObservers.Close();
    }

CCFStarter::CCFStarter( MCFContextInterface& aCF ):
    CActive( EPriorityStandard ),
    iCF( aCF )
    {
    FUNC_LOG;
    
    CActiveScheduler::Add( this );
    }

void CCFStarter::ConstructL()
    {
    FUNC_LOG;
    
    // Construct starter phases
    iPhases.InsertL(
        CCFPhaseDeviceStarting::NewL( iCF ),
        CCFPhaseBase::ECFDeviceStarting );
    iPhases.InsertL(
        CCFPhaseDeviceStarted::NewL( iCF ),
        CCFPhaseBase::ECFDeviceStarted );
    iPhases.InsertL(
        CCFPhaseLoadingPlugins::NewL( iCF ),
        CCFPhaseBase::ECFLoadingPlugins );
    iPhases.InsertL(
        CCFPhaseLoadingRules::NewL( iCF ),
        CCFPhaseBase::ECFLoadingRules );
    iPhases.InsertL(
        CCFPhaseCfwReady::NewL( iCF ),
        CCFPhaseBase::ECFCfwReady );
    }

// METHODS

//-----------------------------------------------------------------------------
// CCFStarter::AddObserverL
//-----------------------------------------------------------------------------
//
void CCFStarter::AddObserverL( MCFStarterObserver* aObserver )
    {
    FUNC_LOG;
    
    __ASSERT_DEBUG( aObserver, Panic( EInvalidObserver ) );
    
    iObservers.AppendL( aObserver );

    aObserver->SetEventHandler( *this );
    }

//-----------------------------------------------------------------------------
// CCFStarter::Start
//-----------------------------------------------------------------------------
//
void CCFStarter::StartL()
    {
    FUNC_LOG;
    
    HEAP( "Starting CF initialization" );
    TIMESTAMP( "Starting CF initialization" );
    
    // Define context: [ContextFramework: Status]
    iCF.DefineContext( KCfwSource, KCfwSourceStatus, KCfwSourceStatusSec );
    
    // Set in first state and run it
    iCurrentPhase = CCFPhaseBase::ECFDeviceStarting;
    RunNextL();
    }

//-----------------------------------------------------------------------------
// CCFStarter::RunL
//-----------------------------------------------------------------------------
//
void CCFStarter::RunL()
    {
    FUNC_LOG;
    
    // First switch to next phase if error occurs we can continue
    CCFPhaseBase::TCFPhaseId phaseId = SwitchToNextPhase();

    INFO_1( "Phase %d execution start", phaseId );
    HEAP_1( "Phase %d execution start", phaseId );
    TIMESTAMP( "Phase execution start" );

    // Handle current phase
    if( iStatus == KErrNone )
        {
        TInt count = iObservers.Count();
        for( TInt i = 0; i < count; i++ )
            {
            TInt err = KErrNone;
            TRAP( err, iObservers[i]->InitializePhaseL( phaseId ) );
            ERROR_3( err, "Phase observer with index: [%d] failed to init in phase: [%d] with error code: %d",
                i,
                phaseId,
                err );
            }
        }
        
    INFO_1( "Phase %d execution end", phaseId );
    HEAP_1( "Phase %d execution end", phaseId );
    TIMESTAMP( "Phase execution end" );

    // Run next phase
    RunNextL();
    }

//-----------------------------------------------------------------------------
// CCFStarter::DoCancel
//-----------------------------------------------------------------------------
//
void CCFStarter::DoCancel()
    {
    FUNC_LOG;
    
    if( iCurrentPhase < iPhases.Count() )
        {
        iPhases[iCurrentPhase]->Cancel();
        }
    }

//-----------------------------------------------------------------------------
// CCFStarter::RunError
//-----------------------------------------------------------------------------
//
TInt CCFStarter::RunError( TInt /*aError*/ )
    {
    FUNC_LOG;

    // Current phase failed to run in RunL
    // Switch to next phase
    SwitchToNextPhase();
    TInt count = iPhases.Count();
    for( TInt i = iCurrentPhase; i < count; i++ )
        {
        TRAPD( err, RunNextL() );
        if( err == KErrNone )
            {
            break;
            }
        else
            {
            // Failed to run next phase again
            // Switch to next phase
            SwitchToNextPhase();
            }
        }
    return KErrNone;
    }

//-----------------------------------------------------------------------------
// CCFStarter::HandleEvent
//-----------------------------------------------------------------------------
//
void CCFStarter::HandleEvent( TCFStarterEvents aEvent )
    {
    FUNC_LOG;
    
    if( iCurrentPhase >= 0 && iCurrentPhase < iPhases.Count() )
        {
        iPhases[iCurrentPhase]->HandleEvent( aEvent );	
        }    
    }

//-----------------------------------------------------------------------------
// CCFStarter::SwitchToNextPhase
//-----------------------------------------------------------------------------
//
CCFPhaseBase::TCFPhaseId CCFStarter::SwitchToNextPhase()
    {
    FUNC_LOG;
    
    __ASSERT_DEBUG( iCurrentPhase >= 0 && iCurrentPhase < iPhases.Count(),
        Panic( EInvalidState ) );

    CCFPhaseBase::TCFPhaseId previous = iCurrentPhase;
    iCurrentPhase = iPhases[iCurrentPhase]->NextPhase();
    
    return previous;
    }

//-----------------------------------------------------------------------------
// CCFStarter::RunNextL
//-----------------------------------------------------------------------------
//
void CCFStarter::RunNextL()
    {
    FUNC_LOG;

    __ASSERT_DEBUG( !IsActive(), Panic( EAlreadyStarted ) );

    if( iCurrentPhase < iPhases.Count() )
        {
        iStatus = KRequestPending;
        iPhases[iCurrentPhase]->ExecuteL( &iStatus );
        SetActive();
        }
    else
        {
        HEAP( "[END] CF Starter phases executed" );
        }
    }