Java廢棄註解

一、概述

註解是Java語言中一種用於代碼中聲明和使用元數據的技術。隨着Java語言的不斷發展，許多新註解不斷被開發出來，而有些老的註解則逐漸被廢棄。在Java SE 9版本中，共有8個註解被廢棄，它們分別是：@Contended、@Deprecated、@Incubating、@Export、@Import、@Restricted、@sun.misc、@sunw。這些註解雖然可能仍然能夠使用，但是官方不再推薦使用這些註解，而是推薦使用其他的註解代替它們。

二、@Deprecated註解

Java中的@Deprecated註解用於標註一個方法或者類已經被Deprecated所替代。使用@Deprecated註解對那些已經過時的方法或者類進行標記，這樣就可以告訴用戶該方法或者類已經被淘汰，請使用新的方法或者類。@Deprecated註解可以幫助程序員更好地了解自己使用的方法或類是否已經過時，從而更好地規劃代碼的升級和重構。

/**
 * @deprecated This method is replaced by method foo2
 */
@Deprecated
public void foo(){
    //do something
}

三、@Contended註解

Java中的@Contended註解用於標註一個類或者字段是競爭的。通常，在多線程環境下，多個線程同時訪問同一個共享對象會帶來競爭條件的問題。Java SE 8版本引入了一種名為VarHandle的新API，可以優化共享對象的訪問，最簡單的方法就是添加@Contended註解。但是在Java SE 9版本中，@Contended註解被廢棄了，因為它並不是一個通用的方案，而且它可能會影響程序的運行速度。

四、@Incubating註解

@Incubating註解用於標註一個接口或者類是實驗性的API。在一個API處於開發中的階段時，通常很難確保其完整性和穩定性。為了讓用戶更好地了解API的狀態和使用風險，Java SE 8版本引入了@Incubating註解。該註解告訴用戶，該API仍處於試驗階段，並且可能會在未來的版本中發生變化。但是在Java SE 9版本中，該註解被廢棄，因為它並沒有提供真正有用的信息，而且在廢棄之前已經沒有被廣泛使用。

五、@Export、@Import、@Restricted、@sun.misc、@sunw註解

@Export、@Import、@Restricted、@sun.misc、@sunw這五個註解都是Java SE 9版本中廢棄的註解，它們的作用各不相同。

@Export、@Import註解主要用於JDK的內部開發，用於標記那些具有導出或導入功能的方法。@Restricted註解用於標記那些在JDK中受到限制的API，它們只能在某些特定環境中使用。@sun.misc註解用於標記那些在sun.misc包中的類和方法，它們只有在Java SE實現中被使用，並且不能保證在其他Java SE實現中存在。@sunw註解用於標記那些在sunw.*包中的類和方法，它們被用於支持Solaris操作系統。