Метод Mark as никогда не должен использоваться

Question

Я хотел бы знать, есть ли какой-нибудь хороший способ в java, чтобы показать, что какой-либо метод никогда не должен вызываться? Я думаю на случай, что я работаю с более крупной командой и расскажу ребятам, что этот метод никогда не будет вызван, поэтому не пытайтесь его протестировать. Может быть, утверждение - хорошая идея?

Контекст: я использую ReactiveX в java, и мой Observable никогда не будет остановлен, он может вызывать только onError и onNext, но onCompleted никогда не будет вызываться, но мой Observer расширяет подписчик, поэтому мне нужно @Override onCompleted.

Answer 1

Если вы не хотите, чтобы другие вызывали метод, используйте аннотацию @Deprecated с соответствующим документом java.
Обратите внимание, что это просто указание вызывающему, хотя они все равно могут вызвать метод.

Answer 2

@Deprecated - самая близкая стандартная вещь, и бросать UnsupportedOperationException - это разумная вещь, которую можно сделать во многих подобных случаях.

Обратите также внимание, что из-за полиморфизма вызывающий может не знать конкретного типа Observer, который они вызывают до выполнения, поэтому никакая аннотация не может помочь.

Однако, в случае, о котором вы описали, я думаю, что вы должны написать пустую реализацию onCompleted() и тест, который просто утверждает, что он не генерирует исключение. Несмотря на то, что вы решили, что Observable никогда не перестанет производиться, не кажется разумным бросать исключение, если однажды он это сделает.