欢迎来到天天文库
浏览记录
ID:6075200
大小:433.11 KB
页数:27页
时间:2018-01-02
《java代码飞检案例输出》由会员上传分享,免费在线阅读,更多相关内容在行业资料-天天文库。
1、文档名称文档密级1类、方法和变量缺少注释1.1【问题描述】变量没有注释:方法没有注释:类没有注释:文件名:ConfigNetworkService.java起始行:40上下文:publicclassConfigNetworkService【问题解读】变量、方法缺少注释,影响代码走读效率,对java类没有做注释说明,会导致使用该类的人不知道这个类的功能是什么【纠正措施】在变量、方法和类上面添加必要的注释,方便后来维护者维护理解【举一反三】平时开发是严格按照华为java编程规范编码2021-6-11华为保密信息,未经授权禁止扩散第27页,共27页文档名称文档密
2、级1代码注释未与上方代码空行隔开1.1【问题描述】为了提高代码的可读性,跟层次感,注释应该跟上面的代码空一行紧贴下面代码(以DGAlarmService.java为例)/***获取油机的原始当前告警列表**@paramdgInfo*@return*/publicListgetOrginalCurAlarms(DGInfodgInfo){ListtempDns=dgInfo.getDgDnList();ListcurrentAlarmList=getDGAlarmsBySiteDn(dgInfo.get
3、SiteDN());//告警分2套,原来的告警可以取到subFdn,新的告警取不到,只有Mocid和InsIdif(currentAlarmList!=null){…………}returncurrentAlarmList;}在上面的代码中红色字体中的注释没有跟上面代码中空一行或者跟下面代码空一行,都不符合编码规范。【问题解读】为了提高代码的可读性(减少歧义)跟层次感,代码规范要求注释应该跟上面的代码空一行,紧贴下面代码行。2021-6-11华为保密信息,未经授权禁止扩散第27页,共27页文档名称文档密级【纠正措施】根据编码规范,该场景的解决方法如下:/***
4、获取油机的原始当前告警列表**@paramdgInfo*@return*/publicListgetOrginalCurAlarms(DGInfodgInfo){ListtempDns=dgInfo.getDgDnList();ListcurrentAlarmList=getDGAlarmsBySiteDn(dgInfo.getSiteDN());//告警分2套,原来的告警可以取到subFdn,新的告警取不到,只有Mocid和InsIdif(null!=currentAlarmList){…………}r
5、eturncurrentAlarmList;}【举一反三】在编码中为了之后的维护,我们要增强代码的可读性我们在编码的过程中应适当加一些注释,提高代码的层次感,以方便维护人员能更好的维护。2021-6-11华为保密信息,未经授权禁止扩散第27页,共27页文档名称文档密级1对象判断是否为空,应该把Null放在前面(常量和变量作比较未把常量放在前面)1.1【问题描述】判断一个对象是否为null时,应该把null放在前面如if(null==XXX),null放后面不符合编码规范(以DGAlarmService.java为例)/***获取油机的原始当前告警列表**@
6、paramdgInfo*@return*/publicListgetOrginalCurAlarms(DGInfodgInfo){ListtempDns=dgInfo.getDgDnList();ListcurrentAlarmList=getDGAlarmsBySiteDn(dgInfo.getSiteDN());//告警分2套,原来的告警可以取到subFdn,新的告警取不到,只有Mocid和InsIdif(currentAlarmList!=null){StringsubFdn=null;Stri
7、ngmocId=null;StringinsId=null;for(Iteratorit=currentAlarmList.iterator();it.hasNext();){PropertiesuserData=it.next().getUserData();subFdn=userData.getProperty(FmDataPropertyDefine.PROP_SUB_FDN);if(subFdn==null
8、
9、subFdn.isEmpty()){mocId=userData.getProperty(FmDataPropertyD
10、efine.PROP_MOC_ID);insId=userData
此文档下载收益归作者所有