Symbian手记【一】 —— Symbian命名法

【一】 Symbian命名法

每个美感尚存的C++ coder,第一次看到Symbian C++的程序,第一反应是:这鬼代码怎么缩进的?接下来,所有人会有疑问应该是:函数和类上的乱七八糟的前后缀是啥意思?
娃再丑也是爸妈生的,生成这模样虽然很无奈,但确实也是事出有因。在我看来,Symbian命名法的核心出发点,就是为了更好的内存资源管理。C++的人肉内存管理模式,在给人以控制到字节的快感的同时,也带了了麻烦到每行代码的烦恼。命名法,就是Symbian设计者憋出来用来辅助管理内存资源的方式之一。

类命名

Symbian的类,通常都带着一个字母的前缀,比如C、M、T、R、H等等。
所有从CBase派生而来的子类,都以C开头,形如Cxxxx。每个正确设计的,非抽象(不可实例化)的C类,都只能在堆上分配。为了保证这一点,每一个可实例化的C类,都应该按照Symbian的二阶段构造模式。但当然,这可以有意外。比如一些派生自CCoeControl的控件对象类,会需要从Resource文件中构造类的成员对象(而不仅仅通过二阶段中的ConstructL方式来构造),这使得它可能不适合按照二阶段构造的方式来封装。
做过.Net或者Java的人应该都明白,保持一个单一根的类型系统有什么好处,.Net在没有泛型的日子里,就是通过这个共根来实现一些基础的容器和方法。但这个好处,在C++,尤其是Symbian C++中体现的并不明显。因为C++有void *(在Symbian中华丽的转身为TAny *),有模板,可以来做一些类似的事情。更重要的,在Symbian C++中,为了节约空间,把虚表的RTTI项给精简掉了,使得Symbian C++的类丧失了dynamic_cast的能力,从而导致整个Symbian在运行期的动态识别能力,很是孱弱。
所以说,之所以要从CBase类进行派生堆上对象,很重要的一个原因,就是为了内存管理。CBase做了一件很重要的事情,就是将拷贝构造函数和赋值函数设置成了私有。这意味着,所有从CBase派生的子类,都默认被阉割了一刀,失去了拷贝构造的能力。这是为了提醒所有使用者,C对象的浅拷贝是不受欢迎的,如果你想提供该对象的拷贝功能(要深拷贝,不要浅...),往往是利用一些CloneL之类的接口来实现,保证行为的统一性。

C的类们,都涌向了堆中,栈上的活,留给了T类来完成。T类没有什么特殊的继承结构,每个T类,需要可以随意的在堆上或者栈上分配。大部分时候,它们该待的地方是栈,在栈上分配,并可以快速拷贝,一旦被析构,所以资源被释放,生不带来死不带走不留下一点残渣。因此,它们不应该包含大块的数据对象,但却可以拥有很复杂的接口,增加操作的便利性。比如,TRgb、TRect之类的系统类,就是典型的人小鬼大的代表人物。但T类不是C++的old plain类,它可以有继承结构,比如Symbian中描述符的那一堆堆T类,就拥有复杂的继承结构。

但世界是残酷的,有的类,偏偏就是投错了胎,搞得人不人,鬼不鬼。HBuf,就是此中代表。为了保持队形,维系接口,HBuf派生自TDesC,用以表示分配在堆上的Symbian描述符(就是字符串...)。但与一般T类不同,因为其占用空间动态变化,它必须在堆上分配,所以丧失了叫T的权利;另一方面,为了接口,它派生了T类,在排斥多根的C++中,它就不能够在从CBase派生了(继承的局限性,可见一斑),被断了叫C的后路。于是,就带上了H的特殊帽子,表示其在堆上分配,但不苟且于C类的屋檐下。

R类,换成通俗的描述,就是句柄类。它天生为了管理资源而存活,R类本身很简单,通常在栈上分配,可以拷贝,在这一点非常接近于T类。但与T类不同的时,R类往往带有某个堆对象的指针,指向文件之类的资源,或者是大块的堆数据对象。它析构的时候,默认是不析构这个指向的对象的,而是提供了一些类似于Close,Release之类的接口,需要人肉手动释放。有的T类也是指向另一块堆或者栈区域的,比如TPtr类。这两者一个本质的区别在于,T类指向的对象,不是它自己分配,它只是提供一个快捷方式,并不管指向对象的死活;而R类指向的资源,往往是自己本身或者另一个同类分配的资源,R类对象指向的资源,必须从这个R类的对象构造,从这个R类的对象析构(两个对象可以不同,但类是一致的)。

在Symbian C++中,还有一些类,不涉及任何内存资源。一个就是接口类,它们以M开头,相当于.Net的Interface,是一个纯虚类。每个Symbian中的类,可以派生自若干个M类,但仅仅能从一个有内存资源的对象那里进行分配。理论上,作为一个纯虚类,应该提供一个虚的析构函数,但在Symbian C++中,这往往是不需要的。因为在一个没有RTTI的世界里,只有第一个被继承的接口才有可能成功析构所有对象。比如一个类,形如 class A : public Cxxx, public Mxxx。只有用Cxxx接口才能管理资源,对Mxxx接口进行delete,完全没有办法释放全部资源(除非Cxxx里面没有任何数据...)。而Symbian的堆对象往往派生自CBase,所以,不可能从一个M类来析构对象,这个析构函数成不成虚,就是无关紧要的事情了。
另外一个不含任何资源的类,就是静态类了,在Symbian C++中它们没有任何前缀,是唯一不戴帽子的家伙。这个和.Net的static class一样,只包含一堆的静态方法,需要屏蔽所有构造、析构、拷贝接口(要没有这个闲工夫,不屏蔽也无所谓了...)。虽然,C++有函数,但出于对面向对象的热衷,使用这样的静态类,还是很值得鼓励的。。。

函数命名

在Symbian中,类是戴帽子的,函数则是穿裤子的。在Symbian的函数(包括成员和非成员函数)中,常有两种后缀,一个是L,另一个是LC。L,就是告诉你,这个函数可能Leave,换人类可知的语言描述,就是这个函数会抛出异常,需要谨慎处理。L是有传递性的,如果在调用该函数的地方对此L不理不睬放任其Leave,那么,在此调用函数后面,也需要添加一个L。
除了L,还有跟进一步的LC。这通常都是构造性的函数,它告诉你,它构造的过程中,不但可能Leave,并且分配的对象处于清理栈中。这是一个接近于语法糖的功能,如果在本函数中的后续部分需要调用被构造对象的相关接口,应该用LC,然后自己pop,而不是L。

其他命名法

还有一些对象,是会被带着前缀的。比如对象的成员变量,都带着前缀i;函数参数,都带着a(如果后面是原因字母开头,则需要用an,*_*)。在成员变量加前缀,这是常用的手段,可以和成员变量区分开了,帮助节约命名一个变量的脑细胞。但对函数形参加前缀,就是一件很诡异的事情了,剖有画蛇添足的艺术气息。
在Symbian中,所有的常量,都应该是K开头的,包括定义的const量,_LIT定义的字符常量等等。而枚举类型,同属于T类型,以T开头,其中的枚举值,则是以E开头。给这些类型的东西建立命名法,是常见的手段,只是Symbian不走寻常路,命名方式上不屑于与别人苟同。。。

结语

简而言之,Symbian制定了一套复杂的命名法规则,期待以此来规范化内存管理等操作。但世界的残酷在于,一个没有强制的标准,是不可靠的。命名法是一种弱约束的东西,工期赶的再急,也不可能无视编译和运行时的错误,但却可以无条件的忽视命名规则。并且,命名法是有强烈的破窗效应,一旦某一个函数没有合理的添加L,所有直接和间接调用它的函数,都可能会错误使用它,从而埋下隐患。况且,Symbian的命名法也算是枝繁叶茂了,很容易让人看不清楚端倪,不知不觉的就用错了,一个团队每个人在这上面犯一些错误,到最后命名法就完全丧失了效能。不过,就算是环境恶劣,对于个人而言,还是应该严于律己的,不论如何,不要轻易抛弃正确命名,这样,才可能造福大家。。。

posted on 2009-05-25 23:56  duguguiyu  阅读(...)  评论(... 编辑 收藏

导航

统计