通过“注解+反射”实现低代码大屏中间件层的自动化路由与原子服务装配，即定义@AtomService注解标识服务路径与分类，扫描注册带注解类到内存路由表，再由Filter统一拦截请求并动态分发至对应AtomHandler处理，无需Spring MVC依赖，兼顾轻量性、可控性与可扩展性。
在自研低代码大屏的中间件层实现“注解 + 反射”驱动的自动化路由与原子服务装配，本质是构建一个轻量、可控、可扩展的服务注册与分发中枢。它不依赖 Spring MVC 的完整 Web 层，而是聚焦于大屏场景下高频调用的原子能力（如数据查询、图表渲染配置、权限校验、缓存刷新等），通过编译期约定 + 运行时扫描完成自动装配。
核心思路是：用自定义注解声明服务能力 → 类路径扫描识别 → 反射实例化 + 元数据注册 → 中间件统一拦截并路由到对应服务
一、定义标准化服务注解
为原子服务打标，明确其能力标识与路由路径：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface AtomService {
String value() default ""; // 路由路径，如 "/api/chart/config"
String category() default "chart"; // 分类，便于分组管理或权限控制
boolean enabled() default true;
}✅ 关键点：
@Retention(RUNTIME)是反射可用的前提；value()直接作为 HTTP 路径前缀，避免额外配置文件。
二、编写服务发现与注册器（非 Spring 管理）
跳过 Spring Boot 的 @Controller 自动注册逻辑，自己掌控生命周期：
- 使用
ClassGraph或Spring Boot内置的ResourcePatternResolver扫描指定包路径下的所有类； - 过滤出带有
@AtomService注解的类； - 反射创建实例（注意无参构造或支持
@Autowired构造需配合 BeanFactory）； - 将其实例 + 注解元数据存入内存注册表（如
ConcurrentHashMap<String, AtomHandler>）。
示例注册逻辑片段：
Map<String, AtomHandler> registry = new ConcurrentHashMap<>();
// 扫描 com.example.atoms 包下所有类
List<Class<?>> atomClasses = scanAtomClasses("com.example.atoms");
for (Class<?> cls : atomClasses) {
AtomService ann = cls.getAnnotation(AtomService.class);
if (ann != null && ann.enabled()) {
try {
Object instance = cls.getDeclaredConstructor().newInstance();
registry.put(ann.value(), new DefaultAtomHandler(instance, cls));
} catch (Exception e) {
log.warn("Failed to register atom service: {}", cls.getName(), e);
}
}
}✅ 关键点：注册器应在中间件启动早期执行（如
ServletContextListener或ApplicationRunner），确保路由表就绪后再接收请求。
三、中间件层统一拦截与动态分发
在 Servlet Filter 或 WebMvcConfigurer 的 HandlerMapping 前置位置，拦截匹配 /api/atoms/** 的请求：
- 提取路径后缀（如
/api/atoms/chart/config→/chart/config）； - 查 registry 表，找到对应
AtomHandler； - 调用其
handle(HttpServletRequest, HttpServletResponse)方法； - 支持统一异常包装、日志埋点、耗时统计。
public class AtomRouterFilter implements Filter {
private final Map<String, AtomHandler> registry;
@Override
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) {
HttpServletRequest request = (HttpServletRequest) req;
String path = request.getRequestURI();
if (path.startsWith("/api/atoms/")) {
String subPath = path.substring("/api/atoms".length());
AtomHandler handler = registry.get(subPath);
if (handler != null) {
handler.handle(request, (HttpServletResponse) res);
return; // 不再走后续链路
}
}
chain.doFilter(req, res);
}
}✅ 关键点：避免和 Spring MVC 冲突，建议将原子服务路由独立于
@RestController，用纯 Filter 控制权更清晰；响应体格式统一（如{code:0,data:{},msg:""}），便于前端 SDK 封装。
四、原子服务编写规范（开发者侧）
每个原子服务只需三步：
- 实现统一接口（如
AtomHandler），或继承抽象基类（含默认 JSON 解析、参数校验等）； - 加
@AtomService("/chart/data")注解； - 在方法内专注业务逻辑，不关心 HTTP 细节。
@AtomService("/chart/data")
public class ChartDataAtom implements AtomHandler {
@Override
public void handle(HttpServletRequest req, HttpServletResponse resp) throws IOException {
String chartId = req.getParameter("id");
Map<String, Object> data = queryChartData(chartId);
writeJson(resp, data);
}
}✅ 关键点：不强制依赖 Spring，适合嵌入式或信创环境；若需注入其他 Bean（如
DataSource），可通过ApplicationContextAware获取，或在注册器中手动 set。
不需要写上百个 @RequestMapping，也不用维护 XML 或 YAML 路由映射表。只要遵循注解规范，新原子服务打上包、重启中间件（或热加载），就能自动上线。对平台来说，这是可治理的扩展机制；对业务方来说，这是“写一个类，就多一个 API”的极简交付体验。
