如何限制注解仅标注在继承/实现指定父类/接口的类上并解决泛型报错

Java泛型存在运行时类型擦除机制，T的实际类型在代码运行时无法被自动感知，Reflections扫描注解得到的结果是无类型约束的Set<Class<?>>，直接赋值给Set<Class<T>>会触发编译期类型不匹配错误。同时你需要额外的运行时校验，保证标注了注解的类确实继承/实现了你要求的父类/接口，避免后续逻辑出现类型转换异常。

在构造函数中新增基类类型参数，用这个参数做运行时类型校验和安全转换，修改后的完整代码如下：

import java.util.HashSet;
import java.util.Set;
import org.bukkit.plugin.java.JavaPlugin;
import org.reflections.Reflections;
import java.lang.annotation.Annotation;

public abstract class Initializer<T> {
    private final JavaPlugin plugin;
    private final Set<Class<T>> classSet;

    /**
     * @param plugin 插件实例
     * @param reflections Reflections扫描实例
     * @param annotation 要扫描的自定义注解
     * @param baseType 注解允许标注的类必须继承/实现的基类/接口类型
     */
    public Initializer(JavaPlugin plugin, Reflections reflections, Class<? extends Annotation> annotation, Class<T> baseType) {
        this.plugin = plugin;
        Set<Class<?>> annotatedClasses = reflections.getTypesAnnotatedWith(annotation);
        this.classSet = new HashSet<>();

        for (Class<?> clazz : annotatedClasses) {
            // 校验当前类是否符合基类类型约束
            if (!baseType.isAssignableFrom(clazz)) {
                throw new IllegalArgumentException(
                    String.format("类%s标注了@%s，但未实现/继承要求的基类%s",
                        clazz.getName(),
                        annotation.getSimpleName(),
                        baseType.getName())
                );
            }
            // 校验通过后做类型转换，此处类型安全
            @SuppressWarnings("unchecked")
            Class<T> validClazz = (Class<T>) clazz;
            classSet.add(validClazz);
        }
    }

    public JavaPlugin getPlugin() {
        return plugin;
    }

    protected Set<Class<T>> getClassSet() {
        return classSet;
    }
}

调用示例 #

如果你的自定义注解仅允许标注在实现了CustomHandler接口的类上，初始化代码如下：

Initializer<CustomHandler> handlerInitializer = new Initializer<>(
    plugin,
    reflections,
    CustomAnnotation.class, // 你的自定义注解
    CustomHandler.class // 约束的基类类型
) {
    // 实现抽象业务逻辑
};

补充说明 #

• 上述代码在初始化阶段就会完成类型校验，一旦出现错误使用注解（标注在不符合类型要求的类上）的情况，会直接抛出异常快速失败，避免后续运行时出现隐蔽的类型转换错误。
• 如果你不需要强校验，只需要过滤掉不符合要求的类，直接删除抛出异常的分支即可，不符合类型的类会被自动跳过。
• 此处的@SuppressWarnings("unchecked")是安全的，因为转换前已经通过isAssignableFrom确认了类型匹配关系，不存在类型安全问题。

内容的提问来源于stack exchange，提问作者Lennert Soffers