Java基础里的@Target是什么?怎么用?

@Target是Java中限定自定义注解适用位置的元注解,通过ElementType枚举值(如TYPE、METHOD、FIELD等)约束其使用范围,配合@Retention可精确控制注解生命周期。

@Target 是 Java 中的一个元注解(meta-annotation),用来**限定自定义注解可以被用在哪些程序元素上**。它不提供功能逻辑,只起“约束作用”——告诉编译器:这个注解只能写在类、方法、字段、参数等特定位置,否则编译报错。

它能限制哪些地方?

通过 @Target 的 value 参数,传入一个或多个 ElementType 枚举值,比如:

  • ElementType.TYPE:类、接口、枚举
  • ElementType.METHOD:方法声明
  • ElementType.FIELD:成员变量(字段)
  • ElementType.PARAMETER:方法参数
  • ElementType.LOCAL_VARIABLE:局部变量(Java 8+ 支持)
  • ElementType.ANNOTATION_TYPE:用在其他注解上(即元注解)

怎么写一个带 @Target 的自定义注解?

定义时直接在注解上加 @Target,例如:

@Target(ElementType.METHOD)
public @interface LogExecutionTime {
}

这样写完后,LogExecutionTime 只能标注在方法上。如果强行写在类上:

@LogExecutionTime  // 编译错误!
public class UserService { ... }

编译器会提示:“Annotation '@LogExecutionTime' is not applicable to this kind of decl

aration”。

常见组合写法

一个注解常支持多种位置,用大括号包住多个 ElementType:

@Target({ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.FIELD})
public @interface NotNull {
}

上面的 @NotNull 就允许用在方法、构造器、字段三处。注意:不能省略大括号,即使只有一个类型也要写成 @Target(ElementType.METHOD)(这是语法要求)。

和 @Retention 有什么区别?

@Target 管“能写在哪”,@Retention 管“保留到什么时候”(源码期、编译期、运行期)。两者经常一起出现:

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Retryable {
    int maxAttempts() default 3;
}

这表示:该注解只能用于方法,且在运行时可通过反射读取。

基本上就这些。用对 @Target,能让注解更安全、更清晰,避免误用。