如何在Java中将方法标记为不鼓励的？[关闭]

Question

第一个函数只是从映射中读取并返回值（可以是null或无效），而第二个函数将该值转换为LogLevel，并在没有给出有效值时返回默认值。

因此，我不想让程序员使用泛型的get()，但是在特殊情况下，这个方法很有用，所以我不能仅仅保护它。现在我使用@deprecated，但我认为这不是一个好的解决方案，因为它只是用于将来要删除的方法。（如果我错了，请纠正我，这就是SonarLint告诉我的@deprecated注释）

/**
 * @Deprecated When possible, use the key-specific getter instead
 */
public String get(String key) {
    return values.get(key);
}

public int getLogLevel() {
    return Log.getLogLevel(values.get(LOG_LEVEL), Log.getLogLevel(defaultValues.get(LOG_LEVEL)));
}

Answer 1

如果@deprecated不是解决方案，那么只有一个选项。在javadocs中输入一条消息，说明“不鼓励”使用（特殊情况除外）...并希望人们能够阅读javadocs。

定义您自己的自定义注释不会有帮助，因为您无法让您的用户使用能够识别它的注释处理器。

同样，您也不能通过FindBugs、PMD、Sonar等的自定义规则来实现，因为这需要您的用户自定义这些产品的安装。