伯乐共勉

讨论。NET专区
  博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

Symbian OS 中的Class命名约定(R类)

Posted on 2007-02-09 16:52  伯乐共勉  阅读(218)  评论(0编辑  收藏  举报
前缀“R”意为“资源(Resource)”,R类通常是指向一个外部资源的句柄,例如一个文件服务会话。和C类不同的是,这里没有相应的RBase类, 所以一个典型的R类通常有一个构造函数来设定它的资源句柄为零,并显示当前资源为空。不要企图在构造函数中初始化资源句柄,因为这样可能会失败,而构造函 数中是禁止产生leave的(参见第4章)。

   可以使用R类提供的函数获取R类对象提供的资源,诸如Open(),Create() 或Initialize()等函数来分配资源和设定句柄成员变量,如果调用失败则会返回一个错误码或导致leave。R类同样提供相应的Close()或 Reset()函数来释放资源和重置句柄值。在同一对象上多次调用此类函数是安全的。尽管理论上清理函数可以任意命名,但绝大多数情况下都命名为 Close()。
在使用R类时一个较常见的失误是忘记调用Close()或以为R类对象可以在析构函数中释放自己的资源。但这会导致严重的内存泄露。

    R类通常占用空间较小,通常除了资源句柄以外并不包含其它数据成员。R类极少有析构函数——因为清除工作通常在Close()函数中完成。

   R 类可以以一个类成员或自动变量的方式在stack上存在,有些时候也可以在heap上分配。你必须确保R类在leave发生时资源可以被有效释放,通常使 用清洁栈来处理这类情况,详细描述参见第3章。记住,如果基于heap分配一个R类自动变量,你必须在使用后确信将变量所使用资源和内存释放完毕,通常有 两种push调用完成这样的功能:CleanupClosePushL()(或者同类函数),用以确保资源的释放,也可调用标准的 CleanupStack::PushL(TAny*)函数,这个函数只是在heap单元上简单的调用User::Free()。

    通常R类的成员数据要简单的多,可以直接进行逐位复制,所以你不必期待可以在R类中看到复制构造函数和赋值操作符,否则浅表复制会引起未定义行为 (undefine behavior)。比如通过逐位复制方式获得的句柄副本将会导致资源所有权的混淆。这种情况下的未定义行为多半可以归咎于两个副本 都试图释放资源而导致的。在同一对象上重复调用Close()是安全的,这是因为句柄值成员在调用Close()时复位。但是如果通过指向同一资源的两个 不同的句柄对象来调用Close()函数,这时的情况就完全不同了。如果一个句柄对象释放了指向的资源,那么指向该资源的另一个句柄也将会随即失效。

   如果你的类包含一个指向不可通过逐位复制进行安全共享的资源的句柄成员,则应该声明一个复制函数来完成必要的资源复制任务。如果你希望预防对R类任何形式的复制,可以模仿C类的方式,将复制构造函数和赋值操作符声明为private,但是不予实现。
R类的规则要多于C类和T类,所以你可以看到更多不同“物种”的R类。在Symbian OS中R类所拥有资源类型是多种多样的——从文件服务会话的class RFs到基于heap分配内存的class RArray。


   基本原则----R类对象必须通过调用Close()函数释放资源