`
火神曲
  • 浏览: 31788 次
  • 性别: Icon_minigender_1
  • 来自: 广州
最近访客 更多访客>>
社区版块
存档分类
最新评论

【6.1】Java缩进排版规范

阅读更多
4个空格常被作为缩进排版的一个单位。缩进的确切解释并未详细指定(空格 vs. 制表符)。一个制表符等于8个空格(而非4个)。

1、行长度(Line Length)

尽量避免一行的长度超过80个字符,因为很多终端和工具不能很好处理之。

注意:用于文档中的例子应该使用更短的行长,长度一般不超过70个字符

2、换行(Wrapping Lines)

当一个表达式无法容纳在一行内时,可以依据如下一般规则断开之:

- 在一个逗号后面断开
- 在一个操作符前面断开
- 宁可选择较高级别(higher-level)的断开,而非较低级别(lower-level)的断开
- 新的一行应该与上一行同一级别表达式的开头处对齐
- 如果以上规则导致你的代码混乱或者使你的代码都堆挤在右边,那就代之以缩进8个空格。

以下是断开方法调用的一些例子:

  someMethod(longExpression1, longExpression2, longExpression3,
                   longExpression4, longExpression5);

  var = someMethod1(longExpression1,
                            someMethod2(longExpression2,
                                               longExpression3));
 
以下是两个断开算术表达式的例子。前者更好,因为断开处位于括号表达式的外边,这是个较高级别的断开。

  longName1 = longName2 * (longName3 + longName4 - longName5)
                     + 4 * longname6; //PREFFER

  longName1 = longName2 * (longName3 + longName4
                                         - longName5) + 4 * longname6; //AVOID
 
以下是两个缩进方法声明的例子。前者是常规情形。后者若使用常规的缩进方式将会使第二行和第三行移得很靠右,所以代之以缩进8个空格

  //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) {
    ...
  }
 
if语句的换行通常使用8个空格的规则,因为常规缩进(4个空格)会使语句体看起来比较费劲。比如:

  //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;

转载自http://www.huihoo.org/code/java_code_conventions.html#41
分享到:
评论

相关推荐

    Java语言编码规范

    4. 缩进排版 4.1 行长度 通常建议每行代码长度不超过80个字符,以确保在大多数编辑器和IDE中,代码可以无需水平滚动就能查看完整。 4.2 换行 - 当方法签名过长时,参数应在逗号后换行。 - 长表达式或语句应适当换行...

    java编码规范华为.doc

    该文档提供了详细的排版规范,包括代码缩进、空格、换行、注释等,旨在确保代码的可读性和维护性。 4.1 规则 * 代码缩进使用4个空格 * 方法之间使用空行分隔 * 使用空格分隔运算符和操作数 4.2 建议 * 使用 ...

    java代码编写规范

    #### 四、缩进与排版 ##### 4.1 行长度 每行代码的长度不应超过80个字符,以确保代码在大多数编辑器中能够完整显示,同时也有利于提高代码的可读性。 ##### 4.2 换行 当一行代码过长时,应当在适当的位置进行...

    java 编码规范文档

    - **内容**:本文档主要涵盖了Java编程语言的编码规范,包括命名规则、注释规范、排版规范以及数据库相关的命名与格式化等内容。 - **编写目的**:制定一套统一的编码规范有助于提升代码的可读性和可维护性,降低...

    JAVA编码规范全集

    缩进排版 正确的缩进和排版可以使代码更具可读性。 ##### 4.1 行长度 每行代码不应超过80个字符,以避免水平滚动。如果代码过长,则应当进行换行处理。 ##### 4.2 换行 - **方法调用参数过多**:当方法调用的...

    Java语言编码规范 中文翻译版

    缩进排版(Indentation) **4.1 行长度(Line Length)** 建议每一行的字符数不超过80个,以保持良好的可读性。过长的行可能会导致代码难以阅读,尤其是在较小的屏幕上。 **4.2 换行(Wrapping Lines)** 当一行代码...

    Java语言编码规范[含书签]

    缩进排版 ##### 4.1 行长度 为保持代码的可读性,建议每行的字符数不超过80个字符。 ##### 4.2 换行 当一行代码超过推荐的最大行长度时,应适当换行。例如,对于方法调用的参数列表,可以在逗号后换行,使每个...

    Java语言编码规范.pdf

    缩进排版 (Indentation) ##### 4.1 行长度 (Line Length) 建议每行代码的最大长度不要超过80个字符,以保持代码的可读性。过长的行会使得代码难以阅读,特别是在屏幕宽度有限的情况下。 ##### 4.2 换行 ...

    java编码规范(试行版)

    缩进排版** 4.1. 行长度:推荐每行代码的长度不超过80个字符,以适应大多数开发环境的默认宽度,超出部分可以通过换行来处理。 4.2. 换行:方法定义、条件语句、循环语句等应该在操作符后换行,以保持代码的清晰...

    java编码规范描述

    缩进排版 ##### 4.1 行长度 建议每行代码的最大长度为80字符。过长的行可能导致代码难以阅读,特别是在多显示器环境中。 ##### 4.2 换行 当一行代码超过推荐的长度时,应当合理地将其拆分成多行。例如,长参数...

    Java编码规范

    **3.3 缩进排版** 代码的缩进应该一致,推荐使用四个空格作为一级缩进,避免使用Tab键。这样可以确保代码在不同的编辑器和环境中看起来整洁统一。 #### 四、注释规范 (Comments) **4.1 实现注释的格式** 实现...

    J2EE 开发 编程 规范

    1. **排版规范**:包括代码的布局、缩进、空格使用等,旨在提高代码的视觉整洁度。 2. **注释规范**:强调如何编写清晰、有条理的注释,以便于理解代码功能和用途。 3. **命名规范**:规定了变量、类、接口、方法等...

Global site tag (gtag.js) - Google Analytics