资源描述：
《华为JAVA编码规范.doc》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。
1、密级:内部公开DKBAX-2001.121.程序块采用缩进风格,空格为4个.说明:对于开发工具自动生成的代码可以不一致2.分界符(如大括号{和})应各自占一行并且在同一列,同时与引用它们的语句左对齐,在方法的开始,类和接口的定义,以及if,for,do,while,switch,case语句都要采用上述缩进说明:for(…){…//yourcode}3.较长(>80字符)的语句,表达式和参数要分多行,长表达式要在低优先级操作符划分新行,操作符放在行首,新行要适当缩进,整齐,语句可读.说明:if(filename!=nul
2、l&&newFile(logPath+filename).length()3、g.getLevel()4、这种松散方式编写代码目的是让程序更加清晰,由于空格所产生的清晰性是相对的,所以在已经很清晰的语句中没有必要留空格,如果语句已足够清晰,则括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间不必加空格,因为java中括号已经是很清晰的标志了.在长句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部中不加空格,给操作符留空格时不要连续留两个以上空格3.类属性和方法不要交叉放置,不同存取范围的属性和方法也不要交叉放置说明:类定义:{类公有属性定义;类保护属性定义;类私有属性定义;类公有方法定义;类保护方法定义;
5、类私有方法定义;}4.源程序的有效注释量必须在30%以上5.包的注释写入一个名为package.html的html格式的说明文件放入当前路径6.包的注释内容:本包作用,详细描述本包内容,产品模块名称及版本,公司版本说明:
一句话描述
详细描述
产品模块
公司版本信息14密级:内部公开DKBAX-2001.121.文件注释:写入文件头部,包名之前2.文件注释内容:版本说明,描述信息,修改历史,生成日期说明:/**文件名*版权*描述*修改人*修改时间*修改
6、内容*跟踪单号*修改单号*/3.类和接口注释:放在package注释之后,class或interface之前4.类和接口注释内容:类的注释要一句话功能描述,功能详细描述说明:/***<一句话功能简述>*<功能详细描述>*@author*@version*@see[相关类/方法]*@since[产品/模块版本]*@deprecated(表示不建议使用该类或者接口)5.类属性,公有和保护方法注释:写在类属性,公有和保护方法上面6.成员变量注释内容:成员变量的意义,目的,功能,可能被用到的地方7.公有和保护方法注释的内容:方法
7、的一句话功能描述,功能详细描述,输入参数,输出参数,返回值,违例说明:/***@param*@return*@exception/throws*/8.对于方法内部用throw抛出的异常,要在方法的注释中标明,对于调用其他方法抛出的异常,选主要的在注释中说明,对于非RuntimeException,即throws子句声明会抛出的异常,必须在方法的注释中标明14密级:内部公开DKBAX-2001.121.注释应与描述的代码相近,对代码的注释应放在代码上方或者右方(单行注释)相邻位置,不可放在下面,如放于上方则与上面代码用空行
8、隔开2.注释与描述的内容进行同样的缩进3.对变量的定义和分支语句,必须加以注释4.对于switch下的case语句,如果处理完一个case要进入下一个case,必须在该case处理完,下一个case前加上明确的注释说明:这样比较清楚程序编写者的意图，有效防止无故遗漏break语句5.边写代码边写注释,修改代码同时修改
