当前位置: 首页 > news >正文

自定义注解

Java中自定义注解

注解的概念

注解的概念

  • 注解是一种元数据形式。即注解是属于Java的一种数据类型,和类、接口、数组、枚举类似。
  • 注解用量修饰,类、方法、变量、参数、包
  • 注解不会对所修饰的代码产生直接的影响

注解的使用范围

注解有许多用法,其中有:

为编译器提供信息 - 注解能被编译器检测到错误或抑制警告。

编译时和部署时的处理 - 软件工具能处理注解信息从而生成代码,XML文件等等。

运行时的处理 - 有些注解在运行时能被检测到。

如何自定义注解

注解是一种标记,可以在程序代码中的关键节点(类,方法,变量,参数,包)上打标记,然后程序在编译时或运行时可以检测到这些标记从而执行一些特殊操作。因此可以得出自定义注解使用的基本流程

  • 定义注解 --- 相当于定义标记
  • 配置注解 --- 把标记打在需要用到的程序代码中
  • 解析注解 --- 在编译或运行时检测到标记,并进行特殊操作

注解的基本语法

注解类型的声明部分

注解在java中,与类,接口,枚举类似,因此其声明语法基本一致,只是所使用的关键字有所不同,注解使用@interface关键字来声明。在底层实现上,所有定义的注解都会自动继承java.lang.annotation.Annotation接口

public @interface Information{}

注解类型的实现部分:

根据我们日常定义类或接口的经验,在类中无非是要定义构造方法、属性或一般方法。但是,在自定义注解中,其实现部分只能定义一个东西:注解类型元素(annotation type element)。基本语法如下:

public @interface Information {String name();int age();String[] hobbies();String address();
}

根据上面定义的属性,我们可以发现这种定义的内容类似抽象方法,实际上这是一种规定的注解类型元素

注解类型元素允许我们设置默认值,如果不设置则在后续使用注解时候,必须填写对应的属性值

public @interface Information {String name();int age();String[] hobbies();String address() default "中国";
}

定义注解类型元素时需要注解一下几点:

  1. 访问修饰符必须为public,不写默认为public
  2. 该元素的类型只能是基本数据类型,String ,class,枚举类型,注解类型
  3. ()不是定义方法参数的地方,也不能在括号中定义任何参数,仅仅只是一个特殊的语法;
  4. default代表默认值,值必须和第2点定义的类型一致;
  5. 如果没有默认值,代表后续使用注解时必须给该类型元素赋值。

元注解

一个最基本的注解定义就只包括了上面的两部分内容:1、注解的名字;2、注解包含的类型元素。但是,我们在使用JDK自带注解的时候发现,有些注解只能写在方法上面(比如@Override);有些却可以写在类的上面(比如@Deprecated)。当然除此以外还有很多细节性的定义,那么这些定义该如何做呢?这些限定就是通过元注解来实现的。
元注解:专门修饰注解的注解。它们都是为了更好的设计自定义注解的细节而专门设计的。

@Target

@Target注解,是专门用来限定某个自定义注解能够被应用在哪些java元素上面的,它使用一个枚举类型定义如下:

public enum ElementType {/** Class, interface (including annotation type), or enum declaration */TYPE,/** Field declaration (includes enum constants) */FIELD,/** Method declaration */METHOD,/** Formal parameter declaration */PARAMETER,/** Constructor declaration */CONSTRUCTOR,/** Local variable declaration */LOCAL_VARIABLE,/** Annotation type declaration */ANNOTATION_TYPE,/** Package declaration */PACKAGE,/*** Type parameter declaration** @since 1.8*/TYPE_PARAMETER,/*** Use of a type** @since 1.8*/TYPE_USE
}
//限定@Information注解只能使用在类、接口或方法上面。
@Target({ElementType.TYPE,ElementType.METHOD})
public @interface Information {String name();int age();String[] hobbies();String address() default "中国";
}

@Retention

@Retention注解,翻译为持久力、保持力。即用来修饰自定义注解的生命力。
注解的生命周期有三个阶段:

  • java 源文件阶段
  • 编译到class文件阶段
  • 运行期阶段

注:只有注解信息在运行时保留,我们才能在运行时通过反射获取到注解信息

同样使用了RetentionPolicy枚举类型定义了三个阶段:

public enum RetentionPolicy {/*** Annotations are to be discarded by the compiler.* (注解将被编译器忽略掉)*/SOURCE,/*** Annotations are to be recorded in the class file by the compiler* but need not be retained by the VM at run time.  This is the default* behavior.* (注解将被编译器记录在class文件中,但在运行时不会被虚拟机保留,这是一个默认的行为)*/CLASS,/*** Annotations are to be recorded in the class file by the compiler and* retained by the VM at run time, so they may be read reflectively.* (注解将被编译器记录在class文件中,而且在运行时会被虚拟机保留,因此它们能通过反射被读取到)* @see java.lang.reflect.AnnotatedElement*/RUNTIME
}

@Retention 的四种配置:

  1. 如果一个注解被定义为RetentionPolicy.SOURCE,则它将被限定在Java源文件中,那么这个注解即不会参与编译也不会在运行期起任何作用,这个注解就和一个注释是一样的效果,只能被阅读Java文件的人看到;

  2. 如果一个注解被定义为RetentionPolicy.CLASS,则它将被编译到Class文件中,那么编译器可以在编译时根据注解做一些处理动作,但是运行时JVM(Java虚拟机)会忽略它,我们在运行期也不能读取到;

  3. 如果一个注解被定义为RetentionPolicy.RUNTIME,那么这个注解可以在运行期的加载阶段被加载到Class对象中。那么在程序运行阶段,我们可以通过反射得到这个注解,并通过判断是否有这个注解或这个注解中属性的值,从而执行不同的程序代码段。

    我们实际开发中的自定义注解几乎都是使用的RetentionPolicy.RUNTIME;

  4. 在默认的情况下,自定义注解是使用的RetentionPolicy.CLASS。

@Documented

@Documented注解,是被用来指定自定义注解是否能随着被定义的java文件生成到JavaDoc文档当中。

@Inherited

@Inherited注解,是指某个自定义注解如果卸载了父类的声明部分,那么子类的声明部分也能自动拥有该注解,类似继承。@Inherited注解只对那些@Target被定义为ElementType.TYPE的自定义注解起作用。

注:类并不从它所实现的接口继承annotation,方法并不从它所重载的方法继承annotation。

自定义注解的特殊语法

  1. 特殊语法一

    如果注解本身没有注解类型元素,那么在使用注解的时候可以省略(),直接写为:@注解名,它和标准语法@注解名()等效!

    @Retention(RetentionPolicy.RUNTIME)
    @Target(value = {ElementType.TYPE})
    @Documented
    public @interface FirstAnnotation {
    }
    
    //等效于@FirstAnnotation()
    @FirstAnnotation
    public class DemoClass{//省略实现部分
    }
    
  2. 特殊语法二

    如果注解本本身只有一个注解类型元素,而且命名为value,那么在使用注解的时候可以直接使用:@注解名(注解值),其等效于:@注解名(value = 注解值)。

    @Retention(RetentionPolicy.RUNTIME)
    @Target(value = {ElementType.TYPE})
    @Documented
    public @interface SecondAnnotation {String value();
    }
    
    //等效于@SecondAnnotation(value = "this is second annotation")
    @SecondAnnotation("this is annotation")
    public class DemoClass{//省略实现部分
    }
    
  3. 特殊语法三

    如果注解中的某个注解类型元素是一个数组类型,在使用时又出现只需要填入一个值的情况,那么在使用注解时可以直接写为:@注解名(类型名 = 类型值),它和标准写法:@注解名(类型名 = {类型值})等效!

    @Retention(RetentionPolicy.RUNTIME)
    @Target(value = {ElementType.TYPE})
    @Documented
    public @interface ThirdAnnotation {String[] name();
    }
    
    //等效于@ThirdAnnotation(name = {"this is third annotation"})
    @ThirdAnnotation(name = "this is third annotation")
    public class DemoClass{//省略实现部分
    }
    

自定义注解的特殊语法

  1. 特殊语法一

    如果注解本身没有注解类型元素,那么在使用注解的时候可以省略(),直接写为:@注解名,它和标准语法@注解名()等效!

    @Retention(RetentionPolicy.RUNTIME)
    @Target(value = {ElementType.TYPE})
    @Documented
    public @interface FirstAnnotation {
    }
    
    //等效于@FirstAnnotation()
    @FirstAnnotation
    public class DemoClass{//省略实现部分
    }
    
  2. 特殊语法二

    如果注解本本身只有一个注解类型元素,而且命名为value,那么在使用注解的时候可以直接使用:@注解名(注解值),其等效于:@注解名(value = 注解值)。

    @Retention(RetentionPolicy.RUNTIME)
    @Target(value = {ElementType.TYPE})
    @Documented
    public @interface SecondAnnotation {String value();
    }
    
    //等效于@SecondAnnotation(value = "this is second annotation")
    @SecondAnnotation("this is annotation")
    public class DemoClass{//省略实现部分
    }
    
  3. 特殊语法三

    如果注解中的某个注解类型元素是一个数组类型,在使用时又出现只需要填入一个值的情况,那么在使用注解时可以直接写为:@注解名(类型名 = 类型值),它和标准写法:@注解名(类型名 = {类型值})等效!

    @Retention(RetentionPolicy.RUNTIME)
    @Target(value = {ElementType.TYPE})
    @Documented
    public @interface ThirdAnnotation {String[] name();
    }
    
    //等效于@ThirdAnnotation(name = {"this is third annotation"})
    @ThirdAnnotation(name = "this is third annotation")
    public class DemoClass{//省略实现部分
    }
    
public class PersonService {@Information(name = "Evan", age = 18, hobbies = {"编程", "看电影", "踢足球"})public void outputPersonInfo(Person person) {String outputStr = String.format("我是%s,我来自%s,今年%s岁,我的爱好是%s。",person.getName(),person.getAddress(),person.getAge(),person.getHobbies());System.out.println(outputStr);}
}
public class AnnotationTest {public static void main(String[] args) throws Exception {Class<?> clazz = PersonService.class;Method method = clazz.getMethod("outputPersonInfo", Person.class);if (!method.isAnnotationPresent(Information.class)){System.out.println(method.getName()+"方法没有标注@Information注解!");return;}Person person = new Person();Information information = method.getAnnotation(Information.class);person.setName(information.name());person.setAddress(information.address());person.setAge(information.age());person.setHobbies(Arrays.asList(information.hobbies()).toString());PersonService personService=new PersonService();method.invoke(personService,person);}
}

运行结果:

标注注解:
我是Evan,我来自中国,今年18岁,我的爱好是[编程, 看电影, 踢足球]。未标注注解:
outputPersonInfo方法没有标注@Information注解!
http://www.hskmm.com/?act=detail&tid=34437

相关文章:

  • 2025 年电磁流量计最新推荐榜,聚焦企业技术实力与市场口碑深度解析
  • 2025 年涡轮流量计厂家企业品牌推荐排行榜,揭秘行业前十优质品牌涡轮流量计公司推荐
  • 2025 年涡街流量计厂家企业品牌推荐排行榜,实力铸就良好口碑涡街流量计公司推荐
  • 练习篇:从零开始了解网络空间安全(网导1)
  • 2025年粘度计厂家推荐排行榜,在线/旋转/振动/实验室粘度计,反应釜/管线在线粘度计公司推荐!
  • 20232306 2025-2026-1 《网络与系统攻防技术》实验二实验报告
  • JAVA基础的ATM机存款项目
  • 对话式AI竞赛决赛队伍揭晓
  • 2025年粉末涂料厂家推荐排行榜,广东粉末,绝缘粉,钣金粉,烤漆粉,专业品质与市场口碑深度解析!
  • Boids算法
  • Spring Cloud RabbitMQ 详解:从基础概念到秒杀实战 - 详解
  • 2025年安装厂家权威推荐榜单:管道/电气/生物医药工厂机电/暖通空调/空压系统/纯水系统/厂房通风/车间配电/机械设备/工业设备安装公司精选
  • 35跬步本手@数学学习+计算机学习+语言学习@20251019
  • 【容器日志采集】【 四】消费kafka保存到es
  • 嵌入式实验3串口通信---任务二串口传输文件实验
  • 2025年润滑油厂家推荐排行榜,工业润滑油,汽车润滑油,发动机润滑油,甲醇发动机润滑油,全合成润滑油,长效发动机润滑油公司推荐!
  • 题解:loj6703 小 Q 的序列
  • 【容器日志采集】【二】fluent-bit配置文件
  • 【容器日志采集】【三】创建daemonsets采集日志发送到kafka
  • 2025年保洁公司权威推荐榜单:驻场/钟点/开荒/外包/商场/办公楼/工厂/医院/企业保洁服务优选指南
  • 2025年电源适配器厂家推荐排行榜,电脑/手机/平板电源适配器,高品质充电解决方案!
  • 解题报告-洛谷SCP2025T2 P14254 分割(divide)
  • 深入解析:Spring Cloud Netflix Eureka:从微服务基础到高可用集群实战
  • 2025.10.19——1绿1蓝
  • 别看我只是一只羊
  • 10.19 —— (VP)2022icpc西安
  • 2025年储罐源头厂家推荐排行榜,钢衬塑/钢塑复合/化工/防腐/PE/盐酸/硫酸/聚丙烯/不锈钢/次氯酸钠储罐公司精选!
  • 26-wsl-nginx-chinese-encoding-fix
  • win10-减少广告的三个操作
  • java方法