java注解编程

内置注解 •
Override –继承父类方法 且重写（覆盖）父类方法
表示当前方法覆盖父类的方法，可以保证编译时 •
候Override函数声明的正确性

只能用于方法 •

@Override
public void sayHello(){
System.out.println("老师好!");
}

Deprecated -表明方法已经过时

表示当前元素是不赞成使用的 •

可以作用于类、属性、方法 •

@Deprecated
class Person{
@Deprecated
public String name;
@Deprecated
public void doSteal(){ //这个方法是不赞成使用的
System.out.println("偷东西是不对的！");
}
}

SuppressWarnings –

关闭特定的警告信息，如：使用泛型的时候未指定类型 •

可以作用于一段代码

@SuppressWarnings("serial")
public class Test implements Serializable{
@SuppressWarnings("unchecked")
Set set = new HashSet();
@SuppressWarnings("unchecked")
public static void main(String[] args) {
@SuppressWarnings("unused")
List list = new ArrayList();
}
}

自定义注解

类似于新创建一个接口类文件，但为了区分，我们需要将它声 •
明为@interface。

说明：
注解中的每个方法实际上是声明了一个配置参数 –
方法的返回值要求是：基本类型、String、Class、枚 –
举、Annotation和它们组成的数组
另外，可用使用@Target、@Retention等限制自定义注解 –
[<修饰符>] @interface <注解名>{
返回值 方法名称() [<default value>];
返回值 方法名称() [<default value>];
……
}

元注解
元注解是指注解的注解。包括 @Retention @Target @Document •
@Inherited四种。
@Retention: 定义注解的保留策略
@Target：定义注解的作用目标
@Document：说明该注解将被包含在javadoc中
@Inherited：说明子类可以继承父类中的该注解

在Java编译器编译时，会识别在源代码里添加的注解是否还会 •
保留，这就是RetentionPolicy。编译器的处理有三种策略：
@Retention(RetentionPolicy.RUNTIME) –
表示JVM运行时此注解存在 •
@Retention(RetentionPolicy.CLASS) –
表示仅在class文件中存在，程序运行无法读取 •
@Retention(RetentionPolicy.SOURCE) –
表示仅在源文件中存在，编译之后会丢失

限制注解的使用范围
@Target: 表示该注解可以用于什么地方。可用ElementType枚 •
举类型主要有：
TYPE : 类、接口或enum声明 –
FIELD: 域(属性)声明 –
METHOD: 方法声明 –
PARAMETER: 参数声明 –
CONSTRUCTOR: 构造方法声明 –
LOCAL_VARIABLE:局部变量声明 –
ANNOTATION_TYPE:注释类型声明 –
PACKAGE: 包声明 –

自定义注解-示例
/*
* 自定义注解
*/@
Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyAnnotation {
public enum FontColor {
BLUE, RED, GREEN
}i
nt id() default 100;
String info();
String[] names();
FontColor fontColor() default FontColor.RED;
}

public class MyAnnotationUsing {
@MyAnnotation(id = 1, info = "m1方法", names = { "zhangsan", "lisi" })
public void m1() {
}
@MyAnnotation(info = "m2方法", names = { "Tom", "Jerry" }, fontColor = FontColor.BLUE)
public void m2() {
}
}

/*

* 解析自定义注解
*/
public static void main(String[] args) throws ClassNotFoundException {
Class c = Class.forName("com.neuedu.MyAnnotationUsing");
Method[] methods = c.getDeclaredMethods();
for (Method method : methods) {
if (method.isAnnotationPresent(MyAnnotation.class)) {
MyAnnotation ann = method.getAnnotation(MyAnnotation.class);
System.out.println(method.getName() + ": " + ann.id() + ", "
+ ann.info() + ", " + Arrays.toString(ann.names()) + "," + ann.fontColor());
}
}
}

在程序中读取注解信息，需要用到反射。 •
在系统中用到注解权限时非常有用，可以精确控制权限的 –
粒度
注意：要想使用反射去读取注解，必须将Retention的值选 –
为RetentionPolicy.RUNTIME

Java反射机制（Reflection）
在运行状态中，对于任意一个类，都能够知道这个类的所 –
有属性和方法；对于任意一个对象，都能够调用它的任意
一个属性和方法。
这种动态获取类的信息及动态调用对象方法的功能称 –
为java语言的反射机制。
反射机制提供的功能：在运行时获得类中各成员并使用它们 •
在运行时判断任意一个对象所属的类； –
在运行时构造任意一个类的对象； –
在运行时判断任意一个类所具有的成员变量和方法； –
在运行时调用任意一个对象的方法； –
生成动态代理。 –

四个核心类
Java反射机制的实现要借助于以下4个类 •
Class：类对象 –
下面三个组件都是通过Class获取的 •
Constructor：类的构造器对象 –
Field：类的属性对象 –
Method：类的方法对象 –

Class的获取及常用方法
// 1、获取类的类对象
Class<?> c_1 = Class.forName("com.Student");
// 2、获取对象的类对象
Student student = new Student();
Class<?> c_2 = student.getClass();
// 3、获取int的类对象
Class<?> c_3 = int.class;
// 4、获取包装类的类对象
Class<?> c_4 = Integer.TYPE;

Class的获取及常用方法
常用方法 •
forName(String className)：返回与带有给定字符串名的类或接 
口相关联的 Class 对象
getClassLoader() ：返回该类的类加载器 
getDeclaredAnnotations() ：返回直接存在于此元素上的所有注解 
getDeclaredConstructors() ：返回类声明的所有构造方法 
getDeclaredFields()：返回类声明的所有字段，包括公共、保 
护、默认（包）访问和私有字段，但不包括继承的字段
getDeclaredMethods() ：返回类声明的所有方法，包括公共、保 
护、默认（包）访问和私有方法，但不包括继承的方法
getName() ：以 String 的形式返回此 Class 对象所表示的实体（ 
类、接口、数组类、基本类型或 void）名称
getPackage() ： 获取此类的包 

Constructor的获取及常用方法
Class<?> c = Class.forName("com.neuedu.Student");
// 本数组作为待查询构造器的参数（按顺序）
Class<?>[] objs = new Class[] { String.class, double.class }; Constructor<?> c_1 = c.getConstructor(objs);
Constructor<?>[] c_2 = c.getConstructors();
Constructor<?> c_3 = c.getDeclaredConstructor(objs);
Constructor<?>[] c_4 = c.getDeclaredConstructors();

常用方法 •
getName()：以字符串形式返回此构造方法的名称 
getModifiers()：以整数形式返回此 Constructor 对象所表示构造方法的 
Java 语言修饰符
getDeclaredAnnotations()：返回直接存在于此元素上的所有注释 
newInstance(Object... initargs) ：使用此 Constructor 对象表示的构造方法 
来创建该构造方法的声明类的新实例

实现反射机制的步骤
实现反射机制有以下三步 •
1、获得你想操作的类的 java.lang.Class 对象 –
2、获得你想操作的类的组件 –
（Constructor、Field、Method）或组件列表
3、使用反射的API来操作这些组件

实现反射机制的步骤
// 1、先获取 Student 的类对象
Class<?> c = Class.forName("com.Student");
// 2、构造类的实例，可以使用private的构造器
Constructor<?> constructor = c.getDeclaredConstructor(double.class,
boolean.class); // 获取到private构造器
constructor.setAccessible(true);
Student student = (Student) constructor.newInstance(60, true); // score初始值设置为60
student.doStudy();
System.out.println();

// 3、调用方法，可以调用private的 doPlay()方法
// student.doPlay(); //直接使用，不能访问private方法
Method method = c.getDeclaredMethod("doPlay");
method.setAccessible(true); // 设置可以访问private方法
method.invoke(student);
Class[] cs = new Class[] { String.class, String.class };
Method method_2 = c.getDeclaredMethod("doEat", cs); // 调用有参有返回值的方法
String str = (String) method_2.invoke(student, "面包", "啤酒");
System.out.println(str);
System.out.println();
// 4、获取属性，可以获取private属性
// System.out.println(student.studyAtHome); //不能直接访问
Field field = c.getDeclaredField("studyAtHome");
field.setAccessible(true);
System.out
.println(field.getName() + " is " + field.getBoolean(student));

解析自定义注解
Class c = Class.forName("com.MyAnnotationUsing");
Method[] methods = c.getDeclaredMethods();
for (Method method : methods) {
if (method.isAnnotationPresent(MyAnnotation.class)) {
MyAnnotation ann = method.getAnnotation(MyAnnotation.class);
System.out.println(method.getName() + ": " + ann.id() + ", "
+ ann.info() + ", " + Arrays.toString(ann.names())
+ "," + ann.fontColor());
}
}