Java中如何使用注解？自定义注解开发-java教程-PHP中文网

Java中如何使用注解？自定义注解开发

星夢妙者

发布： 2025-07-11 18:16:02

原创

177人浏览过

java 中的注解是一种提供元数据的机制，不影响程序逻辑但能提升代码可读性和简化配置。1. 常见内置注解如 @override、@deprecated、@suppresswarnings 和 @functionalinterface 用于编译期检查和提示。2. 自定义注解通过 @interface 定义，包含带默认值的属性，使用时可省略属性名。3. 元注解如 @retention、@target、@documented 和 @inherited 控制注解的行为与生命周期。4. 通过反射机制可在运行时获取并处理注解信息，实现动态逻辑处理。5. 使用时应避免滥用，合理设计结构，并注意 retention 策略与配合其他机制使用。

Java中如何使用注解？自定义注解开发

在 Java 中，注解（Annotation）是一种元数据，它为代码提供额外的信息，但本身不会直接影响程序的逻辑。合理使用注解可以提升代码可读性、简化配置、甚至实现某些框架级别的功能。自定义注解则是进阶开发中常用的技术，尤其在 Spring、Hibernate 等主流框架中大量应用。

下面我们就来看看Java 中如何使用注解，以及如何开发自定义注解。

1. 常见内置注解及其用途

Java 提供了一些常用的内置注解，比如：

立即学习“Java免费学习笔记（深入）”；

@Override：表示方法重写了父类的方法。
@Deprecated：标记某个类、方法或字段已过时。
@SuppressWarnings：压制编译器警告。
@FunctionalInterface：声明一个函数式接口（Java 8+）。

这些注解主要用于编译阶段提示或检查，帮助开发者写出更规范、安全的代码。

例如：

@Override
public String toString() {
    return "User{}";
}

登录后复制

如果没正确覆盖父类方法，编译器会报错。

2. 自定义注解的基本结构

要创建自己的注解，使用 @interface 关键字即可。一个简单的自定义注解如下：

public @interface MyAnnotation {
    String value() default "default value";
    int count() default 1;
}

登录后复制

这个注解有两个属性：value 和 count，都有默认值。使用方式如下：

@MyAnnotation(value = "hello", count = 5)
public class MyClass {
}

登录后复制

如果你只设置了一个属性，并且是 value()，可以省略属性名：

@MyAnnotation("just value")

登录后复制

3. 注解的元注解（Meta-Annotations）

为了让自定义注解具备更多行为，Java 提供了几个“元注解”，用来标注注解本身的特性：

@Retention：指定注解保留策略（SOURCE / CLASS / RUNTIME）
@Target：指定注解可以用于哪些地方（如 METHOD, TYPE, FIELD 等）
@Documented：是否被文档工具记录
@Inherited：子类是否继承该注解

举个例子，如果我们希望注解能在运行时通过反射访问到，就要加上：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface MyRuntimeAnnotation {
}

登录后复制

这样就可以在运行时获取类上的注解信息了。

4. 获取并处理注解（反射机制）

自定义注解本身没有实际功能，它的作用往往是在运行时通过反射机制来解析和使用。

以下是一个基本的反射获取注解的例子：

if (MyClass.class.isAnnotationPresent(MyAnnotation.class)) {
    MyAnnotation annotation = MyClass.class.getAnnotation(MyAnnotation.class);
    System.out.println(annotation.value());
    System.out.println(annotation.count());
}

登录后复制

通过这种方式，我们可以根据注解的内容动态执行逻辑，比如自动注册 Bean、校验参数等。

很多框架（如 Spring）就是基于这种机制实现了依赖注入、AOP 等功能。