Java基础-学习使用Annotation注解对象
2009-12-02 21:40
816 查看
核心提示:注解(也被称为元数据)为我们在代码中添加信息提供了一种形式化的方法,使我们可以在稍后某个时刻非常方便地使用这些数据。
Java基础-学习使用Annotation注解对象
注解(也被称为元数据)为我们在代码中添加信息提供了一种形式化的方法,使我们可以在稍后某
个时刻非常方便地使用这些数据
1-1:基本语法
Java SE5内置三种标准注解
@Override:表示当前的方法定义将覆盖超类中的方法.如果你不小心拼写错误,或者方法签名对不上被覆
盖的方法,编译器就会发出错误提示
@Deprecated:如果程序员使用了注解为它的元素,那么编译器就会发出警告信息
@SupperessWarnings:关闭不当的编译器警告信息.
Java SE5内置四种元注解
@Target:表示该注解可以用于什么地方.可能的ElementType参数包括:
1)CONSTRUCTOR:构造器的声明
2)FIELD:域声明(包括enum实例)
3)LOCAL_VARIABLE:局部变量声明
4)METHOD:方法声明
5)PACKAGE:包声明
6)PARAMETER:参数声明
7)TYPE:类、接口(包括注解类型)或enum声明
@Retention:表示需要在什么级别保存该注解信息.可选的RetentionPolicy参数包括:
1)SOURCE:注解将被编译器丢弃
2)CLASS:注解在class文件中可用,但会被VM丢弃
3)RUNTIME:VM将在运行期也保留注解,因此可以通过反射机制读取注解的信息
@Documented:将此注解包含在Javadoc中
@Inherited:允许子类继承父类中的注解
大多数时候,程序员主要是定义自己的注解,并编写自己的处理器来处理它们.
1-2:编写注解处理器
如果没有用来读取注解的工具,那注解也不会比注释更有用.使用注解的过程中.很重要的一个部
分就是创建与使用注解处理器.Java SE5扩展了反射机制的API,以帮助程序员构造这类工具.同时,它还提
供了一个外部工具apt帮助程序员解析带有注解的Java源代码.
下面是一个非常简单的注解处理器,我们将用它来读取PasswordUtils类,并使用反射机制查
找@UseCase标记.我们为其提供了一组id值得,然后它会列出在PasswordUtils中找到的用例,以及缺失的
用例.
这个程序用到了两个反射的方法:getDeclaredMethods()和getAnnotation(),它们都属
于AnnotatedElement接口(class,Method与Field等类都实现了该接口).getAnnotation()方法返回指定类
型的注解对象,在这里就是UseCase,如果被注解的方法上没有该类型的注解,则返回null值.然后我们通过
调用id()和description()方法从返回的UseCase对象中提取元素的值.其中encryptPassword()方法在注
解的时候没有指定description的值,因此处理器在处理它对应的注解时,通过description()方法取得的
是默认值no description.
Java基础-学习使用Annotation注解对象
注解(也被称为元数据)为我们在代码中添加信息提供了一种形式化的方法,使我们可以在稍后某
个时刻非常方便地使用这些数据
1-1:基本语法
Java SE5内置三种标准注解
@Override:表示当前的方法定义将覆盖超类中的方法.如果你不小心拼写错误,或者方法签名对不上被覆
盖的方法,编译器就会发出错误提示
@Deprecated:如果程序员使用了注解为它的元素,那么编译器就会发出警告信息
@SupperessWarnings:关闭不当的编译器警告信息.
Java SE5内置四种元注解
@Target:表示该注解可以用于什么地方.可能的ElementType参数包括:
1)CONSTRUCTOR:构造器的声明
2)FIELD:域声明(包括enum实例)
3)LOCAL_VARIABLE:局部变量声明
4)METHOD:方法声明
5)PACKAGE:包声明
6)PARAMETER:参数声明
7)TYPE:类、接口(包括注解类型)或enum声明
@Retention:表示需要在什么级别保存该注解信息.可选的RetentionPolicy参数包括:
1)SOURCE:注解将被编译器丢弃
2)CLASS:注解在class文件中可用,但会被VM丢弃
3)RUNTIME:VM将在运行期也保留注解,因此可以通过反射机制读取注解的信息
@Documented:将此注解包含在Javadoc中
@Inherited:允许子类继承父类中的注解
大多数时候,程序员主要是定义自己的注解,并编写自己的处理器来处理它们.
----------------------------- UseCase.java ------------------------- package com; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Target(ElementType.METHOD)//用来定义你的注解将应用在什么地方,本处应用为方法 //用来定义该注解在哪一个级别可用,在源代码中(source)类文件中(class)或者运行时(runtime) @Retention(RetentionPolicy.RUNTIME) public @interface UseCase { public int id(); public String description()default "no description"; } ----------------------------- PasswordUtils .java ------------------------- package com; public class PasswordUtils { @UseCase(id=47,description="Passwords must contain at least one numeric") public boolean validatePassword(){ return true; } @UseCase(id=48) public String encryptPassword(String password){ return password; } @UseCase(id=49,description="Jong_Cai") public void showName(){ System.out.println("Jong_Cai"); } }
1-2:编写注解处理器
如果没有用来读取注解的工具,那注解也不会比注释更有用.使用注解的过程中.很重要的一个部
分就是创建与使用注解处理器.Java SE5扩展了反射机制的API,以帮助程序员构造这类工具.同时,它还提
供了一个外部工具apt帮助程序员解析带有注解的Java源代码.
下面是一个非常简单的注解处理器,我们将用它来读取PasswordUtils类,并使用反射机制查
找@UseCase标记.我们为其提供了一组id值得,然后它会列出在PasswordUtils中找到的用例,以及缺失的
用例.
------------------------ UseCaseTracker.java --------------------------- package com; import java.lang.reflect.Method; import java.util.ArrayList; import java.util.Collections; import java.util.List; public class UseCaseTracker { public static void trackUseCases(List<Integer> list, Class<?> cl) { for (Method m : cl.getDeclaredMethods()) { UseCase us = m.getAnnotation(UseCase.class); if (us != null) { System.out.println("Found Use Case:" + us.id() + " " + us.description()); list.remove(new Integer(us.id())); } } for (int i : list) { System.out.println("Warning:Missing use case-" + i); } } public static void main(String[] args) { List<Integer> list = new ArrayList<Integer>(); Collections.addAll(list, 47,48,49,50,51); trackUseCases(list, PasswordUtils.class); } }
这个程序用到了两个反射的方法:getDeclaredMethods()和getAnnotation(),它们都属
于AnnotatedElement接口(class,Method与Field等类都实现了该接口).getAnnotation()方法返回指定类
型的注解对象,在这里就是UseCase,如果被注解的方法上没有该类型的注解,则返回null值.然后我们通过
调用id()和description()方法从返回的UseCase对象中提取元素的值.其中encryptPassword()方法在注
解的时候没有指定description的值,因此处理器在处理它对应的注解时,通过description()方法取得的
是默认值no description.
相关文章推荐
- Java基础-学习使用Annotation注解对象
- Java基础-学习使用Annotation注解对象
- 学习使用Annotation注解对象
- Java基础笔记 – Annotation注解的介绍和使用 自定义注解
- JAVA基础学习之final关键字、遍历集合、日期类对象的使用、Math类对象的使用、Runtime类对象的使用、时间对象Date(两个日期相减)(5)
- Java基础笔记 – Annotation注解的介绍和使用 自定义注解
- Java基础笔记 – Annotation注解的介绍和使用 自定义注解
- java事务学习笔记(七)--像Spring一样使用Transactional注解(Annotation)
- JAVA基础学习之IP简述使用、反射、正则表达式操作、网络爬虫、可变参数、了解和入门注解的应用、使用Eclipse的Debug功能(7)
- 【Java基础】在使用@Deprecated注解时发生的对象引用变量的类型的问题
- JAVA基础学习之流的简述及演示案例、用缓冲区方法buffer读写文件、File类对象的使用、Serializable标记接口(6)
- Java基础复习笔记12Java自定义注解Annotation的使用
- Java基础笔记 – Annotation注解的介绍和使用 自定义注解
- [学习笔记]Java基础_IO(包含对象流序列化使用和RandomAccessFile 类的使用)
- 第五天03 JAVA基础语法(认识对象--使用标准类)(学习笔记)
- Java基础学习总结(120)——JVM 参数使用详细说明
- java教程之对象序列化使用基础示例详解
- 黑马程序员--Java基础学习之IO流之File类、Properties对象、打印流、序列流等
- Java 注解的简单学习与应用 Annotation
- Java基础学习笔记--对象的初始化