java - 带有泛型的未知 Javadoc 标记 TYPE

Question

我有javadoc的方法:

/**
 * Supplier interface mixed with {@link ServiceCast}.
 * @param <R> is <TYPE> of supplier.
 */
public interface ServiceCastSupplier<R> extends ServiceCast, Supplier<R> {

}

在管道中我收到错误:

error: unknown tag: TYPE
[ERROR]      * @param <R> is <TYPE> of supplier

r.

为什么它不喜欢 <R> , 怎么了？

Answer 1

理想的解决方案是将文档更改为

/**
 * Supplier interface mixed with {@link ServiceCast}.
 * @param <R> is the type of supplier.
 */

即删除 <TYPE>完全一样，就像标准库一样，除非它对您的代码有重要意义。

如果你真的需要显示尖括号，你可以使用 {@literal}

/**
 * Supplier interface mixed with {@link ServiceCast}.
 * @param <R> is {@literal <TYPE>} of supplier.
 */