我总结的一些软件开发规范
作者:田进恩
为了提高软件开发质量,降低开发周期,增强代码的可重用性和易读性,使软件便于维护,开发人员间便于交流和协作,特总结出开发规范,以为参考。
一. 原则:
1. 软件工程化
2. 模块化
3. 能简单不复杂
4. 强调团队协作
5. 强调创新和特色
二. 具体规范:
1. 命名规范
命名应尽量使用匈牙利命名法,变量名或函数名中使用大写字符来区分各个部分,以便于记忆和阅读。如bPatchMinute, DeleteDirInfo()。全局(包括类中的)变量用长名字,局部变量用短名字。
类成员变量前一般应加上m_,全局变量加上g_,仅与本模块有关的变量加上l_,紧接着是变量的类型。
整型: n,i
长整型: l
无符号整型: u
无符号长整型:dw
字符: ch
布尔量: b
浮点数: f
双精度浮点: d
字符串: str,lpsz,sz,p,lp,ac,
指针: p
字节指针: pb
无符号指针: pv
字符指针: lpsz
整型指针: lpn
文件指针: fp
如:
m_nTotalNum,m_strPath,m_bRcving,m_fPrice,g_lOpenDate,g_dwCardNo,lpszNameStr, lpnSysDoomType,uMsgID,m_pProgress
局部变量应尽量易懂简洁,使用常见的变量,如
Num,nCount,i,j,k,n,len,pos, offset,nReadNum,index,nRet,ret, string,filename
临时变量,如ltmp,ftmp,tmpStr,tempStr,
函数命名也应该见名知意。如CalcAllDataStyle(),ReadDocDataFromTime(),GetIndexInfo() 常见的函数
Init, OpenAll, Create_, Get_, Set_, Read_, Load_, Write_, Start_, Stop_,
Check_, Test_, Fill_, Process_, Sort_, Do_, Select_, Is_, Exist_,_Ex。
宏命名和typedef定义类型应详细,避免重复,一律为大写,如
#define DEL_EMPTY(a) {if (a) {delete a;a=NULL;}}
#define SUCCESS 0
#define FAIL -1
typedef struct
{
char lpzSource[100];
char lpzTitle[100];
char lpzURL[194];
short nType;
long npos;
long nlen;
}ATTBODY,*LPATTBODY; (指针前加LP)
自定义消息从WM_USER开始
#define MYAPP_MESSAGE WM_USER+0x1001
2. 代码规范
有些不易理解的变量或函数应作注释,难懂的代码要有注解,在文件的开始处有该文件的用途描述。一定要保持注释的一致性。
代码组织要清晰,{,},(,),if,else,do,while,for,case等要对应整齐,少用空格,缩进全部用Tab键。变量的定义要集中,函数间要有空行分开,一个程序中的空行数目最好占8%-16%。多态函数和功能相近的函数集中放在一起。
代码应该简洁、清楚并讲述了所发生的一切,我们的目标应该是写出最清晰的代码,而不是最巧妙的代码。例如如果是MFC多文档程序,就要严格按照其生成的框架写代码。尽量使用编译器已经提供的函数,不必花时间另行编写。例如系统已经有qsort函数,可直接拿来排序用。
某些公用代码要注意多平台易移植,最好使用标准C。
代码的重用要仔细,要将相关的代码也拷贝过来,注意那段代码也许不适合你的应用场合。
删掉从来没有用过的函数或变量,大篇幅注释掉的代码行也应删除,以免使程序混乱难读。
3. 工程文件组织规范
一个工程往往包含很多很多文件(*.h,*.cpp,*.inc,*.lib,资源文件等),向工程中加入文件或删除工程中的文件要慎重,避免把工程损坏。工程中不起作用的文件或类应删除,工程目录下的非工程文件也应该移走,保持工程的清洁,避免混淆难于管理。工程文件如果很多,应归类。
在VC环境下,建议将常用的头文件全部放入stdafx.h中,而在每个cpp开始处嵌入stdafx.h。避免头文件的交叉引用,如果有严重的交叉引用,适当使用类的声明。
将独立性比较强的模块抽出来,做成DLL,控件或COM组件,该模块可单独编写和测试,也增强了其可重用性。
一个比较大的工程应留有一定的消息接口或插件接口等。
工程的版本控制要严格,版本格式为xx.xx.xx,必要时使用Build次数或日期。高版本尽量兼容低版本的用法、数据或协议。
工程的编译宏定义和工程参数设置应正确,每作一个新工程时应检查工程参数是否正确。 建议字节对齐方式为1字节对齐。
工程文件应经常备份,备份时注明备份日期和主要增加的功能。
4. 类组织规范
类一般有两个文件,一个头文件,一个实现体CPP。
类力求封装好,严格区分public,private,protect等作用域,如果一个函数与本类有莫大的关系,可以作为该类的静态成员函数,不用或少用友元函数等破坏类封装性的方法和技巧。 如果一些结构或宏仅与本类有关,可在类头文件中定义。
类的成员变量在构造函数或初始化函数中应赋初值。指针在构造函数中赋NULL,析构时DEL_EMPTY它,以免内存泄露。
5. 用户界面规范
有四大类型的用户界面:对话框、单文档界面、多文档界面、其它界面
对话框要易用且简洁,字体和控件的组织搭配要得体,能简单不复杂,各控件的焦点、Tab顺序等要讲究,视应用场合要适当支持键盘。在简洁易用的前提下,力求个性化,设计得更加友好。程序各对话框的风格要保持一致。
单文档和多文档界面的程序功能可以做得很强,也便于扩充和管理。其中菜单、工具栏、状态栏等设计要有特色。菜单按一定的分类弹出,必要时设计成多套菜单,在重要的窗口或区域应能弹出右键,实现常见操作。工具栏上放最常用的操作按钮,必要时动态更换按钮。状
态栏显示足够多的有用信息。
消息主控在Mainframe中,单文档的主控也可在View中,所有的对话框的弹出或非模态对话框的控制都在主控窗口中完成,具体的数据处理放在单独的文件中或设计成类。在App类中实现Ini读写,各数据对象的定义和析构,全局变量的赋值和初始计算,存盘退出等。各视图的OnDraw和GDI画图尽量使用内存位图的方式,以免闪烁。
其它还有ATL,控制台,嵌入式程序界面等,也有作为其它容器如IE中的插件等,此类程序可能不用MFC,而采用COM组件等方法实现。
6. 疑难解答和Bug调试方法
勤问、善于问。在不打扰正常工作的前提下,开发人员间应相互帮助,聚思广益,也许你的问题或Bug就是他人的前车之鉴。
从各种途径请求解答。专业书、教材、期刊、电子文档以及国际标准文献、RFC等,Internet上专业网站、论坛、专家组等。
Bug的出现总是有一定的原因的,冷静查找,不要总是拘泥于某一个小局部,换一个想法、从另外一个角度也许让你柳暗花明。使用一些辅助开发或调试工具,如Spy++,Process Viewer,系统监视器等。
拓宽知识面。多参阅其它编程语言、数据库知识、编译原理、网络协议等,熟悉硬件设备、底层汇编、数字逻辑电路等。使用和揣摩其它软件功能和界面,集百家之长,做出有创新意义和有特色的功能性软件。
三. 一些习惯:
我认为比较好的习惯:
1.if(0 == GetDataType(…))比if(GetDataType(…) == 0) 好,纵使误将==写成=,在编译一层就会报错。
2.
#define MAX_DOWNLOADNUM 20
struct DownInfo m_DownInfo[MAX_DOWNLOADNUM];
在代码中尽量不用具体的大小数值,定义成宏,便于以后维护。
3.
CUSTXG_CONTABLE g_lpCustCon[] =
{
{"数值串1",C_ZGB,C_CUSTJBM,C_VT_FBJ,"万"},
{"数值串2",C_ZSZ,C_CUSTJBM,C_VT_FBJ,"万"},
…
{"数值比例",C_WTB,C_CUSTHQ,C_VT_FBJ,"%"}
};
int g_nCustNum = sizeof(g_lpCustCon)/sizeof(CUSTXG_CONTABLE);
g_ nCustNum自动适应g_lpCustCon的大小。
4.
函数定义short GetInputType( const char * lpzInput)比short GetInputType (char * lpzInput)好,以免lpzInput在函数体中被破坏。
5.
协议包头定义成:
typedef struct tagDataHeader
{
struct{
unsigned char Version:4;
unsigned char HeaderFlag:2;
unsigned char Reserved:2;//保留Bits位
}Info;
long nOther;
long Reserved; //保留4个字节
} DATAHEADER;
定义有一定的保留字段,供以后扩充使用。
6.
变量在定义时赋初值,类析构时或程序退出时判断释放所有变量。
7.
编码空间一定要充分预留,编码时注意可扩充性。
我认为不好的习惯:
1. 代码中是"+2","+4",而不是"+sizeof(short)","+sizeof(int)"。
2. filename[40],而不是filename[MAX_PATH]。
3. GDI资源使用完后不释放,位图、笔刷等用完后不Select出来。这样会将导致系统Gdi资源丢失或内存泄露。
4. 大量使用无符号型变量。无符号变量在判断时易造成错误,甚至死循环,尽量少用。
5. 使用malloc,free不使用new,delete,大量使用realloc。new,delete是规范的C++语法,通用性强,realloc易造成内存抖动。
6. #define square(x) (x)*(x)
宏的体应加括号,否则容易出问题,如1/square(x)将被替换1/(x)*(x)
以上仅是我总结的一些,比较少,希望能抛砖引玉,请大家补充
我总结的一些关于女性避孕的措施
目前常用的女性避孕方法有:宫内节育器,药物避孕,外用避孕等 男性避孕在我国主要是阴茎套。
一.宫内节育器
它的抗生育作用主要是局部组织对异物产生一种慢性炎症反应而影响受精卵着床,副反应较多,比较适用于没有禁忌症且不再生育的妇女,你现在用不到,就不给你介绍了。
二.药物避孕
即常说的避孕药,它的成分主要是雌激素和孕激素,主要通过抑制排卵或抑制受精卵着床发挥避孕作用。
它的种类很多,最常用的是口服避孕药,口服避孕药也有两种,即:复方短效口服避孕药和复方长效口服避孕药。
1.复方短效口服避孕药
使用方法比较复杂,如复方炔诺酮片(最早的避孕药1号),于月经第五日开始服第一片,连服药22日,停药7日后服第二周期,漏服两片,补服后要加用其他避孕措施,漏服三片要停药,待出血后再服用下一周期药。不同药物服用方法不同,说明书上都会标示的非常清楚。还有一种左炔诺孕酮三相片,每个药片旁都会注明星期几服用,很简明,现在的新产品我也不知道都有啥,你问问同事吧,按说明服用就行。正确使用复方短效避孕药有效率可接近100%,是所有措施中避孕效果最好的。
2.复方长效口服避孕药
服药一次可避孕一个月,方法简单一些,但是它的激素含量大 ,副反应较多(如类早孕反应,月经失调),所以建议还是不要图省事选这个。
非口服的避孕药还有长效避孕针,探亲避孕药,缓释避孕药(包括皮下埋植剂,避孕贴片等)等,这些方法你自己操作不了,现在不建议你使用,等以后有条件了再详细给你说吧。
只要是药都会对人体有些不好的影响,这些激素类避孕药如果被长期应用会对糖代谢和脂代谢有影响,对心血管不利,因此对于有心血管疾病,血栓性疾病,肝炎,肾炎,糖尿病,甲亢,有严重偏头痛,反复发作的病人不能使用。
三.外用避孕
一般都是用避孕套,使用前应先行吹气检查有无漏孔,同时排去小囊内空气,射精后在阴茎尚未疲软时捏住套口和阴茎一起取出。国外还有女用的阴道套,不知道现在国内有没有。
四.紧急避孕
无保护性生活后或避孕失败(阴茎套破裂等造成)后几小时或几日内可口服紧急避孕药避孕(如毓婷,惠婷,安婷,都属于左炔诺酮片,米非司酮副反应相对较少,19xx年就被应用了,不知道现在还有没有),服用的剂量比较大,仅对一次无保护性生活有效 ,所以平时要小心,尽量不要有用到它的机会,但是实在碰上了也得用,毕竟它还是比中标了再去人工流产好。
五.安全期避孕
不十分可靠,所以作为辅助避孕就好。判断安全期有三种方法:
1.日历表法,适用于月经周期规律的女性,排卵通常发生在下次月经前十四天左右,因为精子进入体内后存活期大概是1--3天,而卵子产生后存活期是1天,所以排卵前三天和后一天是最易受孕的时期,因为具体哪一天排卵无法准确推断,所以这个时间一般延长为排卵前后四到五天为易受孕期,其余时间视为安全期,越接近月经期越安全。
2.基础体温法:一般排卵后到下次月经来临前体温会升高0.3--0.5摄氏度。体温上升前后两天是排卵期,可以买个体温计通过测量体温推断。3.宫颈粘液观察法:就是看白带,非排卵期,白带粘稠,量少,排卵期白带清澈透明,量多,富于弹性,不易拉断,出现这种粘液最后一天的四十八小时之间会发生排卵。
还要说的是有时候情绪紧张或精神激动可能会发生额外排卵,就不能用安全期避孕了,特别是刚开始性生活的时候,精神会比较亢奋,不能用这种方法。
差不多所有的避孕措施都介绍过了,下面就再说说每种避孕措施的适用时期吧。
如果是第一次进行性生活,双方可能比较紧张,又缺乏经验,避孕工具可能会难以掌握,建议服用复方短效口服避孕药进行避孕,因为是短效,剂量不大,所以副作用小,而且有效率最高,可以减少心理负担(不要对避孕药有心理阴影,它是一种不错的避孕手段,不要长时间应用就好),当双方对身体熟悉以后,就可以停用避孕药了,改用避孕套,如果出现意外情况,再用紧急避孕药。
目录一.引言...........................................................…
首先,在刚刚去的时候,对于手机这一块,我的大脑还是一片空白,从刚开始接触,我们就开始学习wml1.2的标签,开始一步一步的研究学习…
有感于网盘开发过程有感于网盘开发过程...............................................…
20xx年年终总结20xx年x月x日,我有幸成为公司一员。我进入公司也快6个月,回首过去的几个月中我也感受到不少的喜悦,尤其在公司…
软件项目总结报告范文1引言1.1编写目的XXX公司业务管理系统的开发已经基本完成。写此项目开发总结报告,以方便我们在以后的项目开发…
我校在日常工作中,始终重视安全工作,“安全无小事”、“安全大于天”“师生安全,人人有责”已深入人心,关爱生命,注重安全;已成为师生…
20xx年,团市委宣传部在团市委党组的正确领导下,全面贯彻落实市委、市政府提出的三大战役和全会六大工程精神,加强宣传阵地建设,规范…
在全校教职工大会的总结讲话------执行总裁朱瑜尊敬的各位教职工、领导:春暖花开,鸟语花香。在这播种的季节里,我们迎来了华中东典…
南昌一楼盘工地工人6米高空坠落遭钢筋穿体20xx年x月x日下午,南昌某楼盘工地发生惊险一幕,一男子在工地干活时,不慎从6米高处头朝…
九龙小学20xx—20xx学年度第一学期安全教育月活动总结彻落实上级有关安全的文件精神,按照市教体局文件要求,进一步提高我校广大师…