完善api-doc,用eclipse生成javadoc的時候發生“編碼 GBK 的不可映射字符 ”,其實是字符編碼問題。
打開eclipse,project -> Generate javadoc 一項一項的選你要輸出javadoc的項目,在VM設置中加入以下代碼
-encoding utf-8 -charset utf-8
這次操作,輸出的html代碼不會發生“編碼 GBK 的不可映射字符 ”問題,而且html字符編碼都設爲了UTF-8,問題徹底解決。
對應的ant target 如下
<target name="javadoc"> <echo>+---------------------------------------------------+</echo> <echo>| Building Doc File |</echo> <echo>+---------------------------------------------------+</echo> <javadoc access="protected" additionalparam="-encoding utf-8 -charset utf-8 " author="true" classpath="${classes.dir}" destdir="${doc.dir}/api" nodeprecated="false" nodeprecatedlist="false" noindex="false" nonavbar="false" notree="false" packagenames="org.xxx.common.web.tag.go" source="1.6" sourcepath="${src.dir}" splitindex="true" use="true" version="true" > <link href="http://java.sun.com/javase/6/docs/api/" /> </javadoc> </target>
更爲徹底的辦法就是修改eclipse.ini文件,在末尾加入如下兩行內容:
-Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8