如何在运行时注册可变数量的Jackson子类型以替代Mixin注解

完全可以通过运行时扫描+动态配置的方式，替代编译期的Mixin注解方案，实现对所有Figure接口实现类的JSON序列化/反序列化支持，效果和Mixin配置完全一致。以下是具体实现步骤：

1. 运行时扫描所有Figure接口实现类 #

首先需要扫描类路径下所有实现Figure的类，这里提供两种常用方案（按需选择）：

方案A：基于Spring工具类扫描（适合依赖Spring的场景） #

import org.springframework.context.annotation.ClassPathScanningCandidateComponentProvider;
import org.springframework.core.type.filter.AssignableTypeFilter;

import java.util.Set;
import java.util.stream.Collectors;

public class FigureClassScanner {
    public static Set<Class<? extends Figure>> scan(String basePackage) {
        ClassPathScanningCandidateComponentProvider scanner = new ClassPathScanningCandidateComponentProvider(false);
        scanner.addIncludeFilter(new AssignableTypeFilter(Figure.class));
        
        return scanner.findCandidateComponents(basePackage)
                .stream()
                .map(beanDef -> {
                    try {
                        return (Class<? extends Figure>) Class.forName(beanDef.getBeanClassName());
                    } catch (ClassNotFoundException e) {
                        throw new RuntimeException("加载Figure实现类失败", e);
                    }
                })
                .collect(Collectors.toSet());
    }
}

方案B：基于Reflections库扫描（无Spring依赖） #

先引入Reflections依赖（Maven为例）：

<dependency>
    <groupId>org.reflections</groupId>
    <artifactId>reflections</artifactId>
    <version>0.10.2</version>
</dependency>

然后实现扫描逻辑：

import org.reflections.Reflections;

import java.util.Set;

public class FigureClassScanner {
    public static Set<Class<? extends Figure>> scan(String basePackage) {
        Reflections reflections = new Reflections(basePackage);
        return reflections.getSubTypesOf(Figure.class);
    }
}

2. 动态配置Jackson ObjectMapper #

将扫描到的实现类注册到ObjectMapper，同时模拟原来Mixin的JsonTypeInfo配置：

import com.fasterxml.jackson.annotation.JsonTypeInfo;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.jsontype.impl.StdTypeResolverBuilder;

import java.util.Set;

public class FigureJacksonConfig {
    public static void setupObjectMapper(ObjectMapper mapper, Set<Class<? extends Figure>> figureImpls) {
        // 复刻Mixin中的类型信息配置：用"type"字段存储类型名称
        StdTypeResolverBuilder typeResolver = new StdTypeResolverBuilder()
                .init(JsonTypeInfo.Id.NAME, null)
                .inclusion(JsonTypeInfo.As.PROPERTY)
                .typeProperty("type");
        
        // 注册所有扫描到的子类型，默认用类名小写作为类型标识（可自定义规则）
        for (Class<? extends Figure> implClass : figureImpls) {
            String typeName = implClass.getSimpleName().toLowerCase();
            typeResolver.registerSubtype(implClass, typeName);
        }
        
        // 给Figure接口绑定类型解析规则
        mapper.setDefaultTyping(typeResolver);
    }
}

3. 整合使用示例 #

在类库初始化阶段执行扫描和配置：

// 扫描指定包下的所有Figure实现（可让使用者传入自定义包路径）
Set<Class<? extends Figure>> figureImpls = FigureClassScanner.scan("com.user.custom.package");

// 配置ObjectMapper
ObjectMapper objectMapper = new ObjectMapper();
FigureJacksonConfig.setupObjectMapper(objectMapper, figureImpls);

关键注意事项 #

• 扫描范围控制：必须让使用者指定扫描包路径，避免全类路径扫描带来的性能损耗。
• 类型标识自定义：可以扩展逻辑，比如让自定义实现类标注专属注解来指定type字段值，替代默认的类名规则。
• 类加载器兼容：如果使用者用自定义类加载器加载类，扫描时要确保使用对应的类加载器实例。
• 初始化时机：类路径扫描仅需执行一次，建议在类库启动时完成，不要重复执行。

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