当前位置:文档之家› 代码说明书

代码说明书

系统编码规范1.目的为了统一开发过程中关于代码编写时的编写规范和具体开发工作时的编程规范,保证代码的一致性,便于交流和维护,特制定此规范。

2.适用范围本规范适用于开发组全体人员,为详细设计,代码编写和代码审核提供参考和依据。

3.代码格式在编写代码过程中,建议遵循以下规则。

(1)缩进规则:使用四个空格作为每层次代码的缩进值。

(2)在括号对对齐的位置垂直对齐左右括号,如:For(i=0;i++){….}(3)沿逻辑结构行缩进代码,如:If…thenIf…then…Else…End ifElse…End if(4)为了防止在阅读代码时左右滚动代码编辑器,每行代码或注释不得超过一个显示屏。

(5)当一行分别为几行时,通过将串联运算符放在每行的末尾而不是开头,清楚地表示没有后面的行是不完整的。

(6)Case 规则:default case 总应该存在,如果不允许到达,则应该保证:若到达了就会触发一个错误。

Case的选择条件最好使用int或string类型。

(7)对齐规则:变数的申明和初始化都应对齐。

4.注释规范4.1. 块注释//用户名非空验证+长度验证+合法性验证function checkUserName(){var name = document.myform1.txtUser;if(name.value==""){alert("请输入用户名");name.focus();return false;}else if(name.value.length<4||name.value.length>16){//用户名长度验证alert("用户名输入的长度4-16个字符");name.select();return false;}4.2. 行注释用户名非空验证+长度验证+合法性验证function checkUserName(){var name = document.myform1.txtUser;if(name.value==""){alert("请输入用户名");name.focus();return false;}else if(name.value.length<4||name.value.length>16){//用户名长度验证alert("用户名输入的长度4-16个字符");name.select();return false;}//用户名输入合法性验证for(var i=0;i<name.value.length;i++){var charTest=name.value.toLowerCase().charAt(i);if( (!(charTest>='0' && charTest<='9')) && (!(charTest>='a' &&charTest<='z')) && (charTest!='_') ){alert("会员名包含非法字符,只能包括 a-z、0-9 和下划线");name.select();return false;}}return true;}//密码非空验证+确认验证+长度验证function checkPass(){var pass=document.myform1.txtPass;var rpass=document.myform1.txtRPass;if(pass.value==""){alert("密码不能为空");pass.focus();return false;}else if(pass.value.length<6||pass.value.length>12){alert("密码长度为6-12个字符");pass.select();return false;}4.3. 尾随注释//获取用户名文本框中的值int m = 4 ;//获取密码框中的值//用户名长度验证4.4. 注释哪些部分5.命名5.1. 命名的基本约定(1)要使用可以准确说明变量/字段/类的完整的英文描述符,如firstName。

对一些作用显而易见的变量可以采用简单的命名,如在循环里的递增(减)变量就可以被命名为” i ”。

(2)要尽量采用项目所涉及领域的术语。

(3)要采用大小写混合,提高名字的可读性。

为区分一个标识符中的多个单词,把标识符中的每个单词的首字母大写。

不采用下划线作分隔字符的写法。

有两种适合的书写方法,适应于不同类型的标识符:PasalCasing:标识符的第一个单词的字母大写;camelCasing:标识符的第一个单词的字母小写。

下表描述了不同类型标识符的大小写规则:6.首页代码<SCRIPTtype="text/javascript"language="javascript">function checkForm(){if(checkUserName()&&checkPass()&&checkEmail()&&checkDate()){return true;}else{return false;}}//用户名非空验证+长度验证+合法性验证function checkUserName(){var name = document.myform1.txtUser;if(name.value==""){alert("请输入用户名");name.focus();return false;}else if(name.value.length<4||name.value.length>16){//用户名长度验证alert("用户名输入的长度4-16个字符");name.select();return false;}//用户名输入合法性验证for(var i=0;i<name.value.length;i++){var charTest=name.value.toLowerCase().charAt(i);if( (!(charTest>='0' && charTest<='9')) && (!(charTest>='a'&& charTest<='z')) && (charTest!='_') ){alert("会员名包含非法字符,只能包括 a-z、0-9 和下划线");name.select();return false;}}return true;}//密码非空验证+确认验证+长度验证function checkPass(){var pass=document.myform1.txtPass;var rpass=document.myform1.txtRPass;if(pass.value==""){alert("密码不能为空");pass.focus();return false;}else if(pass.value.length<6||pass.value.length>12){ alert("密码长度为6-12个字符");pass.select();return false;}//确认密码一致性验证if(rpass.value!=pass.value){alert("确认密码与密码输入不一致");rpass.select();return false;}return true;}//电子邮件验证function checkEmail(){var strEmail=document.myform1.txtEmail;if (strEmail.value.length==0){alert("电子邮件不能为空!");strEmail.focus();return false;}else if (strEmail.value.indexOf("@",0)==-1){alert("电子邮件格式不正确\n必须包含@符号!");strEmail.select();return false;}else if (strEmail.value.indexOf(".",0)==-1){alert("电子邮件格式不正确\n必须包含.符号!");strEmail.select();return false;}//@和.字符不能在句首elseif(strEmail.value.charAt(0)=="@"||strEmail.value.charAt(0)=="."){alert("符号@和符号.不能在邮件地址第一位");strEmail.select();return false;}//@和.字符不能在句尾elseif(strEmail.value.charAt(strEmail.value.length-1)=="@"||strEmail.value.charAt(strEmail.value.length-1)=="."){alert("符号@和符号.不能在邮件地址最后一位");strEmail.select();return false;}return true;}7.用户登录代码8.用户注册代码。

相关主题