java中各种注解含义（不断更新中）

墨蓝 2022-03-15 05:16 310阅读 0赞

**@Deprecated**  
API解释：  
用 @Deprecated 注释的程序元素，不鼓励程序员使用这样的元素，通常是因为它很危险或存在更好的选择。在使用不被赞成的程序元素或在不被赞成的代码中执行重写时，编译器会发出警告。

**@SuppressWarnings**  
API解释：  
指示应该在注释元素（以及包含在该注释元素中的所有程序元素）中取消显示指定的编译器警告。注意，在给定元素中取消显示的警告集是所有包含元素中取消显示的警告的超集。例如，如果注释一个类来取消显示某个警告，同时注释一个方法来取消显示另一个警告，那么将在此方法中同时取消显示这两个警告。

根据风格不同，程序员应该始终在最里层的嵌套元素上使用此注释，在那里使用才有效。如果要在特定的方法中取消显示某个警告，则应该注释该方法而不是注释它的类。

@SuppressWarnings({"serial", "all"})
    public class XmlBeanFactory extends DefaultListableBeanFactory {

<table> 
 <thead> 
  <tr> 
   <th>关键字</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>deprecation</td> 
   <td>使用了已过时或者不推荐使用的类或方法时的警告</td> 
  </tr> 
  <tr> 
   <td>unchecked</td> 
   <td>执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型</td> 
  </tr> 
  <tr> 
   <td>fallthrough</td> 
   <td>当 Switch 程序块直接通往下一种情况而没有 Break 时的警告</td> 
  </tr> 
  <tr> 
   <td>path</td> 
   <td>在类路径、源文件路径等中有不存在的路径时的警告</td> 
  </tr> 
  <tr> 
   <td>serial</td> 
   <td>当在可序列化的类上缺少 serialVersionUID 定义时的警告</td> 
  </tr> 
  <tr> 
   <td>all</td> 
   <td>关于以上所有情况的警告</td> 
  </tr> 
 </tbody> 
</table>

**@Target**  
指示注释类型所适用的程序元素的种类。如果注释类型声明中不存在 Target 元注释，则声明的类型可以用在任一程序元素上。如果存在这样的元注释，则编译器强制实施指定的使用限制。 例如，此元注释指示该声明类型是其自身，即元注释类型。它只能用在注释类型声明上：

@Target(ElementType.ANNOTATION_TYPE)
        public @interface MetaAnnotationType {
            ... 
        }

此元注释指示该声明类型只可作为复杂注释类型声明中的成员类型使用。它不能直接用于注释：

@Target({}) 
        public @interface MemberType {
            ...
        }

这是一个编译时错误，它表明一个 ElementType 常量在 Target 注释中出现了不只一次。例如，以下元注释是非法的：

@Target({ElementType.FIELD, ElementType.METHOD, ElementType.FIELD})
        public @interface Bogus {
            ...
        }