将方法标记为永远不应使用

Question

我想知道在Java中是否有一些好方法可以表明永远不要调用某些方法？ 我在考虑是否要与更大的团队合作，并告诉大家永远不要调用此方法，因此请不要尝试对其进行测试。 断言是个好主意吗？

上下文：我在Java中使用ReactiveX，并且我的Observable永远不会停止，它只能调用onError和onNext，但是永远不会调用onCompleted，但是我的Observer扩展了Subscriber，因此我需要@Override onCompleted。

Answer 1

@Deprecated是最接近的标准操作，在许多类似情况下，抛出UnsupportedOperationException是合理的操作。

还要注意，由于多态性，调用者可能直到运行时才知道他们正在调用的Observer的具体类型，因此没有注释可以提供帮助。

但是，在您描述的情况下，我认为您应该编写一个空的onCompleted()和一个仅断言它不会引发异常的测试。 尽管您已经确定Observable永远不会停止产生，但是如果有一天抛出异常，似乎是不合理的。

Answer 2

如果您不希望其他人调用该方法，请在适当的Java文档中使用@Deprecated批注。
请注意，尽管调用者仍然可以调用该方法，但这仅是对调用者的指示。