Java 标准注解（内置注解+元注解）的详细说明及使用场景

以下是 Java 标准注解（内置注解）的详细说明及使用场景：

1. 核心标准注解

(1) @Override

用途：标记一个方法覆盖父类的方法或实现接口的抽象方法。
约束：
- 若方法未正确覆盖/实现，编译器会报错。
- 不能用于字段或类。

示例：

@Override
public void toString() {return "Custom toString()";
}

(2) @Deprecated

用途：标记过时的类、方法或字段，编译器会发出警告。
约束：
- 使用时需配合 @deprecated Javadoc 标记说明替代方案。

示例：

@Deprecated
public void oldMethod() {System.out.println("This method is deprecated!");
}

(3) @SuppressWarnings

用途：抑制特定编译器警告（如未使用的变量）。
参数：指定要抑制的警告类型（如 "unchecked"、"rawtypes"）。

示例：

@SuppressWarnings({"unchecked", "rawtypes"})
public void suppressWarningsExample() {List untypedList = new ArrayList(); // 抑制未指定泛型的警告
}

2. 元注解（Meta-Annotations）

元注解用于定义其他注解的特性，是注解的注解：

(1) @Target

用途：指定注解可应用的目标元素类型。
参数：ElementType 枚举值（如 METHOD, FIELD, TYPE 等）。

示例：

@Target(ElementType.METHOD)
@interface MyAnnotation {}

(2) @Retention

用途：指定注解的保留阶段。
参数：RetentionPolicy 枚举值：
- SOURCE：仅存在于源码，编译时丢弃（默认）。
- CLASS：编译到 class 文件，但运行时不可访问。
- RUNTIME：运行时可通过反射获取。

示例：

@Retention(RetentionPolicy.RUNTIME)
@interface RuntimeAnnotation {}

(3) @Documented

用途：将注解包含在 Javadoc 文档中。

示例：

@Documented
@interface DocumentedAnnotation {}

(4) @Inherited

用途：允许子类继承父类的注解（仅对类级别注解有效）。

示例：

@Inherited
@interface InheritedAnnotation {}@InheritedAnnotation
class Parent {}class Child extends Parent {} // 自动继承 @InheritedAnnotation

3. Java 8+ 新增注解

(1) @SafeVarargs

用途：抑制使用泛型数组时的 unchecked 警告，需确保参数不“泄漏”。
约束：仅对静态/最终方法有效。

示例：

@SafeVarargs
public final <T> void safeMethod(List<T>... lists) {// 安全操作泛型数组
}

(2) @FunctionalInterface

用途：标记一个接口为函数式接口（仅一个抽象方法）。
约束：若接口不符合条件，编译器报错。

示例：

@FunctionalInterface
interface MyFunc {void execute(); // 允许默认/静态方法
}

4. 其他常用注解

(1) @Repeatable（Java 8+）

用途：允许在同一位置多次使用同一注解（需配合容器注解）。

示例：

@Repeatable(Roles.class)
@interface Role {String value();
}@Role("admin") @Role("user")
class MyClass {} // 等价于 @Roles({@Role("admin"), @Role("user")})

(2) @Native

用途：标记本地方法（native 关键字的替代，但实际未被广泛使用）。

5. 使用场景总结

注解	典型用途
`@Override`	确保方法覆盖正确性。
`@Deprecated`	标记废弃的 API，提示开发者使用新方法。
`@SuppressWarnings`	抑制特定编译器警告（需谨慎使用，优先修复问题）。
`@Target`	定义自定义注解的适用范围。
`@Retention`	控制注解的生命周期（如是否在运行时可用）。
`@FunctionalInterface`	确保接口适合作为 Lambda 表达式的目标。

6. 注意事项

避免过度使用 @SuppressWarnings
优先修复警告根源，而非简单忽略。
自定义注解设计
通过元注解（@Target、@Retention）明确注解的约束和用途。
运行时处理
若需反射读取注解信息，必须设置 @Retention(RUNTIME)。

7. 示例：自定义注解

// 自定义注解：标记需要日志记录的方法
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@interface Loggable {String value() default "INFO";
}// 使用示例
public class MyService {@Loggable("DEBUG")public void doSomething() {// 方法体}
}