java注解

Java注解(Annotations)是Java提供的一种对代码进行标记的元数据(metadata)形式。注解本身不会直接影响代码的执行,但可以被编译器或运行时环境用来生成其他文件、进行编译检查或运行时处理。注解以@符号开头,后跟注解名。

注解的用途

  1. 信息提供:注解可以用来为代码(类、方法、变量等)提供额外的信息,这些信息可以在编译时或运行时被读取和处理。

  2. 编译时检查:通过自定义注解和注解处理器,可以在编译时检查代码的某些方面,例如检查是否遵循了特定的编程约定或规则。

  3. 运行时处理:注解也可以被用来在运行时通过反射查询注解信息,进而进行动态处理。

注解的分类

Java注解可以分为三种类型,根据它们的应用位置和目标不同来区分:

  1. 标记注解(Marker Annotations) :这种注解没有任何成员,仅作为一种标记存在。例如,@Override注解用于指示某个方法是重写了父类的方法。

  2. 单值注解(Single-Value Annotations):这种注解有一个成员,但成员的值在注解声明时指定,而不是在注解使用时指定。不过,由于Java注解的灵活性,通常不会严格区分单值注解和多值注解,因为即使是多值注解,也可以通过默认值使得某个成员看起来像是"单值"的。

  3. 完整注解(Full Annotations):这种注解可以包含多个成员,每个成员在注解使用时都需要(或可以选择)指定值。

元注解(Meta-Annotations)

Java定义了几个特殊的注解,称为元注解,用于修饰其他注解。元注解有:

  • @Target:指定被修饰的注解可以应用于哪些Java元素(如类、方法、字段等)。
  • @Retention:指定被修饰的注解的保留策略,即注解保留的时间长短。可以是源码中(SOURCE),类文件中(CLASS,默认值),或者运行时(RUNTIME)保留。
  • @Documented:指示被修饰的注解应该被javadoc工具记录。
  • @Inherited:指示被修饰的注解具有继承性,即如果某个类使用了该注解,那么它的子类也会自动继承这个注解。

自定义注解

你可以通过定义注解接口来创建自定义注解。注解接口使用@interface关键字来声明,并且注解内部定义的成员变量实际上是以无参方法的形式存在的,其返回值类型限定了成员变量的类型。

java 复制代码
public @interface MyAnnotation {
    String value() default "default value";
    int id() default -1;
}

在这个例子中,MyAnnotation是一个自定义注解,它有两个成员变量:valueid,并且都提供了默认值。

使用注解

注解的使用非常简单,只需在需要使用注解的Java元素前加上@符号和注解名即可。如果注解有成员变量需要指定值,可以使用括号()包围的键值对形式来指定。

java 复制代码
@MyAnnotation(value = "hello", id = 1)
public class MyClass {
    // 类体
}

总结

Java注解是一种强大的特性,它提供了一种为代码添加元数据的机制。这些元数据可以在编译时或运行时被读取和处理,从而实现各种功能,如编译时检查、自动生成代码、动态处理等。通过自定义注解和注解处理器,Java开发者可以创建出高度灵活和可扩展的代码库和框架。

相关推荐
Lhappy嘻嘻6 小时前
Java IO|File 文件操作 + 字节流 / 字符流完整笔记 + 递归删除文件实战
java·笔记·php
科技道人7 小时前
记录 默认置灰/禁用 app ‘Search Engine Selector‘ 的disable按钮
开发语言·前端·javascript
伊玛目的门徒7 小时前
试用leetcode之典中典 二数之和问题
java·算法·leetcode
逝水无殇9 小时前
C# 异常处理详解
开发语言·后端·c#
懒鸟一枚10 小时前
深入理解 Linux 内存、Swap 交换分区与分页机制的关系
java·linux·数据库
玖玥拾11 小时前
C# 语言进阶(十五)C# 游戏服务端 MySQL 数据库
服务器·开发语言·网络·数据库·mysql·c#
铅笔侠_小龙虾11 小时前
Rust 学习目录
开发语言·学习·rust
我命由我1234511 小时前
执行 Gradle 指令报错,无法将“grep”项识别为 cmdlet、函数、脚本文件或可运行程序的名称
android·java·java-ee·android studio·android jetpack·android-studio·android runtime
考虑考虑11 小时前
Sentinel安装
java·后端·微服务
云泽80811 小时前
从零吃透 C++ 异常:抛出捕获、栈展开、异常重抛与编码规范详解
开发语言·c++·代码规范