如何正確地使用Java的@deprecated 標注

Rule #1: do Javadoc how not to

公司主營業(yè)務：網(wǎng)站設計制作、成都網(wǎng)站制作、移動網(wǎng)站開發(fā)等業(yè)務。幫助企業(yè)客戶真正實現(xiàn)互聯(lián)網(wǎng)宣傳，提高企業(yè)的競爭能力。創(chuàng)新互聯(lián)建站是一支青春激揚、勤奮敬業(yè)、活力青春激揚、勤奮敬業(yè)、活力澎湃、和諧高效的團隊。公司秉承以“開放、自由、嚴謹、自律”為核心的企業(yè)文化，感謝他們對我們的高要求，感謝他們從不同領域給我們帶來的挑戰(zhàn)，讓我們激情的團隊有機會用頭腦與智慧不斷的給客戶帶來驚喜。創(chuàng)新互聯(lián)建站推出海陽免費做網(wǎng)站回饋大家。

每當你棄用某方法時，創(chuàng)建JavaDoc告訴其他程序員如何不再使用這個方法。不要只說“這個方法廢棄了，不要用它”。因為這就是廢棄標注和JavaDoc中@deprecated的字面意義，完全沒有必要再重復一遍。Java開發(fā)人員作為目標受眾，都知道deprecation的意思。

命名新的方法，取代舊有的。(使用@link標注!)這可能還不夠，新的方法對應的文檔將解釋如何使用它。不要在JavaDoc中重復（其字面意義），文檔也應遵從DRY原則。另一方面你可能想要描述怎樣替換掉舊方法的調用，你可以就重構的細節(jié)給出提示。

Rule #2: do not Javadoc how to

移除過時的JavaDoc文檔。有些人可能爭辯：維護遺留代碼的用戶可能還會需要這些文檔。事實上，他們使用的是舊版本庫中的舊版本方法。舊版本的文檔仍舊存在那里，像被刻在石頭上（更確切的說是刻在資源倉庫的某個版本上）。含有被廢棄掉的方法的實際版本不應包含過時的描述文檔，那會鼓勵程序員去繼續(xù)使用。對于廢棄的方法，只有一種用法：不去用。JavaDoc應該被實時描述，如同rule#1所述。

Rule #3: 不要在JavaDoc中解釋

不要在JavaDoc中解釋為什么方法被廢棄了。你是一個可靠的的開發(fā)，這是你的決定，你的選擇，其他人只能忍著。如果愿意，可以寫一篇博客記錄這次調整的決策背景。這可能有幫助，但它不應被寫在JavaDoc中。

JavaDoc的Deprecated API專用來講解如何不再使用。

重點是如何(how)。而不是“為什么不再使用它(why)”。

Rule #4: do deprecate

如果你覺得需要棄用一方法，那就去做吧！如果你害怕你的用戶，或不想因你廢棄掉一些方法導致你用戶體驗更加痛苦，這個決定將讓你自己痛苦。盡你所能去讓API維持長久的穩(wěn)定。但如果有需要被廢棄的：立刻扔掉它。不要因“為何當初設計API時沒有考慮到未來的變動”而感到愧疚。沒有人能完美的預見未來。畢竟，如果你知道未來，生活就無趣了。

怎樣恢復java中已經(jīng)被標記棄用的方法？

去掉方法上面的@Deprecated這個注解就可以了

這樣你就發(fā)現(xiàn)這個方法不是廢棄的了

java方法已廢棄是怎么回事，

說的就是這個方法肯能在早些版本的JDK中使用良好 但是在你當前的這個版本中不建議使用這個方法了應該會有一個代替它的方法。可能函數(shù)內部實現(xiàn)已經(jīng)有變動。