1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/ossrv/lowlevellibsandfws/pluginfw/Framework/frame/ServerStartupManager.cpp Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,277 @@
1.4 +// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
1.5 +// All rights reserved.
1.6 +// This component and the accompanying materials are made available
1.7 +// under the terms of "Eclipse Public License v1.0"
1.8 +// which accompanies this distribution, and is available
1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.10 +//
1.11 +// Initial Contributors:
1.12 +// Nokia Corporation - initial contribution.
1.13 +//
1.14 +// Contributors:
1.15 +//
1.16 +// Description:
1.17 +// The Implementation of the CServerStartupMgr class which
1.18 +// connects to the Domain manager to keep aware of the current start-up
1.19 +// state and distributes the state changes to the interested MStartupStateObserver
1.20 +// objects.
1.21 +//
1.22 +//
1.23 +
1.24 +/**
1.25 + @internalComponent
1.26 + @file
1.27 +*/
1.28 +
1.29 +#include "ServerStartupManager.h"
1.30 +#include "EComServer.h"
1.31 +#include "EComDebug.h"
1.32 +#include "EComPerformance.h"
1.33 +
1.34 +/**
1.35 +constructor of CServerStartupMgr
1.36 +@param aHierarchyId The Id of the domain hierarchy to connect to.
1.37 +@param aDomainId The Id of the domain to connect to.
1.38 +@param aFs A reference to a connected file server session.
1.39 +*/
1.40 + CServerStartupMgr::CServerStartupMgr(TDmHierarchyId aHierarchyId, TDmDomainId aDomainId, RFs& aFs):
1.41 +#ifdef __ECOM_SERVER_TESTABILITY__
1.42 + CDmDomainTestHarness(aHierarchyId,aDomainId),
1.43 +#else
1.44 + CDmDomain(aHierarchyId,aDomainId),
1.45 +#endif
1.46 + EKFinalStartupState(EStartupStateNonCritical),
1.47 + iCurrentStartupState(EStartupStateUndefined),
1.48 + iFs(aFs)
1.49 + {
1.50 + // does nothing.
1.51 + }
1.52 +
1.53 +
1.54 +/**
1.55 +destructor
1.56 +@internalComponent
1.57 +*/
1.58 +CServerStartupMgr::~CServerStartupMgr()
1.59 + {
1.60 + Cancel();
1.61 + iObserverList.Reset();
1.62 + }
1.63 +
1.64 +
1.65 +/**
1.66 +Accessor to the current startup state
1.67 +@internalComponent
1.68 +@return the current startup state
1.69 +*/
1.70 +TStartupStateIdentifier CServerStartupMgr::CurrentStartupState()
1.71 + {
1.72 + return iCurrentStartupState;
1.73 + }
1.74 +
1.75 +/**
1.76 +updates the MStartupStateObserver objects.
1.77 +@internalComponent
1.78 +@param aKnownState the startup state passed into the MStartupStateObserver objects.
1.79 +*/
1.80 +void CServerStartupMgr::UpdateStateAwareObjectsL(TStartupStateIdentifier aKnownState)
1.81 + {
1.82 + RECORD_STARTUP_STATE_TIMER_RESULT(aKnownState)
1.83 + RECORD_STARTUP_STATE_HEAP_RESULT(aKnownState)
1.84 + TInt observerCount=iObserverList.Count();
1.85 + for (TInt i = 0; i < observerCount; i++)
1.86 + {
1.87 + iObserverList[i]->ProcessSSAEventL(aKnownState);
1.88 + }
1.89 + RECORD_STARTUP_STATE_HEAP_RESULT(aKnownState)
1.90 + RECORD_STARTUP_STATE_TIMER_RESULT(aKnownState)
1.91 + }
1.92 +
1.93 +/**
1.94 +This method takes a a startup state which can be KSS or USS as a parameter,
1.95 +and returns a ECOM Known Startup State
1.96 +@internalComponent
1.97 +@param aStartupState a startup state which can be KSS or USS.
1.98 +@return an ECOM known startup state
1.99 +*/
1.100 +TStartupStateIdentifier CServerStartupMgr::GetKnownStartupState(TDmDomainState aStartupState)
1.101 + {
1.102 + if(aStartupState >= EStartupStateNonCritical)
1.103 + {
1.104 + return EStartupStateNonCritical;
1.105 + }
1.106 + else if(aStartupState >= EStartupStateCriticalDynamic)
1.107 + {
1.108 + return EStartupStateCriticalDynamic;
1.109 + }
1.110 + else if(aStartupState >= EStartupStateCriticalStatic)
1.111 + {
1.112 + return EStartupStateCriticalStatic;
1.113 + }
1.114 + else
1.115 + {
1.116 + return EStartupStateUndefined;
1.117 + }
1.118 + }
1.119 +
1.120 +
1.121 +/**
1.122 +Register the MStartupStateObserver object with the CServerStartupMgr.
1.123 +@internalComponent
1.124 +@param aObs the pointer to the MStartupStateObserver object to be registered with CServerStartupMgr.
1.125 +*/
1.126 +void CServerStartupMgr::RegisterObserverL(const MStartupStateObserver* aObs)
1.127 + {
1.128 + User::LeaveIfError(iObserverList.Append(aObs));
1.129 + }
1.130 +
1.131 +
1.132 +/**
1.133 +Handle the error if RunL leaves. Panic with the error code
1.134 +@internalComponent
1.135 +@param aError error code generated by the RunL(), not used here.
1.136 +@return KErrNone to avoid CActiveScheduler to panic.
1.137 +*/
1.138 +TInt CServerStartupMgr::RunError(TInt aError)
1.139 + {
1.140 + __ECOM_LOG1("ECOM: PANIC in CServerStartupMgr::RunError(), error= %d", aError);
1.141 + User::Panic(KEComServerPanicCategory, EEComPanic_CServerStartupMgr_RunError);
1.142 + return KErrNone; // dummy return to stop compiler warnings
1.143 + }
1.144 +
1.145 +/**
1.146 +This method indicates how the CServerStartupMgr interacts with the Domain
1.147 +manager to keep aware of the startup state change, and distribute it to the
1.148 +MStartupStateObserver objects inside ECOM.
1.149 +@internalComponent
1.150 +@pre CServerStartupMgr is fully constructed.
1.151 +*/
1.152 +void CServerStartupMgr::InitialiseL(TBool aSsaEnabled)
1.153 + {
1.154 + if(!aSsaEnabled)
1.155 + {
1.156 + // it is not SSA, do a full discovery.
1.157 + __ECOM_TRACE("ECOM: CServerStartupMgr::InitialiseL(): It is not SSA, do a full discovery");
1.158 + UpdateStateAwareObjectsL(EKFinalStartupState);
1.159 + iCurrentStartupState = EKFinalStartupState;
1.160 + return;
1.161 + }
1.162 + // it is SSA.
1.163 + else
1.164 + {
1.165 + __ECOM_TRACE("---------------------------------------------------");
1.166 + __ECOM_TRACE("ECOM: CServerStartupMgr::InitialiseL(): SSA is on.");
1.167 +#ifdef __ECOM_SERVER_TESTABILITY__
1.168 + TRAPD(err, CDmDomainTestHarness::ConstructL());
1.169 +#else
1.170 + TRAPD(err, CDmDomain::ConstructL());
1.171 +#endif
1.172 + if(err!=KErrNone)
1.173 + {
1.174 + // the ConstructL leaves, then do a full discovery.
1.175 + __ECOM_TRACE("ECOM: CServerStartupMgr::InitialiseL(): Can not connect to the Domain Manager, do a full discovery.");
1.176 + UpdateStateAwareObjectsL(EKFinalStartupState);
1.177 + iCurrentStartupState = EKFinalStartupState;
1.178 + return;
1.179 + }
1.180 +
1.181 + //get the state from Domain Manager in case missing any.
1.182 +#ifdef __ECOM_SERVER_TESTABILITY__
1.183 + RequestTransitionNotificationL();
1.184 +#else
1.185 + RequestTransitionNotification();
1.186 +#endif
1.187 +
1.188 + // get the start up state from the Domain Manager.
1.189 + TDmDomainState state = GetState();
1.190 +
1.191 + // either something wrong with the Domain Manager or final state is reached.
1.192 + if(state <= EStartupStateUndefined || state >= EStartupStateNonCritical)
1.193 + {
1.194 + // do a full discovery. Cancel outstanding request.
1.195 + UpdateStateAwareObjectsL(EKFinalStartupState);
1.196 + iCurrentStartupState = EKFinalStartupState;
1.197 + Cancel();
1.198 + return;
1.199 + }
1.200 +
1.201 + // get the ECom Known state.
1.202 + TStartupStateIdentifier nextKnownState = GetKnownStartupState(state);
1.203 +
1.204 +
1.205 + //for EStartupStateCriticalStatic or EStartupStateCriticalDynamic.
1.206 + if(nextKnownState != EStartupStateUndefined)
1.207 + {
1.208 + // catch up to the ECOM interested state.
1.209 + UpdateStateAwareObjectsL(EStartupStateCriticalStatic);
1.210 + }
1.211 +
1.212 + iCurrentStartupState = nextKnownState;
1.213 + }
1.214 + }
1.215 +
1.216 +
1.217 +/**
1.218 +Executed when the startup state change is done, it does the same thing
1.219 +as the method InitialiseL() does when SSA is on and the CurrentStartupState is not EStartupStateNonCritical.
1.220 +@internalComponent
1.221 +*/
1.222 +void CServerStartupMgr::RunL()
1.223 + {
1.224 + // Leave if something wrong with the RequestTransitionNotification().
1.225 + User::LeaveIfError(iStatus.Int()); //RunError will handle this.
1.226 +
1.227 + //do request transition notification in case missing any.
1.228 +#ifdef __ECOM_SERVER_TESTABILITY__
1.229 + RequestTransitionNotificationL();
1.230 +#else
1.231 + RequestTransitionNotification();
1.232 +#endif
1.233 +
1.234 + // get the start up state from Domain Manager.
1.235 + TDmDomainState state = GetState();
1.236 + //If the state is EStartupStateUndefined there must be sth wrong.
1.237 + if(state == EStartupStateUndefined)
1.238 + {
1.239 +#ifdef __ECOM_SERVER_TESTABILITY__
1.240 + AcknowledgeLastStateL(KErrBadHandle);
1.241 +#else
1.242 + AcknowledgeLastState(KErrBadHandle);
1.243 +#endif
1.244 + Cancel();
1.245 + User::Leave(KErrBadHandle); //RunError will handle this.
1.246 + }
1.247 +
1.248 + //get the known state
1.249 + TStartupStateIdentifier nextKnownState = GetKnownStartupState(state);
1.250 +
1.251 + //If the nextKnownState is a state that we are ready to switch to
1.252 + //update all the state aware objects and change the state.
1.253 + //This way if we receive a state that is same as our current state
1.254 + //we do not process it. Or the new state is less than our current
1.255 + //state, we just ignore it.
1.256 + if((iCurrentStartupState < EStartupStateCriticalStatic && nextKnownState == EStartupStateCriticalStatic)
1.257 + || (iCurrentStartupState < EStartupStateCriticalDynamic && nextKnownState == EStartupStateCriticalDynamic)
1.258 + || (iCurrentStartupState < EStartupStateNonCritical && nextKnownState == EStartupStateNonCritical))
1.259 + {
1.260 + UpdateStateAwareObjectsL(nextKnownState);
1.261 + iCurrentStartupState = nextKnownState;
1.262 + }
1.263 +
1.264 + //Tell domain manager that we have processed the last state change.
1.265 +#ifdef __ECOM_SERVER_TESTABILITY__
1.266 + AcknowledgeLastStateL(KErrNone);
1.267 +#else
1.268 + AcknowledgeLastState(KErrNone);
1.269 +#endif
1.270 +
1.271 + //do not request transition notification if we have reached the last state
1.272 + if(nextKnownState == EStartupStateNonCritical)
1.273 + {
1.274 + Cancel();
1.275 + }
1.276 + }
1.277 +
1.278 +
1.279 +
1.280 +