javadoc生成API 常见问题

用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 楼 di1984HIT 2014-06-16  

谢谢，不错。