- Java 双重比较
- java - 比较器与 Apache BeanComparator
- Objective-C 完成 block 导致额外的方法调用?
- database - RESTful URI 是否应该公开数据库主键?
我正在处理一个项目的 javadoc,修复 Javadoc 显示的所有错误和警告。但是在修复了大部分之后,由于某种我无法想象的原因,只有这个被显示.
4 warnings
[WARNING] Javadoc Warnings
[WARNING] C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\src\main\java\com\globalmentor\marmot\MarmotSession.java:100: warning - Tag @see: can't find getResourceKit(Repository, URFResource, Capability...) in com.globalmentor.marmot.MarmotSession
[WARNING] C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\src\main\java\com\globalmentor\marmot\MarmotSession.java:140: warning - Tag @see: can't find getResourceKit(Repository, URFResource, Capability...) in com.globalmentor.marmot.MarmotSession
[WARNING] C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\src\main\java\com\globalmentor\marmot\MarmotSession.java:166: warning - Tag @link: can't find getResourceKit(Repository, URFResource, Capability...) in com.globalmentor.marmot.MarmotSession
[WARNING] C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\src\main\java\com\globalmentor\marmot\MarmotSession.java:140: warning - Tag @link: can't find getResourceKit(Repository, URFResource, Capability...) in com.globalmentor.marmot.MarmotSession
[INFO] Building jar: C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\target\marmot-0.5.1-SNAPSHOT-javadoc.jar
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 33.921 s
[INFO] Finished at: 2016-10-21T10:03:11-02:00
[INFO] Final Memory: 29M/412M
[INFO] ------------------------------------------------------------------------
问题是:这些引用与方法在同一个类中,甚至 Eclipse 在我开始编写引用时都建议它们,有人知道任何其他可以给我这个警告的东西吗?
这是显示警告的 javadoc:
/**
* Determines if there exists resource kit appropriate for the given resource supporting the given capabilities.
* @param repository The repository in which the resource resides.
* @param resource The resource for which a resource kit should be returned.
* @param capabilities The capabilities required for the resource kit.
* @return <code>true</code> if there exists a resource kit to handle the given resource with the given capabilities, if any, in relation to the resource.
* @see #getResourceKit(Repository, URFResource, Capability...)
*/
public boolean hasResourceKit(final Repository repository, final URFResource resource, final Capability... capabilities);
/**
* Retrieves a resource kit appropriate for the given resource statically if possible, without further resource lookup. This method locates a resource kit in
* the following priority:
* <p>
* The first resource kit supporting the resource content type determined by:
* </p>
* <ol>
* <li>The given content type, if any.</li>
* <li>The content determined if possible by {@link #getExtensionContentType(String)} from the resource URI extension.</li>
* <li>The resource description is retrieved as a last resort and the resource kit is determined by delegating to
* {@link #getResourceKit(Repository, URFResource, Capability...)}.</li>
* </ol>
* @param repository The repository in which the resource resides.
* @param resourceURI The URI of the resource in the given repository.
* @param contentType The type of content the resource contains, or <code>null</code> if unknown.
* @param capabilities The capabilities required for the resource kit.
* @return A resource kit to handle the given resource with the given capabilities, if any, in relation to the resource; or <code>null</code> if there is no
* registered resource kit with the given capabilities in relation to the resource.
* @throws ResourceIOException if an error occurred retrieving a description of the resource kit.
* @see #getResourceKit(Repository, URFResource, Capability...)
*/
public RK getResourceKit(final Repository repository, final URI resourceURI, final ContentType contentType, final Capability... capabilities)
throws ResourceIOException;
/**
* Retrieves a resource kit appropriate for a MIME content type. This method should only be used for special-purpose functionality; when accessing resources
* {@link #getResourceKit(Repository, URFResource, Capability...)} should normally be used instead.
* @param contentType The type of content the resource contains.
* @param capabilities The capabilities required for the resource kit.
* @return A resource kit with the requested capabilities to handle the given content type, or <code>null</code> if no appropriate resource kit is registered.
*/
public RK getResourceKit(final ContentType contentType, final Capability... capabilities);
这是在上面的 javadoc 中引用的方法,它来自同一个类:
/**
* Retrieves a resource kit appropriate for the given resource. This method locates a resource kit in the following priority:
* <ol>
* <li>The first resource kit supporting the resource content type determined by {@link #determineContentType(URFResource)}.</li>
* <li>The first resource kit supporting one of the resource types.</li>
* <li>If the resource has a collection URI, the default collection resource kit.</li>
* <li>The default resource kit.</li>
* </ol>
* @param repository The repository in which the resource resides.
* @param resource The resource for which a resource kit should be returned.
* @param capabilities The capabilities required for the resource kit.
* @return A resource kit to handle the given resource with the given capabilities, if any, in relation to the resource; or <code>null</code> if there is no
* registered resource kit with the given capabilities in relation to the resource.
* @see #determineContentType(URFResource)
*/
public RK getResourceKit(final Repository repository, final URFResource resource, final Capability... capabilities);
由于该项目是公开的,这里是我为修复 javadoc 所做的工作的拉取请求的链接:Bitbucket - Globalmentor's Project: MARMOT-5
最佳答案
你的问题实际上与 Capability
是一个static inner class 有关,在带有内部类的 javadoc 工具中有很多已知问题,可以解决这个问题你应该用它的外部类作为前缀,在你的例子中是ResourceKit
。
所以简单地替换这个
@see #getResourceKit(Repository, URFResource, Capability...)
有了这个
@see #getResourceKit(Repository, URFResource, ResourceKit.Capability...)
还有这个
{@link #getResourceKit(Repository, URFResource, Capability...)}
有了这个
{@link #getResourceKit(Repository, URFResource, ResourceKit.Capability...)}
关于生成包时显示 Javadoc 警告,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/40176550/
通过终端,您可以使用命令 - “SetFile -a B 文件名” 以编程方式,我认为我应该通过[[NSFileManager defaultManager] createDirectoryAtPat
嗨,正在尝试书中的一些示例:Practical Graph mining with R对于子图挖掘: library(subgraphMining) library(igraph) graph1 =
代码中的相同问题: class Foo { int getIntProperty () { ... } CustomObject getObjectProperty () { ... }
所以这可能是一个愚蠢的问题,但它已经困扰我一段时间了。 使用 React,我创建了两个组件(Buttons.js 和 Message.js),每个组件都有一个导出。但是,现在我希望将这两个组件用作 n
从今天早上开始,我发现我无法再从某个范围安装任何 NPM 包(或任何具有依赖项的包)。例如,如果我输入 npm i webpack 我会收到以下错误... npm ERR! code E401 npm
我在这里搜索过,Angular 2, @ngtools/webpack, AOT ,但对我不起作用。我运行了 npm install 命令。我正在做的是创建一个新的 Angular 2 项目。当我运行
情况: 我有一个 Swift 包,将其命名为 lib。 lib 位于其自己的存储库中。在lib的仓库中,有一堆本地包;也就是说,这些包是在 lib 中定义的,使用本地路径依赖格式 .package(p
我想在工作中学习和使用nodejs,但是在使用 de npm 命令安装模块/包时遇到网络问题。我是否可以使用我的家用计算机构建完整的 Node js 包,然后将其安装在另一台计算机(我的工作场所计算机
我需要将一些 .tar.bz2 格式的非 Python 包转换为 Anaconda/miniConda .egg 文件并安装它们。为此,我需要一个适用于 Windows 的 bld.bat 文件。互联
我需要共享库文件 libthrift-0.9.3.so 作为其他包的依赖项。我在构建 thrift-0.9.3 包时看到编译问题(我确实从 https://thrift.apache.org/down
我尝试在 R 版本 3.5.0 中安装“arcgisbinding”包。但是我失败了,得到以下错误和警告。 Installing package into ‘C:/Users/Lenovo/Docum
我尝试在 R 版本 3.5.0 中安装“arcgisbinding”包。但是我失败了,得到以下错误和警告。 Installing package into ‘C:/Users/Lenovo/Docum
我试图在 flutter 中测试这个应用程序,但我无法运行该应用程序,因为出现此错误“名称‘Page’在库‘package:burn_off/widgets/page.dart’和‘package’中
试图理解和学习如何编写包...用我一直使用的东西进行测试,记录... 您能帮我理解为什么“日志”变量不起作用...并且屏幕上没有日志记录吗? 谢谢! 主要文件: #!/opt/local/bin/py
我尝试运行此使用 Google 云的代码。 import signal import sys from google.cloud import language, exceptions # creat
我想知道是否有人找到了一个很好的 R 包来分析眼动追踪数据? 我遇到了 eyetrackR,但据我所知,没有可用的英文支持文档: http://read.psych.uni-potsdam.de/pm
我正在 R 上制作一个包。我有两个函数共享一个变量(全局)。 如何将其导入到包中? 例如, m<-0 f<-function() { m <- m+1 } g<-function() { m <- m
我用 C 为 Lua 编写了很多模块。每个模块都包含一个 Lua 用户数据类型,我像这样加载和使用它们: A = require("A") B = require("B") a = A.new(3,{
我正在尝试在 R 中的 Ubuntu 上安装 xlsx 包,以便使用允许在 R 中插入链接然后将它们导出到 Excel 的功能。 话虽如此,我根本无法安装该软件包。 显然它必须与 rJava 一起使用
我想在 Haskell 中做一些蒙特卡洛分析。我希望能够编写这样的代码: do n <- poisson lambda xs <- replicateM n $ normal mu sigma
我是一名优秀的程序员,十分优秀!