所有的程序开发手册都包含了各种规则。一些习惯自由程序人员可能对这些规则很不适应,但是在多个开发人员共同写作的情况下,这些规则是必需的。这不仅仅是为了开发效率来考虑,而且也是为了后期维护考虑。
命名规范
定义这个规范的目的是让项目中所有的文档都看起来像一个人写的,增加可读性,减少项目组中因为换人而带来的损失。(这些规范并不是一定要绝对遵守,但是一定要让程序有良好的可读性)
● Package 的命名
Package 的名字应该都是由一个小写单词组成。
● Class 的命名
Class 的名字必须由大写字母开头而其他字母都小写的单词组成
● Class 变量的命名
变量的名字必须用一个小写字母开头。后面的单词用大写字母开头。
● Static Final 变量的命名
Static Final 变量的名字应该都大写,并且指出完整含义。
● 参数的命名
参数的名字必须和变量的命名规范一致。
● 数组的命名
数组应该总是用下面的方式来命名:
byte[] buffer;
而不是:
byte buffer[];
● 方法的参数
使用有意义的参数命名,如果可能的话,使用和要赋值的字段一样的名字:
SetCounter(int size){
this.size = size;
}
Java文件样式
所有的 Java(*.java) 文件都必须遵守如下的样式规则:
● 版权信息
版权信息必须在 java 文件的开头,比如:
/**
* Copyright ?2000 Shanghai XXX Co. Ltd.
* All right reserved.
*/
其他不需要出现在 javadoc 的信息也可以包含在这里。
● Package/Imports
package 行要在 import 行之前,import 中标准的包名要在本地的包名之前,而且按照字母顺序排列。如果 import 行中包含了同一个包中的不同子目录,则应该用 * 来处理。
package hotlava.net.stats;
import java.io.*;
import java.util.Observable;
import hotlava.util.Application;
这里 java.io.* 使用来代替InputStream and OutputStream 的。
● Class
接下来的是类的注释,一般是用来解释类的。
/**
* A class representing a set of packet and byte counters
* It is observable to allow it to be watched, but only
* reports changes when the current set is complete
*/
接下来是类定义,包含了在不同的行的 extends 和 implements :
public class CounterSet
extends Observable
implements Cloneable
● Class Fields
接下来是类的成员变量:
/**
* Packet counters
*/
protected int[] packets;
public 的成员变量必须生成文档(JavaDoc)。proceted、private和 package 定义的成员变量如果名字含义明确的话,可以没有注释。
● 存取方法
接下来是类变量的存取的方法。它只是简单的用来将类的变量赋值获取值的话,可以简单的写在一行上。
/**
* Get the counters
* @return an array containing the statistical data. This array has been
* freshly allocated and can be modified by the caller.
*/
public int[] getPackets() { return copyArray(packets, offset); }
public int[] getBytes() { return copyArray(bytes, offset); }
public int[] getPackets() { return packets; }
public void setPackets(int[] packets) { this.packets = packets; }
其它的方法不要写在一行上。
● 构造函数
接下来是构造函数,它应该用递增的方式写(比如:参数多的写在后面)。
访问类型 ("public", "private" 等.) 和 任何 "static", "final" 或 "synchronized" 应该在一行中,并且方法和参数另写一行,这样可以使方法和参数更易读。
public
CounterSet(int size){
this.size = size;
}
● 克隆方法
如果这个类是可以被克隆的,那么下一步就是 clone 方法:
public
Object clone() {
try {
CounterSet bj = (CounterSet)super.clone();
obj.packets = (int[])packets.clone();
obj.size = size;
return obj;
}catch(CloneNotSupportedException e) {
throw new InternalError("Unexpected CloneNotSUpportedException: " + e.getMessage());
}
}
● 类方法
下面开始写类的方法:
/**
* Set the packet counters
* (such as when restoring from a database)
*/
protected final
void setArray(int[] r1, int[] r2, int[] r3, int[] r4)
throws IllegalArgumentException
{
//
// Ensure the arrays are of equal size
//
if (r1.length != r2.length || r1.length != r3.length || r1.length != r4.length)
throw new IllegalArgumentException("Arrays must be of the same size");
System.arraycopy(r1, 0, r3, 0, r1.length);
System.arraycopy(r2, 0, r4, 0, r1.length);
}
● toString 方法
无论如何,每一个类都应该定义 toString 方法:
public
String toString() {
String retval = "CounterSet: ";
for (int i = 0; i retval += data.bytes.toString();
retval += data.packets.toString();
}
return retval;
}
}
● main 方法
如果main(String[]) 方法已经定义了,那么它应该写在类的底部。
代码编写格式
● 代码样式
代码应该用 unix 的格式,而不是 windows 的(比如:回车变成回车+换行) 。
● 文档化
必须用 javadoc 来为类生成文档。不仅因为它是标准,这也是被各种 java 编译器都认可的方法。使用 @author 标记是不被推荐的,因为代码不应该是被个人拥有的。
● 缩进
缩进应该是每行2个空格。不要在源文件中保存Tab字符。在使用不同的源代码管理工具时Tab字符将因为用户设置的不同而扩展为不同的宽度。
如果你使用 UltrEdit 作为你的 Java 源代码编辑器的话,你可以通过如下操作来禁止保存Tab字符,方法是通过 UltrEdit中先设定 Tab 使用的长度室2个空格,然后用 Format|Tabs to Spaces 菜单将 Tab 转换为空格。
● 页宽
页宽应该设置为80字符。源代码一般不会超过这个宽度,并导致无法完整显示,但这一设置也可以灵活调整。在任何情况下,超长的语句应该在一个逗号或者一个操作符后折行。一条语句折行后,应该比原来的语句再缩进2个字符。
● {} 对
{} 中的语句应该单独作为一行。例如,下面的第1行是错误的第2行是正确的:
if (i>0) { i ++ }; // 错误, { 和 } 在同一行
if (i>0) {
i ++
}; // 正确, { 单独作为一行
} 语句永远单独作为一行。
如果 } 语句应该缩进到与其相对应的 { 那一行相对齐的位置。
● 括号
左括号和后一个字符之间不应该出现空格,同样,右括号和前一个字符之间也不应该出现空格。下面的例子说明括号和空格的错误及正确使用:
CallProc( AParameter ); // 错误
CallProc(AParameter); // 正确
不要在语句中使用无意义的括号。括号只应该为达到某种目的而出现在源代码中。下面的例子说明错误和正确的用法:
if ((I) = 42) { // 错误 - 括号毫无意义
if (I == 42) or (J == 42) then // 正确 - 的确需要括号
程序编写规范
● exit()
exit除了在main中可以被调用外,其他的地方不应该调用。因为这样做不给任何代码代码机会来截获退出。一个类似后台服务地程序不应该因为某一个库模块决定了要退出就退出。
● 异常
申明的错误应该抛出一个RuntimeException或者派生的异常。
顶层的main()函数应该截获所有的异常,并且打印(或者记录在日志中)在屏幕上。
● 垃圾收集
JAVA使用成熟的后台垃圾收集技术来代替引用计数。但是这样会导致一个问题:你必须在使用完对象的实例以后进行清场工作。比如一个prel的程序员可能这么写:
...
{
FileOutputStream fos = new FileOutputStream(projectFile);
project.save(fos, "IDE Project File");
}
...
除非输出流一出作用域就关闭,非引用计数的程序语言,比如JAVA,是不能自动完成变量的清场工作的。必须象下面一样写:
FileOutputStream fos = new FileOutputStream(projectFile);
project.save(fos, "IDE Project File");
fos.close();
● Clone
下面是一种有用的方法:
implements Cloneable
public
Object clone()
分享到:
相关推荐
Java命名规范是编程实践中至关重要的指导原则,旨在提高代码的可读性和一致性。遵循这些规范,可以帮助团队成员更好地理解和维护代码,减少误解和错误。以下是Java命名规范的主要方面: 1. **包(Package)**: 包名...
该规范涵盖了JAVA中的各种命名规则,包括包命名、类命名、方法命名、参数命名、变量命名和常量命名等。 包命名规范: * JAVA包的名字都是由小写单词组成。 * 为了保障每个JAVA包命名的唯一性,在最新的JAVA编程...
### Java命名规范详解 在Java开发过程中,遵循一套合理的命名规范不仅能够提高代码的可读性和可维护性,还能帮助团队成员更快地理解和协作。本文将详细介绍Java中的命名规范,并结合给定的部分内容来具体说明。 ##...
### Java命名规范详解 #### 一、概述 Java命名规范是为了确保代码的可读性和一致性而制定的一套规则。遵循这些规范有助于提升团队合作效率,减少因命名不一致导致的理解障碍。本文将详细介绍Java中的几种主要命名...
该规范涵盖了Java开发中的各个方面,包括类名、方法名、变量名、常量名、包名等。 1. 代码中的命名不能以下划线或美元符号开始,也不能以下划线或美元符号结束。例如,_name、__name、$Object、name_、name$等都是...
Java关键字和命名规范是Java编程语言中的基础概念,它们对于编写清晰、规范的代码至关重要。Java关键字是Java语言内置的、具有特殊用途的保留字,而命名规范则是关于如何给类、方法、变量等命名的约定。 ### Java...
为了确保代码的可读性、可维护性和团队协作效率,遵循一套统一的编码规范、命名规范和优化规范至关重要。以下是一些关键点的详细说明: 1. **前言**: 编码规范的目的是为了提高代码质量,减少因不规范的编程习惯...
本文将深入探讨Java和C#这两种语言的命名规范,帮助开发者形成一致的编码风格。 1. Java命名规范: - 类(Class):Java类名应采用驼峰式命名(Camel Case),每个单词首字母大写,例如`MyClassName`。 - 接口...
java命名规范: 英文版 Sun公司的标准
该文档包括java开发中的注释规范,命名规范,属性名和方法名。还有命名原则
【Java命名规范】是编程实践中至关重要的一环,它关乎代码的可读性和团队协作的效率。Java编程规范中,命名规则主要包括以下几个方面: 1. **包的命名**:包(Package)的名字通常由小写字母组成,为了确保唯一性,...
Neusoft公司Java编码规范 目的 5 范围 6 前提条件 7 Java编码规范概要 8 1 代码风格 8 1.1 一般格式说明 8 1.2 基本结构 8 2 代码结构 9 2.1 变更履历 9 2.2 Package声明 11 2.3 Import声明 12 2.4 Class Header 13 ...
本文将深入探讨几种常见的编程命名规范,包括骆驼命名法、帕斯卡命名法、匈牙利命名法以及接口类命名规则,这些规范在Java、C#、JavaScript等主流编程语言中被广泛采用。 ### 骆驼命名法 骆驼命名法分为小驼峰命名...
在Java编程语言中,命名规范是非常重要的,它不仅关乎代码的可读性和可维护性,也是编程者之间交流思想的有效工具。以下是对Java命名规则的详细解读: 1. 类(Class)命名: Java类的命名应使用驼峰式命名法...
该规范涵盖了 Java 编码风格、文件组织、代码风格、注释、命名、声明、异常、习惯等方面。 一、文件组织 * 文件注释:每个 Java 源文件都应包含一个单一的公共类或接口,私有类和接口可以与公共类放入同一个源文件...
该试题涵盖了 JAVA 编程规范的多个方面,包括变量命名、代码格式、异常处理、日志记录、数据库操作等。 以下是对试题中所涉及到的知识点的详细解释: 1. equals 操作符:在 JAVA 中,equals 操作符的使用需要遵守...
以下是关于"C#和JAVA命名和编程规范"的详细解析: 一、C#编程规范 1. 命名规则: - 类(Class):使用PascalCase,每个单词首字母大写,如`MyClassName`。 - 方法(Method):同样使用PascalCase,如`...
本文档从“Java编程代码规范”,“Java编程注释规范”,“Java编程命名规范”,“代码缩进/断行/空行/空格/大括号规范”,“日志记录规范”和“代码上库规范”六个方面提取两家公司的Java编程规范共性。希望能供Java...
Java 编码规范规定,代码中的命名不能以下划线或美元符号开始,也不能以下划线或美元符号结束。同时,代码中的命名也不能使用拼音与英文混合的方式,更不允许直接使用中文的方式。但是,alibaba /beijing 等国际通用...