元注解和使用实例

1. 元注解是什么
 元注解也是注解,不过它的用途稍微有点不同,它是用来注解(动词)注解(名词)的注解(名词)。其中注解@Retention和@Inherited两个注解很经常使用。

2. 元注解之:@Retention
 @Retention:只能用于修饰一个Annotation定义,用于指定该Annotation可以保留的域,通过赋一个RetentionPolicy类型的值,指定可以保留的域。再通俗点将就是这个注解的作用是指定给谁用的。

参数值赋值后的作用
RetentionPolicy.CLASS(默认值)给解析器使用的。编译器会把注解记录在class文件中,当运行java程序的时候,JVM不会保留注解。
RetentionPolicy.RUNTIME编译器会在注解记录在class文件中,当运行java程序时,JVM会保留注解,程序可以通过反射来获取该注解。
RetentionPolicy.SOURCE给编译器使用的。编译器不会将注解记录到class文件中。

 
3. 元注解之@Target
 @Target注解的作用是用于修饰类的哪个成员。它包含了一个名为value,类型为ElementType的成员变量。用于指定修饰目标对象的类型:TYPE(类、接口)、FIELD(成员变量)、METHOD(方法)。

4. 元注解之@Documented
 用于指定被@Documented修饰的 Annotation 类将被 javadoc 工具提取成文档。使用该元注解修饰,该注解的信息可以生成到javadoc 文档中。

5. 元注解之@Inherited
 如果一个注解使用该元注解修饰,那么某个类使用了这个注解,其子类也会自动继承这个注解。

6. 自定义注解实例
 下面的一个实例是设置工作时间上限的,一般我们也能通过配置文件来进行设置,但是我们今天要用注解的方式来完成。
首先我们设置一个自定义注解:

@Retention(RetentionPolicy.RUNTIME) //JVM会保留这个注解。
@Target(ElementType.METHOD) //这个元注解是说明这个注解的目标是用于方法的。
public @interface StandardTime{
    //int型注解属性,上限工作时间。
    int ceilingTime();
}

目标程序(放在自定义的Work类中)使用这个注解:

@StandardTime(ceilingTime=8)    //使用我们自定义的注解
public void setWorkTime(int time)throws SecurityException, NoSuchMethodException{
    //1.第一步获取当前method对象。

        //1.1获取当前类的class对象。
        Class clazz = this.getClass();
        //1.2获取当前方法的method对象。
        Method method = clazz.getDeclaredMethod("setWorkTime",int.class);
        //1.3判断当前方法是否有ceilingTime这个注解?
        if(method.isAnnotationPresent(StandardTime.class)){

            //2.在Method类中有一个getAnnotation(Class annotationClass),可以获取一个注解对象。
            //3.通过注解对象来获取注解的属性。
            StandardTime standard = method.getAnnotation(StandardTime.class);
            int ceilingTime = standard.ceilingTime();
            if(time>ceilingTime)
                throw new RuntimeException("最大的工作时间为"+ceilingTime+"小时。");
            System.out.println("工作时间设置成功,为"+time+"小时。");
        }
}

我们来测试一下是否可行:

public class WorkTimeTest {
    public static void main(String[] args) throws SecurityException, NoSuchMethodException {
        Work work = new Work();
        work.setWorkTime(9);
    }
}

测试结果:
如果我们设置为6个小时,控制台的情况为:工作时间设置成功,为6小时。
如果我们设置为9个小时,控制台的情况为:
设置9个小时的情况
如果我们设置为6个小时,控制台的情况为:工作时间设置成功,为9小时。

  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值