sysstatemgmt/systemstateplugins/adptplugin/src/stateadaptationref.cpp
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 31 Aug 2010 16:29:05 +0300
branchRCL_3
changeset 21 ccb4f6b3db21
parent 0 4e1aa6a622a0
child 22 8cb079868133
permissions -rw-r--r--
Revision: 201033 Kit: 201035

// Copyright (c) 2007-2010 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: This adaptation plugin implementation is for test/reference purposes.   
// The loading of this plugin is controlled through test macro defined in the iby file "ssmcompatibility.iby".
// If the macro "TEST_SSM_MACRO" is not defined, original plugins are loaded and this plugin is not loaded.
// If the test P & S key is set in the test code, the calls are routed to the reference or dummy implementations.
// Else the actual plugins are loaded and the calls are routed to the actual implementations.
// The test P & S key which it looks for is KStateAdaptationPluginPropertyKey (0x2000D76A)
//

#include <e32property.h>
#include <ssm/ssmstate.h>
#include "stateadaptationref.h"
#include "ssmdebug.h"

const TUint32 KStateAdaptationPluginPropertyKey = 0x2000D76A;
const TUid KPropertyCategory={0x2000D75B};

/**
Static method to create new State Adaptation Plugin.

@return	a new plugin object for State Adaptation.
*/
EXPORT_C MStateAdaptation* CreateStateAdaptationL()
	{
	CStateAdaptationRef* stateAdaptationRef = CStateAdaptationRef::NewL();
	return (static_cast<MStateAdaptation*>(stateAdaptationRef));
	}

CStateAdaptationRef* CStateAdaptationRef::NewL()
	{
	CStateAdaptationRef* self = new(ELeave) CStateAdaptationRef;
	
	CleanupStack::PushL(self);
	self->ConstructL();
	CleanupStack::Pop();

	return self;
	}

CStateAdaptationRef::~CStateAdaptationRef()
	{
	delete iTimer;
	iSaaStateAdaptationLib.Close();
	}

CStateAdaptationRef::CStateAdaptationRef()
	{
	}

void CStateAdaptationRef::ConstructL()
	{
    DEBUGPRINT1A("Loading Actual plugins");
    _LIT(KSaaStateAdaptationDLL, "saastateadaptation.dll");
    User::LeaveIfError(iSaaStateAdaptationLib.Load(KSaaStateAdaptationDLL));
    iSaaStateAdaptationDll = (MStateAdaptation *)(iSaaStateAdaptationLib.Lookup(1)()); 
	iTimer = CStateRefAdaptationTimer::NewL();
	}

//from MStateAdaptation
void CStateAdaptationRef::Release()
	{
	delete this;
	}

void CStateAdaptationRef::RequestCoopSysStateChange(TSsmState aState, TRequestStatus& aStatus)
	{
	if(!IsTestPsKeyDefined())
	    {
	    DEBUGPRINT1A("RequestCoopSysStateChange:: Calling Actual plugins functions (saastateadaptation.dll)");
	    iSaaStateAdaptationDll->RequestCoopSysStateChange(aState, aStatus);
	    }
	else
	    {
	    DEBUGPRINT1A("RequestCoopSysStateChange:: Calling ref plugins functions (stateadaptationref.dll)");
	    aStatus = KRequestPending;
	    TRequestStatus* status = &aStatus;
	    User::RequestComplete(status, KErrNone);
	    }
	}

void CStateAdaptationRef::RequestCoopSysSelfTest(TRequestStatus& aStatus)
	{
	if(!IsTestPsKeyDefined())
        {
        DEBUGPRINT1A("RequestCoopSysSelfTest:: Calling Actual plugins functions (saastateadaptation.dll)");
        iSaaStateAdaptationDll->RequestCoopSysSelfTest(aStatus);
        }
    else
        {
        DEBUGPRINT1A("RequestCoopSysSelfTest:: Calling ref plugins functions (stateadaptationref.dll)");
        aStatus = KRequestPending;
        TRequestStatus* status = &aStatus;
        User::RequestComplete(status, KErrNone);
        }
	}

void CStateAdaptationRef::RequestCoopSysPerformRestartActions(TInt aReason, TRequestStatus& aStatus)
	{
	if(!IsTestPsKeyDefined())
        {
        DEBUGPRINT1A("RequestCoopSysPerformRestartActions:: Calling Actual plugins functions (saastateadaptation.dll)");
        iSaaStateAdaptationDll->RequestCoopSysPerformRestartActions(aReason, aStatus);
        }
    else
        {
        DEBUGPRINT1A("RequestCoopSysPerformRestartActions:: Calling ref plugins functions (stateadaptationref.dll)");
        aStatus = KRequestPending;
        TRequestStatus* status = &aStatus;
        User::RequestComplete(status, KErrNone);
        }
	}

void CStateAdaptationRef::RequestCoopSysPerformShutdownActions(TInt aReason, TRequestStatus& aStatus)
	{
	if(!IsTestPsKeyDefined())
        {
        DEBUGPRINT1A("RequestCoopSysPerformShutdownActions:: Calling Actual plugins functions (saastateadaptation.dll)");
        iSaaStateAdaptationDll->RequestCoopSysPerformShutdownActions(aReason, aStatus);
        }
    else
        {
        DEBUGPRINT1A("RequestCoopSysPerformShutdownActions:: Calling ref plugins functions (stateadaptationref.dll)");
        aStatus = KRequestPending;
        TRequestStatus* status = &aStatus;
        User::RequestComplete(status, KErrNone);
        }
	}

void CStateAdaptationRef::RequestCoopSysPerformRfsActions(TSsmRfsType aRfsType, TRequestStatus& aStatus)
	{
	if(!IsTestPsKeyDefined())
        {
        DEBUGPRINT1A("RequestCoopSysPerformRfsActions:: Calling Actual plugins functions (saastateadaptation.dll)");
        iSaaStateAdaptationDll->RequestCoopSysPerformRfsActions(aRfsType, aStatus);
        }
    else
        {
        DEBUGPRINT1A("RequestCoopSysPerformRfsActions:: Calling ref plugins functions (stateadaptationref.dll)");
        aStatus = KRequestPending;
        TRequestStatus* status = &aStatus;
        User::RequestComplete(status, KErrNone);
        }
	}

/**
  Cancel the notification request. Reference implementation completes the requests immediately so there is nothing to Cancel.
  On a device, Cancel() needs an implementation as the Request might be outstanding and it needs to be cancelled.
*/
void CStateAdaptationRef::RequestCancel()
	{
	if(!IsTestPsKeyDefined())
        {
        DEBUGPRINT1A("RequestCancel:: Calling Actual plugins functions (saastateadaptation.dll)");
        iSaaStateAdaptationDll->RequestCancel();
        }
	}

/**
  The reference implementation completes with KErrNotSupported. This is required for automated testing.
  Actual plugins return expected values and this can be verified by manual testing
  On a device, State Adaptation Plug-in would request for notification from the Cooperating System for 'aEvent'.
  
  The above mentioned implementation is modified to facilitate testing and increase the code coverage of the Adaptation 
  server code.The modified functionality is as follows.
  
  
  Instead of completing the notification request with KErrNotSupported the it is passed to 
  CStateAdaptationRefEventHandler which is an active object wiht lower priority compared to 
  the server active object.Because of this a delay will be introduced in completing the notification
  request so that other active objects can run avoiding infinite loop and starvation of other 
  active objects,which will be the case if the notification request is immediately completed.
  This is strictly for testing purposes.On a device this call will be replaced by a notification request
  to cooperative system.
  
  
*/
void CStateAdaptationRef::NotifyCoopSysEvent(TDes8& /*aEvent*/, TRequestStatus& aStatus)
	{
	if(!IsTestPsKeyDefined())
        {
        /* Only ssmpowersup.dll has an outstanding request. If this is passed to the actual plugin, the
        request will never complete till a power event happens. This would add the test code requests in a queue
        and the test code waits indefinitely. Hence, complete the request with KErrServerTerminated. This would free 
        the queue for test code to be executed. It has not impact on the test environment */
        aStatus = KRequestPending;
        TRequestStatus* status = &aStatus;
        User::RequestComplete(status, KErrServerTerminated);
        }
    else
        {
        DEBUGPRINT1A("NotifyCoopSysEvent:: Calling ref plugins functions (stateadaptationref.dll)");
        aStatus = KRequestPending;
        iTimer->After(2000000,aStatus);
        }
	}

/**
  Cancel the notification request. Reference implementation completes the requests immediately so there is nothing to Cancel.
  On a device, Cancel() needs an implementation as the Request might be outstanding and it needs to be cancelled.
*/
void CStateAdaptationRef::NotifyCancel()
	{
	if(!IsTestPsKeyDefined())
        {
        DEBUGPRINT1A("NotifyCancel:: Calling Actual plugins functions (saastateadaptation.dll)");
        iSaaStateAdaptationDll->NotifyCancel();
        }
    else
        {
        DEBUGPRINT1A("NotifyCancel:: Calling ref plugins functions (stateadaptationref.dll)");
        if(iTimer->IsActive())
            {
            iTimer->Cancel();
            }
        }
	}

/**
    Helper function to check for P&S Key
*/
TBool CStateAdaptationRef::IsTestPsKeyDefined()
    {
    TBool testPsKeyDefined = EFalse;
    TInt result = RProperty::Get(KPropertyCategory, KStateAdaptationPluginPropertyKey, testPsKeyDefined);
    DEBUGPRINT3(_L("KStateAdaptationPluginPropertyKey %d Error %d"), testPsKeyDefined, result);
    if ((KErrNone != result) && (KErrNotFound != result))
        {
        //Could not retrieve property value. Tests might fail 
        DEBUGPRINT1A("IsTestPsKeyDefined ERROR :: Could not retrieve property value)");
        }
    return testPsKeyDefined;
    }

CStateRefAdaptationTimer::CStateRefAdaptationTimer():CTimer(CActive::EPriorityUserInput)
	{
   	CActiveScheduler::Add(this);
	}

CStateRefAdaptationTimer::~CStateRefAdaptationTimer()
	{
	Cancel();	
	}

CStateRefAdaptationTimer* CStateRefAdaptationTimer::NewL()
	{
   	CStateRefAdaptationTimer* self=new (ELeave) CStateRefAdaptationTimer();
   	CleanupStack::PushL(self);
   	self->ConstructL();
   	CleanupStack::Pop();
    return self;		
	}

void CStateRefAdaptationTimer::After(TTimeIntervalMicroSeconds32 aCancelDelay, TRequestStatus& aStatus)
	{
	iReqStatus = &aStatus;
	if(!IsActive())
	CTimer::After(aCancelDelay);	
	}



void CStateRefAdaptationTimer::DoCancel()
	{
	User::RequestComplete(iReqStatus, KErrCancel);	
	CTimer::DoCancel();	
	}


void CStateRefAdaptationTimer::RunL()
	{
	User::RequestComplete(iReqStatus, KErrNone);	
	}