最新Domino代码优化、编码规范(1)课件PPT.ppt 43页

'Domino代码优化、编码规范(1) 表单规则:1．1表单命名规则表单名称统一用中文,尽量能展示该表单的功能和意图.如果表单名无法展示其意图,或者表单名必须用英文,或者需要对表单做些其他说明,则填写表单的备注.必须填写表单的别名.别名的可以用英文单词组合或汉语拼音.如果用拼音,在能够容忍的长度内,尽量用全拼。规定：如果名称全拼在16个字之内，用全拼并且每个字的首字母要大写。如果超过16个字，则全用每个字的首字母大写。表单名无需加”fm”的前缀。但可以按其功能类别加前缀，比如用于区分“核心表单和非核心表单”的前缀对于不需要用来创建文档的表单，名字用括弧括起来，用以将后台表单和前台表单区分开，如功能性的表单作为后台表单。 表单规则:1．2表单的JsHeader表单的JsHeader中的函数应尽可能的少。只保留仅与本表单相关的特殊的Js函数。规定：放在页面里的js函数包要在页面中写明每个包中的函数名称，方便查找和查看。资源库中的js函数包同时要有同名的说明文件。还要求有一个总体说明文件。1．3表单的OnKeyDown事件可以在此函数中限制用户的一些按键，例如：//防止用户CTRL+N,避免繁盛保存冲突if(event.keyCode==78&&event.ctrlKey)returnfalse; 视图的规则3．1视图的命名规则视图名称统一用中文,尽量能展示该视图的功能和意图.如果视图名无法展示其意图,或者视图名必须用英文,或者需要对视图做些其他说明,则填写视图的备注。规定：如果视图本身是被调用的在备注中必须写明被谁调用。必须填写视图的别名.别名的可以用英文单词组合或汉语拼音.如果用拼音,在能够容忍的长度内,尽量用全拼.规定：如果名称全拼在16个字之内，用全拼并且每个字的首字母要大写。如果超过16个字，则全用每个字的首字母大写。视图名无需加”vw”的前缀.对于不需要用于前台显示的视图，名字用括弧括起来成为隐藏视图，用以将后台视图和前台视图区分开 视图的规则3．3视图的列一般应填写列的“标题”属性，用于辨别该列视图的列的内容的字体应统一设置，一般字号设置为9，字体为宋体，颜色根据客户需要设置，风格应协调统一。视图的列公式尽可能的简洁，减少计算量。避免使用时间相关的列公式，比如@Now,@Created,@Modified.列尽可能不排序删除所有不必要的列 视图的规则3．4视图的选择公式避免使用复杂的视图选择公式视图选择公式避免使用与时间、当前用户相关的函数或命令，如@now,@Today,@UserName都是应该避免使用的 视图的规则3．5嵌入视图视图作为“嵌入元素”嵌入页面或表单时，“要显示的行”属性的数字尽量设置的少些，以提高嵌入视图的打开速度。规定：初始值设为20行，如果用户提出速度问题，可以改为10行，作为第一解决方案。 代理的规则4．1代理的命名规则代理的名字可以用英文单词组合或汉语拼音.如果用拼音,在能够容忍的长度内,尽量用全拼.规定：如果名称全拼在16个字之内，用全拼并且每个字的首字母要大写。如果超过16个字，则全用每个字的首字母大写。必须填写代理的备注，对代理进行详细的说明。代理名加用于标明其是否为核心代理的前缀. 代理的规则4．2代理的其他规则对于定时执行的代理，在该数据库正式启用前，或者该定时代理暂时不使用时，取消代理前的复选框，以暂时禁用该代理。对于那些只为管理者在客户端使用的代理，应设为“私有代理”，防止为他人误用代理“SubInitialize”中的代码要尽可能的简短，不能超过40行。多个代理中或和其他设计元素中共享的代码，应独立到“script库”中。 代理的规则4．3同时运行代理缺省的，domino同一时刻只执行一个web代理（串行），配置domino并行运行web代理能够提高应用的答复时间。配置并行运行代理，需要设置服务器文档中HTTP页下的“是否同时运行web代理”为“是”或者在notes.ini中设置这一行“DominoAsynchronizeAgents=1” 代理的规则4．4防止资源冲突同时运行web代理时，为防止资源冲突，要使用用加锁机制，例如:SharesResources=docCgi.UNID(0)+"save"lockID=Createlock(SharesResources)gotLock=Codelock(lockID)=======================================//你的代码=======================================If(gotLock)ThenreleaseLock=Codeunlock(lockID)dseleteLock=Destroylock(lockID)EndIf Script库的规则script库中要放功能相近的代码，以达到“高内聚”的目的。也便于查看代码。Script库的开头区域要有对整个Script说明的注释 LotusScript代码规则6．1函数的长度单个函数中的代码行数不要超过40行。这是一个最重要的规则。 LotusScript代码规则6．2函数的命名让我们看一些错误的命名：PersonLog‘更新人员日志PeopleOut‘打印人员外出的信息RemoveUser"从文档的当前环节和当前处理人中删除指定处理人RenyuanJB’计算人员的级别6．2．1函数的名字用英文单词组合。6．2．2函数名字的语法结构,一般应采用“动宾”等动词开头的结构6．2．3函数的名字在能容忍的程度内，尽可能的长，以更好的揭示意图6．2．4函数的名字应和函数的功能一致，不可超出或小于函数的功能，或者“风马牛不相及”。 LotusScript代码规则6．3参数的规则6.3.1参数名字要有意义例如：subSetValue(width,height)’良好的风格subSetValue(x,y)’不好的风格例如编写字符串拷贝函数StringCopy，它有两个参数。如果把参数名字起为str1和str2，例如functionStringCopy(str1,str2)那么我们很难搞清楚究竟是把str1拷贝到str2中，还是刚好倒过来。可以把参数名字起得更有意义，如叫strSource和strDestination。这样从名字上就可以看出应该把strSource拷贝到strDestination。6．3．2如果输入参数以值传递的方式传递，则宜改用“ByValargument”方式来传递，这样可以防止作为参数的变量值被修改，同时又可以省去临时变量的构造过程，从而提高效率。6．3．3避免函数有太多的参数，参数个数尽量控制在5个以内。 LotusScript代码规则6．4函数的返回值要书写函数的返回值类型函数的返回值要与函数的名字相配合函数的正常返回值和错误返回值的区分函数尽量不要通过参数传递函数的返回值,除非有多个不相干的返回值 LotusScript代码规则6．5函数的职责函数的职责要单一，如果觉得职责的“粒度”不好把握，可以先用自然语言写出总控模块（可以作为注释），针对自然语言的每句话即可作为一个函数。 LotusScript代码规则6．6变量的规则每个模块必须使用optiondeclare这个语句来强制要求所有的变量必须定义变量的定义后面要书写该变量的注释变量的作用范围尽量少用全局，作用范围越小越好变量尽量都要定义类型少使用Variant类型 LotusScript代码规则6．7嵌套的深度和广度条件语句的嵌套不能超过3层。循环语句的嵌套不能超过3层。两者混合的嵌套也不能超过3层。条件结构的开始和结束语句之间的代码不能超过20行。循环结构的开始和结束语句之间的代码不能超过20行。 LotusScript代码规则将Redim的使用降到最少，下面的片断A比片断B快20%Fori=1to10000If(i>iMax)TheniMax=iMax+100RedimPreservesArray(1ToiMax)EndIfsArray(i)=“”NextFragmentBFori=1to10000RedimPreservesArray(1Toi)sArray(i)=“”Next使用GetNextDocument代替GetNthDocument LotusScript代码规则6．8其他规则使用For循环代替Do循环遍历数组元素时，使用Forall代替For避免使用不必要的数组，例如：片断A比片断B快一倍。片断Afori=1to100sum=sum+x(i)nextt(1)=sum片断Bfori=1to100t(1)=t(1)+x(i)Next LotusScript代码规则6．9禁止硬编码任何将数据库文件名和路径名直接写在程序中的，都是硬编码。任何取当前数据库同路径作为目标数据库路径的做法，都是硬编码 公式规则尽可能不用或少用@DbColumn,@DbLookup尽可能使用视图列序号而不是域的名字作为@DbColumnor@DbLookup的参数使用@DbColumn,@DbLookup.时，尽量开启“缓存”参数 图片规则所有的图片尽量放在文件系统上，使用来引用，这样既可以利用浏览器端的缓存，也可以省去Domino对图片的转换 JavaScript具有通用性的，可以提取的js函数独立到一个单独的资源数据库中。 注释规则10．1函数体注释针对每个函数，按照下面的模板进行注释"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""NAME名字"PARAMETERS每个参数的名字、意图、类型""PRE-CONDITIONS前提条件"RETURNEDVALUES类型，格式""LASTUPDATEDBY作者"LASTUPDATEDDATE2002-1-28,2002-3-11"VERSIONNUMBER2.1"DESCRIPTION实例化本类""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""subsubNamedim…..set……endsub 注释规则10．2代码行注释对于变量、关键的代码行都要在其右边进行注释。10．3设计元素版本说明对于使用%include来隐藏代码的代理或Script库，需要在%include上面说明下面三个信息：1.更新人2.更新时间3.被引入代码的版本信息4.被引入代码的作者5.被引入代码的功能概要"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""LASTUPDATEDBY更新人"LASTUPDATEDDATE2002-1-28,2002-3-11"VERSIONNUMBER2.1‘Author代码作者"DESCRIPTION实例化本类""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 总结：1.首要考虑性能问题，尽可能不用或少用@DbColumn,@DbLookup以及其他影响性能的设计。 总结：2.单个函数中的代码行数不要超过40行。这是一个最重要的规则3.函数的职责要单一4.禁止硬编码5.必须注释 中药外敷法 概述中药外敷法是指将新鲜中草药切碎、捣烂，或将中药末加辅形剂调匀成糊状，敷于患处或穴位的方法称敷药法。具有舒筋活络、祛瘀生新、消肿止痛、清热解毒、拔毒等功效。中药外敷法是以中医学为理论基础，根据不同的病证，选择相应的药物，制成膏、丹、丸、散、糊、锭等制剂，敷于相应的体表部位或穴位上，通过药物的经皮吸收或对体表部位及穴位的刺激，来调节人体气血津液、经络脏腑等的功能，达到防病治病的目的。 历史来源敷药疗法历史悠久，源远流长，是中医药学宝库中的瑰宝，亦是中医外治法的重要组成部分。先古人类在长期的生活实践中发现，用一些植物或加热的石块、沙土等，敷于身体某些部位，可以减轻或消除机体的一些病痛，这可能就是敷药疗法的起源。随着人类创造文字，历代医著及相关书籍中逐渐有了关于敷药疗法的记载。我国现存最早的医方书《五十二病方》中载有用地胆等外敷治病的方法；《灵枢·经脉篇》载有治筋急的马膏膏法；《周礼·天官》载有外敷药物治疗疮疡；《肘后备急方》载有将生地黄或瓜蒌捣烂外敷治伤等。 我国现存最早的外科专著《刘涓子鬼遗方》，全书收方151首，其中就有6首外敷药方。其后各代，敷药疗法均有发展，至清代《理瀹骈文》的问世，标志着外治法这一中医学分支学科的发展与成熟。其中，敷药疗法内容占有很大比重，该书外治理、法、方、药俱全，并提出了“外治之理，即内治之理”的重要论断，治疗范围涉及内、外、妇、儿、五官、皮肤科等疾病。外治法在近现代继续受到重视，尤其是敷药疗法。本着继承与发展的原则，学者们以传统医学与现代科学相结合的方式，广泛开展了敷药疗法的理论与临床研究，使其在临床上广泛发挥效用。细胞核 作用敷药疗法通过药物的直接作用和间接作用达到防病治病的目的： 　　直接作用就是药物本身的作用——药物通过皮肤渗透和吸收，进入体内，随血液的运行到达病所，发挥药理功效而防病治病。 　　间接作用就是药物通过不断地刺激敷药部位的皮肤或穴位，来调节机体的神经、体液、组织、器官等的功能而防病治病。敷药疗法适用范围广泛，包括内、外、妇、儿、五官、皮肤科等多种病证。并且有许多优点，如：药物直达病所，奏效迅速；廉便效验，易于推广；适应证广；可减缓药物毒性和不良反应；并可弥补内治法疗效的不足。 方法1、物品准备 治疗盘、治疗碗内盛调制好的药物、油膏刀、棉垫或纱布块、棉纸、胶布、绷带。调制新鲜中草药需准备切刀、切板、乳调制中药末根据需要备好清水、茶水、醋、蜜、麻油、饴糖等辅形剂。 2、操作方法（1）敷药局部作清洁处理。（2）新鲜中草药须切碎、捣烂，平摊于棉垫上。药末经清水或醋、蜜等调制成糊状，平摊于棉垫或纱布上，并在药物上面加一大小相等的棉纸或纱布。（3）将药物敷于患处，用胶布或绷带固定。 3、护理（1）调制的药物须干湿适中，厚薄均匀，根据药物作用，决定敷药厚薄，如消散药膏宜厚，创面生肌药膏宜薄，一般以0.2～0.3cm为宜，大小须超出病变处1～2cm为度，对皮肤有腐蚀的药物应限于病变部位以内。专业打造教育平台航母（2）用水或醋调制的药物，容易干燥，干燥时可取下敷料加水或醋湿润后再敷，亦可将药物刮下，加水或醋重新调制再敷，一般2～3天后更换一次，亦有敷数小时即取下，如哮喘膏。（3）饴糖调制的药物，夏天易发酵，可每日更换药物或加适量防腐剂。（4）敷药后应询问病人有无瘙痒难忍感觉，并观察局部有无皮疹、水泡等过敏现象，若有过敏反应，应停止敷药。 注意事项应用敷药疗法须注意以下事项： 1.在敷药过程中，让病人采取适当的体位。 2.应对敷药部位进行消毒。 3.敷药后，包扎固定好，以免药物流撒别处。 4.妇女孕期禁用有堕胎及致畸作用的药物。 5.小儿皮肤娇嫩，不宜使用刺激性强的药物，用药时间不宜过长，加强护理，防止小儿将所敷药物抓脱。 6.有过敏反应者及时对症处理。 7.如局部出现水疱，应用消过毒的针刺破，外用消毒药物，防止皮肤继发感染。8.进行热敷时应把握好温度，以免烫伤皮肤。9.敷药疗法虽然相对安全，但对一些特殊病人，如患有严重高血压、心脏病者，要密切注意其敷药后的反应，如有不适感应及时中止治疗，并采取相应的处理措施。10.皮肤破损处禁用刺激性药物。11.外用药物，严禁内服。12.有些病证不能单纯依靠敷药疗法，应配合其他方法治疗，以免耽误病情。13.敷药疗法为辅助疗法，应作为临床明确诊断及遵医嘱治疗的补充。 ThankYou！'