`
lee5593
  • 浏览: 57792 次
社区版块
存档分类
最新评论

奇怪的枚举类型 Javadoc 文档生成问题

阅读更多
最近使用maven2生成javadoc时遇到java中的枚举类型报错的问题,请教是否有人遇到过此类问题?

java源代码如下:
/**
 * 业务操作状态注解,默认为无效选项
 *
 * @author Lee
 */
public enum State {
	/**
	 * 无效
	 */
	INVALID,
	
	/**
	 * 有效
	 */
	VALID
}


错误代码如下:
State.java:8: 警告 - @param 参数 "指定要返回的枚举常量的名称。" 不是参数名称。
java.util.MissingResourceException: Can't find resource for bundle com.sun.tools
.doclets.formats.html.resources.standard, key doclet.malformed_html_link_tag
        at java.util.ResourceBundle.getObject(ResourceBundle.java:325)
        at java.util.ResourceBundle.getObject(ResourceBundle.java:322)
        at java.util.ResourceBundle.getString(ResourceBundle.java:285)
        at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(
MessageRetriever.java:114)
        at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(
MessageRetriever.java:92)
        at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(
MessageRetriever.java:81)
        at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.warning(
MessageRetriever.java:290)
        at com.sun.tools.doclets.formats.html.HtmlDocletWriter.redirectRelativeL
inks(HtmlDocletWriter.java:1526)
        at com.sun.tools.doclets.formats.html.HtmlDocletWriter.commentTagsToStri
ng(HtmlDocletWriter.java:1438)
        at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printCommentTags(
HtmlDocletWriter.java:1397)
        at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComme
nt(HtmlDocletWriter.java:1370)
        at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComme
nt(HtmlDocletWriter.java:1366)
        at com.sun.tools.doclets.formats.html.AbstractIndexWriter.printComment(A
bstractIndexWriter.java:192)
        at com.sun.tools.doclets.formats.html.AbstractIndexWriter.printDescripti
on(AbstractIndexWriter.java:126)
        at com.sun.tools.doclets.formats.html.AbstractIndexWriter.generateConten
ts(AbstractIndexWriter.java:91)
        at com.sun.tools.doclets.formats.html.SingleIndexWriter.generateIndexFil
e(SingleIndexWriter.java:76)
        at com.sun.tools.doclets.formats.html.SingleIndexWriter.generate(SingleI
ndexWriter.java:52)
        at com.sun.tools.doclets.formats.html.HtmlDoclet.generateOtherFiles(Html
Doclet.java:103)
        at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration
(AbstractDoclet.java:122)
        at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractD
oclet.java:64)
        at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:4
2)
        at com.sun.tools.doclets.standard.Standard.start(Standard.java:23)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.
java:39)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAcces
sorImpl.java:25)
        at java.lang.reflect.Method.invoke(Method.java:585)
        at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269)
        at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143)
        at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340)
        at com.sun.tools.javadoc.Start.begin(Start.java:128)
        at com.sun.tools.javadoc.Main.execute(Main.java:41)
        at com.sun.tools.javadoc.Main.main(Main.java:31)

Command line was:"D:\Program Files\Java\jdk1.5.0_09\jre\..\bin\javadoc.exe" @opt
ions @packages
分享到:
评论

相关推荐

    JDK18-javadoc-guide.pdf

    JavaDoc 是一款文档生成工具,用于生成 Java 类、接口、枚举、注释、字段、方法、构造函数等元素的文档。JavaDoc 能够自动提取 Java 源代码中的注释信息,生成 HTML 格式的文档,以便于开发者快速了解和理解 Java ...

    JavaDoc(1.8中文版)

    6. **枚举(Enums)**:Java 1.5引入了枚举类型,JavaDoc也会涵盖枚举的详细信息,包括枚举常量和相关的方法。 7. **包(Packages)**:Java程序通常按包组织,JavaDoc会呈现整个包的结构和其中包含的所有类和接口...

    jsoup-1.11.2-javadoc.rar

    Javadoc是一种工具,用于生成关于Java源代码的文档,包括类、接口、方法等的详细描述。这个索引可能包含了关于JSoup中所有类、接口、枚举和注解的信息,便于开发者在使用过程中快速查找和理解相关类型。 **使用示例...

    jfreechart-1.0.19-javadoc.zip

    总结,JFreeChart 1.0.19的Javadoc文档是学习和使用该库的重要资源,它详尽地解释了API的各个方面,使得开发者能够轻松地利用JFreeChart创建出专业且美观的数据图表。通过深入研究这些文档,开发者可以更好地掌握...

    用doxygen+graphviz自动化生成代码文档

    Doxygen是一款流行的开源文档生成工具,专门用于为C++、C、Java、Python等编程语言生成文档。它通过解析源代码中的注释来提取相关信息,包括类结构、函数、变量、枚举等,然后自动生成易于阅读的HTML、PDF或CHM格式...

    javadoc 标签, 文档注释

    12. **`@value`**:这个标签用于显示常量的值,通常用于枚举类型或常量字段的文档中。 13. **`@version`**:这个标签用于记录类的版本信息,帮助跟踪代码的更新历史。 使用这些JavaDoc标签可以极大地提高代码的...

    tracker-javadoc.zip

    4. **枚举和常量**:如果"tracker"模块包含枚举类型,Javadoc会列出它们的值和描述,常量也会有相应的说明。 5. **包结构**:文档将展示类和接口所属的包,这有助于理解它们在项目中的组织方式和依赖关系。 6. **...

    rabbitmq-javadoc

    4. **枚举和异常**:RabbitMQ Java 客户端中可能包含一些枚举类型,如 `DeliveryMode`,表示消息的持久化级别,以及自定义的异常类,如 `IOException` 的子类,用于处理与网络或数据传输相关的错误。 5. **示例代码...

    BPS6 API JavaDoc开发指南 ,介绍EOS6的相关文档,欢迎下载!

    4. **枚举和常量**:列出所有的枚举类型和常量,说明它们的用途和值。 5. **注释和示例**:开发者可以找到丰富的代码示例,以便快速上手和理解API的实际运用。 **四、使用BPS6 API** 要使用BPS6 API,开发者需要...

    j-ftp-1.53-javadoc api 中文版

    Javadoc是Java开发中的一个重要工具,它生成了API文档,使得开发者能够快速了解类、接口、方法等的使用方式、参数说明和返回值等信息。对于J-FTP 1.53的中文版Javadoc,开发者可以更方便地理解这个库的每个组件,...

    JavaDoc_0_9.wdgt.zip_JavaDoc_0_9.wdgt_doc

    生成的文档通常包括类、接口、构造函数、方法、枚举等的详细说明,以及它们之间的关系图。 在"JavaDoc.wdgt"这个文件中,我们可能找到关于如何使用这个早期版本的JavaDoc的详细信息,如命令行选项、配置设置、...

    javadoc5.0

    JavaDoc是Java编程语言中一个极其重要的工具,用于生成关于Java源代码的API文档。它通过解析源代码中的注释,将这些注释转化为结构化的HTML文档,方便开发者理解和使用API。在Java开发中,良好的文档是项目可维护性...

    jdk6_api_javadoc

    其中,Javadoc是Java语言的官方文档生成工具,它能够自动生成关于Java源代码的详细文档,方便开发者理解和使用API。 JDK6的API包含了一系列核心类库,这些类库提供了丰富的功能,如集合框架、输入/输出处理、网络...

    hibernate javadoc 4.2.1

    Javadoc是Java编程语言中的一个工具,用于生成关于类、接口、方法等的API文档。`hibernate javadoc 4.2.1`是Hibernate 4.2.1版本的API文档,提供了详细的英文说明,帮助开发者理解和使用该版本的Hibernate框架。 在...

    json-lib-2.1-jdk15-javadoc.zip

    1. **stylesheet.css**:这是样式表文件,定义了Javadoc文档的样式和布局,使文档更易读。 2. **index-all.html**:这个文件包含了整个API的索引,用户可以通过这个文件快速查找和跳转到具体的类、接口或方法。 3....

    MyEclipse自动生成注释文档

    - Javadoc注释还可以自动生成API文档,方便外部开发者使用你的库或框架。 5. **最佳实践**: - 注释应清晰简洁,提供必要但不过度的信息。例如,解释方法的目的、参数和返回值,而不是简单地复述代码。 - 保持...

    alkacon-diff-0.9.2-javadoc.jar.zip

    在"alkacon-diff-0.9.2-javadoc.jar.zip"这个压缩包中,包含了Alkacon Diff 0.9.2 的Javadoc文档,这些文档通常包含以下内容: 1. **类概览**:列出项目中的所有类,包括类的继承关系和实现的接口。 2. **包概览**...

    java编码注释和doc自动生成

    要自动生成Javadoc文档,你需要Javadoc工具。在命令行中,你可以指定`-encoding utf-8`来确保输出文件使用UTF-8编码,并通过`-charset utf-8`设置源文件的字符集。例如,为当前目录下的所有.java文件生成文档,可以...

    JavadocExample_java_

    这些示例可能包括如何为类、接口、构造函数、方法、枚举以及变量添加注释,以生成详尽的API文档。 1. **Javadoc的基本结构** Javadoc注释可以包含多行文本,支持HTML标签,使得可以在注释中添加格式化文本、链接和...

    jdk17中文说明文档

    7. **开发工具:** Javadoc用于生成API文档,Javac是Java编译器,JConsole用于监视JVM性能,JProfiler进行深入性能分析等。 8. **新特性实验(JEPs):** JDK 17可能包含一些实验性的Java增强提案(JEPs),例如新...

Global site tag (gtag.js) - Google Analytics