@Target是编译期约束注解使用位置的元注解,决定语法合法性;如ElementType.PARAMETER限定仅用于方法参数,写错则编译失败,与运行时无关。
@target 不是运行时的“检查器”,而是编译期的“说明书”——它明确告诉 javac:这个注解**只允许写在哪些位置上**。写错地方,编译直接失败;写对了,jvm 运行时完全不关心它。
ElementType.PARAMETER:精准限定到方法参数
当你希望注解只用于方法形参(比如做参数校验、日志标记、注入标识),就用 ElementType.PARAMETER:
- 它专指方法或构造器的声明参数,不包括局部变量、字段或返回值
- 必须配合 @Retention(RetentionPolicy.RUNTIME) 才能在运行时通过反射读取参数上的注解
- 示例:
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidUserId { }
这样写后,只能出现在类似public void updateUser(@ValidUserId Long id)中;若误标在字段或方法体里,编译报错
ElementType.PACKAGE:唯一合法写法是 package-info.java
包级注解不能写在普通类文件中,必须放在名为 package-info.java 的特殊文件里:
- 文件名严格为
package-info.java,不能叫PackageInfo.java或其他变体 - 内容只有包声明 + 注解,例如:
@MyPackageLevelAnnotation
package com.example.api; - IDE(如 IntelliJ 或 Eclipse)通常不支持“新建类”方式创建该文件,需手动“新建文件”并命名为
package-info.java - 常见用途:统一配置包级行为(如 Spring 的
@ComponentScan默认扫描规则、文档生成、模块访问控制)
组合使用更贴近真实需求
单个 ElementType 往往不够用,多数实用注解支持多个位置:
- 比如校验注解
@NotNull常同时支持参数和字段:
@Target({ElementType.PARAMETER, ElementType.FIELD}) - 若还需支持构造器入参或局部变量(Java 8+),可继续追加:
@Target({ElementType.PARAMETER, ElementType.FIELD, ElementType.CONSTRUCTOR, ElementType.LOCAL_VARIABLE}) - 注意语法:即使只有一个类型,也必须用大括号包裹,
@Target(ElementType.METHOD)是非法写法,正确是@Target({ElementType.METHOD})
别和 @Retention 混淆:一个管“能写在哪”,一个管“能活到哪”
@Target 和 @Retention 各司其职,常成对出现但作用完全不同:
- @Target 决定语法合法性(编译期约束)
- @Retention 决定信息是否保留到运行时(影响能否用反射读取)
- 例如:
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.CLASS)
表示:允许标在参数上,但仅保留在 .class 文件里,运行时反射拿不到 —— 适合仅供字节码工具处理的场景










