1 / 40
文档名称:

Java开发规范(公司规范)要点.docx

格式:docx   大小:104KB   页数:40页
下载后只包含 1 个 DOCX 格式的文档,没有任何的图纸或源代码,查看文件列表

如果您已付费下载过本站文档,您可以点这里二次下载

分享

预览

Java开发规范(公司规范)要点.docx

上传人:changjinlai 2021/6/1 文件大小:104 KB

下载得到文件列表

Java开发规范(公司规范)要点.docx

文档介绍

文档介绍:Java 开发规范
第1章 序言
本规范的目的在于: 建立一个可行可操作的编程标准、 约定和指南, 以规范 公司 java 代码研发工作。
2013 年为公司的质量年,为了提高公司研发能力,该规范的制定是为了规
范 java 代码开发,提高 java 开发质量,从代码的层面规范并提高 java 项目的
研发水平。该规范由运营中心技术小组制定,运营中心技术小组将结合 PM货查 工具以及相应的检查工具,组织技术监控人员对重点项目以及新的 java 项目定 期检查, 对代码质量进行评估, 对代码质量较差限期整改, 并报运营中心备案作 为项目考核依据。
本规范适用于 2013年公司 java 代码研发规范。 本规范的内容包括两个方面:
java 开发一般规范, 以及 java 代码开发安全性规范。 Java 代码开发一般规范主
要从 java 基本语法,代码格式,耦合性以及设计方面,以及代码质量因子等进
行描述; java 代码开发安全性规范主要从 sql 注入,资源注入,跨站脚步,安
全边界违例,系统信息泄露进行描述。
为了方便并配合PMD 佥查工具等相应检查工具,方便开发者针对违规代码进 行调整,本规范中java 一般开发规范描述形式将结合 PMD并提供示例代码, 其形式如下:
规范描述:
PMD®则名称:
PM吸别(注1):
违规示例代码:
合法示例代码:
本规范中java安全开发规范部分将结合具体项目,对出现安全隐患的代码 进行分析,以及相应的解决办法和思路上进行分析 ,其具体格式如下:
风险及危害:
应对措施:
非安全代码示例
安全代码示例
本规范解释权归运营中心技术小组,属于运营中心为了提供公司研发水平 以及质量的一系列措施中的一部分,在后续的版本中将根据具体需要进行修改以 及调整。
注1: PMD®别分为5级
Error high 必须修改
Error 不修改的项需要进行说明
Warning high 代码中该项每千行代码不能多于 2%
Warning 参考
Information 参考
注2:对于Error级别需要项目组通过以下文字说明:
技术小组审核后给出相应的整改意见,对于有争议的问题,可直接与运营 中心技术小组领导成员沟通。
第2章要求
气象局项目组的所有java开发人员,编写的代码必须满足第三章的所有规 范(每个标题为一个规范)。项目组成员之间每周或每月互相检查对方编写的代 码,若发现问题,要求对方及时更正。项目经理应该随时抽查、并最终审查代
码,保证代码的规范性。
第 3章 java 一般性研发规范
代码格式
包、类、方法的命名规范 :
规范描述:
包, 类, 方法命名只能为 27 个英文字符以及数字, 不能包括特殊字符例如 - , _,$等;
包命名,首字符必须小写;
类命名,首字符必须大写;
方法命名,首字符必须小写;
常量命名,必须全部大写;
变量,以及属性命名,首字符必须小写;
在类中非创建方法其命名应避免与类名一致;
在类中属性的命名应避免与类名一致;
在同一类中属性命令应避免与方法命名一致;
在方法中命名临时变量时应避免与方法的参数名一致;
PMDK则名称:
AvoidDollarSigns
PackageCase
ClassNamingConventions
MethodNamingConventions
SuspiciousConstantFieldName
VariableNamingConventions
MethodWithSameNameAsEnclosingClass
AvoidFieldNameMatchingTypeName
MisleadingVariableName
规则级别:
Error High
warn High
warn High
warn High
warn High
Error High
Error High
Error High
违规示例代码:
1、常量、变量命名
public static final int my_num |= 0; // 常量应大写
public String MyTest = ""; // 变量命名,首字符小写
DataModule DMTest = new DataModule();// 变量命名,首字符小写
2、方法命名
public class Foo {
public void FoogtuffO {
}
}
3、类命名:首字符应大写
public class foo | {}
4、非法使用特殊字符命名
public class Fo$o { // yi