【ひすいしょう】

非推奨(デプリケーテッド) とは?

最終更新:
💡 「利用を見直してね」というお知らせ。削除とは別
📌 このページのポイント
「利用を見直してね」の目印 非推奨の方法 oldMethod() ! まだ動く場合も 代替の例 newMethod() 置き換えを検証 移行 公式資料 移行ガイド 理由・代替・終了予定 版と動作を確認 非推奨 ≠ 削除済み
関数名は例です。代替手段や削除予定があるとは限らないので、利用中の版の公式資料で理由・移行方法・終了予定を確かめます。
ひよこ ひよこ
deprecatedって、壊れているという意味?
ペンギン先生 ペンギン先生
いいえ。「利用を勧めない」という状態だよ。まだ動くこともあるけれど、設計上の問題や代替機能など、非推奨になった理由を確認しよう。
ひよこ ひよこ
次の版で必ず消える?
ペンギン先生 ペンギン先生
必ずではないよ。Javaの@DeprecatedではforRemovalという項目で、将来の削除を意図するかを別に示す。非推奨だけでは削除日を決められないんだ。
ひよこ ひよこ
警告が出ていなければ大丈夫?
ペンギン先生 ペンギン先生
設定やツールによって警告の出方が違うので、それだけでは判断できないよ。利用している版の公式資料やリリースノートも見よう。
ひよこ ひよこ
何から直せばいい?
ペンギン先生 ペンギン先生
使っている場所を探し、理由・代替機能・終了予定を調べるんだ。期限や影響の大きいところから移行を計画し、置き換え後のテストも行おう。
ひよこ ひよこ
名前を新しい関数に変えるだけ?
ペンギン先生 ペンギン先生
引数や戻り値、例外の扱いが異なる場合があるよ。移行ガイドに沿って意味の違いまで確かめることが大切だね。
もっと詳しく知りたい人へ

非推奨とサポート終了はどう違う?

非推奨は利用の推奨状態、サポート終了は修正や問い合わせ対応などの提供期間に関する話です。さらに削除は機能自体が使えなくなる変更です。同じ日になるとは限らないので、提供元が何の終了を告知しているか確認します。

ペンギン
まとめ:ざっくりこれだけ覚えればOK!
非推奨は「利用を勧めない」という目印。削除とは別なので、理由・代替方法・終了予定を公式資料で確かめよう。
📖 おまけ:英語の意味
「Deprecated」 = 非推奨
💬 ソフトウェアでは、利用を続けるか見直してほしい機能の目印として使うよ。

参考資料

← 用語集にもどる