注解是一种为代码添加元数据的特殊语法结构,使用@interface定义,可包含成员变量并设置默认值,通过@注解名应用于类、方法等程序元素,结合@Target、@Retention等元注解控制作用范围和生命周期,RUNTIME策略下可通过反射读取注解信息,广泛用于配置、校验、日志等场景。

注解(Annotation)是Java语言中一种特殊的语法结构,用于为代码添加元数据。它不会直接影响程序的逻辑,但可以被编译器、开发工具或运行时环境读取并处理,从而实现诸如代码检查、配置简化、依赖注入等功能。
注解的基本定义
注解本质上是一种接口,使用 @interface 关键字定义。它通常包含方法声明,这些方法相当于注解的成员变量,返回值类型只能是基本类型、String、Class、枚举、注解以及它们的数组类型。
示例:自定义一个简单的注解
public @interface Author { String name(); String email() default "unknown@example.com"; int year();}
上面定义了一个名为 Author 的注解,包含三个成员:name、email(带默认值)、year。使用 default 可以为成员设置默认值,使用时可不显式赋值。
注解的使用方法
定义好注解后,可以在类、方法、字段、参数等程序元素上使用它。使用时以 @注解名 的形式添加。
立即学习“Java免费学习笔记(深入)”;
示例:在类上使用 Author 注解
@Author(name = "张三", email = "zhangsan@example.com", year = 2024)public class MyService { // 类内容}
如果注解只有一个成员且名为 value,使用时可省略成员名。例如:
public @interface Description { String value();}@Description("这是一个工具类")public class Utils { // ...}
元注解:控制注解的行为
Java 提供了一些内置的“元注解”,用来修饰自定义注解,控制其作用范围和生命周期。
@Target:指定注解可以修饰哪些程序元素,如类、方法、字段等。常用取值包括 ElementType.TYPE(类)、ElementType.METHOD(方法)、ElementType.FIELD(字段)等。 @Retention:定义注解的保留策略。RetentionPolicy.SOURCE(源码期)、RetentionPolicy.CLASS(字节码期)、RetentionPolicy.RUNTIME(运行期),只有 RUNTIME 策略才能通过反射读取。 @Documented:表示该注解应被 javadoc 工具记录。 @Inherited:表示子类可以继承父类上的注解。示例:添加元注解
@Target({ElementType.TYPE, ElementType.METHOD})@Retention(RetentionPolicy.RUNTIME)public @interface Logger { String level() default "INFO";}
通过反射读取注解信息
若注解的保留策略为 RUNTIME,就可以在程序运行时通过反射获取注解信息。
示例:反射读取类上的注解
if (MyService.class.isAnnotationPresent(Author.class)) { Author author = MyService.class.getAnnotation(Author.class); System.out.println("作者:" + author.name()); System.out.println("邮箱:" + author.email()); System.out.println("年份:" + author.year());}
这段代码会输出 MyService 类上 Author 注解的具体值。
基本上就这些。掌握注解的定义、使用和反射读取,就能在实际开发中灵活应用,比如实现框架中的配置、权限校验、日志记录等功能。不复杂但容易忽略细节,尤其是元注解和保留策略的选择。
以上就是Java语法基础中注解的定义和使用方法的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/16789.html
微信扫一扫
支付宝扫一扫