Java代码规范

1 介绍(Introduction)

1.1 为什么要有编码规范(Why Have Code Conventions)

编码规范对于程序员而言尤为重要，有以下几个原因：

l  一个软件的生命周期中，80%的花费在于维护

l  几乎没有任何一个软件，在其整个生命周期中，均由最初的开发人员来维护

l  编码规范可以改善软件的可读性，可以让程序员尽快而彻底地理解新的代码

l  如果你将源码作为产品发布，就需要确任它是否被很好的打包并且清晰无误

l  如你已构建的其它任何产品为了执行规范，每个软件开发人员必须一致遵守规范

2 文件名(File Names)

这部分列出了常用的文件名及其后缀。

2.1 文件后缀(File Suffixes)

Java程序使用下列文件后缀：

文件类别	文件后缀
Java源文件	.java
Java字节码文件	.class

2.2 常用文件名(Common File Names)

常用的文件名包括：

文件名	用途
GNUmakefile	makefiles的首选文件名。我们采用gnumake来创建（build）软件。
README	概述特定目录下所含内容的文件的首选文件名

3 文件组织(File Organization)

一个文件由被空行分割而成的段落以及标识每个段落的可选注释共同组成。超过2000行的程序难以阅读，应该尽量避免。

3.1 Java源文件(Java Source Files)

每个Java源文件都包含一个单一的公共类或接口。若私有类和接口与一个公共类相关联，可以将它们和公共类放入同一个源文件。公共类必须是这个文件中的第一个类或接口。

建议一个源文件中只定义一个Java类或接口，无论该类或接口是否被声明为public的，文件名都以其来命名，源文件中各成分的出现顺序为：

 1）开始的注释

 2）package语句

 3）import语句

 4）类/接口声明

3.1.1 开头注释(Beginning Comments)

所有的源文件都应该在开头有一个C语言风格的注释，其中列出类名、版本信息、日期和版权声明：

文件头部注释主要是表明该文件的一些信息，是程序的总体说明，可以增强程序的可读性和可维护性。文件头部注释一般位于 package/imports 语句之后，Class 描述之前。要求至少写出文件名、创建者、创建时间和内容描述。我们要添加一些注释，其格式应该尽量约束如下：

 

Class
　　
　　接下来的是类的注释，一般是用来解释类的。

 

         

3.1.2 包和引入语句(Package and Import Statements)

在多数Java源文件中，第一个非注释行是包语句。在它之后可以跟引入语句。例如：

  package java.awt;

 

  import java.awt.peer.CanvasPeer;

         

3.1.3 类和接口声明(Class and Interface Declarations)

下表描述了类和接口声明的各个部分以及它们出现的先后次序。

	类/接口声明的各部分	注解
1	类/接口文档注释()	该注释中所需包含的信息。
2	类或接口的声明
3	类/接口实现的注释()如果有必要的话	该注释应包含任何有关整个类或接口的信息，而这些信息又不适合作为类/接口文档注释。
4	类的(静态)变量	首先是类的公共变量，随后是保护变量，再后是包一级别的变量(没有访问修饰符，access modifier)，最后是私有变量。
5	实例变量	首先是公共级别的，随后是保护级别的，再后是包一级别的(没有访问修饰符)，最后是私有级别的。
6	构造器
7	方法	这些方法应该按功能，而非作用域或访问权限分组。例如，一个私有的类方法可以置于两个公有的实例方法之间。其目的是为了更便于阅读和理解代码。

在一个Java类中，各种成分的排列顺序本无严格规定，也没有特别通用的惯例，为便于掌握，给出一个推荐的顺序：

 1）属性声明

 2）构造方法声明

 3）static语句

 4）普通方法声明

 5）main方法声明

 6）内部类的声明

4 缩进排版(Indentation)

4个空格常被作为缩进排版的一个单位。缩进的确切解释并未详细指定(空格 vs. 制表符)。一个制表符等于8个空格(而非4个)。预处理语句、全局数据、标题、附加说明、函数说明、标号等均顶格书写。语句块的"{"、"}"配对对齐，并与其前一行对齐，语句块类的语句缩进建议每个"{"、"}"单独占一行，便于匹对。

4.1 行长度(Line Length)

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

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

4.2 换行(Wrapping Lines)

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

l  在一个逗号后面断开

l  在一个操作符前面断开

l  宁可选择较高级别(higher-level)的断开，而非较低级别(lower-level)的断开

l  新的一行应该与上一行同一级别表达式的开头处对齐

l  如果以上规则导致你的代码混乱或者使你的代码都堆挤在右边，那就代之以缩进8个空格。

换行实例：

1）以下是断开方法调用的一些例子：

  someMethod(longExpression1, longExpression2, longExpression3,

                   longExpression4, longExpression5);

 

  var = someMethod1(longExpression1,

                            someMethod2(longExpression2,

                                               longExpression3));

         

2）以下是两个断开算术表达式的例子。前者更好，因为断开处位于括号表达式的外边，这是个较高级别的断开。

  longName1 = longName2 * (longName3 + longName4 - longName5)

                     + 4 * longname6; //PREFFER

 

  longName1 = longName2 * (longName3 + longName4

                                         - longName5) + 4 * longname6; //AVOID

         

3）以下是两个缩进方法声明的例子。前者是常规情形。后者若使用常规的缩进方式将会使第二行和第三行移得很靠右，所以代之以缩进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) {

    ...

  }

         

4）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();

  }

 

5）这里有三种可行的方法用于处理三元运算表达式：

  alpha = (aLongBooleanExpression) ? beta : gamma;

 

  alpha = (aLongBooleanExpression) ? beta

                                   : gamma;

 

  alpha = (aLongBooleanExpression)

          ? beta

          : gamma;

         

4.3 行数（Line Numbers）

一般的集成编程环境下，每屏大概只能显示不超过50行的程序，所以这个函数大概要5-6屏显示，在某些环境下要8屏左右才能显示完。这样一来，无论是读程序还是修改程序，都会有困难。因此建议把完成比较独立功能的程序块抽出，单独成为一个函数。把完成相同或相近功能的程序块抽出，独立为一个子函数。可以发现，越是上层的函数越简单，就是调用几个子函数，越是底层的函数完成的越是具体的工作。这是好程序的一个标志。这样，我们就可以在较上层函数里容易控制整个程序的逻辑，而在底层的函数里专注于某方面的功能的实现了。

5 注释(Comments)

Java程序有两类注释：实现注释(implementation comments)和文档注释(document comments)。实现注释是那些在C++中见过的，使用和//界定的注释。文档注释(被称为"doc comments")是Java独有的，并由界定。文档注释可以通过javadoc工具转换成HTML文件。

实现注释用以注释代码或者实现细节。文档注释从实现自由(implementation-free)的角度描述代码的规范。它可以被那些手头没有源码的开发人员读懂。

注释应被用来给出代码的总括，并提供代码自身没有提供的附加信息。注释应该仅包含与阅读和理解程序有关的信息。例如，相应的包如何被建立或位于哪个目录下之类的信息不应包括在注释中。

在注释里，对设计决策中重要的或者不是显而易见的地方进行说明是可以的，但应避免提供代码中己清晰表达出来的重复信息。多余的的注释很容易过时。通常应避免那些代码更新就可能过时的注释。

注意：频繁的注释有时反映出代码的低质量。当你觉得被迫要加注释的时候，考虑一下重写代码使其更清晰。

注释不应写在用星号或其他字符画出来的大框里。注释不应包括诸如制表符和回退符之类的特殊字符。

5.1 实现注释的格式(Implementation Comment Formats)

程序可以有4种实现注释的风格：块(block)、单行(single-line)、尾端(trailing)和行末(end-of-line)。

5.1.1 块注释(Block Comments)

块注释通常用于提供对文件，方法，数据结构和算法的描述。块注释被置于每个文件的开始处以及每个方法之前。它们也可以被用于其他地方，比如方法内部。在功能和方法内部的块注释应该和它们所描述的代码具有一样的缩进格式。

块注释之首应该有一个空行，用于把块注释和代码分割开来，比如：

 

         

块注释可以以

         

注意：如果你不使用indent(1)，就不必在代码中使用

    ...

  }

         

5.1.3 尾端注释(Trailing Comments)

极短的注释可以与它们所要描述的代码位于同一行，但是应该有足够的空白来分开代码和注释。若有多个短注释出现于大段代码中，它们应该具有相同的缩进。

以下是一个Java代码中尾端注释的例子：

  if (a == 2) {

      return TRUE;             

  } else {

      return isPrime(a);        

  }

         

5.1.4 行末注释(End-Of-Line Comments)

注释界定符"//"，可以注释掉整行或者一行中的一部分。它一般不用于连续多行的注释文本；然而，它可以用来注释掉连续多行的代码段。以下是所有三种风格的例子：

  if (foo > 1) {

 

      // Do a double-flip.

      ...

  }

  else {

      return false;          // Explain why here.

  }

 

  //if (bar > 1) {

  //

  //    // Do a triple-flip.

  //    ...

  //}

  //else {

  //    return false;

  //}

         

5.2 文档注释(Documentation Comments)

文档注释描述Java的类、接口、构造器，方法，以及字段(field)。每个文档注释都会被置于注释定界符之中，一个注释对应一个类、接口或成员。该注释应位于声明之前：

 

  public class Example { ...

         

注意顶层(top-level)的类和接口是不缩进的，而其成员是缩进的。描述类和接口的文档注释的第一行(”注释语句进行类注释。类注释的内容包括：

1、 这个类是干什么的（必须）

2、 使用这个类的注意事项（不必须）

3、 类调用实例（不必须，重要的类必须有）

4、这个类相关联的类是哪些（列主要的，必须使用@see关键字进行定义，这样，在产生的javadoc里面可以直接连接到这个类）

5、修改日志，修改日志是一个表格，包括“修改人”，“版本号”，“时间”，“修改的内容”，所有的类版本从1.0.0开始，每修改一次，在第二个小数点后面的数字上加1。

6、 作者（修改者也是作者的一部分，多个作者以换行分割，第一个为创建者）

7、 当前版本号和最后修改时间

例如

 

5.2.2方法注释(Method Comments)

简单的不传参数的构造方法可以视情况不加注释，传参数的构造方法必须注释，注释的时候要说明每个参数的意义。其他的方法，不管是公共的还是私有的，都必须加注释。

方法注释的内容包括

1、 这个方法可以干什么（必须）

2、 这个方法的注意事项

3、 这个方法是否为deprecate的方法，如果是，要求使用@deprecated进行注释

4、 如果有参数，这个方法每个参数的意义

5、 如果有返回值，这个方法返回值的意义

6、 跟这个方法相关的类，变量和方法，要求使用@see进行注释

7、 可能的异常的说明，以@exception关键字进行申明

例如：

 

 public int sss(String ddd) {

  //代码块注释

  //……代码块……

  return 0;

 }

 

 

 public int ggg(String ddd) {

  //代码块注释

  //……代码块……

  return 0;

 }

6 声明(Declarations)

6.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

         

6.2 初始化(Initialization)

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

6.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!

          ...

      }

      ...

  }

         

6.4 类和接口的声明(Class and Interface Declarations)

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

l  在方法名与其参数列表之前的左括号"("间不要有空格

l  左大括号"{"位于声明语句同行的末尾

l  右大括号"}"另起一行，与相应的声明语句对齐，除非是一个空语句，"}"应紧跟在"{"之后

l  方法与方法之间以空行分隔

  class Sample extends Object {

      int ivar1;

      int ivar2;

 

Sample(int i, int j) {

          ivar1 = i;

          ivar2 = j;

        }

 

      int emptyMethod() {}

 

      ...

  }

 

7 语句(Statements)

7.1 简单语句(Simple Statements)

每行至多包含一条语句，例如：

  argv++;       // Correct

  argc--;       // Correct

  argv++; argc--;       // AVOID!

         

7.2 复合语句(Compound Statements)

复合语句是包含在大括号中的语句序列，形如"{ 语句 }"。例如下面各段。

l  被括其中的语句应该较之复合语句缩进一个层次

l  左大括号"{"应位于复合语句起始行的行尾；右大括号"}"应另起一行并与复合语句首行对齐。

l  大括号可以被用于所有语句，包括单个语句，只要这些语句是诸如if-else或for控制结构的一部分。这样便于添加语句而无需担心由于忘了加括号而引入bug。

7.3 返回语句(return Statements)

一个带返回值的return语句不使用小括号"()"，除非它们以某种方式使返回值更为显见。例如：

  return;

 

  return myDisk.size();

 

  return (size ? size : defaultSize);

         

7.4 if，if-else，if else-if else语句(if, if-else, if else-if else Statements)

if-else语句应该具有如下格式：

  if (condition) {

      statements;

  }

 

  if (condition) {

      statements;

  } else {

      statements;

  }

 

  if (condition) {

      statements;

  } else if (condition) {

      statements;

  } else{

      statements;

  }

         

注意：if语句总是用"{"和"}"括起来，避免使用如下容易引起错误的格式：

  if (condition) //AVOID! THIS OMITS THE BRACES {}!

      statement;

         

7.5 for语句(for Statements)

一个for语句应该具有如下格式：

  for (initialization; condition; update) {

      statements;

  }

         

一个空的for语句(所有工作都在初始化，条件判断，更新子句中完成）应该具有如下格式：

  for (initialization; condition; update);

         

当在for语句的初始化或更新子句中使用逗号时，避免因使用三个以上变量，而导致复杂度提高。若需要，可以在for循环之前(为初始化子句)或for循环末尾(为更新子句)使用单独的语句。

7.6 while语句(while Statements)

一个while语句应该具有如下格式

  while (condition) {

      statements;

  }

         

一个空的while语句应该具有如下格式：

  while (condition);

         

7.7 do-while语句(do-while Statements)

一个do-while语句应该具有如下格式：

  do {

      statements;

  } while (condition);

         

7.8 switch语句(switch Statements)

一个switch语句应该具有如下格式：

  switch (condition) {

  case ABC:

      statements;

     

  case DEF:

      statements;

      break;

 

  case XYZ:

      statements;

      break;

 

  default:

      statements;

      break;

  }

         

每当一个case顺着往下执行时(因为没有break语句)，通常应在break语句的位置添加注释。上面的示例代码中就包含注释。

7.9 try-catch语句(try-catch Statements)

一个try-catch语句应该具有如下格式：

  try {

      statements;

  } catch (ExceptionClass e) {

      statements;

  }

         

一个try-catch语句后面也可能跟着一个finally语句，不论try代码块是否顺利执行完，它都会被执行。

  try {

      statements;

  } catch (ExceptionClass e) {

      statements;

  } finally {

      statements;

  }

         

8 空白(White Space)

8.1 空行(Blank Lines)

空行将逻辑相关的代码段分隔开，以提高可读性。

下列情况应该总是使用两个空行：

l  一个源文件的两个片段(section)之间

l  类声明和接口声明之间

下列情况应该总是使用一个空行：

l  两个方法之间

l  方法内的局部变量和方法的第一条语句之间

l  块注释或单行注释之前

l  一个方法内的两个逻辑段之间，用以提高可读性

不得存在无规则的空行，比如说连续十个空行。程序文件结构各部分之间空两行，若不必要也可只空一行，各函数实现之间一般空两行，由于每个函数还要有函数说明注释，故通常只需空一行或不空，但对于没有函数说明的情况至少应再空一行。对自己写的函数，建议也加上“//------”做分隔。函数内部数据与代码之间应空至少一行，代码中适当处应以空行空开，建议在代码中出现变量声明时，在其前空一行。类中四个“p”之间至少空一行，在其中的数据与函数之间也应空行。

8.2 空格(Blank Spaces)

下列情况应该使用空格：

l  一个紧跟着括号的关键字应该被空格分开，例如：

  while (true) {

      ...

  }

         

注意：空格不应该置于方法名与其左括号之间。这将有助于区分关键字和方法调用。

l  空白应该位于参数列表中逗号的后面

l  所有的二元运算符，除了"."，应该使用空格将之与操作数分开。一元操作符和操作数之间不应该加空格，比如：负号("-")、自增("++")和自减("--")。例如：

    a += c + d;

    a = (a + b) / (c * d);

 

    while (d++ = s++) {

        n++;

    }

printSize("size is " + foo + "\n");

 

l  for语句中的表达式应该被空格分开，例如：

    for (expr1; expr2; expr3)

         

l  强制转型后应该跟一个空格，例如：

    myMethod((byte) aNum, (Object) x);

    myMethod((int) (cp + 5), ((int) (i + 3)) + 1);

原则上变量、类、常量数据和函数在其类型，修饰名称之间适当空格并据情况对齐。关键字原则上空一格，如：if ( ... ) 等。运算符的空格规定如下："::"、"->"、"["、"]"、"++"、"--"、"~"、"!"、"+"、"-"（指正负号）、"&"（引用）等几个运算符两边不加空格（其中单目运算符系指与操作数相连的一边），其它运算符（包括大多数二目运算符和三目运算符"?:"两边均加一空格，在作函数定义时还可据情况多空或不空格来对齐，但在函数实现时可以不用。","运算符只在其后空一格，需对齐时也可不空或多空格。不论是否有括号，对语句行后加的注释应用适当空格与语句隔开并尽可能对齐。个人认为此项可以依照个人习惯决定遵循与否。

9 命名规则

命名规范使程序更易读，从而更易于理解。它们也可以提供一些有关标识符功能的信息，以助于理解代码，例如，不论它是一个常量，包，还是类。

包(Packages)

一个唯一包名的前缀总是全部小写的ASCII字母并且是一个顶级域名，通常是com，edu，gov，mil，net，org，或1981年ISO 3166标准所指定的标识国家的英文双字符代码。包名的后续部分根据不同机构各自内部的命名规范而不尽相同。这类命名规范可能以特定目录名的组成来区分部门(department)，项目(project)，机器(machine)，或注册名(login names)。

名词或名词性词组，全部小写；一般使用本公司／组织网站域名的逆序后跟具体的软件内部模块名

命名实例

com.sun.eng
com.apple.quicktime.v2
edu.cmu.cs.bovik.cheese

 

类(Classes)

类名是个一名词，采用大小写混合的方式，每个单词的首字母大写。尽量使你的类名简洁而富于描述。使用完整单词，避免缩写词(除非该缩写词被更广泛使用，像URL，HTML)

命名实例   

class Raster;

class ImageSprite;

 

接口(Interfaces) 规则同类

命名实例  

interface RasterDelegate;

 

方法(Methods)

方法名是一个动词，采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写。

命名实例    

run();
runFast();
getBackground();

变量(Variables)

名词或名词性词组，首字母小写，第二个及以后的单词首字母大写；不提倡使用下画线"_"和美元符"$"作为变量开头；单词间可以使用下画线分隔；变量名不宜过长但也应有意义，除非是临时使用（例如只涉及几行代码）后即丢弃的情况，不建议使用单个字母做变量名，常用的临时使用的变量名包括表示整数的i，j，k，m，n和表示字母的c以及表示异常对象的e等。

变量命名举例：

int age； int student_age； String studentName； Exception e；

常量(Constants)

名词或名词性词组，每个单词的首字母大写；单词间使用下画线分隔。

常量命名举例：int MAX_LEVEL； double　Comm_Tax；

数组

Byte [] buffer;

而不是Byte buffer[];

10 编程惯例(Programming Practices)

10.1 提供对实例以及类变量的访问控制(Providing Access to Instance and Class Variables)

若没有足够理由，不要把实例或类变量声明为公有。通常，实例变量无需显式的设置(set)和获取(gotten)，通常这作为方法调用的边缘效应 (side effect)而产生。

一个具有公有实例变量的恰当例子，是类仅作为数据结构，没有行为。亦即，若你要使用一个结构(struct)而非一个类(如果java支持结构的话)，那么把类的实例变量声明为公有是合适的。

10.2 引用类变量和类方法(Referring to Class Variables and Methods)

避免用一个对象访问一个类的静态变量和方法。应该用类名替代。例如：

  classMethod();             //OK

  AClass.classMethod();      //OK

  anObject.classMethod();    //AVOID!

         

10.3 常量(Constants)

位于for循环中作为计数器值的数字常量，除了-1,0和1之外，不应被直接写入代码。

10.4 变量赋值(Variable Assignments)

避免在一个语句中给多个变量赋相同的值。它很难读懂。例如：

  fooBar.fChar = barFoo.lchar = 'c'; // AVOID!

         

不要将赋值运算符用在容易与相等关系运算符混淆的地方。例如：

  if (c++ = d++) {        // AVOID! (Java disallows)

      ...

  }

应该写成

  if ((c++ = d++) != 0) {

    ...

  }

不要使用内嵌(embedded)赋值运算符试图提高运行时的效率，这是编译器的工作。例如：

  d = (a = b + c) + r;        // AVOID!

应该写成

  a = b + c;

  d = a + r;

         

10.5 其它惯例(Miscellaneous Practices)

10.5.1 圆括号(Parentheses)

一般而言，在含有多种运算符的表达式中使用圆括号来避免运算符优先级问题，是个好方法。即使运算符的优先级对你而言可能很清楚，但对其他人未必如此。你不能假设别的程序员和你一样清楚运算符的优先级。

  if (a == b && c == d)     // AVOID!

  if ((a == b) && (c == d))  // RIGHT

         

10.5.2 返回值(Returning Values)

设法让你的程序结构符合目的。例如：

  if (booleanExpression) {

      return true;

  } else {

      return false;

  }

应该代之以如下方法：

  return booleanExpression;

类似地：

  if (condition) {

      return x;

  }

  return y;

应该写做：

  return (condition ? x : y);

         

10.5.3 条件运算符"?"前的表达式(Expressions before '?' in the Conditional Operator)

如果一个包含二元运算符的表达式出现在三元运算符" ? : "的"?"之前，那么应该给表达式添上一对圆括号。例如：

  (x >= 0) ? x : -x;

         

10.5.4 特殊注释(Special Comments)

在注释中使用XXX来标识某些未实现(bogus)的但可以工作(works)的内容。用FIXME来标识某些假的和错误的内容。

11 代码范例(Code Examples)

11.1 Java源文件范例(Java Source File Example)

下面的例子，展示了如何合理布局一个包含单一公共类的Java源程序。接口的布局与其相似。

 

 

 

package java.blah;

 

import java.blah.blahdy.BlahBlah;

 

 

public class Blah extends SomeClass {

   

 

   

    public static int classVar1;

 

   

    private static Object classVar2;

 

   

    public Object instanceVar1;

 

   

    protected int instanceVar2;

 

   

    private Object[] instanceVar3;

 

   

    public Blah() {

        // ...implementation goes here...

    }

 

   

    public void doSomething() {

        // ...implementation goes here...

    }

 

   

    public void doSomethingElse(Object someParam) {

        // ...implementation goes here...

    }

 

}