ITeye博客

javadoc生成API 常见问题

zwh910621 · 2010-09-19 13:57 · Java · 编程语言 · Markdown

用JAVADOC生成API

点击你的项目右键-export-java-javadoc-一般都可以一直默认的下去就行

可能会发生的几个问题

1.如果你的项目是UTF-8

控制台错误信息:编码 GBK 的不可映射字符
 

2.内存不足

控制台错误信息:javadoc: 错误 - java.lang.OutOfMemoryError:请增加内存。
 

3.注释中有不规范的标签

控制台错误信息:java.util.MissingResourceException: Can't find resource for bundle com.sun.tools.doclets.formats.html.resources.standard, key doclet.malformed_html_link_tag
 

问题1和2的解决方法

分别在这两个地方添加如下代码

 

 

-J-Xmx256m

-encoding UTF-8 -charset UTF-8
生成英文API:-locale en_US -encoding UTF-8 -charset UTF-8 -J-Xmx256m 

 

问题3.

主要原因是在项目的注释里存在<a>标签

删除<a>标签就OK了

如果还不能解决,可以尝试使用JDK6生成API应该就能解决这个问题,也有可能是@link里的内容找不到

评论(1)

  1. #1 楼 · di1984HIT · 2014-06-16 16:25

    谢谢,不错。

评论功能维护中,当前仅展示历史评论。