Java进阶——注解一文全懂

        Java注解(Annotation)是一种强大的元数据机制,为代码提供了附加信息,能简化配置、增强代码的可读性和可维护性。本文将深入探讨 Java 注解的相关知识。首先阐述了注解的基础概念,包括其本质、作用以及核心分类(内置注解、元注解、自定义注解)。接着深入讲解元注解,如@Target、@Retention、@Documented、@Inherited、@Repeatable等,解释了它们的用途和使用方式。还介绍了自定义注解的定义语法、属性类型限制及默认值设置,以及常见应用场景等。

本文目录

    • 一、注解基础概念
      • 1.1 本质与作用
      • 1.2 核心注解分类
    • 二、元注解详解
      • 2.1 @Target
      • 2.2 @Retention
      • 2.3 @Documented
      • 2.4 @Inherited
      • 2.5 @Repeatable
    • 三、自定义注解
      • 3.1 定义语法
      • 3.2 属性类型限制
      • 3.3 默认值
    • 四、注解处理方式
      • 4.1 编译时处理
      • 4.2 运行时处理
    • 五、常见应用场景
      • 5.1 框架配置
      • 5.2 API文档生成
      • 5.3 数据校验
      • 5.4 AOP切面编程
      • 5.5 单元测试
    • 六、工作日常实战应用
      • 6.1 接口权限控制注解
      • 6.2 基于角色的接口权限校验
    • 七、注解使用重要注意点
      • 7.1 注解继承问题
      • 7.2 默认值约束
      • 7.3 性能开销
    • 八、总结

一、注解基础概念

1.1 本质与作用

        注解本质上是元数据,它为代码提供了额外的信息,例如配置信息、标记信息或校验规则等。重要的是,注解并不直接影响代码的逻辑执行。在编译期或运行时,Java可以通过反射机制读取和处理这些注解,从而实现一些自动化的操作。

1.2 核心注解分类

  • 内置注解:Java提供了一些内置的注解,像@Override用于检查方法是否正确重写,@Deprecated用于标记某个方法或类已经废弃,@SuppressWarnings则可以抑制编译器产生的警告信息。
  • 元注解:元注解是用于定义其他注解的注解,常见的有@Target@Retention等。
  • 自定义注解:开发时可以根据具体的业务需求来定义自己的注解。


二、元注解详解

2.1 @Target

@Target注解用于指定一个注解可以应用的目标范围,它通过ElementType枚举来指定。例如:

@Target({
   ElementType.METHOD, ElementType.TYPE})
public @interface CustomAnnotation {
   }

常见的目标类型包括TYPE(类或接口)、METHOD(方法)、FIELD(字段)、PARAMETER(参数)等。

2.2 @Retention

@Retention注解定义了注解的保留策略,通过RetentionPolicy枚举来指定。有以下几种策略:

  • SOURCE:注解仅在源码级别存在,编译后会被丢弃,例如@Override
  • CLASS:注解会保留到字节码文件中,但在运行时不可见(默认策略)。
  • RUNTIME:注解在运行时可以通过反射机制读取,例如Spring的@Autowired

2.3 @Documented

@Documented注解用于标记一个注解是否应该包含在Javadoc中。

2.4 @Inherited

@Inherited注解允许子类继承父类的注解,但需要注意的是,它仅对类有效,对方法和字段无效。

2.5 @Repeatable

@Repeatable注解允许在同一位置重复使用同一个注解,不过需要配合一个容器注解一起使用。示例如下:

@Repeatable(Authorities.class)
public @interface Authority {
   
    String value();
}

public @interface Authorities {
   
    Authority[] value();
}



三、自定义注解

3.1 定义语法

自定义注解使用@interface关键字来定义,例如:

public @interface Loggable {
   
    String module

你可能感兴趣的:(Java,java,注解)