できることは 2 つあります。
@Deprecated
メソッドにアノテーションを
追加
し、メソッド@deprecated
のjavadocにタグを追加します
両方やるべき!
この件に関する Java ドキュメントを引用すると、次のようになります。
J2SE 5.0 以降では、@Deprecated
アノテーションを使用してクラス、メソッド、またはフィールドを非推奨にします。さらに、@deprecated Javadoc タグを使用して、代わりに何を使用するかを開発者に伝えることができます。
注釈を使用すると、非推奨のクラス、メソッド、またはフィールドが使用されたときに Java コンパイラが警告を生成します。非推奨のコンパイル単位が非推奨のクラス、メソッド、またはフィールドを使用している場合、コンパイラは非推奨の警告を抑制します。これにより、警告を生成せずにレガシー API を構築できます。
@deprecated
新しい API の使用方法を説明する適切なコメントを含むJavadoc タグを使用することを強くお勧めします。これにより、開発者は古い API から新しい API への実行可能な移行パスを持つことができます。