注 解

注解

• 注解：注释类型 Annotation
• 注解Annotation是一种引用数据类型，编译之后生成.class文件
• 自定义注解的语法格式

		[修饰符列表] @interface 注解类型名{

		}

• 注解的使用的语法格式 @注解类型名
• 注解可以使用在类、属性、方法、变量等上，还可以使用在注解类型上。

注解类型

• Deprecated 用 @Deprecated 注释的程序元素，不鼓励程序员使用这样的元素（已过时），通常是因为它很危险或存在更好的选择。
• Override 表示一个方法声明打算重写超类中的另一个方法声明。
  • 只能注解方法。Override注释是给编译器参考的，和运行阶段没有关系。凡是java中方法带有这个注解的，编译器就进行编译检查，如果这个方法不是重写的父类的方法，编译器报错。
• SuppressWarnings 指示应该在注释元素（以及包含在该注释元素中的所有程序元素）中取消显示指定的编译器警告。

Override

• Override 表示一个方法声明打算重写超类中的另一个方法声明。
  • 只能注解方法。Override注释是给编译器参考的，和运行阶段没有关系。凡是java中方法带有这个注解的，编译器就进行编译检查，如果这个方法不是重写的父类的方法，编译器报错。
    

元注解

• 元注解：用于标注“注解类型”的注解称为元注解
• • 常见的元注解
    • Target
    • Retention
• Target用来标注被标注的注解可以出现在哪些位置。
• Retention用来标注被标注的注解最终保持到哪里
  • @Retention(RetentionPolicy.SOURCE) ——表示该注解(例Override注解)被保留在java源文件当中
  • @Retention(RetentionPolicy.CLASS) ——表示该注解被保留在Class文件中
  • @Retention(RetentionPolicy.RUNTIME) ——表示该注解被保留在class文件中，并且可以被反射机制读取到。
    

注解中定义属性

• 如果一个注解中有属性
  • 当该属性指定默认值时，不需要赋值 int age() default 25;
  • 当该属性没有指定时，需要在使用注解时给该属性赋值。
  • 当只有一个value属性时，String value(); 在注解赋值时，可以写value =“123”，可以写“123”。省略value
    

属性类型

• 属性类型
  • byte 、short、int、long、float、double、boolean、char、String、Class、枚举类型以及上述每一个的数组形式。
    

反射获得注解

注解应用

package Advance.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
 * @author 衣鱼
 *		设置一个注解Id
 *			这个Id用来标注类，被标注的类必须有一个Int类型的属性
 *			没有Int类型的属性，被标注为异常
 */
import java.lang.reflect.Field;
public class AnnotationTest02 {
	public static void main(String[] args) throws Exception{
		Class c =Class.forName("Advance.annotation.user");
		boolean isok =false;
		if(c.isAnnotationPresent(Id.class)) {
			//当一个类上的Id注解的时候，要求该类有Int类型属性
			Field[] fields = c.getDeclaredFields();
			for(Field field : fields) {
				if("Id".equals(field.getName())
						&&"int".equals(field.getType().getSimpleName())) {
					isok=true;
					break;
				}
			}
			if(!isok) {
				throw new hasNotIdPropertyException("被@Id注解的类必须有一个Int类型"
						+ "的属性Id");
			}
		}
	}
}

@Id
class user{
	
}

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

//自定义异常
class hasNotIdPropertyException extends RuntimeException{
	public hasNotIdPropertyException(String s) {
		super();
	}
}