@deprecated vs @Deprecated

Question

私は関数またはクラス@Deprecatedアノテーションを非難することができます。しかし、XMLの@deprecatedエントリは、クラス/関数を非推奨とマークしています。 @deprecatedは実際にクラス/関数を非推奨にしていますか？

Answer 1

@Deprecatedがに非推奨の方法をマークするために使用され、コンパイラによって読み取られたアノテーションで参照してくださいではありませんコンパイラは、メソッドが使用されている場合、非推奨のコンパイル時の警告を生成します。

@deprecatedは、非推奨についてのドキュメントを提供するために使用されるjavadocタグです。これを使用して、そのメソッドが推奨されなかった理由を説明し、代替案を提案することができます。このタグを@Deprecatedアノテーションと組み合わせて使用​​することだけが理にかなっています。

使用例：

/** 
* This method does ... 
* @deprecated As of <product> <version>, because ... use 
*    {@link #replacementMethod()} instead. 
*/ 
@Deprecated 
public void deprecatedMethod() { 
    // ... 
} 

ここでは、より多くの情報のためにそれをチェックアウトし、guide on deprecationです。

---

は、より具体的にあなたの質問に答えるために、それはあなたがコンパイラからそれを源泉徴収しながら、この情報がドキュメントに制限されるようにしたいと思うのは意味がありませんので、あなたは @Deprecatedのいずれか、または両方を使用する必要があります。 @Deprecatedは、実行時およびコンパイル時に使用できるため、そのメソッドを使用しているツール（IDEなど）に非推奨としてマークします。さらに、javadocツールでは、 @deprecatedを使用して非推奨に関する情報を追加していなくても、 @Deprecatedの通知を受け取ります。

注釈を付ける代わりにメソッドを非推奨にするだけでは、コンパイラや独自のツールなどのツールを使用する代わりに、手動で使用法を検索する必要があります。

Answer 2

@deprecated Javadocのタグ： あなたは非推奨としてのJavadocは、プログラム要素を表示するために@deprecatedタグを使用することができます。 @deprecatedタグの後ろにはスペースまたは改行が必要です。クラス、メソッド、またはフィールドを廃止する@Deprecated注釈を使用した を@Deprecated

は、コードがそのプログラム要素を使用する場合、すべてのコンパイラが警告を発行するようになります。これとは対照的に、すべてのコンパイラは常に@deprecated Javadocのタグ

に基づいて警告を発するという保証はありhere