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

【6.1】Java声明规范

阅读更多

1 每行声明变量的数量(Number Per Line)

推荐一行一个声明,因为这样以利于写注释。亦即,

  int level;  // indentation level
  int size;   // size of table
 
要优于,

int level, size;

不要将不同类型变量的声明放在同一行,例如:

  int foo,  fooarray[];   //WRONG!
 
注意:上面的例子中,在类型和标识符之间放了一个空格,另一种被允许的替代方式是使用制表符:

  int level;         // indentation level
  int size;          // size of table
  Object currentEntry;  // currently selected table entry
 
2 初始化(Initialization)

尽量在声明局部变量的同时初始化。唯一不这么做的理由是变量的初始值依赖于某些先前发生的计算。

3 布局(Placement)

只在代码块的开始处声明变量。(一个块是指任何被包含在大括号"{"和"}"中间的代码。)不要在首次用到该变量时才声明之。这会把注意力不集中的程序员搞糊涂,同时会妨碍代码在该作用域内的可移植性。

  void myMethod() {
      int int1 = 0;         // beginning of method block

      if (condition) {
          int int2 = 0;     // beginning of "if" block
          ...
      }
  }
 
该规则的一个例外是for循环的索引变量

  for (int i = 0; i < maxLoops; i++) { ... }
 
避免声明的局部变量覆盖上一级声明的变量。例如,不要在内部代码块中声明相同的变量名:

  int count;
  ...
  myMethod() {
      if (condition) {
          int count = 0;     // AVOID!
          ...
      }
      ...
  }
 
4 类和接口的声明(Class and Interface Declarations)

当编写类和接口是,应该遵守以下格式规则:

- 在方法名与其参数列表之前的左括号"("间不要有空格
- 左大括号"{"位于声明语句同行的末尾
- 右大括号"}"另起一行,与相应的声明语句对齐,除非是一个空语句,"}"应紧跟在"{"之后

  class Sample extends Object {
      int ivar1;
      int ivar2;

      Sample(int i, int j) {
          ivar1 = i;
          ivar2 = j;
      }

      int emptyMethod() {}

      ...
  }

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

相关推荐

    Google Java 编程规范(中文版).pdf

    ### Google Java 编程规范(中文版)知识点详解 #### 1. 源文件基础 **1.1 文件名** - **规范说明**: 源文件应当以其包含的最顶层类名命名,并且文件扩展名为`.java`。例如,如果最顶层的类名为`MyClass`,那么...

    java 编码规范文档

    ### Java编码规范文档知识点 #### 1. 概述 - **内容**:本文档主要涵盖了Java编程语言的编码规范,包括命名规则、注释规范、排版规范以及数据库相关的命名与格式化等内容。 - **编写目的**:制定一套统一的编码规范...

    JAVA编码规范全集

    ##### 6.1 每行声明变量的数量 每个变量声明应放在单独一行,以提高可读性。 ```java int x; int y; ``` ##### 6.2 初始化 变量在声明时应尽可能立即初始化。 ```java int x = 10; String name = "John Doe"; `...

    日语版本java编码规范

    ### 日语版本 Java 编码规范 #### 命名规则 **1.1. 包名** - 包名采用以下主包作为基础:`com.hisas.lysithea`。 - 子包名需要根据具体情况进行定义。 - **示例**: `com.hisas.lysithea.service`。 **1.2. 类/...

    java编程规范(第三版)

    6.1 声明 86 6.2 名称和标识符 86 6.3 声明的作用域 88 6.4 成员和继承 92 6.5 确定名称的含义 95 6.6 访问控制 104 6.7 完全限定的名称和规范名称 109 6.8 命名约定 110 第7章 包 116 7.1 包成员 116 7.2...

    Java™ Servlet 规范.

    其他的 Java 平台规范 .......................................................................................................................................3 其他重要参考资料 ............................

    java代码编写规范

    ##### 6.1 每行声明变量的数量 每次声明变量时只声明一个变量,避免在同一行声明多个变量,以提高代码的可读性。 ##### 6.2 初始化 变量声明时应尽可能立即进行初始化,除非有特殊理由。 ##### 6.3 布局 变量...

    java编程语言代码规范(中文)

    ##### 6.1 每行声明的数量 每行只声明一个变量或常量。 ##### 6.2 初始化 变量在声明时应尽可能地初始化。 ##### 6.3 布局 变量声明通常放在类的顶部,并且按照一定的逻辑顺序排列。 ##### 6.4 类和接口的声明...

    Sun_Java语言编码规范(中文版).pdf

    **6.1 每行声明变量的数量 (Number Per Line)** - 每行只声明一个变量,以提高代码的可读性。 - 示例:`int a;` #### 6. 语句规范 (Statement Conventions) **7.1 简单语句 (Simple Statements)** - 简单语句...

    java编码规范描述

    ### Java编码规范详解 #### 1. 介绍 ##### 1.1 为什么要有编码规范 ...这个示例包含了开头注释、类声明、方法声明、常量定义、文档注释等元素,展示了如何遵循Java编码规范来编写高质量的代码。

    java编码规范

    这部分详细规定了Java文件的基本结构和样式要求,例如文件头部的版权信息、包声明的位置、导入语句的组织方式等。通过一致的文件样式,可以提高代码的可读性和美观度。 #### 五、代码编写格式 - 缩进:通常使用四...

    jAVA编程规范J2EE代码规范

    ### Java编程规范与J2EE代码规范解析 #### 一、引言 本文档旨在提供一套全面且标准化的Java编程规范指南,适用于基于J2EE规范的所有项目中的Java代码(包括JSP、SERVLET、JAVABEAN、EJB等)。此规范不仅为项目开发...

    JAVA 编码规范_沈阳东软软件股份有限公司

    ### JAVA编码规范要点解析 #### 一、引言与背景 **1.1 简介** 本规范由沈阳东软软件股份有限公司金融事业部制定,旨在为Java开发者提供一套全面的编码指南。对于习惯自由编程的Java程序员而言,遵循一定的编码...

    Java语言编码规范

    Java语言编码规范是软件开发中不可或缺的一部分,它旨在提高代码的可读性、可维护性和团队协作效率。本文将详细阐述Java编码规范的各个方面,帮助开发者遵循统一的标准,提升代码质量。 1. 介绍 编码规范是编程实践...

Global site tag (gtag.js) - Google Analytics