Java中方法参数上的类型注解怎么通过 Parameter.getAnnotatedType 读取-java教程-PHP中文网

java中方法参数的类型注解必须声明为elementtype.type_use，才能通过parameter.getannotatedtype()正确读取；若声明为elementtype.parameter，则仅出现在getannotations()中，与类型无关。

java中方法参数上的类型注解怎么通过 parameter.getannotatedtype 读取

Java 中方法参数上的类型注解（Type Annotation），比如 @NonNull、@Positive 或自定义的 @MyTypeAnno，**必须声明为 ElementType.TYPE_USE**，才能通过 Parameter.getAnnotatedType() 正确读取。仅用 ElementType.PARAMETER 声明的注解，会出现在 Parameter.getAnnotations() 中，而不是类型上。

类型注解必须用 TYPE_USE 声明

这是最关键的前置条件。例如：

@Target(ElementType.TYPE_USE)
@Retention(RetentionPolicy.RUNTIME)
public @interface NonNull {}

如果写成 @Target(ElementType.PARAMETER)，它就属于“参数级注解”，和类型无关，getAnnotatedType() 不会包含它。

注解要写在类型位置，而非参数名前

正确写法（作用于类型）：

void process(@NonNull String name, @Positive int id) { ... }

错误写法（看似一样，实则语义不同）：

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

void process(String @NonNull name, int @Positive id) { ... } // ❌ 语法错误（除非用嵌套类型）

注意：@NonNull String 表示“非空的 String 类型”，注解修饰的是 String 这个类型；而 String @NonNull name 是非法的，因为 @NonNull 没有放在合法的类型使用位置（如泛型边界、数组维度、强制转换等）。标准参数类型注解就写在类型关键字前。

通过 getAnnotatedType() 获取并提取注解

Parameter.getAnnotatedType() 返回的是 AnnotatedType，需调用其 getAnnotations() 或 getAnnotation(Class<t>)</t>：

对于普通类型（如 @NonNull String），getAnnotatedType() 返回 AnnotatedType，调用 .getAnnotation(NonNull.class) 可直接获取
对于带泛型的类型（如 @NonNull List），需递归检查 AnnotatedParameterizedType 的原始类型和类型参数的 AnnotatedType
注意：getAnnotatedType().getAnnotations() 只返回该类型**顶层**的注解（即直接写在 String 上的 @NonNull），不包括泛型参数内部的注解（需手动展开）

完整示例代码

假设定义了：

@Target(ElementType.TYPE_USE)
@Retention(RetentionPolicy.RUNTIME)
@interface NotEmpty {}

void example(@NotEmpty String s, List list) {}

反射读取：

Method m = clazz.getDeclaredMethod("example", String.class, List.class);
Parameter p0 = m.getParameters()[0];
AnnotatedType at0 = p0.getAnnotatedType(); // 对应 @NotEmpty String
NotEmpty anno0 = at0.getAnnotation(NotEmpty.class); // ✅ 可拿到

Parameter p1 = m.getParameters()[1];
AnnotatedType at1 = p1.getAnnotatedType(); // 对应 List
if (at1 instanceof AnnotatedParameterizedType apt) {
    AnnotatedType[] typeArgs = apt.getAnnotatedActualTypeArguments();
    if (typeArgs.length > 0) {
        NotEmpty inner = typeArgs[0].getAnnotation(NotEmpty.class); // ✅ 拿到泛型里的 @NotEmpty
    }
}

不复杂但容易忽略：类型注解生效的前提是声明位置 + 使用位置都符合 TYPE_USE 规范，缺一不可。