Changes between Version 8 and Version 9 of standard


Ignore:
Timestamp:
05/04/2012 04:38:27 PM (14 years ago)
Author:
lifeng
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • standard

    v8 v9  
    1818=== Java源文件 === 
    1919每个Java源文件都包含一个单一的公共类或接口。若私有类和接口与一个公共类相关联，可以将它们和公共类放入同一个源文件。公共类必须是这个文件中的第一个类或接口。 
    20  ====  开头注释  ====  
    21 所有的源文件都应该在开头有一个C语言风格的注释，其中列出类名、版本信息、日期和版权声明： 
    22 {{{ 
    23   /* 
    24    * Classname 
    25    * Version information 
    26    * Date 
    27    * Copyright notice 
    28    */ 
    29 }}} 
     20 
    3021 ====  包和引入语句  ====  
    3122在多数Java源文件中，第一个非注释行是包语句。在它之后可以跟引入语句。例如： 
    … …  
    3526  import java.awt.peer.CanvasPeer; 
    3627}}} 
     28 ====  开头注释  ====  
     29所有的源文件都应该在开头有一个文档注释，其中列出描述、版本信息和日期： 
     30{{{ 
     31  /** 
     32   * 环境相关类 
     33   * BBS7.0 
     34   * 2012-12-23 
     35   */ 
     36}}} 
    3737 ====  类和接口声明  ====  
     38TODO 
    3839=== 注释 === 
    3940* Java程序有两类注释：'''实现注释'''(implementation comments)和'''文档注释'''(document comments)。'''实现注释'''是那些在C++中见过的，使用/*...*/和!//界定的注释。'''文档注释'''(被称为"doc comments")是Java独有的，并由/!**...*/界定。文档注释可以通过javadoc工具转换成HTML文件。实现注释用以注释代码或者实现细节。文档注释从实现自由(implementation-free)的角度描述代码的规范。它可以被那些手头没有源码的开发人员读懂。