Thing in java(第三版) 读书摘要（1）

2005-03-22
--------------------------------------------------------------------------------------------------------------------------------------

1. Primitive成员的缺省值只有在“变量被作用在类的成员”时，Java才能确保其获得初始化。“本地”变量--也就是非类数据成员的变量，就享受不到这种保障。因此，如果你在方法中定义了：
int x;
那么这个x可以是任意值，它不会自动地初始化为零。

2. 如果类成员或方法是静态成员或方法，您可以使用两种方式调用：一种是使用对象调用；另一种是直接使用类来调用。
程序的入口点main方法就用到了这个特性：
public static void main(String[] args) {
  String s = new String ("Hello");
  System.out.println(s);
 }

3.名字的可见性：java使用了域名方式解决名字冲突问题，一般是将域名sun.com倒过来作为命名如package：com.sun.ejb等。同时类名必须与文件名相同，目录结构需同package的命名方式。

4.使用import引入要使用的类（库），如import java.util.ArrayList或使用通配符(*)同时引入几个类如import java.util.*；

5.注释文档javadoc，格式如：
/**
*/
用法主要有两种一种是嵌入式的html和文档标记（doc tags），独立的文档注释是由一些打头的@命令
如：
/**
*<pre>
*
*</pre>
*/
标记举例：
@see ： 引用其他类，能让你引用到文档中的其他类，javadoc会用@see生成到其他html文档的链接，形式如下：
@see classname;
@fully-qualified-classname;
@fully-qualified-classname#method-name
每一行都会在生成的文档里加上一个see also的超链接，注意javadoc不会检查这个超链接的有效性，所以必须我们自己检查

{@ link package.class#member label}：与@see很相似，他只是内嵌式的文档标记，而且label是作为超链接的文本而不是“see also”出现的。

{@ docRoot}：返回以文档目录为根的相对路径。用于连接目录中的页面。

{@ inheritDoc} ：把与这个类最近的那个基类的文档继承到当前文档中。

@version ： 用法是：
    @version version-information
你可以在version-information里面填任何你觉得合适的东西。在命令行下用-version参数调用javadoc之后，就能生成带版本信息的html文档了。

@author ：用法是：
    @author author-information
其中author-information应该是你的姓名，当然也可以包括厄mial地址，以及其他信息。你可以放多个作者标记，但是必须连续放。在html文件里，所有作者信息都放在一起。

@since 这个标记能让你表明，程序是从哪一个版开始提供某种特性的。在java的html文档里面，你会看到它表示jdk的版本的。

@param
    用于标注方法，其用法是：
            @param parameter-name description
其中parameter-name 表示方法的参数列表，而description是一段可以分成好几行的文本。只有碰到新的文档标记，description才算结束。

@return
        用于标注方法，其用法是 @return description 告诉你返回值的信息。

@throws  方法是：
        @throws fully-qualified-class-name desciption，其中fully-qualified-class-name 必须是方法所声名的异常的名字，而description(可以有行几行长)则会告诉你，是什么原因导致方法产生这个异常。

@deprecated
        这是用来表示程序的某个特性已经被更新的，改进过的特性所替代了。deprecate标记建议用户不再使用这个特性，因为未来这个特性可能会从程序里面取出。客户程序使用了@deprecated标记的方法会导致编译器报一个警告消息。