活动对象的理解

自己按照教程上面的东西作了个定时器的例子,在这里我们理解和分析下定时器的运行和架构,找了个hzb1983的文章 结合的分析下:

总结一下：系统中有一个“活动调度器”，我们建立一个“活动对象ao1”，将该对象与某个系统中的异步函数绑定，然后将该活动对象注册到“活动调度器”中，“活动调度器”会等待异步函数返回的“完成”消息。收到完成消息后，调度器遍历所注册的活动对象，如果发现status != KRequestPending则找到该status对应的“活动对象ao1”，调用其中的RunL方法，以事件的方式告知我们异步函数已经执行完成。
Symbian编程总结-基础篇-活动对象正解（2）-使用活动对象
我们已经大致了解了活动对象的基本概念，要使用活动对象机制，需要用到活动对象、活动调度器、异步函数。我们想使用异步函数，要按照应用程序->活动对象->活动调度器->异步函数的流程来使用。接下来我们开始进入实战，使用活动对象。

一、创建活动调度器

我们知道，活动调度器是应用程序和异步函数之间的桥梁，应用程序使用活动对象通过活动调度器去截获异步函数的返回“完成”消息，并以事件的方式通知应用程序。

使用Carbide C++ 1.3，通过模板向导生成的控制台程序自动为我们生成了创建活动调度器的代码：

    CActiveScheduler* scheduler = new (ELeave) CActiveScheduler();    CActiveScheduler::Install(scheduler);CActiveScheduler::Install()方法调用以后，内部代码就会将scheduler指针赋值给CActiveScheduler类内部的静态指针，后面的代码就可以方便的使用CActiveScheduler类的静态方法，如：

    IMPORT_C static void Add(CActive* aActive);    IMPORT_C static void Start();    IMPORT_C static void Stop();Add()方法：将活动对象加入活动调度器中注册，以备使用
Start()方法：启动活动调度器，活动调度器将开始循环等待异步函数返回的通知消息
Stop()方法：停止活动调度器
二、创建活动对象

1、我们创建的活动对象必须派生自CActive类，CActive类已经为我们准备好了iStatus成员变量：

public:    TRequestStatus iStatus;private:    TBool iActive;另外一个成员变量iActive起着标识作用，证明该活动对象已经请求了异步函数，如：

RTimer::After(iStatus, 1000000);SetActive(); SetActive()方法为基类CActive的方法，其实就是将iActive = ETrue;，用来标识活动对象已经调用了异步函数。所以，我们只要调用了异步函数，在调用异步函数的代码后面应该紧挨着调用SetActive()方法的代码。

2、有两个虚方法必须继承：

    virtual void DoCancel() =0;    virtual void RunL() =0;RunL方法：活动调度器接收到异步函数返回的“完成”消息后，遍历在其注册的所有活动对象，如果活动对象的iActive = ETrue且iStatus != KRequestPending则调用活动对象的RunL方法，并将iActive设置成EFalse，以防下次轮询时仍然调用此活动对象。
在这里“RunL”这个名字会让很多人产生歧义，我刚开始接触的时候总以为和J2me中的Runnable接口的run方法差不多。其实在这里把“RunL”改为“NotifyRequestCompleteL”更贴切些。

再次声明一下，调用异步函数时，参数TRequestStatus& status都是以引用的方式传递的，如：

IMPORT_C void After(TRequestStatus &aStatus, TTimeIntervalMicroSeconds32 anInterval);
所以异步函数内部可以改变status的实参，也就是改变活动对象的类成员iStatus。
DoCancel()方法：基类CActive中有取消异步函数的方法Cancel()，调用Cancel()后，活动对象会通过DoCancel()方法通知应用程序做取消方法的后期工作，如删除对象及回收指针等。注意：在应用程序中如果想终止活动对象，要使用Cancel()方法调用而不是DoCancel()方法。

3、活动对象的带优先级的构造函数：

基类CActive的构造函数原型如下：

protected:    IMPORT_C CActive(TInt aPriority);此处将传入一个优先级枚举值，枚举值内容如下：

/**Defines standard priorities for active objects.*/enum TPriority    {    /**    A low priority, useful for active objects representing    background processing.    */    EPriorityIdle=-100,            /**    A priority higher than EPriorityIdle but lower than EPriorityStandard.    */    EPriorityLow=-20,            /**    Most active objects will have this priority.    */    EPriorityStandard=0,    /**    A priority higher than EPriorityStandard; useful for active objects    handling user input.    */    EPriorityUserInput=10,            /**    A priority higher than EPriorityUserInput.    */    EPriorityHigh=20,    };当调用CActiveScheduler::Add方法注册活动对象时，活动调度器会按照活动对象的优先级进行排序，插入或添加到活动对象集合中。在此会起到如下作用：当多个异步函数消息同时返回时（多个iStatus同时不为KRequestPending），活动对象调度器轮训集合的时候总是会先找到优先级高的活动对象并调用其RunL方法。

但是在通常情况下，我们会在构造函数传入EPriorityStandard。

三、活动调度器Start方法的伪代码

通过以上两点分析，我们完全可以模拟出CActiveScheduler::Start方法：

void CActiveScheduler::Start()   

{   

    for (;;)       

    {        // 挂起线程直到异步函数消息返回       

              // 注：活动调度器和应用程序不在一个线程，所以应用程序不会阻塞           User::WaitForAnyRequest();

// 如果异步函数和主程序在不同的线程则RThread::WaitForAnyRequest();       

// 当消息返回的时候线程会苏醒       

// 以优先级降序的方式检测调度器集合中每个活动对象       

for (;;)            {            // 调用第一个已完成且iActive == ETrue的活动对象事件处理函数            if (activeObject->IsActive() && activeObject->iStatus != KRequestPending)                {                // 找到一个已准备好处理事件的活动对象                // 重置iActive状态以表明其不再是活动状态了                activeObject->iActive = EFalse;                // 在TRAP中调用活动对象的事件处理函数                TRAPD(err, activeObject->RunL())                ;                if (err != KErrNone)                    {                    // 如果异常则调用活动对象的RunError方法                    err = activeObject->RunError();                    if (err != KErrNone)                        {                        Error(err);                        }                    }                break;                }            }        }    }四、使用活动对象的例子

 

 

 

首先是主类:

AOTest类的代码:

AOTest.h:

#ifndef __AOTEST_H__#define __AOTEST_H__// Include Files#include <e32base.h>// Function PrototypesGLDEF_C TInt E32Main();#endif // __AOTEST_H__

AOTest.cpp:

#include "AOTest.h"#include "TimerDelay.h"#include <e32base.h>#include <e32std.h>#include <e32cons.h>// Console_LIT(KTextConsoleTitle, "Console");_LIT(KTextFailed, " failed, leave code = %d");_LIT(KTextPressAnyKey, " [press any key]/n");// Global VariablesLOCAL_D CConsoleBase* console; // write all messages to thisLOCAL_C void DoStartL(){CActiveScheduler* scheduler=new(ELeave)CActiveScheduler();//创建一个活动对象调度器CleanupStack::PushL(scheduler);//把它压栈CActiveScheduler::Install(scheduler);//安装活动调度器 把它作为当前线程的活动调度器CTimerDelay* task=CTimerDelay::NewLC(1000,*console);//创建活动对象 并且把它增加到活动对象调度器中task->StartL(30);//执行活动对象 发起一个异步请求 CActiveScheduler::Start();//请求了以后 开始运行调度器CleanupStack::PopAndDestroy(2,scheduler);}LOCAL_C void MainL(){//// add your program code here, example code below//console->Write(_L("Hello, world!/n"));}// 程序入口GLDEF_C TInt E32Main(){// Create cleanup stack__UHEAP_MARK;CTrapCleanup* cleanup = CTrapCleanup::New();//创建Clearup对象// 创建输出控制台TRAPD(createError, console = Console::NewL(KTextConsoleTitle, TSize(KConsFullScreen, KConsFullScreen)));if (createError)return createError;// 在TRAPD里面运行应用代码，等待终端的输入, wait keypress when terminatedTRAPD(mainError, DoStartL());if (mainError)console->Printf(KTextFailed, mainError);console->Printf(KTextPressAnyKey);console->Getch();delete console;delete cleanup;__UHEAP_MARKEND;return KErrNone;}

 

然后是自己的活动对象TimerDelay类:

TimerDelay.h

#ifndef TIMERDELAY_H#define TIMERDELAY_H#include <e32base.h>// For CActive, link against: euser.lib#include <e32std.h>// For RTimer, link against: euser.libclass CTimerDelay : public CActive //定义一个时间延时类{public:// 析构方法~CTimerDelay();// 俩步构造方法之二static CTimerDelay* NewL(TTimeIntervalMicroSeconds32 aInterval,CConsoleBase& aConsole);// 俩步构造方法之一static CTimerDelay* NewLC(TTimeIntervalMicroSeconds32 aInterval,CConsoleBase& aConsole);public:// 初始化请求的功能void StartL(TTimeIntervalMicroSeconds32 aDelay);private:// 默认构造函数CTimerDelay(TInt aDelayTimes,TTimeIntervalMicroSeconds32 aInterval,CConsoleBase& aConsole);// 俩步构造函数的实质阶段void ConstructL();//功能方法 打印void ConsolePrint();private:// 活动对象的默认函数// 处理完成后的方法void RunL();// 取消方法void DoCancel();// Override to handle leaves from RunL(). 当活动对象发生panic的时候默认执行的方法TInt RunError(TInt aError);private:enum TTimerDelayState{EUninitialized, // Uninitialized 没有初始化EInitialized, // Initalized初始化完成EError//错误// Error condition};private:TInt iDelayTimes;TInt iCounter;CConsoleBase& iConsole;TInt iState; // 活动对象的状态RTimer iTimer; // 提供异步的时间服务的对象TTimeIntervalMicroSeconds32 ilnterval;//提供32位时间延时的系统};#endif // TIMERDELAY_H

 

TimerDelay.cpp

#include "TimerDelay.h"#include "e32cons.h"_LIT(kTimeDelayNum," TimeDelay%d/n");_LIT(kErr,"Timer error%d/n");//第一阶段的构造函数 也就是默认的构造函数CTimerDelay::CTimerDelay(TInt aDelayTimes,TTimeIntervalMicroSeconds32 aInterval,CConsoleBase& aConsole):CActive(EPriorityStandard),iConsole(aConsole),iDelayTimes(aDelayTimes) ,ilnterval(aInterval){iCounter=1;}//CTimerDelay* CTimerDelay::NewLC(TTimeIntervalMicroSeconds32 aInterval,CConsoleBase& aConsole){CTimerDelay* self = new (ELeave)CTimerDelay(30,aInterval,aConsole);CleanupStack::PushL(self);self->ConstructL();return self;}CTimerDelay* CTimerDelay::NewL(TTimeIntervalMicroSeconds32 aInterval,CConsoleBase& aConsole){CTimerDelay* self = CTimerDelay::NewLC(aInterval,aConsole);CleanupStack::Pop(); // self;return self;}//真正的构造函数 通过他的句柄RTimer来连接到异步服务器提供者 如果没有足够的内存分配给定时器就会发生异常void CTimerDelay::ConstructL(){User::LeaveIfError(iTimer.CreateLocal()); // 初始化iTimerCActiveScheduler::Add(this); // 把活动对象增加到活动调度器中}CTimerDelay::~CTimerDelay(){Cancel(); // Cancel any request, if outstandingiTimer.Close(); // Destroy the RTimer object// Delete instance variables if any}void CTimerDelay::DoCancel()//取消等待的请求{iTimer.Cancel();}//被用来初始化异步请求他要做的就是在 RunL()方法被完成前等待一段时间 尽管 Start（）函数本身会迅速的返回 但是一旦异步定时器请求完成RunL()会在未来某个时刻被调用void CTimerDelay::StartL(TTimeIntervalMicroSeconds32 aDelay){Cancel(); // 为了在开始前确定 取消了任何请求iState = EUninitialized;//状态iTimer.After(iStatus, aDelay); // Set for later（请求状态，延时时间）在给定的时间后异步时间的服务器提供者会通过做俩件事情想当前这个线程发出信号亮SetActive(); // 告诉活动调度器一个请求被激活了 Tell scheduler a request is active}void CTimerDelay::RunL()//运行调度器后执行这里{ConsolePrint();//在终端打印消息来显示异步请求服务结束if ((iState ==KErrNone)||iCounter<=iDelayTimes){iTimer.After(iStatus, 1000000); // Set for 1 sec laterSetActive(); // Tell scheduler a request is active// Do something the first time RunL() is callediState = EInitialized;}else if (iState != EError){User::Leave(KErrNoMemory);}}void CTimerDelay::ConsolePrint()//在终端打印消息{iConsole.Printf(kTimeDelayNum,iCounter);iCounter++;}TInt CTimerDelay::RunError(TInt aError){return aError;}

 

 

 本文部分来自CSDN博客，转载请标明出处：http://blog.csdn.net/hzb1983/archive/2009/06/17/4277907.aspx