推奨されないAPIの作り方

お世話になります。

JavaAPIなどを見ていると推奨されないAPIというのがでてきます。

この推奨されないAPIというのは自分で作ることは可能なのでしょうか？
JavaDocで＠deprecation
とつけると確かにJavaDocには反映されるのですが、
別にそのメソッドを呼んでコンパイルしても警告もなにもでないです。

以上よろしくお願いいたします。

No.2 ベストアンサー 回答者： UKY 回答日時： 2003/05/23 18:37

非推奨にするためのコメントの書き方を間違えていないか、もう一度確認してください。

Javadoc 用のコメントに @deprecated タグをつけておけば、コンパイラが自動的に解釈してメッセージを出してくれます。

例)

/**
* サンプルのクラスです。
*/
class Example {
　　
　　/**
　　 * サンプルのメソッドです。
　　 * @deprecated このメソッドは非推奨です。
　　 */
　　void method() {
　　System.out.println("非推奨メソッドを呼び出しました。");
　　}
　　
}

この回答へのお礼

返信が大変遅れまして、申しわけありません。

早速ご指摘どおりに試してみたいと思います。
ありがとうございました。

お礼日時：2003/05/29 10:43

No.3 回答者： Harry_ 回答日時： 2003/05/29 10:37

No.2 の方が回答してくれてますが、

@deprecation

ではなく

@deprecated

です。

この回答へのお礼

ご回答ありがとうございます。

早速ご指摘どおりに試してみたいと思います。
ありがとうございました。

お礼日時：2003/05/29 10:44

No.1 回答者： ct27 回答日時： 2003/05/23 11:01

javacコマンドのオプションに-deprecationというもの

があるのでそれをつけてコンパイルしてみてはどうでしょう。

参考URL：http://java.sun.com/j2se/1.4/ja/docs/ja/tooldocs …

この回答への補足

ご回答ありがとうございます。

ご指摘頂いた方法はコンパイル時に
推奨されないAPIが使われていたときに詳しく教えてくれるものだという認識です。

推奨されないAPI自体を自分で作ることができるのかという質問なんです。
例えば
例外を投げるメソッドにthrows句をつけるとできるなど
なにかマークというかキーワードがあるのかと思いまして...

補足日時：2003/05/23 11:17