问题标签 [doclet]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
188 浏览

java - Doclet:firstSentence 为空

我正在用 Doclets 做一些实验。我正在使用 Java 7 和 Maven。

我的 pom.xml 是:

我的 doclet 是:

我正在尝试使用 doclet 处理的课程是

据我了解“我的酷方法”。应该是第一句话,但在调试中有一个null值,当我在 MyDoclet 中有断点时processMethod()

调试 doclet 时 Eclipse 中的变量视图

我错过了一些想法?

注意:我刚试过

并且没有变化...

0 投票
1 回答
379 浏览

javadoc - 如何添加产品名称和标志?

JDK javadoc中,在所有类上方的左侧面板中,有一个产品名称,例如:

它也在每一页的页眉和页脚中。

  1. 如何在每个页面的javadoc中添加产品名称?

  2. 如何在每个页面的页眉或页脚中添加徽标?

谢谢。

0 投票
0 回答
498 浏览

jax-rs - 有没有办法在 swagger jaxrs doclet 中指定支持的提交方法?

我有休息服务,我需要向我的客户展示。文档由Swagger-jaxrs-doclet完成。它可以按我的意愿工作,但我不想让我的客户通过 API 向我的服务发送请求。原因很简单,我不希望他们弄乱我的后端。Swagger 有设置的可能supportedSubmitMethods。这不是绝对安全,但它是一个开始。有没有办法supportedSubmitMethods为 Swagger-jaxrs-doclet 设置?

0 投票
0 回答
230 浏览

swagger - Swagger jaxrs Doclet 自定义注释不生成输出

我正在使用 teamcarma 提供的非常有用的 swagger-jaxrs-doclet 工具来生成必要的 json 文件,这些文件将馈送到 swagger-ui 前端以记录我的 RESTful 服务。

我遇到的一个问题是 doclet 文档中描述的自定义注释(例如 @bodyType )在文档生成时似乎没有被 doclet 拾取。

以 doclet 文档本身为例,我可能有一个服务端点记录如下:

我希望@inputType注释用于提供身体模型。

不幸的是,注释被完全忽略了。

有没有人在使用 swagger-jaxrs-doclet 时遇到过类似的问题?你是怎么过来的?

0 投票
2 回答
789 浏览

java - 使用 maven-javadoc-plugin 将 jar 添加到 doclet 类路径

我编写了一个 doclet,它收集一些数据并将其传递给记者。我希望这个记者是可以交换的。我尝试使用 AdditionalDependency 和/或 pluginDependency 将报告器实现添加到 doclet 类路径。我无法使用 Java 6 服务加载器加载报告器实现,并且使用 doclets 类加载器或线程上下文类加载器获取类也不起作用。

如何将 test.TestReporterImpl 放入 test-doclet 类路径?

在 doclet 中:

在执行 doclet 的 pom 中

test-doclet-test-reporter/src/main/resources/META-INF/services/test.TestReporter

0 投票
0 回答
457 浏览

android - 更改 Android Studio doclet 版本

我需要为 Android Studio 中的库生成 javadoc。

问题是,当我开始创建文档时,我看到以下日志:

我不知道到底是什么问题。我认为是doclet版本(默认为1.8.0_31);我试图修改它,但我没有成功......有什么帮助吗?

我正在使用 Mac OSX 和 Android Studio 1.2.2

0 投票
1 回答
365 浏览

java - JDK8 更改了 Javadoc 布局

JDK8生成的Javadoc与JDK7生成的Javadoc完全不同。在新的 Javadoc 中,标题文本重叠并且布局完全混乱。在阅读 Oracle 文档后,我了解到 Doclet 是创建 Javadoc html 视图的原因。有没有办法使用与JDK7相关的Doclet来生成Javadoc ..?

0 投票
1 回答
1754 浏览

java - Javadoc 私有方法

我开发了自己的 Doclet 来从 Java 类生成 csv。我需要启动这个关于许多项目的 Doclet,我无法编辑 POM 文件。所以我正在使用终端运行:

我需要为 Private 方法生成文档,所以我尝试添加-Dprivate但这不起作用。

有人知道我能做什么吗?

谢谢,伊万。

0 投票
1 回答
1057 浏览

java-8 - jdk 8 的 Java Doclet API 更改

我是Java的新手。我正在尝试升级到 jdk 1.8,并在执行“gradle test”时发现以下错误:

我提到了http://grepcode.com/file/repository.grepcode.com/java/root/jdk/openjdk/8-b132/com/sun/tools/doclets/formats/html/SubWriterHolderWriter.java/

http://grepcode.com/file/repository.grepcode.com/java/root/jdk/openjdk/7u40-b43/com/sun/tools/doclets/formats/html/SubWriterHolderWriter.java/

(我们的代码导入这个:import com.sun.tools.doclets.formats.html.SubWriterHolderWriter;)

发现h2()、printHyperLink()、hr()、table()、tableHeaderStart()、tableHeaderEnd()、tableEnd()、pre()、strong()、preEnd()、ul()等很多api, print()、li()、ulEnd()、printHtmlHeader()、center()、today()、printTop()、navLinks()、printBottom() 和 printBodyHtmlEnd() 已被移除。

有没有一种快速的解决方法可以让我们绕过符号错误?或者我们应该用现有的 API 替换缺失的 API。对我来说,这看起来像是很多工作——成为一名参赛者。有没有关于如何做到这一点的现有例子?我在互联网上搜索了很多,但找不到任何有用的东西。

CustomWriter.java 中的代码用于使用自定义 System Test 标记输出 Javadoc 页面。任何帮助表示赞赏 - 我们时间紧迫。

0 投票
2 回答
2881 浏览

android - 当内部类依赖于 R.java 时,Gradle 在 Android Javadocs 中排除 R.java

我正在为 API 构建 JavaDoc,其中 API 中的类依赖于 R.java。我想构建 Javadoc 没有引用丢失的 R.java 文件的符号错误,即使我设置failOnError false构建成功但我们的 Jenkins 作业将在成功构建中发生错误时将构建报告为失败。下面的任务将成功创建 javadocs,但会在构建期间报告与未找到 R.java 相关的错误。

我尝试过的一些事情:

  • 硬编码生成的 R.java 文件的路径并添加到类路径中。

classpath += project.files(android.sourceSets.main.java.srcDirs, variant.javaCompile.classpath.files, android.bootClasspath, ext.R)

这成功地消除了错误,因此构建成功,但生成的 javadoc 在 javadoc 中有指向 R.*.class 的空链接。

  • 从排除列表中删除该exclude '**/R.java'行,同时在类路径中不包括 R.java 的路径。

这成功地消除了错误并且构建成功,但生成的 javadoc 具有指向 R.*.class 文件的链接。

似乎该exclude语句从类路径中排除,而不是从 javadoc 中排除。任何有关如何生成类依赖于 R.java 但在 javadoc 输出中不包含 R.java 的 javadoc 的见解将不胜感激。