qihuiyong6
- 浏览: 39428 次
- 性别:
- 来自: 北京
-
最新评论
今天试着做了一下使用maven生成doc文档，这个功能开始还是觉得很简单的以为自己几小时内能搞定，但是遇到了一个诡异的问题花了我将近多半天时间才解决。在这里记录一下方便遇到同类问题的人参考。
操作步骤
使用maven生成doc 正常情况下还是很简单的在pom里面配置一个javadoc的插件，然后可以在指定的maven寿命周期上绑定插件的配置如下：
开始的错误日志：
解决方法：
这个问题是由于java环境变量配置造成的，我开始是.;%javahome%\jre\lib\tools.jar;%javahome%\jre\lib\dt.jar
后来改为：.;D:\devtools\Java\jdk1.6.0_39\lib\tools.jar;D:\devtools\Java\jdk1.6.0_39\jre\lib\rt.jar
后来重启电脑，才好的；不重启还是不行，另一个项目还有点问题，大概可以确定是环境的问题。大家不要像我一样在pom配置上找了半天。
操作步骤
使用maven生成doc 正常情况下还是很简单的在pom里面配置一个javadoc的插件，然后可以在指定的maven寿命周期上绑定插件的配置如下：
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.qhy.demo</groupId> <artifactId>DocGen</artifactId> <version>0.0.1-SNAPSHOT</version> <name>sss</name> <description>ddddd</description> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.10.3</version> <executions> <execution> <id>attach-javadoc</id> <phase>package</phase> <goals> <goal>jar</goal> </goals> </execution> </executions> <configuration> <show>public</show> <charset>UTF-8</charset> <encoding>UTF-8</encoding> <docencoding>UTF-8</docencoding> <excludePackageNames>com.alibaba.com.*</excludePackageNames> <links> <link>http://docs.oracle.com/javase/6/docs/api</link> </links> </configuration> </plugin> </plugins> </build> </project>
开始的错误日志：
[INFO] --- maven-jar-plugin:2.3.2:jar (default-jar) @ DocGen --- [INFO] Building jar: E:\work\workspace_dubbo\DocGen\target\DocGen-0.0.1-SNAPSHOT.jar [INFO] [INFO] --- maven-javadoc-plugin:2.10.3:jar (attach-javadoc) @ DocGen --- [INFO] 正在装入软件包 com.qhy.gen 的源文件... 正在构造 Javadoc 信息... 标准 Doclet 版本 1.6.0_39 正在构建所有软件包和类的树... 正在生成 E:/work/workspace_dubbo/DocGen/target/apidocs\com/qhy/gen/\Test.html... [INFO] ------------------------------------------------------------------------ [INFO] BUILD FAILURE [INFO] ------------------------------------------------------------------------ [INFO] Total time: 7.850s [INFO] Finished at: Fri Jun 03 15:16:57 CST 2016 [INFO] Final Memory: 18M/157M [INFO] ------------------------------------------------------------------------ [ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.3:jar (attach-javadoc) on project DocGen: MavenReportException: Error while generating Javadoc: [ERROR] Exit code: 1 - java.lang.IllegalArgumentException [ERROR] at sun.net.www.ParseUtil.decode(ParseUtil.java:189) [ERROR] at sun.misc.URLClassPath$FileLoader.<init>(URLClassPath.java:958) [ERROR] at sun.misc.URLClassPath$3.run(URLClassPath.java:328) [ERROR] at java.security.AccessController.doPrivileged(Native Method) [ERROR] at sun.misc.URLClassPath.getLoader(URLClassPath.java:322) [ERROR] at sun.misc.URLClassPath.getLoader(URLClassPath.java:299) [ERROR] at sun.misc.URLClassPath.findResource(URLClassPath.java:145) [ERROR] at java.net.URLClassLoader$2.run(URLClassLoader.java:385) [ERROR] at java.security.AccessController.doPrivileged(Native Method) [ERROR] at java.net.URLClassLoader.findResource(URLClassLoader.java:382) [ERROR] at java.lang.ClassLoader.getResource(ClassLoader.java:1002) [ERROR] at java.lang.ClassLoader.getResourceAsStream(ClassLoader.java:1192) [ERROR] at javax.xml.parsers.SecuritySupport$4.run(SecuritySupport.java:96) [ERROR] at java.security.AccessController.doPrivileged(Native Method) [ERROR] at javax.xml.parsers.SecuritySupport.getResourceAsStream(SecuritySupport.java:89) [ERROR] at javax.xml.parsers.FactoryFinder.findJarServiceProvider(FactoryFinder.java:250) [ERROR] at javax.xml.parsers.FactoryFinder.find(FactoryFinder.java:223) [ERROR] at javax.xml.parsers.SAXParserFactory.newInstance(SAXParserFactory.java:128) [ERROR] at com.sun.tools.doclets.internal.toolkit.builders.LayoutParser.parseXML(LayoutParser.java:72) [ERROR] at com.sun.tools.doclets.internal.toolkit.builders.ClassBuilder.build(ClassBuilder.java:108) [ERROR] at com.sun.tools.doclets.formats.html.HtmlDoclet.generateClassFiles(HtmlDoclet.java:155) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.generateClassFiles(AbstractDoclet.java:164) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:106) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64) [ERROR] at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42) [ERROR] at com.sun.tools.doclets.standard.Standard.start(Standard.java:23) [ERROR] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) [ERROR] at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) [ERROR] at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) [ERROR] at java.lang.reflect.Method.invoke(Method.java:597) [ERROR] at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269) [ERROR] at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143) [ERROR] at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340) [ERROR] at com.sun.tools.javadoc.Start.begin(Start.java:128) [ERROR] at com.sun.tools.javadoc.Main.execute(Main.java:41) [ERROR] at com.sun.tools.javadoc.Main.main(Main.java:31) [ERROR] com.sun.tools.doclets.internal.toolkit.util.DocletAbortException [ERROR] at com.sun.tools.doclets.internal.toolkit.builders.LayoutParser.parseXML(LayoutParser.java:79) [ERROR] at com.sun.tools.doclets.internal.toolkit.builders.ClassBuilder.build(ClassBuilder.java:108) [ERROR] at com.sun.tools.doclets.formats.html.HtmlDoclet.generateClassFiles(HtmlDoclet.java:155) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.generateClassFiles(AbstractDoclet.java:164) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:106) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64) [ERROR] at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42) [ERROR] at com.sun.tools.doclets.standard.Standard.start(Standard.java:23) [ERROR] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) [ERROR] at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) [ERROR] at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) [ERROR] at java.lang.reflect.Method.invoke(Method.java:597) [ERROR] at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269) [ERROR] at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143) [ERROR] at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340) [ERROR] at com.sun.tools.javadoc.Start.begin(Start.java:128) [ERROR] at com.sun.tools.javadoc.Main.execute(Main.java:41) [ERROR] at com.sun.tools.javadoc.Main.main(Main.java:31) [ERROR] com.sun.tools.doclets.internal.toolkit.util.DocletAbortException [ERROR] at com.sun.tools.doclets.formats.html.HtmlDoclet.generateClassFiles(HtmlDoclet.java:159) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.generateClassFiles(AbstractDoclet.java:164) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:106) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64) [ERROR] at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42) [ERROR] at com.sun.tools.doclets.standard.Standard.start(Standard.java:23) [ERROR] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) [ERROR] at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) [ERROR] at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) [ERROR] at java.lang.reflect.Method.invoke(Method.java:597) [ERROR] at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269) [ERROR] at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143) [ERROR] at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340) [ERROR] at com.sun.tools.javadoc.Start.begin(Start.java:128) [ERROR] at com.sun.tools.javadoc.Main.execute(Main.java:41) [ERROR] at com.sun.tools.javadoc.Main.main(Main.java:31) [ERROR] [ERROR] Command line was: D:\devtools\Java\jdk1.6.0_39\jre\..\bin\javadoc.exe @options @packages [ERROR] [ERROR] Refer to the generated Javadoc files in 'E:\work\workspace_dubbo\DocGen\target\apidocs' dir. [ERROR] -> [Help 1] [ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch. [ERROR] Re-run Maven using the -X switch to enable full debug logging. [ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles: [ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException D:\devtools\Java\jdk1.6.0_39\lib\tools.jar;D:\devtools\Java\jdk1.6.0_39\jre\lib\rt.jar
解决方法：
这个问题是由于java环境变量配置造成的，我开始是.;%javahome%\jre\lib\tools.jar;%javahome%\jre\lib\dt.jar
后来改为：.;D:\devtools\Java\jdk1.6.0_39\lib\tools.jar;D:\devtools\Java\jdk1.6.0_39\jre\lib\rt.jar
后来重启电脑，才好的；不重启还是不行，另一个项目还有点问题，大概可以确定是环境的问题。大家不要像我一样在pom配置上找了半天。
分享到：
发表评论
-
springMVC返回json数据时报406错误
2017-02-03 10:32 1196问题描述 初步搭建起springmvc时候使用@respon ... -
duubo服务端无错客户端报错
2016-10-20 10:57 429问题现象： dubbo消费端调用服务端的时候，服务端没有错误日 ... -
Windows 安装SCALA后cmd识别不到环境变量
2016-02-01 10:24 3540今天安装了一下scala2.8.1final版本，安装完毕以后 ... -
mysql timestamp 类型字段自动更新时间
2016-09-08 14:37 1346以下两个建表语句的效果是一样的： 以下是代码片段： C ... -
GBase报错INSERT comand denied to user
2015-11-25 10:25 790错误代码： INSERT comand denied to ... -
FtpClient下载zip压缩包之后不能正确解压
2015-11-25 10:10 3606在实施过程中发现java类库FTPClient下载的zip解压 ... -
Maven在linux编译问题
2015-11-05 15:27 1857工作中在linux上Maven打包代码遇到一些问题这里记录一下 ... -
安装好hadoop集群后上传文件出错
2014-12-04 13:04 1812错误日志如下： Java HotSpot(TM) Clie ... -
嵌入iframe页面中使用My97DatePicker问题解决
2014-10-11 10:41 2218现象： 在iframe嵌套的页面点击日历控件年、月部分手动输入 ... -
iframe会导致Jquery入口代码执行延时较长
2014-05-06 22:03 524问题描述： 信息时变慢，经过排查发现是浏览器解析完HTM ... -
ActiveMQ 5.8 启动报错
2014-04-24 14:43 2419最近用了一下ActiveMQ做JMS通信使用，在lin ...
相关推荐
Javadoc帮助文档的生成，并备注了代码，可以参考注释的书写格式。
Eclipse中自动生成Javadoc的方法，以及一些标签的含义
对于Javadoc的自动生成网住文档的具体使用方法
使用Eclipse生成javadoc文档的方法
使用Javadoc生成Java API文档的方法
这一段时间在研究Javadoc的问题，前面发布的Javadoc转换chm帮助文档的四种方法总结，总结了如何实现Javadoc到chm的转换，希望给大家带来了一些方便，今天我们来说说如何利用Eclipse生成个性化的Javadoc 文档，也希望...
JavaDoc生成API文档（powernode document）（内含源代码和导出的文档） 1.1 JavaDoc概述 1.2 文档注释的格式 1.3 IDEA生成API文档 vaDoc是Java自带的一种工具，其可以从程序源代码中抽取类、方法、属性等注释形成一...
JavaDoc生成API文档（powernode CD2207）(内含教学视频+源代码) 1.1 JavaDoc概述 1.2 文档注释的格式 1.3 IDEA生成API文档 JavaDoc是Java自带的一种工具，其可以从程序源代码中抽取类、方法、属性等注释形成一个和源...
Javadoc的详细文档以及生成的方式（AndroidStudio、Eclipse、Javadoc命令）
能够使用Javadoc生成OpenAPI规范的文档 要使用此功能，请确保在您的spring上下文中找到了JavadocPluginConfiguration ，并将javadoc doclet的执行添加到您的构建过程中。 Maven的例子： < groupId>org.apache....
javadoc2markdown 将 javadoc 代码文档转换为 Markdown wiki 页面这个小型命令行应用程序将源文件或头文件中的 javadoc 条目转换为 wiki markdown。 它将源/头文件作为唯一的命令行参数。 结果降价是从标准输出发出...
Maven插件，用于从JAX-RS和Javadoc注释生成Swagger 这个Maven插件正在为基于JAX-RS的Java服务器生成Swagger API文档。 JAX-RS批注中未包含的其他信息放置在Javadoc注释中。 例 此处提供了一个使用javadoc2swagger-...
jd2chm 工具 快速生成javadoc 所需要的chm 文档工具 对于开发人员来说 挺有用的 特此share 一下哈
用javadoc命令生成api帮助文档，如果要学习的话，少了帮助文档哪能行，于是就用javadoc命令自己制作了一个。
1.解放双手手动写Word文档,自动生成javadoc文档--CHM帮助文档 2.具体可以查看我博客关于javadoc的那些小技巧和你需要知道的地方>>
Eclipse中设置javadoc中文帮助文档的方法 适合初学者
欢迎下载浏览
Eclipse生成javadoc文档，让你更清楚的了解项目结构
生成Javadoc的具体做法，好多时候需要生成API,却不知道是怎么一回事
使用Javadoc生成word版本文档，多用于详细设计文档。 测试项目代码： 参数说明 ***********************Javadoc生成器************************* * -source 某个java源文件或包名，可空 * * -sourcepath src/main/...