[原文:http://www.oracle.com/technetwork/java/codeconventions-136091.html#262
]
使用8个空格作为缩进。
控制每行的长度不超过80个字符,以便阅读和维护。
当语句过长,应按以下规则进行断行:
* 在一个标点符后进行断行
* 在一个操作符前进行断行
* 按操作优先级由高到低进行断行
* 同级别的表达式断行后左对齐
* 如果以上规则导致代码混乱或代码太过靠向右侧,仅使用8个空格进行一次缩进即可
一些断行的示例:
someMethod(longExpression1, longExpression2, longExpression3,
longExpression4, longExpression5);
var = someMethod1(longExpression1,
someMethod2(longExpression2,
longExpression3));
对算法表达式的断行,按优先级断行是最好的。
longName1 = longName2 * (longName3 + longName4 - longName5)
+ 4 * longname6; // PREFER
longName1 = longName2 * (longName3 + longName4
- longName5) + 4 * longname6; // AVOID
对方法定义的断行。第一种是常规情况下的做法,第二个如果每行都缩进会导致偏离左侧太远,所以只缩进一次
//CONVENTIONAL INDENTATION
someMethod(int anArg, Object anotherArg, String yetAnotherArg,
Object andStillAnother) {
...
}
//INDENT 8 SPACES TO AVOID VERY DEEP INDENTS
private static synchronized horkingLongMethodName(int anArg,
Object anotherArg, String yetAnotherArg,
Object andStillAnother) {
...
}
以下是一个断行容易导致代码混乱的例子,以及改进方式
//DON'T USE THIS INDENTATION
if ((condition1 && condition2)
|| (condition3 && condition4)
||!(condition5 && condition6)) { //BAD WRAPS
doSomethingAboutIt(); //MAKE THIS LINE EASY TO MISS
}
//USE THIS INDENTATION INSTEAD
if ((condition1 && condition2)
|| (condition3 && condition4)
||!(condition5 && condition6)) {
doSomethingAboutIt();
}
//OR USE THIS
if ((condition1 && condition2) || (condition3 && condition4)
||!(condition5 && condition6)) {
doSomethingAboutIt();
}
三目运算符的断行处理
alpha = (aLongBooleanExpression) ? beta : gamma;
alpha = (aLongBooleanExpression) ? beta
: gamma;
alpha = (aLongBooleanExpression)
? beta
: gamma;
分享到:
相关推荐
Java开发中所要遵守的编码规范大体上有如下7点。命名规范、注释规范、缩进排版规范、文件名规范、声明规范、语句规范以及编程规范。
本文档从“Java编程代码规范”,“Java编程注释规范”,“Java编程命名规范”,“代码缩进/断行/空行/空格/大括号规范”,“日志记录规范”和“代码上库规范”六个方面提取两家公司的Java编程规范共性。希望能供Java...
Java语言编码规范 1 开头注释(Beginning Comments) AA 所有的源文件都应该在开头有一个标准的注释,其中列出类名、说明、日期和负责人等: /** * 横表 * FileName: com.dsweb.action.commontaxaction.java * ...
共76页,内容清晰,可选择复制 设计变量命名/缩进/覆写等
JAVA编程规范2012年本公司自编。 1.命名规范 4 1.1. 共通事項 4 1.2. 方法(函数)的命名 4 1.3. 字段与局部变量的命名 5 1.4. 命名实例 5 2.方法 6 2.1. JavaDoc注释方法 6 2.2. 起始注释的记述方法 7 2.3. 其它...
详细从各个方面介绍java 编码标准 包括命名规范,缩进,空格 ,空行,换行。来自官方维护的标准文档。
Java 编码规范,养成良好编码习惯。 ---------------------------- 统一编码风格、提高代码质量。 ---------------------------- 除字符串和注释内以外, 代码中的空格一律为半角。 代码中不应有[TAB]字符(除...
1.1 为什么要有编码规范 ? 1.2 版权声明 2 文件名 ? 2.1 文件后缀 ? 2.2 常用文件名 3 文件组织 ? 3.1 Java源文件 o 3.1.1 开头注释 o 3.1.2 包和引入语句 o 3.1.3 类和接口...
这个ppt主要是为开发人员规范代码提供手册,其中包含漂亮的代码是什么样子、编码规范的原则、标识符命名、空格、空行和缩进、注释及最佳实践和禁忌等内容。
程序块要采用缩进风格编写,缩进的空格数为4个,不允许使用TAB缩进
4 缩进排版(Indentation) 5 注释(Comments) 6 声明(Declarations) 7 语句(Statements) 8 空白(White Space) 9 命名规范(Naming Conventions) 10 编程惯例(Programming Practices) 11 代码范例(Code Examples) 花点...
2.注释规范(1)注释尽可能使用“//” 3.缩进排版规范(1)避免一行的长度超过 60 个字符 4.文件名规范(1)一个 Java 源文件只能存储一个 Jav
声明方法时参数列折行,在逗号之后,折行后参数列起始与上行参数列平齐方法调用时参数列折行,在逗号之后,折行后参数列缩进 4 格,多次折行时,每行都缩进 4 个空格
AStyleWin 是 AStyle (Artistic Style) 的一个 Windows 平台下的图形界面版本,通过 AStyleWin,开发者可以方便地对源代码进行格式化,使其符合预定的编码规范和风格。 AStyleWin 的主要功能包括: 代码自动格式化...
编码规范 缩进 采用设置4个空格的缩进方式。 换行 一行不超过75个字符 如果太长,可以在:“,”后换行,或者运算符前换行 空格 在关键字和()之间加空格,如:while () 运算符前后加空格 在参数列表的“,”后加空格...
其主要目的是使源代码在保持语义不变的前提下,按照特定的编码规范或团队约定进行格式化,从而提高代码的可读性、一致性和维护性。 以下是AStyle的主要特点和功能: 1. **支持多种编程语言**:如前所述,AStyle...
Android内部开发规范,编码规范 目录 1 介绍 5 1.1 目的 5 1.2 术语和定义 5 2 文件组织 5 2.1 JAVA包和源文件 5 2.1.1 开头注释 5 2.1.2 包和引入语句 6 2.1.3 类和接口声明 6 3 缩进排版 7 3.1 行长度 7 3.2 括号 ...
本指南来自于《编写可维护的JavaScript》这本书,基于”Java语言编码规范”和Crockford的JavaScript编程规范,还有Nicbolas的一些个人经验和喜好。写作本文旨在加深自己印象,也为了更多人的了解到JS编码风格,提高...
了解本课程的代码表示约定(Javadoc 规范、缩进、短行等),这有助于使您的程序具有可读性和可理解性。 学习和练习增量编码,这是一种将编码和测试交织在一起的完善的编程方法。 了解并练习使用 JUnit 测试对程序...