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操作系统。