1.概念:注解Annotation是java 1.5的新特性,是一种能够添加到 Java 源代码的语法元数据。类、方法、变量、参数、包都可以被注解,可用来将信息元数据与程序元素进行关联。Annotation 中文常译为“注解”。
2.用处:
(1)生成文档。这是最常见的,也是java 最早提供的注解。常用的有@see @param @return 等
(2)跟踪代码依赖性,实现替代配置文件功能。比较常见的是spring 2.5 开始的基于注解配置。作用就是减少配置。现在的框架基本都使用了这种配置来减少配置文件的数量。也是
(3)在编译时进行格式检查。如@Override 放在方法前,如果你这个方法并不是覆盖了超类方法,则编译时就能检查出。
3.例子
定义的一般都会选择RUNTIME,而默认的则是CLASS
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
String value();
int length() default 2;
定义的注解可选的修饰对象为METHOD(方法),FIELD(域),PARAMETER(参数),我们这里就修饰下FILED,定义一个String来修饰
public class MainActivity extends AppCompatActivity {
@MyAnnotation("value")
String value;
String value;
@MyAnnotation(value = "value2", length = 1)
String value2;
String value2;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}
定义一个类,采用反射的方式将注解的值取出并使用
public class AnnotationParse {
public static void parse(Object o) {
Class<?> mClass = o.getClass();
Field[] fields = mClass.getFields();
for (Field field : fields) {
if (field.isAnnotationPresent(MyAnnotation.class)) {
MyAnnotation myAnnotation = field.getAnnotation(MyAnnotation.class);
String value = myAnnotation.value();
int length = myAnnotation.length();
try {
field.set(o, value + "---" + length);
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
}
}
}
Class<?> mClass = o.getClass();
Field[] fields = mClass.getFields();
for (Field field : fields) {
if (field.isAnnotationPresent(MyAnnotation.class)) {
MyAnnotation myAnnotation = field.getAnnotation(MyAnnotation.class);
String value = myAnnotation.value();
int length = myAnnotation.length();
try {
field.set(o, value + "---" + length);
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
}
}
}
在Activity中调用解析方法并打印
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
AnnotationParse.parse(this);
Log.e("MainActivity", value);
Log.e("MainActivity", value2);
}
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
AnnotationParse.parse(this);
Log.e("MainActivity", value);
Log.e("MainActivity", value2);
}
打印结果为