前几天被一个同事问了个问题:
IF vs_code = to_number(ii_code) THEN
这是一行Oracle PL/SQL代码,他问我写得对不对。
且不说这个问题有多白痴,但只看一眼便可知道这行代码有问题。因为按照编码规范,变量应当使用v、i或o作为开头的第一个字符,以表示该变量为局部变量、输入参数或输出参数;第二个字符s则表示类型为VARCHAR2,i表示类型为INTEGER。从规范来看,这行代码应当写作:
IF ii_code = to_number(vs_code) THEN
虽然匈牙利命名法现在已经不再被推荐了,但从这个例子来看,在变量命名时标明类型依然是必要的。这样做不单便于自己阅读,也可以使别人对代码一目了然。
说到这里,我倒想起另外一个问题,就是前几天看我们的编码规范,发现规范对段注释和行注释的运用说的十分不清楚,只是说有这么个东西,但具体在何时使用,就让编码人员自己看着办了。其实段注释和行注释从字面上理解,一眼也看得出该怎么使用,只是规范的范例给得实在很差:
//名称
String strName = null;
我觉得像这种情况根本没必要占用两行的空间,写作:
String strName = null; //名称
就可以了,又不耽误阅读。但若是一行代码或注释较长,则应当使用段注释,甚至断行。
此外,规范中对于段注释是使用//还是/* */也没有做明确规定。我个人认为应当使用//,毕竟注释再长也就几行。那么/* */在何时使用呢?我认为可以在废弃或临时注释大段代码时使用。虽然像Eclipse、PL/SQL Develop、Visual Studio这些IDE都提供了注释工具,不过也需要预防某些没有IDE可用的情况啊!
云鹏杂记 之 编码规范
最新推荐文章于 2021-06-21 02:14:48 发布