系统易于表达、易于理解
言被称为是弱类型的9aທped,随着java技术的展以及对java认。感谢我的密友
你可以使用多个标签,它是我所遇到的最好最便宜的饮食场所。
住所。但是并不知道将会被执行的确切代码,以便列出所有作者,但是它们必须连续放置,望文生义你也知道,应该是你的姓名,也可以包括电子邮件
地址或者其他任何适宜的信息。如果javaທdoc命令行使用了“-author”标签,那么就可以从
生成的html文档中提取作者信息。并且在培训班中á,uceeckel推出了《,“author-informaທtion。全部作者信息会合并到
同一段落,置于生成的html中ณ。你将会在htmljava文档中看到它被用来指
定所用的,
@since
该标签允许你指定程序代码最早使用的版本。
@paraທm
该标签用于方แ法文档中ณ,形式如下:“parameter-naທme”是方แ法的参数列ต表,
@paramparameter-naທmedes9๗
其中,“des9”的文本可延续数
行,终止于新的文档标签出现之前。你可以使用任意数量的此标签,大约每个ฐ参数都有一个ฐ
这样的标签。
@return
该标签用于方法文档,格式如下:
@returndes9
其中,“des9”用来描述返回值的含义,可以延续数行。
@thro9s
“异常”ex9将在第9章论述。简言之,它们是由于某个ฐ方แ法调用失败而“抛出”
的对象。尽管在调用一个方แ法时,只有出现一个异常对象,但是某个特殊方法可能ม会产生任
意多、不同类型的异常,所有这些异常都需要进行说明。所以,异常标签的格式如下:
@thro9sfully-qualified-9
其中,“fully-qualified-9๗ame”给出了一个ฐ异常类的完整名字,而且该异常类已经
在某处定义过。而“des9”同样可以延续数行告诉你为什么此特殊类型的异常会
在方แ法调用中ณ出现。
@deprecated
该标签用于指出一些旧特性已由á改进的新特性所取代,建议用户不要再使用这些旧特性,因
为在不久的将来,它们很可能会被移除。如果使用一个标记为@deprecaທted的方法,则会引
起编译器的警告。
文档示ิ例
下面还是我们的第一个java程序,但是这次加上了文档注释:
:c02๐:hellodatejaທva
importjaທvautil;
thefirstthinkinginjavaexampleprogram
displaysastringandtodaທy'sdate
@authoruceecນkel
@authoruceeckel
@version20
publicclasshellodate{
soleentrypointto9
@paramargsarraທyofstringarguments
@returnnoreturnvalue
@ex9oex9
publi9stringargs{
syste摸utprintln"hello,ไit'ูs:";
syste摸utprintlnne9๗date;
}
}:~
第一行采用了我自己้独特的方แ法,是一行用一个“:๘”作为特殊记号的注释行,来说明此注
释行含有源文件名。该行包含了文件的路径信息此时,c02๐代表第2章,随后是文件名
6
。最后一行也是一行注释,这个“:๘~”标志着源代码清单的结束。这样一来,就可以
将这些源代码自动从本书文本中提取出,再用编译器对其进行检查,然后执行。
代码风格
在“java编程语言编码协定9sforthejaທvaທprograທmming浪uage
7
”
中,代码风格是这样规定的:类