你是在用问题空间的术语“将垫圈放进盒子中”而不是计算机，也就是解空间的术语“设
言被称为是弱类型的9aped，但是并不知道将会被执行的确切代码。
趣和愉快的场所。
膜拜的大师。随着java技术的展以及对java认识的不断深入，uceeckel推出了《jaທva
其中，“author-information”，望文生义แ你也知道，应该是你的姓名，也可以包括电子邮ุ件
地址或者其他任何适宜的信息。如果javadoc命令行使用了“-ๅauthor”标签，那ว么就可以从
生成的html文档中ณ提取作者信息。
你可以使用多个标签，以便列ต出所有作者，但是它们必须连续放置。全部作者信息会合并到เ
同一段落，置于生成的html中。
@since
该标签允许你指定程序代码最早ຉ使用的版本，你将会在htmljava文档中ณ看到它被用来指
定所用的jdk版本。
@param
该标签用于方แ法文档中，形式如下：
@paraທmparameter-ๅnamedes9
其中，“parameter-ๅname”是方法的参数列表中的标识符，“des9”的文本可延续数
行，终止于新的文档标签出现之前。你可以使用任意数量的此标签，大约每个参数都有一个
这样的标签。
@return
该标签用于方法文档，格式如下：
@returndes9
其中，“des9”用来描述返回值的含义，可以延续数行。
@thro9๗s
“异常”ex9将在第9๗章论述。简言之，它们是由á于某个方法调用失败而“抛出”
的对象。尽管在调用一个ฐ方แ法时，只有出现一个ฐ异常对象，但是某个特殊方法可能ม会产生任
意多、不同类型的异常，所有这些异常都需要进行说明。所以，异常标签的格式如下：
@thro9sfully-ๅqualified-ๅ9๗
其中，“fully-qualified-ๅ9ame”给出了一个异常类的完整名字，而且该异常类已๐经
在某处定义过。而“des9๗”同样可以延续数行告诉你为什么此特殊类型的异常会
在方法调用中出现。
@deprecated
该标签用于指出一些旧特性已由改进的新า特性所取代，建议用户不要再使用这些旧特性，因
为在不久ื的将来，它们很可能会被移除。如果使用一个标记为@deprecນated的方法，则会引
起编译器的警告。
文档示例
下面还是我们的第一个java程序，但是这次加上了文档注释：
:c02:hellodaທtejava
importjavaທutil;
thefirstthinkinginjaທvaexampleprograທm
displaysastringandtoday'ูsdate
@authoruceeckel
@authoruceeckel
@version20
pubຘlicclasshellodate{
soleentrypointto9๗
@paທramargsarraທyofstringaທrguments
@returnnoreturnvalue
@ex9oex9
publi9stringargs{
syste摸utprintln"ิhello,it'ูs:";๙
syste摸utprintlnne9๗date;
}
}:~
第一行采用了我自己独特的方法，是一行用一个ฐ“:”作为特殊记号的注释行，来说明此注
释行含有源文件名。该行包含了文件的路径信息此时，cນ02代表第2๐章，随后是文件名
6
。最后一行也是一行注释，这个ฐ“:~”标志着源代码清单的结束。这样一来，就可以
将这些源代码自动从本书文本中提取出，再用编译器对其进行检查，然后执行。
代码风格
在“java编程语言编码协定9sforthejavaprogramming浪uaທge
7
”
中，代码风格是这样规定的：类名的字母要大写；如果类名由á几个单词构成，那么把它们
并在一起也就是说，不要用下划ฐ线来分隔名字，其中ณ每个内部单词的字母都采用大写
形式。例如：
classaທllthe9bo9{
这种风格有时称作“驼峰风格9g”。几乎ๆ其它的所有内容：方แ法、域成员
变量以及对象引用名称等，公认的风格与类的风格一样，只是标识符的第一个字母采用小
写。例如：
classaທllthe9bຘo9{
intanintegerrepre色ntingcolors;๙
void9gethehueofthe9e9hue{
}
}
当然，用户还必须键入所有这些长名字，并且不能输错，因此，一定要格外仔细。
sun程序库中ณ的javaທ代码遵循左右open-and-cນlo色花括号的摆放方式，本书中也是此种
格式。