Annotation

矫情吗；* 2021-12-23 20:35 156阅读 0赞

首先，对Annotation库的简单介绍  
包含一系列有用元注释，帮助开发者在编译期间发现可能存在的bug  
是属于Support Lib其中之一，独立jar包  
通过注释来完善自身代码质量  
官方文档：  
AndroidAnnotations是一个能让你进行快速开发的开源框架,它让你关注真正重要的地方,它可以简化你的代码,并且有利于你后期的维护  
库的特点  
依赖注入(Dependency injection):支持view, extras, system service, resource等等  
简单的线程模型(Simplified threading model):进行方法注解以让该方法在UI线程或后台线程进行执行  
事件绑定(Event binding):进行方法注解以让方法执行view的时间而不用再添加一些监听  
REST client:创建一个接口,AndroidAnnotations用来实现  
没有神秘感(No magic):AndroidAnnotations在编译时会产生一个子类,你可以查看子类中的代码来知道它是如何工作的.  
编译检测:提供的多种注解,用于检测代码编译时可能存在的异常,并给开发者相关提示,提高代码质量  
AndroidAnnotations来实现这些美好的功能,只需要不到150kb的大小

1、基本注释

@Override：表明该方法是重写父类的方法，eg：

class Test  
\{  
@Override  
public void func()  
\{  
......  
\}  
\}  
  @Deprecated：表示该类或方法已过时，程序使用这些类或方法时会发出编译警告。

@SuppressWarnings：指示类或方法取消显示的编译警告，@SuppressWarnings中只有一个类型为String\[\]的元素成员value，其中常见的参数值为：

1.deprecation：使用了不赞成使用的类或方法时的警告；  
　　　2.unchecked：执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型;   
　　　3.fallthrough：当 Switch 程序块直接通往下一种情况而没有 Break 时的警告;  
　　　4.path：在类路径、源文件路径等中有不存在的路径时的警告;   
　　　5.serial：当在可序列化的类上缺少 serialVersionUID 定义时的警告;   
　　　6.finally：任何 finally 子句不能正常完成时的警告;   
　　　7.all：关于以上所有情况的警告。

使用示例：

@SuppressWarnings(value="unchecked")  
public void func1()  
\{  
List list = new ArrayList<Integer>();  
list.add(10); //list没有指定泛型，此处会产生警告  
  
List<String> ls = list; //将不带泛型的对象赋给带泛型的对象，产生警告，导致“堆污染”  
System.out.println(ls.get(0));//该语句运行时产生异常  
\}  
@SuppressWarnings(\{"unchecked", "deprecation"\})  
public void func2()  
\{  
  
\}  
   @SafeVarargs：指示取消显示个数可变形参产生的警告，eg：

@SafeVarargs  
public static void func3(List<String>...aryStringList) //个数可变的形参相当于是数组，因为没有泛型数组，所以形参相当于是一个List\[\]，泛型被抹去，产生“堆污染”  
\{  
  
\}  
  @FunctionalInterface：指示该接口是一个函数式接口（只有一个抽象方法，可以包含多个默认方法或静态方法的接口）。

2、自定义注释

使用@interface来自定义一个注解，如下定义了名为Coder的注解，注解中包含两个元素personId（int类型）和company（String类型，默认值为"peking"）：

public @interface Coder  
\{  
int personId();  
String city()default "peking";  
\}  
  如果注释中仅包含一个元素，这个元素的名字应该为value，如：

public @interface Coder  
\{  
String value();  
\}  
  注释中可以包含枚举类型：

public @interface FruitColor   
\{  
public enum Color\{ BULE,RED,GREEN\}; //枚举  
Color CoderColor() default Color.GREEN;  
\}  
  声明（使用）自定义的注释的时候需要为其成员变量指定值，如果该变量无默认值的话：

@Coder(personId = 1001)  
public void func()  
\{  
......  
\}  
  如果注释中元素的名字为value，那么在使用这个注解的时候，元素的名字和等号都可以省略，例如：

@Coder(“value”)  
public void func()  
\{  
......  
\}  
  根据注解是否包含成员可以将注解分为标记注解（如@Override）和元注解（如@Retention）。

3、JDK的元注释

在java.lang.annotation下有6个元Annotation，其中@Repeatable用于定义重复注解，其余5个用来修饰自定义的注解。

@Retention：指定被修饰的Annotation保留的时间，通过指定其value成员变量的值：

//编译器把注释保存在class文件中，当运行java程序时，JVM不可获取注释信息，这是默认值。  
@Retention(value = RetentionPolicy.CLASS)  
@interface Testable\{\}  
  
//编译器把注释保存在class文件中，当运行java程序时，JVM可以获取注释信息  
//程序可以通过反射获取该注释  
@Retention(value = RetentionPolicy.RUNTIME)  
@interface Testable\{\}  
  
//注释保存在源码中，编译器直接丢弃该注释。  
@Retention(value = RetentionPolicy.SOURCE)  
@interface Testable\{\}  
  @Target：指定被修饰的Annotation能够修饰哪些程序单元，其成员value值常见的值有：

ElementType.TYPE为指定该Annotation可以修饰类、接口（包括注解）、枚举定义。  
    ElementType.CONSTRUCTOR为指定该Annotation只能修饰构造方法。  
    ElementType.METHOD为指定该Annotation只能修饰方法定义。  
    ElementType.FIELD为指定该Annotation只能修饰成员变量。

@Documented：指定被修饰的Annotation将被javadoc工具提取成文档。

@Inherited：指定被修饰的Annotation具有继承性，使用该Annotation的类的子类自动继承该Annotation。

@Repeatable：在java 8之前，程序的元素（类、方法等）不能添加相同类型的注解，比如下面为使用两个@Result注解的实现方法：

@Results(\{@Result(name = "liyang"), @Result(name = "wulei")\})  
public void func()  
\{  
  
\}  
    java 8中允许使用多个相同类型的注解，通过为注解添加@Repeatable修饰。

转载于:https://www.cnblogs.com/SiriYang/p/10562190.html