Annotation

缺乏、安全感 2021-09-11 07:46 317阅读 0赞

import java.lang.annotation.ElementType;
    import java.lang.annotation.Target;
    
    import javax.lang.model.element.Element;
    
    public class Annotationj {
    	/**2017-02-22 21:13
    	 *  元数据MetaData的支持
    	 *  Annotation 注解
    	 *  这些标记可以在编译、类加载、运行时被读取，并执行相应的处理
    	 *  通过使用注解可以在不改变原有逻辑的情况下，在源文件中嵌入一些补充的信息
    	 *  代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或者进行部署
    	 *  Annotation 提供了一种为程序元素设置元数据的方法
    	 *  Annotation 就像修饰符一样
    	 *  可修饰包、类、构造器、方法、成员变量、参数、局部变量的声明
    	 *  这些信息都被存储在Annotation的  name=value
    	 *  
    	 *  
    	 *  Annotation是一个接口，程序可以通过反射来获取指定程序元素的Annotation对象
    	 *  然后通过Annottion 对象来取得注解里的元数据
    	 *  
    	 *  Annotation 能被用来为程序元素设置元数据
    	 *  Annotation 不影响程序程序代码的执行
    	 *  要想Annotation 在运行时起一定的作用
    	 *  只有通过某种配套的工具对Annotation中的信息进行访问和处理
    	 *  访问和处理Annotation的工具统称APT   Annotation Processing Tool
    	 *  
    	 *  
    	 *  @ 修饰符
    	 *  
    	 *  5个基本Aoontation
    	 *  @Override 
    	 *  指定方法覆载  强制一个子类必须覆盖父类的方法
    	 *  作用就是告诉编译器检查这个方法，保证父类要包含一个被该方法重写的方法，否则就会编译错误
    	 *  只能修饰方法
    	 *  @Deprecated
    	 *  表示某个程序元素已经过时，其他程序使用已过时的类、方法时，编译器将会给出警告
    	 *  @SuppressWarnings
    	 *  取消该类某个编译器警告，同时修饰该类里的某个方法取消显示另一个编译器警告，那么该方法将会同时取消显示这两个编译器警告
    	 *  通常没有泛型限制的集合会引起编译器警告
    	 *  @SafeVarargs   抑制警告
    	 *  堆污染警告
    	 *  泛型擦除时引发unchecked
    	 *  引发这种错误原因称为 堆污染  Heap pollution
    	 *  当把一个 不带泛型的对象赋给一个带泛型的变量时，就会发生这种堆污染
    	 *  @FunctionInterface
    	 *  接口中只有一个抽象方法，该接口就是函数式接口
    	 *  用来指定某个接口必须是函数式接口
    	 *  
    	 */
    	
    	/**2017-02-22 21:42
    	 * annotation 包下提供6个meta annotation 元 Annotation 
    	 * 五个元annotation 都用于修饰其他的Anntation定义
    	 *  @retention  
    	 *  只能用于修饰Annotation定义
    	 *  指定被修饰的Annotation能保留多长时间
    	 *  
    	 * @Target 
    	 * 只能修饰一个Annotation定义
    	 * 指定被修饰的Annotation能用于修饰那些程序单元
    		//	@Target(ElementType.CONSTRUCTOR)  修饰构造器
    	 * 
    	 * @Documented
    	 * 指定被修饰的 将被javadoc提取成文档
    	 * 
    	 * @inherited 
    	 * 被修饰的 annotation将具有继承性
    	 * 其子类将被自动被  @ 修饰
    	 * 
    	 */
    	
    	
    	/**2017-02-22 21:58
    	 * 自定义的注解接口 继承了Annotation 接口
    	 * 可以通过反射看到MyTag接口包含了Annotation里的方法  
    	 * 
    	 * 
    	 * 是否可以包含成员变量，分为两类
    	 * 标记Annotation 
    	 * 没有定义成员变量的Annotation 类型被称为标记
    	 * 这种Annotation仅利用自身的存在与否来提供信息		
    	 * 
    	 * 元数据Annotation 
    	 * 包含成员变量的Annotation 因为他们可以接受更多的元数据
    	 * 也被称为元数据Annotation
    	 * 
    	 */
    	
    	
    	/**2017-02-22 22:01
    	 * 提取Annotation信息
    	 * 使用Annotation修饰了的类、方法、成员变量等成员之后
    	 * 这些Annotation不会自己生效，必须由开发者提供相应的工具来提取并处理Annotation信息
    	 * 
    	 * java使用Annotation接口来代表程序元素前面的注解，该接口是所有注解的父接口
    	 * java.lang.reflect包
    	 * AnnotationElement接口主要有以下实现类
    	 * 		-----Class
    	 * 		-----Constructor  构造器
    	 * 		-----Field成员变量
    	 * 		-----Method
    	 * 		-----Package
    	 * 
    	 * 该包下只要包含一些实现反射功能的工具类
    	 * 只有当定义Annotation时使用了@Retention(RetentionPolicy.RUNTIME)修饰时
    	 * 该Annotation才会在运行时可见
    	 * jvm才会在装在class文件时读取并保存在class文件中的Annotation
    	 * 
    	 * AnnotationElement接口时所有程序元素的父接口
    	 * 程序可以通过反射获取某个类的AnnotationElement对象之后
    	 * 程序就可以调用该对象的方法来访问Annotation信息
    	 * 
    	 */
    	/**2017-02-22 22:14
    	 * 重复注解
    	 * java 8 允许使用多个相同类型的Annotation 来修饰同一个类 
    	 * 重复注解只是一个简化写法，这种简化写法是一种假象
    	 * 多个重复注解其实会被作为 容器注解  的value成员变量的数组元素
    	 */
    	/**2017-02-22 22:18
    	 * 
    	 * ElementType枚举 增加了  TYPE_PARAMETER   TYPE_USE  
    	 * 允许定义枚举时使用@Target（ElementType.TYPE_USE）修饰
    	 * 这种注解被称为Type Annotation  类型注解
    	 * 
    	 *  Type Annotation 可以在任何用到类型的地方使用
    	 *  创建对象 new
    	 *  类型转换
    	 *  使用implements实现接口
    	 *  使用throws声明异常
    	 */
    	
    	/**2017-02-22 22:24
    	 * 编译时 处理 Annotation
    	 * APT  Annotation Processing Tool 是一种注解工具
    	 * 对源代码文件进行检测
    	 * 找出源文件所包含的Annotation 信息
    	 * 针对Annotation信息 进行额外的处理
    	 * 
    	 *   javac.exe -processor  选项可以指定一个Annotation处理器
    	 *   每个处理器都需要实现
    	 */
    	@Testannotation   // 使用自己定义的 注解
    	(age = 0, name = "")
    	public static void main(String[] args) {
    		
    	}
    	
    	//定义一个简单的TYPE  不带任何成员变量
    	@Target(ElementType.TYPE_USE)
    	@interface NotNull{}
    	
    	
    	
    	public @interface Testannotation{
    		String name();
    		int age();
    	}
    }