私のメソッドの1つを「非推奨」にしたい=もう使用しません。

しかし、それでも私はそれを私のAPIに入れたいです。私はその方法を使用しているすべての人に「警告」を表示したいだけです。

どうすればそれを達成できますか？

@Deprecatedメソッドで使用します。javadocフィールドを明確にすることを忘れないでください。

/**
 * Does some thing in old style.
 *
 * @deprecated use {@link #new()} instead.  
 */
@Deprecated
public void old() {
// ...
}

両方を使用し@Deprecated、注釈と@deprecated JavaDocタグのます。

の @deprecatedJavaDocのタグは、文書化のために使用されます。

@Deprecated注釈は、この方法は推奨されていることをコンパイラに指示します。これは、この件に関するSun / Oraclesのドキュメントでの説明です。

使用する@Deprecatedコードは、そのプログラム要素を使用する場合、すべてのコンパイラが警告を発行することを、クラス、メソッド、またはフィールドの性を保証を廃止するために注釈を。対照的に、@deprecatedSunコンパイラは現在、すべてのコンパイラがJavadocタグに基づいて常に警告を発行するという保証はありません。他のコンパイラはそのような警告を発しないかもしれません。したがって、@Deprecatedアノテーションを使用して警告を生成する方が、@deprecatedJavadocタグに依存するよりも移植性が高くなります。

完全なドキュメントは、APIを非推奨にする方法と時期にあります。

いくつかの小さな説明が欠けていたので

@Deprecatedこのようなメソッドでアノテーションを使用する

 /**
 * @param basePrice
 * 
 * @deprecated  reason this method is deprecated <br/>
 *              {will be removed in next version} <br/>
 *              use {@link #setPurchasePrice()} instead like this: 
 * 
 * 
 * <blockquote><pre>
 * getProduct().setPurchasePrice(200) 
 * </pre></blockquote>
 * 
 */
@Deprecated
public void setBaseprice(int basePrice) {
}

説明することを忘れないでください：

1. この方法が推奨されなくなったのはなぜですか。それを使用するときにどのような問題が発生します。該当する場合は、その問題に関するディスカッションへのリンクを提供してください。（読みやすいように行を区切ることを忘れないでください<br/>
2. いつ削除されますか。（ユーザーが古い方法に固執することを決めた場合でも、この方法をどれだけ信頼できるかをユーザーに知らせます）
3. ソリューションまたは推奨する方法へのリンクを 提供する{@link #setPurchasePrice()}

できることは2つあります。

1. 追加 @Deprecatedメソッドにアノテーションを
2. @deprecatedメソッドのjavadocにタグを追加します

あなたは両方をするべきです！

このテーマに関するJavaドキュメントを引用：

J2SE 5.0以降では、@ Deprecatedアノテーションを使用してクラス、メソッド、またはフィールドを非推奨にします。さらに、@ deprecated Javadocタグを使用して、代わりに何を使用するかを開発者に伝えることができます。

アノテーションを使用すると、非推奨のクラス、メソッド、またはフィールドが使用されたときに、Javaコンパイラーが警告を生成します。非推奨のコンパイル単位が非推奨のクラス、メソッド、またはフィールドを使用する場合、コンパイラーは非推奨警告を抑制します。これにより、警告を生成せずにレガシーAPIを構築できます。

新しいAPIの使用方法を説明する適切なコメント付きのJavadoc @deprecatedタグを使用することを強くお勧めします。これにより、開発者は古いAPIから新しいAPIへの移行可能なパスを確保できます

メソッドのアノテーション @Deprecatedを使用します。また、javadocでそれを言及する必要があります。

@Deprecatedアノテーションを見てください。