genericservices/taskscheduler/SCHSVR/SchTimer.cpp
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Wed, 13 Oct 2010 16:27:53 +0300
branchRCL_3
changeset 75 254b651f304e
parent 64 c44f36bb61a3
permissions -rw-r--r--
Revision: 201039 Kit: 201041

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

// User includes
#include "SchTimer.h"
#include "SCHMAN.H"
#include "SCHEDULE.H"

// system includes
#include <e32property.h>

/**
An instance of this class is used for each different time that a
schedule needs to be run. It is created solely in the 
CScheduleCriteriaManager class.  The timer is updated via the 
SetNext method.  When the time has been reached it notifies the schedule
manager via the CScheduleCriteriaManager::DueSchedule() method.

@internalComponent
*/
NONSHARABLE_CLASS(CScheduleTimer) : public CTimer
	{
public:
	~CScheduleTimer();
	static CScheduleTimer* NewL(TInt aSchedule, CScheduleCriteriaManager& aManager);
	
	void SetNext(const TTsTime& aNextTime);
	TInt Id();

	//list capability
	static TInt Offset();
private:
	// From CTimer
	void RunL();

	CScheduleTimer(TInt aSchedule, CScheduleCriteriaManager& aManager);
	void ConstructL();
	
private:
	TTsTime iDueTime;
	TInt iScheduleHandle;
	TSglQueLink iLink;
	CScheduleCriteriaManager& iConditonManager;
	};

CScheduleTimer* CScheduleTimer::NewL(TInt aSchedule, CScheduleCriteriaManager& aManager)
	{
	CScheduleTimer* self = new(ELeave) CScheduleTimer(aSchedule, aManager);
	CleanupStack::PushL(self);
	self->ConstructL();
	CleanupStack::Pop(self);
	return self;
	}

CScheduleTimer::CScheduleTimer(TInt aSchedule, CScheduleCriteriaManager& aManager)
:	CTimer(EPriorityStandard),
	iScheduleHandle(aSchedule),
	iConditonManager(aManager)
	{
	}

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

void CScheduleTimer::ConstructL()
	{
	CTimer::ConstructL();
	CActiveScheduler::Add(this);
	}

void CScheduleTimer::SetNext(const TTsTime& aNewTime)
	{
	// Can't handle (unlikely but theoretical) situation when year is BC (not AD)
	__ASSERT_ALWAYS(aNewTime.GetUtcTime().DateTime().Year()>0,User::Invariant());
	if (IsActive())
		Cancel();

	iDueTime=aNewTime;
	TTime currentTime;
	currentTime.UniversalTime();

	if	(aNewTime.GetUtcTime()>currentTime)
		AtUTC(aNewTime.GetUtcTime());
	else
		AtUTC(currentTime);
	}

//	Respond to an task being due.  RunL is only called once!
void CScheduleTimer::RunL()
	{
	if(iStatus != KErrAbort)
		iConditonManager.DueSchedule(iScheduleHandle);

	// RunL() will also be triggered if the system time is changed, with iStatus
	// set to KErrAbort. In this case DueSchedule() should not be called.
	// If the system time has been changed, the schedule needs to be requeued. 
	// This has already been done automatically by CTaskScheduler::HandleEnvironmentChange()
	// [called by the AO CEnvironmentChangeNotifier],
	// as the active object CEnvironmentChangeNotifier has a higher priority than CScheduleTimer.
	}	

TInt CScheduleTimer::Offset()
	{
	return (_FOFF(CScheduleTimer, iLink));
	}

TInt CScheduleTimer::Id()
	{
	return iScheduleHandle;
	}

//		
// class CPropertyNotifier
// This class handles changes to P&S variables and notifies the
// CConditionManager class when a condition is satisfied.
NONSHARABLE_CLASS(CPropertyNotifier) : public CActive
	{
public:
	~CPropertyNotifier();
	static CPropertyNotifier* NewL(CConditionManager& aManager);
	
private:	
	CPropertyNotifier(CConditionManager& aManager);
	void AttachL();
	// From CActive
	void RunL();
	void DoCancel();

public:
	void SetPropertyL(const TUid& aCategory, TUint aKey);
	
private:
	TUid iCategory;
	TUint iKey;
	RProperty iProperty;
	CConditionManager& iConditionManager;
	};

//		
// class CConditionManager
// This class manages a set of conditions for each schedule.  It is used
// solely by the CScheduleCriteriaManager class. When the set of conditions 
// is met, a the schedule manager is notified.
NONSHARABLE_CLASS(CConditionManager) : public CActive
	{
public:
	~CConditionManager();
	static CConditionManager* NewL(TInt aSchedule, CScheduleCriteriaManager& aManager);
	
private:	
	CConditionManager(TInt aSchedule, CScheduleCriteriaManager& aManager);
	TBool MatchAllConditionsL() const;
	TBool HasVariable(const TUid& aCategory, TUint aKey) const;
	void CompleteRequest();
	// From CActive
	void RunL();
	void DoCancel();

public:
	void ReplaceL(const RArray<TTaskSchedulerCondition>& aConditions);
	TInt Id();
	void VariableChangedL(const TUid& aCategory, TUint aKey);
	//list capability
	static TInt Offset();	
	
private:
	RArray<TTaskSchedulerCondition> iConditions;
	RPointerArray<CPropertyNotifier> iPropertyNotifiers;
	TInt iScheduleHandle;
	TSglQueLink iLink;
	CScheduleCriteriaManager& iManager;
	};

CConditionManager* CConditionManager::NewL(TInt aSchedule, CScheduleCriteriaManager& aManager)
	{
	CConditionManager* self = new(ELeave) CConditionManager(aSchedule, aManager);
	return self;
	}

CConditionManager::CConditionManager(TInt aSchedule, CScheduleCriteriaManager& aManager)
:	CActive(EPriorityStandard+1), //make priority higher that propertynotifier AO
	iScheduleHandle(aSchedule),
	iManager(aManager)
	{
	CActiveScheduler::Add(this);
	}

CConditionManager::~CConditionManager()
	{
	Cancel();
	iPropertyNotifiers.ResetAndDestroy();
	iConditions.Reset();		
	}

//This function evaluates (aValue <op> aState) expression, where "op" could be
//"==", "!=", ">", "<", depending on aType value, and returns the result of expression.
static TBool DoMatchCondition(TTaskSchedulerCondition::TConditionType aType,
							  TInt aValue, 
							  TInt aState)
	{
	if(aType == TTaskSchedulerCondition::EEquals)
		{
		if(aValue == aState)
			{
			return ETrue;
			}
		}
	else if(aType == TTaskSchedulerCondition::ENotEquals)
		{
		if(aValue != aState)
			{
			return ETrue;
			}
		}
	else if(aType == TTaskSchedulerCondition::EGreaterThan)
		{
		if(aValue > aState)
			{
			return ETrue;
			}
		}
	else if(aType == TTaskSchedulerCondition::ELessThan)
		{
		if(aValue < aState)
			{
			return ETrue;
			}
		}
	else
		{
		__ASSERT_ALWAYS(0, User::Invariant());
		}
	return EFalse;
	}

void CConditionManager::ReplaceL(const RArray<TTaskSchedulerCondition>& aConditions)
	{
	// Ensure any active requests are cancelled
	if(IsActive()) 
	{ 
		Cancel(); 
	}

	//destroying existing ones will cancel outstanding requests
	iPropertyNotifiers.ResetAndDestroy(); 
	iConditions.Reset();
	const TInt count = aConditions.Count();
	TInt i;
	//Check that the properties already exist
	for(i=0;i<count;++i)
		{
		TInt value;
		TInt err = RProperty::Get(aConditions[i].iCategory, aConditions[i].iKey, value);
		if(err != KErrNone)
			{
			if(err == KErrNotFound)
				{
				err = KErrArgument; //use KErrArgument error code to signify bad conditions.
				}
			User::Leave(err);	
			}
		}
	//Add the new conditions and notifiers.
	for(i=0;i<count;++i)
		{
		//Create local CPropertyNotifier object
		CPropertyNotifier* notifier = CPropertyNotifier::NewL(*this);
		CleanupStack::PushL(notifier);
		const TTaskSchedulerCondition& condition = aConditions[i];
		notifier->SetPropertyL(condition.iCategory, condition.iKey); 
		//Add condition
		User::LeaveIfError(iConditions.Append(condition));
		//Add notifier
		TInt err = iPropertyNotifiers.Append(notifier);
		if(err != KErrNone)
			{
			iConditions.Remove(iConditions.Count() - 1);//Remove the condition we've just added
			User::Leave(err);
			}
		CleanupStack::Pop(notifier);
		}
	//Check to see that conditions are not already satisfied.
	if(MatchAllConditionsL())
		{
		SetActive(); //we need to set AO active here, otherwise RunL wont be called.	
		CompleteRequest();
		}
	}

void CConditionManager::CompleteRequest()
	{
	TRequestStatus *status = &iStatus;
	User::RequestComplete(status, KErrNone); // now compete request so RunL is triggered
	}
	
//Respond to a condition changing.
//Called from CPropertyNotifier::RunL().
void CConditionManager::VariableChangedL(const TUid& aCategory, TUint aKey)
	{
	//We have been notified that the value of one of the variables has been changed.
	//It is not enough to check that the variable's value satisfies its condition!
	//We have to check that all CConditionManager::iPropertyNotifiers satisfy their conditions.
	//----------------
	//If this is a variable, which is a part of the variables, monitored by the 
	//current CConditionManager object, only then do check variables values against
	//requested conditions	
	if(HasVariable(aCategory, aKey))
		{
		if(MatchAllConditionsL())
			{
			SetActive(); //we need to set AO active here, otherwise RunL wont be called.	
			CompleteRequest();
			}
		}
	}
	
void CConditionManager::RunL()
	{
	// cancel outstanding notification requests by destroying AO's
	iPropertyNotifiers.ResetAndDestroy();
	iManager.DueSchedule(iScheduleHandle);		
	}

void CConditionManager::DoCancel()
	{
	CompleteRequest();  		
	}

//The method returns ETrue, if all monitored variables (aConditions array) 
//satisfy their conditions, EFalse otherwise.
TBool CConditionManager::MatchAllConditionsL() const
	{
	TInt satisfiedConditionsCnt = 0;
	TInt count = iConditions.Count();
	for(TInt i=0;i<count;++i)
		{
		const TTaskSchedulerCondition& condition = iConditions[i];
		TInt value;
		// errors here typically indicate that the P&S variables is not of 
		// integer type (ie its changed) or its been deleted
		User::LeaveIfError(RProperty::Get(condition.iCategory, condition.iKey, value));
		if(::DoMatchCondition(condition.iType, value, condition.iState))
			{
			++satisfiedConditionsCnt;
			}
		}
	return satisfiedConditionsCnt == count;
	}
	
//This method checks if the variable, identified by (aCategory, aKey) pair, is a part
//of CConditionManager::iPropertyNotifiers array and returns ETrue, if that's true.
//EFalse otherwise.
TBool CConditionManager::HasVariable(const TUid& aCategory, TUint aKey) const
	{
	for(TInt i=iConditions.Count()-1;i>-1;--i)
		{
		if(iConditions[i].iCategory == aCategory && iConditions[i].iKey == aKey)
			{
			return ETrue;
			}
		}
	return EFalse;
	}

TInt CConditionManager::Offset()
	{
	return (_FOFF(CConditionManager, iLink));
	}

TInt CConditionManager::Id()
	{
	return iScheduleHandle;
	}

//

CPropertyNotifier* CPropertyNotifier::NewL(CConditionManager& aManager)
	{
	CPropertyNotifier* self = new(ELeave) CPropertyNotifier(aManager);
	return self;
	}

CPropertyNotifier::CPropertyNotifier(CConditionManager& aManager)
:	CActive(EPriorityStandard),
	iConditionManager(aManager)
	{
	CActiveScheduler::Add(this);
	}

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

void CPropertyNotifier::AttachL()
	{
	User::LeaveIfError(iProperty.Attach(iCategory, iKey));
	iProperty.Subscribe(iStatus);
	SetActive();
	}

void CPropertyNotifier::SetPropertyL(const TUid& aCategory, TUint aKey)
	{
	if (IsActive())
		Cancel();
	iCategory = aCategory;
	iKey = aKey;
	AttachL();	
	}

//	Respond to a condition changing
void CPropertyNotifier::RunL()
	{
	if (iStatus.Int() >= KErrNone)
		{
		iConditionManager.VariableChangedL(iCategory, iKey);
		AttachL();
		}
	// if status is KErrNotFound then P&S variable has been deleted!  By 
	// resubscribing we wait for it to be created.  If it never gets
	// created then TRequestStatus never completes so this condition 
	// never gets met and iConditionManager.VariableChanged which 
	// makes sense.
	else if (iStatus.Int() == KErrNotFound)
		AttachL();			
	// If status is another error we have a problem!!! Whatever the case 
	// we should just ignore this condition from now on by doing nothing.
	}

void CPropertyNotifier::DoCancel()
	{
	iProperty.Cancel();
	}
	
	
	
//

CScheduleCriteriaManager* CScheduleCriteriaManager::NewL(CTaskScheduler& aOwner)
	{
	CScheduleCriteriaManager* self = new(ELeave) CScheduleCriteriaManager(aOwner);
	return self;
	}

CScheduleCriteriaManager::~CScheduleCriteriaManager()
	{
	Cancel();
	RemoveTimers();
	RemoveConditions();
	}

CScheduleCriteriaManager::CScheduleCriteriaManager(CTaskScheduler& aOwner)
:	CActive(EPriorityStandard+2), //make priority higher than condition AO
	iTaskScheduler(aOwner),
	iTimers(CScheduleTimer::Offset()),
	iConditions(CConditionManager::Offset())	
	{
	CActiveScheduler::Add(this);
	}

void CScheduleCriteriaManager::CompleteRequest()
	{
	TRequestStatus *status = &iStatus;
	User::RequestComplete(status, KErrNone); // now compete request so RunL is triggered	
	}
	
void CScheduleCriteriaManager::DueSchedule(TInt aScheduleHandle)
	{
	iDueScheduleHandle = aScheduleHandle;
	SetActive(); // need to set AO active so RunL will subsequently be called.
	CompleteRequest();
	}

void CScheduleCriteriaManager::RunL()
	{
	// remove schedule and then notify task scheduler manager	
	RemoveSchedule(iDueScheduleHandle);
	iTaskScheduler.DueTaskNotifyL(iDueScheduleHandle);
	}

void CScheduleCriteriaManager::DoCancel()
	{
	CompleteRequest();
	}
	
// If schedule timer for this ID doesnt exist then create and add new timer.  If schedule 
// timer does exist then just amend existing timer.
//When one of the schedule entries in this schedule has become due,
//this function will be called with aNotFirstTime = ETrue
//If this function is called because of environment changes then aSchChange   = EOnlyTime and only update time based schedule
void CScheduleCriteriaManager::ReplaceScheduleL(CSchedule& aSchedule, TSchChangeType aSchChange , TBool aNotFirstTime)
	{
	aSchedule.CalculateDueTime(aNotFirstTime);

	TInt  scheduleId 		=  	aSchedule.Id();
	const TTsTime nextTime 	= 	aSchedule.DueTime();
	ReplaceScheduleL(nextTime,scheduleId);
	
	//If this function is called because of environment changes then
	//leave conditions unchanged
	if(aSchChange == EOnlyTime)
		return;
	CConditionManager* condition = FindCondition(scheduleId);
	// no point in doing work for 
	if(aSchedule.Conditions().Count() > 0)
		{
		if(!condition)
			{
			condition = CConditionManager::NewL(scheduleId, *this);
			iConditions.AddLast(*condition);
			}
		condition->ReplaceL(aSchedule.Conditions());
		}
	else if(condition)
		RemoveCondition(condition);		
	}
	
// If schedule timer for this ID doesnt exist then create and add new timer.  If schedule 
// timer does exist then just amend existing timer.
void CScheduleCriteriaManager::ReplaceScheduleL(const TTsTime& aNextTime, 
								TInt aSchedule)
	{
	CScheduleTimer* timer = Find(aSchedule);
	// if time is set to MaxTTime then we don't want to set a timer
	// off as it will complete straight away.
	if((aNextTime.GetUtcTime() != Time::MaxTTime())
	&& 	(aNextTime.GetLocalTime() != Time::MaxTTime()))
		{
		if(!timer)
			{	
			timer = CScheduleTimer::NewL(aSchedule, *this);
			iTimers.AddLast(*timer);
			}
		timer->SetNext(aNextTime);
		}
	else if(timer)	
		{
		RemoveTimer(timer); // make sure we remove the old one!
		}
	}

void CScheduleCriteriaManager::RemoveSchedule(TInt aSchedule)
	{
	CScheduleTimer* timer = Find(aSchedule);
	if(timer)
		RemoveTimer(timer); // remove timer also terminates AO

	CConditionManager* condition = FindCondition(aSchedule);
	if(condition)
		RemoveCondition(condition); // remove condition also terminates AO
	
	}

//Timer methods	
void CScheduleCriteriaManager::RemoveTimers()
	{
	CScheduleTimer* timer;
	TSglQueIter<CScheduleTimer> timerIter(iTimers);
    timerIter.SetToFirst();
    while ((timer = timerIter++) != NULL)
		{
		RemoveTimer(timer);
		}
	}

void CScheduleCriteriaManager::RemoveTimer(CScheduleTimer* aTimer)
	{
	iTimers.Remove(*aTimer);
	delete aTimer;
	}
	
CScheduleTimer* CScheduleCriteriaManager::Find(TInt aSchedule)
	{
	CScheduleTimer* timer = NULL;
	TSglQueIter<CScheduleTimer> timerIter(iTimers);
    timerIter.SetToFirst();
    while ((timer = timerIter++) != NULL)
		{
		if	(timer->Id() == aSchedule)
			break;
		}	
	return timer;
	}	

// condition methods
void CScheduleCriteriaManager::RemoveConditions()
	{
	CConditionManager* condition;
	TSglQueIter<CConditionManager> conditionIter(iConditions);
    conditionIter.SetToFirst();
    while ((condition = conditionIter++) != NULL)
		{
		RemoveCondition(condition);
		}
	}

void CScheduleCriteriaManager::RemoveCondition(CConditionManager* aCondition)
	{
	iConditions.Remove(*aCondition);
	delete aCondition;
	}
	
CConditionManager* CScheduleCriteriaManager::FindCondition(TInt aSchedule)
	{
	CConditionManager* condition = NULL;
	TSglQueIter<CConditionManager> conditionIter(iConditions);
    conditionIter.SetToFirst();
    while ((condition = conditionIter++) != NULL)
		{
		if	(condition->Id() == aSchedule)
			break;
		}	
	return condition;
	}