java注解(一)

什么是注解？

注解（Annotation）是JDK5的新特性，是一种特殊的类，作用类似于注释，相当于是一个标记，可以标记在一个类身上的不同位置，可以修饰不同的成员变量、方法甚至是类。
简单来说: 就是相当于一些类似于注释的信息 和 源程序中的元素 绑定的一种技术,这种技术叫做注解。
这种手段可以通过反射获取到元素对象,在获取到这个元素上面绑定的注解,通过绑定的注解获取里面配置信息,
从而达到能够在程序运行阶段通过这些信息动态地改变程序的运行逻辑。

为什么使用注解？

• 1.能够灵活地使用框架提供的注解,最后能够读懂框架的源码
• 2.能够配合反射将代码书写更加的灵活,更加易于维护易于扩展,Properties配置,XML配置,注解配置[Java配置]
• 3.极大程度地简化了代码,提高了代码的可读性

怎么使用注解？

自定义注解并且使用

四种使用注解的方式:

格式一: @注解的名称(属性名1=属性值1,属性名2=属性值2,属性名3=属性值3,...属性名n=属性值n)
　　注意: 如果有两个以上的属性,有多少个属性就必须给多少个属性赋值
格式二: 适用于注解只有一个成员
　　@注解的名称(属性值)
格式三: 适用于成员是数组的情况
　　@注解的名称({属性值1,属性值2,属性值3,...属性值n})
格式四: 使用标记注解
　　@注解的名称

下面列举开发中常见的注解

• @Override：用于标识该方法继承自超类, 当父类的方法被删除或修改了，编译器会提示错误信息(我们最经常看到的toString()方法上总能看到这货)
• @Deprecated：表示该类或者该方法已经不推荐使用，已经过期了，如果用户还是要使用，会生成编译的警告
• @SuppressWarnings：用于忽略的编译器警告信息

@Override注解源码

@Target(ElementType.METHOD)
//ElementType元素类型指定注解的类型
//可以存放的位置 TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE,ANNOTATION_TYPE,PACKAGE,
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

RetentionPolicy的源码
RetentionPolicy是个枚举类，可以设置三种情况的注解，源码时期的注解，编译时期的注解，运行时期的注解

public enum RetentionPolicy {
/**
* Annotations are to be discarded by the compiler.
*/
SOURCE,

/**
* Annotations are to be recorded in the class file by the compiler
* but need not be retained by the VM at run time. This is the default
* behavior.
*/
CLASS,

/**
* Annotations are to be recorded in the class file by the compiler and
* retained by the VM at run time, so they may be read reflectively.
*
* @see java.lang.reflect.AnnotatedElement
*/
RUNTIME
}

注解实例

public class AnnotationDemo01 {
public static void main(String[] args) {

}
}

// 希望当前注解MyAnnotation可以用在类,接口,构造方法,方法上
@Target({ ElementType.TYPE, ElementType.CONSTRUCTOR, ElementType.METHOD })
// 希望当前注解MyAnnotation可以在运行时有效
@Retention(RetentionPolicy.RUNTIME)
// 希望当前注解可以在子类中生效
@Inherited
// 希望当前注解可以在API文档中生成
@Documented
@interface MyAnnotation {
String desc();

int val() default 0;

String[] hobbys();
}

@Target({ ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
@interface Column {
String value();
}

@Target({ ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
@interface PrimaryKey {
boolean isAutoIncrease();
String name();
}

@Target({ ElementType.TYPE })
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@interface Fu {

}

@Fu
class Person {

}

@MyAnnotation(desc = "Student Class", val = 18, hobbys = { "篮球", "足球", "乒乓球" })
class Student extends Person {

@Column("sid")
@PrimaryKey(isAutoIncrease = true, name = "sid")
private String id;
@Column("sname")
private String name;
@Column("sage")
private int age;

public Student() {
super();
}

public Student(String name, int age) {
super();
this.name = name;
this.age = age;
}

@Override
@MyAnnotation(desc = "1111", val = 18, hobbys = { "篮球", "足球", "乒乓球" })
public String toString() {
return "Student [name=" + name + ", age=" + age + "]";
}

public String getName() {
return name;
}

public void setName(String name) {
this.name = name;
}

public int getAge() {
return age;
}

public void setAge(int age) {
this.age = age;
}

}

注解与反射

注解很多时候会和反射一起用，用于底层框架编写的时候。

使用反射解析注解:

• 1.使用反射解析类或者接口或者枚举上面的注解,必须先要获取到字节码文件对象
• 2.解析除了类上的注解外,必须先获取到元素对象
• 3.获取注解之前一定要做存在性判断

为什么? 因为如果是源码或者编译时注解,那么反射是在运行时获取,注解在运行时已经不存在就获取不到

通过反射获取注解元素的相关方法:

1. <A extends Annotation> A getAnnotation(Class<A> annotationClass)
2. Annotation[] getAnnotations()
3. Annotation[] getDeclaredAnnotations()
4. boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)

public class AnnotationDemo02 {
public static void main(String[] args) throws Exception {
// 获取学生类上的注解: @MyAnnotation
Class<?> c = Class.forName("com.sxt.annotationdemo02.Student");
// 获取到id上面注解绑定的信息
Field idField = c.getDeclaredField("id");    
Annotation[] annotations = idField.getAnnotations();
for (Annotation annotation : annotations) {
if (annotation instanceof Column) {
Column column = (Column) annotation;
System.out.println(column.value());
} else if(annotation instanceof PrimaryKey) {
PrimaryKey primaryKey = (PrimaryKey) annotation;
System.out.println(primaryKey.isAutoIncrease() + "|" + primaryKey.name());
}
}

Method toStringMethod = c.getMethod("toString");
if (toStringMethod.isAnnotationPresent(MyAnnotation.class)) {
MyAnnotation annotation = toStringMethod.getAnnotation(MyAnnotation.class);
if (annotation != null) {
String desc = annotation.desc();
System.out.println(desc);
}
}
}

}