- 1、本文档共44页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
Java开发规范(公司规范).doc
Java开发规范
序言
本规范的目的在于:建立一个可行可操作的编程标准、约定和指南,以规范公司java代码研发工作。
2013年为公司的质量年,为了提高公司研发能力,该规范的制定是为了规范java代码开发,提高java开发质量,从代码的层面规范并提高java项目的研发水平。该规范由运营中心技术小组制定,运营中心技术小组将结合PMD检查工具以及相应的检查工具,组织技术监控人员对重点项目以及新的java项目定期检查,对代码质量进行评估,对代码质量较差限期整改,并报运营中心备案作为项目考核依据。
本规范适用于2013年公司java代码研发规范。本规范的内容包括两个方面:java开发一般规范,以及java代码开发安全性规范。Java代码开发一般规范主要从java基本语法,代码格式,耦合性以及设计方面,以及代码质量因子等进行描述;java代码开发安全性规范主要从sql注入,资源注入,跨站脚步,安全边界违例,系统信息泄露进行描述。
为了方便并配合PMD检查工具等相应检查工具,方便开发者针对违规代码进行调整,本规范中java一般开发规范描述形式将结合PMD,并提供示例代码,其形式如下:
规范描述:
PMD规则名称:
PMD级别(注1):
违规示例代码:
合法示例代码:
本规范中java安全开发规范部分将结合具体项目,对出现安全隐患的代码进行分析,以及相应的解决办法和思路上进行分析,其具体格式如下:
风险及危害:
应对措施:
非安全代码示例
安全代码示例
本规范解释权归运营中心技术小组,属于运营中心为了提供公司研发水平以及质量的一系列措施中的一部分,在后续的版本中将根据具体需要进行修改以及调整。
注1:PMD级别分为5级
Error high 必须修改
Error 不修改的项需要进行说明
Warning high 代码中该项每千行代码不能多于2%;
Warning 参考
Information 参考
注2:对于Error级别需要项目组通过以下文字说明:
文件名 代码行数 触发PMD规则 不修改原因 技术小组审核意见 技术小组审核后给出相应的整改意见,对于有争议的问题,可直接与运营中心技术小组领导成员沟通。
要求
气象局项目组的所有java开发人员,编写的代码必须满足第三章的所有规范(每个标题为一个规范)。项目组成员之间每周或每月互相检查对方编写的代码,若发现问题,要求对方及时更正。项目经理应该随时抽查、并最终审查代码,保证代码的规范性。
java一般性研发规范
代码格式
包、类、方法的命名规范:
规范描述:
包,类,方法命名只能为27个英文字符以及数字,不能包括特殊字符例如-,_,$等;
包命名,首字符必须小写;
类命名,首字符必须大写;
方法命名,首字符必须小写;
常量命名,必须全部大写;
变量,以及属性命名,首字符必须小写;
在类中非创建方法其命名应避免与类名一致;
在类中属性的命名应避免与类名一致;
在同一类中属性命令应避免与方法命名一致;
在方法中命名临时变量时应避免与方法的参数名一致;
PMD规则名称:
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
违规示例代码:
常量、变量命名
public static final int my_num = 0; //常量应大写
public String MyTest = ; //变量命名,首字符小写
DataModule DMTest = new DataModule();//变量命名,首字符小写
方法命名
public class Foo {
public void FooStuff() {
}
}
类命名:首字符应大写
public class foo {}
非法使用特殊字符命名
public class Fo$o { // yikes!
}
非创建方法命名应避免与类名一致
public class MyClass {
// this is b
您可能关注的文档
- IPv技术基础信息产业厅下一代互联网.ppt
- IPv网络规划培训.ppt
- IPV设备制造有限责任公司.doc
- IP城域网优化MPLSVPN部署方案.doc
- IP城域网规划设计(新).ppt
- IP城域网规划设计.ppt
- IP城域网路由规划设计.ppt
- IP网络规划.ppt
- iReach中国移动新媒体无线广告市场分析报告.ppt
- iresearchchinasearchenginearket.ppt
- 中国国家标准 GB/T 18233.4-2024信息技术 用户建筑群通用布缆 第4部分:住宅.pdf
- GB/T 18233.4-2024信息技术 用户建筑群通用布缆 第4部分:住宅.pdf
- GB/T 18978.210-2024人-系统交互工效学 第210部分:以人为中心的交互系统设计.pdf
- 《GB/T 18978.210-2024人-系统交互工效学 第210部分:以人为中心的交互系统设计》.pdf
- 中国国家标准 GB/T 18978.210-2024人-系统交互工效学 第210部分:以人为中心的交互系统设计.pdf
- GB/T 16649.2-2024识别卡 集成电路卡 第2部分:带触点的卡 触点的尺寸和位置.pdf
- 《GB/T 16649.2-2024识别卡 集成电路卡 第2部分:带触点的卡 触点的尺寸和位置》.pdf
- 中国国家标准 GB/T 16649.2-2024识别卡 集成电路卡 第2部分:带触点的卡 触点的尺寸和位置.pdf
- GB/T 17889.4-2024梯子 第4部分:铰链梯.pdf
- 《GB/T 17889.4-2024梯子 第4部分:铰链梯》.pdf
最近下载
- T∕CEC 131.4-2016 铅酸蓄电池二次利用 第4部分:电池维护技术规范.pdf
- 百日咳试题附有答案.docx VIP
- 2024年广东省深圳市光明区人大常委会办公室招聘一般类岗位专干12人历年【综合基础知识500题】高频考点模拟试题及参考答案解析.docx VIP
- 高中语文任务驱动型材料作文:枯燥与热闹审题指导(含解析).docx VIP
- 某镇卫生院污水设计方案.pdf VIP
- 2024年广东深圳市光明区人大常委会办公室招聘一般类岗位专干3人历年【综合基础知识500题】高频考点模拟试题及参考答案解析.docx VIP
- 中考数学经验交流会发言稿.pdf
- 2024年7月广东省深圳市光明区人大常委会办公室招聘10人历年【高频考点汇总500题】模拟卷及参考答案详解.docx VIP
- 《溜冰圆舞曲和雷鸣电闪波尔卡》精品课件2023.pptx
- 水利项目安全评价报告.docx
文档评论(0)