华为Java语言编码规范标准 下载本文

内容发布更新时间 : 2024/6/26 18:30:24星期一 下面是文章的全部内容请认真阅读。

Document number 文档编号 Document version 文档版本 Confidentiality level 密级 内部公开 Total 30 pages 共 30 页 Prepared by

拟制

Reviewed by 评审人 Approved by

批准

V1.00

Java语言编码规范

Date 日期 Date 日期

Date 日期

yyyy-mm-dd yyyy-mm-dd yyyy-mm-dd

.

Revision Record 修订记录

Date 日期 yyyy-mm-dd Revision Version 修订版本 Vx.xx Sec No. 修改章节 Change Description 修改描述 Author 作者 . .

.

Table of Contents 目录

1. 2. 3. 4. 4.1. 4.2. 5. 5.1. 5.2. 6. 6.1. 6.2. 7. 7.1. 7.2. 8. 8.1. 8.2.

范围 ......................................................................... 4 规范性引用文件 ............................................................... 4 术语和定义 ................................................................... 4 排版规范 ..................................................................... 5 规则 ......................................................................... 5 建议 ......................................................................... 7 注释规范 ..................................................................... 9 规则 ......................................................................... 9 建议 ........................................................................ 15 命名规范 .................................................................... 17 规则 ........................................................................ 17 建议 ........................................................................ 18 编码规范 .................................................................... 20 规则 ........................................................................ 20 建议 ........................................................................ 24 JTEST规范 ................................................................... 26 规则 ........................................................................ 26 建议 ........................................................................ 27

. .

.

1. 范围

本规范规定了使用Java语言编程时排版、注释、命名、编码和JTEST的规则和建议。 本规范适用于使用Java语言编程的产品和项目。

2. 规范性引用文件

下列文件中的条款通过本规范的引用而成为本规范的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本规范,然而,鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本规范。 序号 1 编号 公司- DKBA1040-2001.12 名称 《Java语言编程规范》 3. 术语和定义

规则:编程时强制必须遵守的原则。 建议:编程时必须加以考虑的原则。 格式:对此规范格式的说明。

说明:对此规范或建议进行必要的解释。

示例:对此规范或建议从正、反两个方面给出例子。

. .

.

4. 排版规范 4.1. 规则

4.1.1. *程序块要采用缩进风格编写,缩进的空格数为4个。

说明:对于由开发工具自动生成的代码可以有不一致。

4.1.2. *分界符(如大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的

语句左对齐。在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。

示例:如下例子不符合规范。

for (...) {

... // program code }

if (...) {

... // program code }

void example_fun( void ) {

... // program code }

应如下书写:

for (...) {

... // program code }

if (...) {

... // program code }

void example_fun( void ) {

... // program code }

4.1.3. *较长的语句、表达式或参数(>80字符)要分成多行书写,长表达式要在低优先级操作

符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。

示例:

if (filename != null

&& new File(logPath + filename).length() < LogConfig.getFileSize()) {

... // program code }

. .