javadoc 生成器答案

【问题标题】：javadoc generatorjavadoc 生成器
【发布时间】：2012-10-11 13:50:52
【问题描述】：

C:\Users\Ramaraj>cd\

C:\>set path="D:\Program Files (x86)\Java\jdk1.6.0_35\bin";

C:\>javadoc D:\PersonAction.java -d D:\doc
Creating destination directory: "D:\doc\"
Loading source file D:\PersonAction.java...
D:\PersonAction.java:22: warning: unmappable character for encoding Cp1252
//σ«ÜΣ╣ëσ??Σ╕║reloadτÜäresultΘç?σ«Üσ?æσê░user.action, σà╢Σ╗ûresultσêÖµîëτàºconve
ntionΘ╗ÿΦ«ñ.
         ^
D:\PersonAction.java:22: warning: unmappable character for encoding Cp1252
//σ«ÜΣ╣ëσ??Σ╕║reloadτÜäresultΘç?σ«Üσ?æσê░user.action, σà╢Σ╗ûresultσêÖµîëτàºconve
ntionΘ╗ÿΦ«ñ.
          ^
D:\PersonAction.java:22: warning: unmappable character for encoding Cp1252
//σ«ÜΣ╣ëσ??Σ╕║reloadτÜäresultΘç?σ«Üσ?æσê░user.action, σà╢Σ╗ûresultσêÖµîëτàºconve
ntionΘ╗ÿΦ«ñ.
                               ^
D:\PersonAction.java:22: warning: unmappable character for encoding Cp1252
//σ«ÜΣ╣ëσ??Σ╕║reloadτÜäresultΘç?σ«Üσ?æσê░user.action, σà╢Σ╗ûresultσêÖµîëτàºconve
ntionΘ╗ÿΦ«ñ.
                                    ^
D:\PersonAction.java:32: warning: unmappable character for encoding Cp1252
        private Page<Person> page = new Page<Person>(15);//µ»?Θí╡5µ?íΦ«░σ╜ò
                                                             ^
D:\PersonAction.java:32: warning: unmappable character for encoding Cp1252
        private Page<Person> page = new Page<Person>(15);//µ»?Θí╡5µ?íΦ«░σ╜ò
                                                                   ^
D:\PersonAction.java:65: warning: unmappable character for encoding Cp1252
                //Φ«╛τ╜«Θ╗ÿΦ«ñµÄÆσ║?µû╣σ╝?
                                   ^
D:\PersonAction.java:65: warning: unmappable character for encoding Cp1252
                //Φ«╛τ╜«Θ╗ÿΦ«ñµÄÆσ║?µû╣σ╝?
                                         ^
D:\PersonAction.java:82: warning: unmappable character for encoding Cp1252
                addActionMessage("Σ┐?σ¡ÿµê?σèƒ");
                                    ^
D:\PersonAction.java:82: warning: unmappable character for encoding Cp1252
                addActionMessage("Σ┐?σ¡ÿµê?σèƒ");
                                          ^
D:\PersonAction.java:90: warning: unmappable character for encoding Cp1252
                        addActionMessage("σêáΘÖñµê?σèƒ");
                                                  ^
D:\PersonAction.java:110: warning: unmappable character for encoding Cp1252
        //-- Θí╡Θ?óσ▒₧µÇºΦ«┐Θù«σç╜µò░ --//
                 ^
D:\PersonAction.java:112: warning: unmappable character for encoding Cp1252
         * listΘí╡Θ?óµÿ╛τñ║τö¿µê╖σêåΘí╡σêùΦí¿.
                   ^
D:\PersonAction.java:1: illegal character: \187
∩╗┐package net.top.app.web.person;
 ^
D:\PersonAction.java:1: illegal character: \191
∩╗┐package net.top.app.web.person;
  ^
2 errors
13 warnings

C:\>

【问题讨论】：

unmappable character for encoding 看起来您在代码中使用了一个无法处理的奇怪外来字符。把那些拿出来。 :)

标签： java

【解决方案1】：

查看 javadoc 的帮助，有编码/字符集的选项

我认为您应该设置-encoding，这是您的源的编码名称。

-编码名称指定源文件的编码名称，例如 EUCJIS/SJIS。如果未指定此选项，则平台默认使用转换器。

-字符集名称指定此文档的 HTML 字符集。该名称应该是 IANA 注册机构中给出的首选 MIME 名称@ http://www.iana.org/assignments/character-sets。例如：
           % javadoc -charset "iso-8859-1" mypackage
         would insert the following line in the head of every generated page:

            <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

         This META tag is described in the HTML standard @
         http://www.w3.org/TR/REC-html40/charset.html#h-5.2.2. (4197265 and 4137321)

      Also see -encoding and -docencoding.

      -docencoding  name
         Specifies the encoding of the generated HTML files. The name should be a preferred MIME name as given in the IANA Registry @
         http://www.iana.org/assignments/character-sets. If you omit this option but use -encoding, then the encoding of the generated
HTML 文件由 -编码。示例：
           % javadoc -docencoding "ISO-8859-1" mypackage

【讨论】：

【解决方案2】：

您的源文件的字符编码似乎与系统的默认编码 (Windows-1252) 不同。

当您调用javadoc 工具并指定正确的编码时，请在命令行上使用-encoding option。（如果您不知道源文件的编码是什么，则必须找出。也许是 UTF-8）。

例如：

javadoc -encoding "UTF-8" ...

【讨论】：

【解决方案3】：

您的编码似乎是错误的（也许您在 cmets 或字符串常量中使用了特殊字符）。你应该看看javadoc command。有一些字符编码参数：

encoding指定输入编码
docencoding指定输出编码
charset 使 javadoc 包含带有编码信息的元标记

【讨论】：