Java编程思想(第4版)读书笔记——01

1.面向对象程序设计(Object-oriented Programming, OOP)

2.程序运行时,对象有五个不同的地方可以存储数据:

  (1)寄存器

  (2)堆栈

  (3)堆

  (4)常量存储

  (5)非RAM存储

 3.基本类型

 4.基本成员默认值

5.一些注释标签

  (1)@see:引用其他类

  @see标签允许用户引用其他类的文档。jacadoc会在其生成的HTML文件中,通过@see链接到其他文档。格式如下:

  @see classname

  @see fully-qualified-classname

  @see fully-qualified-classname#method-name

  (2){@link package.class#member label}

  该标签与@see极其相似,只是它用于行内,并且是用“label”作为超链接文本而不用“See Also”。

  (3){@docRoot}

  该标签产生到文本根目录的相对路径,用于文档树页面的的显示超链接。

  (4){@inheritDoc}

  该标签从当前这个泪的最直接的基类中集成相关文档到当前的文档注释中。

  (5)@version

  该标签的格式如下:

  @version version-infomation

  其中,“version-infomation”可以是任何你认为适合包含在版本说明中的重要信息。如果javadoc命令行使用了"-version"标记,那么就从生成的HTML文档中特别提取出版本信息。

  (6)@author

  该标签的格式如下:

  @author author-infomation

  其中,author-infomation一看便知是你的姓名,但是也可以包括电子邮件地址或者其他任何适宜的信息。如果javadoc命令行使用了-author标记,那么就从生成的HTML文档中特别提取作者信息。

  可以使用多个标签,以便列出所有作者,但是它们必须连续放置。全部作者信息会合并到同一段落,置于生成的HTML中。

  (7)@since

  该标签允许你制定程序代码最早使用的版本,可以在HTML Java文档中看到它被用来指定所用的JDK版本的情况。

  (8)@param

  该标签用于方法文档中,形式如下:

  @param parameter-name description

  其中,parameter-name是方法的参数列表中的标识符,description是可延续数行的文本,终止于新的文档标签出现之前。可以使用任意多个这种标签,大约每个参数都有一个这样的标签。

  (9)@return

  该标签用于方法文档,格式如下:

  @return description

  其中,“desctiption”用来描述返回值的含义,可以延续数行。

  (10)@throws

  “异常”,简言之,它们是由于某个方法调用失败而“抛出”的对象。尽管在调用一个方法时,只出现一个异常对象,但是某个特殊方法可能会产生任意多个不同类型的异常,所有这些异常都需要进行说明。所以,异常标签的格式如下:

  @throws fully-qualifued-class-name description

  其中fully-qualified-class-name给出一个异常类的无歧义的名字,而该异常泪在别处定义。description(同样可以延续数行)告诉你为什么此特殊类型的异常会在方法调用中出现。

  (11)@deprecated/@Deprecated

  该标签用于指出一些旧特性已由改进的新特性所取代,建议用户不要再使用这些旧特性,因为在不久的将来它们很可能会被删除。如果使用一个标记为@deprecated的方法,则会引起编译器发布警告。

posted @ 2016-05-10 14:59  VichanHo  阅读(182)  评论(0编辑  收藏  举报