java中“零配置路由分发”本质是用自定义注解（@controller/@route）替代xml/yaml，通过类路径扫描与反射动态注册并调用处理器。关键步骤：定义注解→启动时扫描控制器类及路由方法→构建路由表→运行时反射分发请求。
Java 中通过反射和注解实现“零配置路由分发”，本质是绕过 XML 或 YAML 配置，用注解标记处理器类/方法，运行时扫描、注册并动态分发请求。核心在于：自定义注解 + 类路径扫描 + 反射调用。下面分步说明关键实现逻辑和注意事项。
定义路由相关注解
需要至少两个注解：一个标记控制器类（如 @Controller），一个标记具体处理方法（如 @GetMapping 或通用 @Route）。
- @Controller：标识该类为路由处理器，可带 base path 属性（如 @Controller("/api")）
- @Route：标注方法，指定 HTTP 方法和路径，例如 @Route(method = "GET", path = "/users")
- 可选增强：支持占位符（/users/{id}）、正则约束、 consumes/produces 等，但基础版只需 path + method
启动时扫描并注册路由映射
在应用初始化阶段（如 main 方法后、或 Servlet 容器启动监听中），递归扫描 classpath 下所有 .class 文件，筛选出被 @Controller 标记的类，再遍历其 public 方法，提取 @Route 元数据，构建 路由表（Map
- 用 ClassPathScanningCandidateComponentProvider（Spring 风格）或手动遍历 ClassLoader.getResources() 获取类名
- 对每个候选类，用 Class.forName().getAnnotation(Controller.class) 判断是否为控制器
- 对每个匹配方法，解析 "/api" + 方法级 "/users" → "/api/users"）
- 将 "/api/users#GET" 作为 key，new HandlerMethod(instance, method) 作为 value 存入路由 Map
运行时根据请求匹配并反射调用
收到 HTTP 请求（如通过自定义 Servlet 或 Jetty Handler）后，解析请求方法（GET/POST）和 URI，构造唯一查找键（如 "/users#GET"），查路由表获取目标方法，再用反射执行：
- 从路由表取出 HandlerMethod 对象，它封装了 controller 实例（需提前创建或按需单例化）和 Method 对象
- 用 method.setAccessible(true) 绕过访问控制（尤其 private 方法）
- 解析 URL 路径参数（如 /users/123 → 提取 id=123）、查询参数、请求体，组装成 Object[] args
- 调用 method.invoke(handlerInstance, args)，返回值可转 JSON 写入响应流
注意点与简化建议
零配置不等于无约定。为降低复杂度，建议：
- controller 类必须有无参构造器（便于反射实例化）
- 路由方法参数尽量简单（String、Long、自定义 DTO 可用 Jackson 自动反序列化，但需引入依赖）
- 避免过度扫描：限定包路径（如 com.example.web），提升启动速度
- 异常统一处理：捕获 IllegalAccessException、InvocationTargetException 等，转为 500 响应
- 生产环境慎用：反射性能略低，且 IDE 和静态分析工具难追踪路由，建议配合注释或生成路由文档
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
