带有泛型的未知 Javadoc 标记 TYPE

问题描述

我有 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>，它有什么问题？

解决方法

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

/**
 * 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.
 */