// Copyright (c) 2005-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:

// The Implementation of the CServerStartupMgr class which

// connects to the Domain manager to keep aware of the current start-up

// state and distributes the state changes to the interested MStartupStateObserver

// objects.

// 

//

/**

 @internalComponent

 @file 

*/

#include "ServerStartupManager.h"

#include "EComServer.h"

#include "EComDebug.h"

#include "EComPerformance.h"

/**

constructor of CServerStartupMgr

@param aHierarchyId The Id of the domain hierarchy to connect to.

@param aDomainId The Id of the domain to connect to.

@param aFs A reference to a connected file server session.

*/

 CServerStartupMgr::CServerStartupMgr(TDmHierarchyId aHierarchyId, TDmDomainId aDomainId, RFs& aFs):

#ifdef __ECOM_SERVER_TESTABILITY__

 CDmDomainTestHarness(aHierarchyId,aDomainId),

#else

 CDmDomain(aHierarchyId,aDomainId),

#endif

 EKFinalStartupState(EStartupStateNonCritical),

 iCurrentStartupState(EStartupStateUndefined),

 iFs(aFs)

	 {

	 // does nothing.	

	 }

/** 

destructor

@internalComponent

*/

CServerStartupMgr::~CServerStartupMgr()

	{

	Cancel();

	iObserverList.Reset();

	}

/** 

Accessor to the current startup state

@internalComponent

@return the current startup state

*/

TStartupStateIdentifier CServerStartupMgr::CurrentStartupState()

	{

	return iCurrentStartupState;

	}

/**

updates the MStartupStateObserver objects.

@internalComponent

@param aKnownState the startup state passed into the MStartupStateObserver objects. 

*/	

void CServerStartupMgr::UpdateStateAwareObjectsL(TStartupStateIdentifier aKnownState)

	{

	RECORD_STARTUP_STATE_TIMER_RESULT(aKnownState)

	RECORD_STARTUP_STATE_HEAP_RESULT(aKnownState)

	TInt observerCount=iObserverList.Count();

	for (TInt i = 0; i < observerCount; i++)

		{

		iObserverList[i]->ProcessSSAEventL(aKnownState);

		}

	RECORD_STARTUP_STATE_HEAP_RESULT(aKnownState)

	RECORD_STARTUP_STATE_TIMER_RESULT(aKnownState)

	}

/** 

This method takes a a startup state which can be KSS or USS as a parameter,

and returns a ECOM Known Startup State

@internalComponent

@param aStartupState a startup state which can be KSS or USS.

@return an ECOM known startup state

*/

TStartupStateIdentifier CServerStartupMgr::GetKnownStartupState(TDmDomainState aStartupState)

	{

	if(aStartupState >= EStartupStateNonCritical)

		{

		return EStartupStateNonCritical;

		}

	else if(aStartupState >= EStartupStateCriticalDynamic)

		{

		return EStartupStateCriticalDynamic;

		}

	else if(aStartupState >= EStartupStateCriticalStatic)

		{

		return EStartupStateCriticalStatic;

		}

	else

		{

		return EStartupStateUndefined;

		}

	}

/**

Register the MStartupStateObserver object with the CServerStartupMgr.

@internalComponent

@param aObs the pointer to the MStartupStateObserver object to be registered with CServerStartupMgr.

*/

void CServerStartupMgr::RegisterObserverL(const MStartupStateObserver* aObs)

	{

	User::LeaveIfError(iObserverList.Append(aObs));

	}

/**

Handle the error if RunL leaves. Panic with the error code

@internalComponent

@param aError error code generated by the RunL(), not used here.

@return KErrNone to avoid CActiveScheduler to panic. 

*/	

TInt CServerStartupMgr::RunError(TInt aError)

	{

	__ECOM_LOG1("ECOM: PANIC in CServerStartupMgr::RunError(), error= %d", aError);

	User::Panic(KEComServerPanicCategory, EEComPanic_CServerStartupMgr_RunError);	

	return KErrNone; // dummy return to stop compiler warnings

	}

/**

This method indicates how the CServerStartupMgr interacts with the Domain

manager to keep aware of the startup state change, and distribute it to the

MStartupStateObserver objects inside ECOM.

@internalComponent

@pre CServerStartupMgr is fully constructed.

*/

void CServerStartupMgr::InitialiseL(TBool aSsaEnabled)

	{

	if(!aSsaEnabled)

		{

		// it is not SSA, do a full discovery.

		__ECOM_TRACE("ECOM: CServerStartupMgr::InitialiseL(): It is not SSA, do a full discovery");

		UpdateStateAwareObjectsL(EKFinalStartupState);

		iCurrentStartupState = EKFinalStartupState;

		return;	

		}

	// it is SSA.	

	else

		{

		__ECOM_TRACE("---------------------------------------------------");

		__ECOM_TRACE("ECOM: CServerStartupMgr::InitialiseL(): SSA is on.");

#ifdef __ECOM_SERVER_TESTABILITY__

		TRAPD(err, CDmDomainTestHarness::ConstructL());

#else

		TRAPD(err, CDmDomain::ConstructL());

#endif

		if(err!=KErrNone)

			{

			// the ConstructL leaves, then do a full discovery.

			__ECOM_TRACE("ECOM: CServerStartupMgr::InitialiseL(): Can not connect to the Domain Manager, do a full discovery.");

			UpdateStateAwareObjectsL(EKFinalStartupState);

			iCurrentStartupState = EKFinalStartupState;

			return;

			}

		//get the state from Domain Manager in case missing any.	

#ifdef __ECOM_SERVER_TESTABILITY__

		RequestTransitionNotificationL();

#else

		RequestTransitionNotification();

#endif

		// get the start up state from the Domain Manager.

		TDmDomainState state = GetState();

		// either something wrong with the Domain Manager or final state is reached.

		if(state <= EStartupStateUndefined || state >= EStartupStateNonCritical)

			{

			// do a full discovery. Cancel outstanding request.

			UpdateStateAwareObjectsL(EKFinalStartupState);

			iCurrentStartupState = EKFinalStartupState;

			Cancel();

			return;

			}

		// get the ECom Known state.

		TStartupStateIdentifier nextKnownState = GetKnownStartupState(state);

		 //for EStartupStateCriticalStatic or EStartupStateCriticalDynamic.

		if(nextKnownState != EStartupStateUndefined)

			{

			// catch up to the ECOM interested state.

			UpdateStateAwareObjectsL(EStartupStateCriticalStatic);

			}

		iCurrentStartupState = nextKnownState;

		}

	}

/**

Executed when the startup state change is done, it does the same thing 

as the method InitialiseL() does when SSA is on and the CurrentStartupState is not EStartupStateNonCritical.

@internalComponent

*/

void CServerStartupMgr::RunL()

	{

	// Leave if something wrong with the RequestTransitionNotification().

	User::LeaveIfError(iStatus.Int()); //RunError will handle this.

	//do request transition notification in case missing any.

#ifdef __ECOM_SERVER_TESTABILITY__

	RequestTransitionNotificationL();

#else

	RequestTransitionNotification();

#endif

	// get the start up state from Domain Manager.

	TDmDomainState state = GetState();

	//If the state is EStartupStateUndefined there must be sth wrong.

	if(state == EStartupStateUndefined) 

		{

#ifdef __ECOM_SERVER_TESTABILITY__

		AcknowledgeLastStateL(KErrBadHandle);

#else

		AcknowledgeLastState(KErrBadHandle);

#endif

		Cancel();

		User::Leave(KErrBadHandle); //RunError will handle this.

		}

	//get the known state			

	TStartupStateIdentifier nextKnownState = GetKnownStartupState(state);

	//If the nextKnownState is a state that we are ready to switch to

	//update all the state aware objects and change the state.

	//This way if we receive a state that is same as our current state

	//we do not process it. Or the new state is less than our current

	//state, we just ignore it.

	if((iCurrentStartupState < EStartupStateCriticalStatic && nextKnownState == EStartupStateCriticalStatic)

	    || (iCurrentStartupState < EStartupStateCriticalDynamic && nextKnownState == EStartupStateCriticalDynamic)

	    || (iCurrentStartupState < EStartupStateNonCritical && nextKnownState == EStartupStateNonCritical))

		{

		UpdateStateAwareObjectsL(nextKnownState);

		iCurrentStartupState = nextKnownState;

		}

	//Tell domain manager that we have processed the last state change.

#ifdef __ECOM_SERVER_TESTABILITY__

	AcknowledgeLastStateL(KErrNone);

#else

	AcknowledgeLastState(KErrNone);

#endif

	//do not request transition notification if we have reached the last state

	if(nextKnownState == EStartupStateNonCritical)

		{

		Cancel();

		}

	}