Java 版 (精华区)

发信人: allen (夏夜晚风·原来的我), 信区: Java
标  题: [蔡学镛][Learning Java the O'Reilly's Way]21
发信站: 哈工大紫丁香 (2002年08月21日00:50:31 星期三), 站内信件

发信人: NullPointer (宁与骐骥亢轭，不随驽马之迹)
发信站: BBS 水木清华站 (Sun Jun 30 19:28:43 2002)

Learning Java the O'Reilly's Way (Part XXI)
Java Power Reference
Java API 多得如恒河沙数，每个 Java 程序设计员都需要透过
一套良好的 API 手册来帮助撰写程序。我心目中理想的 API手
册是像 The Waite Group 出版的《Win32 API Bible》，依功能
将 API 分门别类，然后详细介绍，还佐以短而具代表性的范例。

我认为 The Waite Group 出版的《Win32 API Bible》唯一的缺
失在于它是印刷品。API 手册如果以纸张印刷的方式存在，尽管
索引方式设计得再精良，查询时仍然颇为费时、不便。更何况 
Java 的 API这么多，真要印成手册，恐怕会如大英百科全书般惊
人。如果改以电子手册的方式存在，并以 CD-ROM 的方式发行，
无疑地是 Java API 手册最好的现身方式，除了环保不需纸张的
好处之外，查询检索起来更是方便，甚至可以使用交叉查询的功能。

《Java Power Reference》是一份电子手册，而且文件一律使用
HTML 的格式，所以可以直接用计算机上的浏览器阅读，无须安装
特殊的电子书软件。除了一片 CD-ROM 之外，《Java Power 
Reference》还附有一本薄薄的书（约六十页），简单地描述
Java 2 平台的现况。

《Java Power Reference》的优点包括了：

·   搜寻方式以及交叉索引都很方便，找资料的速度比 Sun 
     的线上说明快。

·   完整地列出 Java 2 所有的 API。包括了 182 package、
     3,900 个类别、38,384 个 methods 和 field 。（虽然
     如此，但其实资料量也只占了光盘片的一小部分，约 
     130MB。）

虽然《Java Power Reference》是电子手册，收集了齐全的 Java
2 API（包括了Core API 和 Standard Extension API），搜寻
功能和索引作得不错，也可以交叉查询，但是它却让我大失所望
。任何人都可以轻易地发现《Java Power Reference》的两大缺失：

·   没有范例程序：你无法知道如何将这些 API 兜在一起，以达到
     特定功能。

·   没有 API 说明：每个 method 只列出其传入参数的型态和其传
     出值的型态，其它的说明一概付之阙如。使用者只好透过 
     method 名称来「望文生义」一番。

没有范例、没有 API 说明的 API 手册，就好比是一本没有例句、
没有单字说明的英文字典，我很怀疑这样的字典能帮我写好英文文
章。对我来说，如果我想知道某 API 的用法，我宁愿利用 Sun 提
供的线上文件，因为它对每个 API 有详细说明；如果我想快速查询
 API格式，我会使用开发工具提供的提示功能（比方说 Jbuilder
的 CodeInside）。

希望在不久的未来《Java Power Reference》能改版，加强范例和 
API 说明，成为真正的 Java POWER Reference。



--
   明天不一定会更好
       但更好的明天一定会到来...

※ 来源:·哈工大紫丁香 bbs.hit.edu.cn·[FROM: 218.7.25.106]