【ひすいしょう】

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

最終更新:
💡 「利用を見直してね」というお知らせ。削除とは別

機能やAPIの利用が推奨されなくなった状態。まだ使える場合があり、削除予定が決まっているとは限りません。理由・代替手段・削除やサポート終了の予定を個別に確認します。

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

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

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

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

参考資料

← 用語集にもどる