前置知识总览

本章不讲 forge-ddl 本身，只把框架里反复出现的「通用 Java / Spring 概念」拎出来扫盲，供其他章节用 前置知识 链接跳转。

何时来看本章

• 在《设计文档》或《使用指南》里看到陌生概念，点了它头顶的 前置知识 就会跳到这里
• 想系统补齐 Java 反射 / Spring 包扫描 / Spring Boot 启动流程的知识
• 想了解某个概念“在本框架里具体怎么用”

章节索引

主题	关键 API	在本框架的角色
Java 元注解	@Target / @Retention / @Documented	决定 @Model / @Field 是否能在运行时被反射读到
Java 反射	Class / Field / getDeclaredFields() / AnnotatedElement	DdlInitializer 用反射遍历字段、读注解、推导类型
Spring 包扫描	ClassPathScanningCandidateComponentProvider / AnnotationTypeFilter	ClazzScanner 不写正则、不重造轮子，直接复用 Spring 内置工具
Spring Boot 启动钩子	ApplicationRunner / CommandLineRunner	DdlInitializer 在容器装配完成之后、应用对外服务之前触发扫描
Spring Boot 自动装配	@AutoConfiguration / AutoConfiguration.imports / AutoConfigurationPackages	DdlAutoConfiguration 通过 imports 文件自动生效，无需业务模块手动配置

阅读约定

每一篇都遵循三段式：

1. 是什么 —— 一句话定义 + 出现年代 / 关键 JDK 或 Spring 版本
2. 怎么用 —— 最小可复制代码示例
3. 本框架怎么用 —— 跳回 design/ 或 reference/ 中具体位置