@deprecated とは

@deprecated はメソッドなどが 非推奨 であることを示すアノテーションコメントです。


Deprecated とは 非推奨 という意味です。

@ はアノテーションで、メタ情報を付加する記号だと思ってください。

どんな時に

@deprecated は「なるべく使わないでほしい」関数にマークます。


言語のバージョンアップやプロジェクトのバージョンアップなど、プログラムを長い間運用するとクラスや関数の役割が変化してしまうことがあります。

また、バグが有り新しい関数を実装するなど、周辺事情が変わってしまうことがありますね。

@deprecated はそのような理由で、「新しい関数を用意したけれども、互換性などの理由から残している」関数に対して、「後方互換性のためのメソッドのため、できるだけ使わないでほしい」などを示すために利用します。

オブジェクト指向でなぜつくるのか 第2版

平澤 章
出版社:日経BP  発売日:2011-04-07

Amazonで詳細を見る