Java API Docs是学习和使用Java语言中最经常使用的参考资料之一。但是长期以来此文档只有英文版和日文版，对于中国地区的Java开发者来说相当的不便。目前Sun 公司正在组织多方力量将此文档翻译成中文。2005年11月，翻译成果终于初露端倪，与广大Java开发人员见面。
岁末送礼 Java API文档中文版更新 不负众望 Java API文档中文版正式发布
网友投票  发表意见 |
翻译进程
SUN网站 |
|||||||||||||||||||||||
|
- 多方观点
-
2005年10月31日，Sun 公司开始发布Java API文档中文版的内容，首先推出的是java.lang和java.util类库的阅读，其他类库API文档的中文版也将于今后一段时间内陆续向中国地区的开发人员提供。
CSDN网友评论 & Sun网友评论
支持声音：感谢Sun 公司推出的Java API文档中文版，“中国JAVA人，需要中文API！”
反对声音：已经看惯了英文文档，中文文档看起来反而费力！支持英文版！支持声音
CSDN网友：[2005-12-29] 期待啊，12月31号。马上就可以看到新的java中文版的文档了，而且还是非常常用的几个类，好期待啊。 CSDN网友：[2005-12-22] 中国JAVA人： 需要中文API ！不仅是个人的表现，更是国家脸面问题。 CSDN网友：[2005-12-8 ] 中文版真好。中本版确实是被动，不过英文版却实实在在是被迫的。 CSDN网友：[2005-11-9 ] 谢谢ＳＵＮ公司 “姗姗来迟” 的中文文档！java支持中国，中国用户支持java！支持API文档中文化！！！ 反对声音
CSDN网友：[2005-12-22] 英文文档本来就很清晰明了，不知道换成中文会怎么样。也许中文的对新手有用，但是毕竟源码中的那部分doc都是英文的，而更多时候再阅读的是jdk的源码而不是文档（因为有IDE工具的支持），而且外面有相当一部分多语言的软件，可是中文部分的翻译都是惨不忍睹，每次找东西都要先切换回英文的才能明白。希望文档的翻译不要那么凄惨。 CSDN网友：[2005-11-6 ] 当程序员，连英文都不行，不如去做房地产推销商那种有前途的职业吧 CSDN网友：[2005-11-11] 我怎么觉得看翻译的更让我看不懂啊。 - 第三方
-
CSDN网友：[2005-11-11] 期待已久,好不容易! 看了几篇文章,虽然有些地方仍有待完善，但比起以前的中文版以及网上已有的一些部分类似翻译文章已强多了,API 的E文版的偶也看过一些，有些原英文还真的有点不感恭维(不要骂偶,实话实说哦),看到这样的中文版,偶已经有点满足了,感谢 SUN 工作人员的辛苦劳动! CSDN网友：[2005-11-7 ] JAVA中文API何時能真正出爐啊??? CSDN网友：[2005-11-8 ] 学JAVA有一段时间了，j2se的常用部分还是搞得比较清楚了，强烈希望把j2ee的文档翻译成中文。
毕竟很多人在学好j2se后都去学j2ee了。CSDN网友：[2005-12-16] 大伙观察得很细呀，不错，置顶了，看来SUN还是很重视的。大家对翻译对比较晦涩难懂的，或者有更好的翻译的，也可以拿出来与同胞们分享啊 ：P - bug讨论
-
中文化过程中的bug讨论 （更新中），欢迎大家 Random类的下面方法翻译有误： 
希望大家都尽一下力，有认为不妥当的地方提出来。请不要在此谩骂、攻击。谢谢合作。
在java.lang.Thread 类的第二句中的concurrently译为“并发地”比“同时”较好。线程是JAVA的核心之一，考虑到绝大多数计算机是只有一个CPU的，或者实际CPU数会比线程数少，那么多个线程实际上不是“同时”在运行，而是通过线程调度来轮流执行，即所谓“并发执行”。许多书籍中也注释过这一点。另外5.0中有个java.util.concurrent实用包,理解为并发更妥当。
nextInt(int n)
返回一个伪随机数，它是从此随机数生成器的序列中取出的、在 0（包括）和指定值（包括）之间均匀分布的 int值。
指定值是不包括的，原文如下：
nextInt(int n)
Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence.Random 类中nextInt(int n) 在类 ArrayList<E> 的概述中出现了一个时间字符串 英文为：Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), drawn from this random number generator's sequence.
翻译为：返回一个伪随机数，它是从此随机数生成器的序列中取出的、在 0（包括）和指定值（包括）之间均匀分布的 int值。nextInt 的常规协定是伪随机地生成并返回指定范围中的一个 int 值。所有 n 个可能 int 值的生成概率（大致）相同。Random 类按如下方式实现 nextInt(int n) 方法
错误：指定值（包括）应为指定值（不包括） 类 ArrayList<E>
java.lang.Object
java.util.AbstractCollection<E>
java.util.AbstractList<E>
java.util.ArrayList<E>
.....
此类的 iterator 和 listIterator 方法返回的迭代器是快速失败的：在创建迭代器之后，除非通过迭代器自身的 remove 或 add 方法从结构上对列表进行修改，否则在任何时间以任何方式对列表[b]16:39 2005-10-8[/b]进行修改，迭代器都会抛出 ConcurrentModificationException。因此，面对并发的修改，迭代器很快就会完全失败，而不是冒着在将来某个不确定时间发生任意不确定行为的风险。建议将null翻译为null而不是“空” StringBuilder中文问题 null应该保留不译，如果是“is empty”，则应该翻译作“为空” 。 原文："在 StringBuilder 上的主要操作是 append 和 insert 方法，可重载这些方法，以接受任意类型的数据。"
将 which are overloaded so as to accept data of any type 翻译成 "可重载这些方法，以接受任意类型的数据。"显然有问题。java.lang.reflect包中InvocationHandler接口翻译错误 其他意见 英文描述如下：
Each proxy instance has an associated invocation handler. When a method is invoked on a proxy instance, the method invocation is encoded and dispatched to the invoke method of its invocation handler.
中文描述如下：
每个代码实例都具有一个关联的调用处理程序。对代理实例调用方法时，将对方法调用进行编码并将其指派到它的调用处理程序的 invoke 方法。
第一句话，代码实例应该是代理实例。• 每个方法的超级链接都是绝对的，一定要改成相对的啊,不然下载下来再修改就太麻烦了啊. • 专业术语希望保持英文本色 • 中文化的速度能再快一點嗎？ • 还是希望能把j2ee中的文档翻译成中文 • 强烈要求API中文文档中要做到中英文并列, 易于对比理解。 • 强烈建议中文API的翻译由中国程序员的加入！ 小编总结 • 我想参与翻译,可以么? 总而言之，Java 文档中文版的推出无论如何都是一件值得庆贺的事。如此庞大的工程，在文档的汉化过程中，bug当然是无可避免。以上所列的内容都是总结了到目前为止网友提供的Java 文档中文版中存在的翻译问题。文档一经公布就引起了广泛的讨论，长远看来，作为最终的受益者——广大国人开发人员，都是非常期盼这一项目的实现。这一事件也将成为Java发展之路上2005年的亮点之一，铭记在人们的心中。
• java API 能不能像.NET的帮助文档一样有一些 实例！！ • 希望sun要把中文术语统一起来，特别是要考虑历史。 • java.lang.stringbuffer中的方法基本全部都没有翻译，希望可以完善 • Java API文档中文版CHM下载 链接
