用注解实现字段映射的核心是通过@column和@table自定义注解+反射，建立java属性与数据库字段的可配置关联；支持显式指定列名、主键、空值约束，并可选驼峰转下划线默认策略。
用注解实现字段映射，核心是让 Java 对象的属性和数据库表字段建立可配置、可读取的关联关系。不需要写 XML 或大量模板代码，靠几个自定义注解 + 反射就能完成基础映射。
定义字段映射注解
创建一个 @Column 注解，用于标记实体类字段与数据库列的对应关系：
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Column {
String value() default ""; // 列名，如 "user_name"
boolean primaryKey() default false;
boolean nullable() default true;
}
再加一个 @Table 注解，标注类对应的表名：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface Table {
String value(); // 如 "t_user"
}
编写映射元数据提取器
通过反射读取类和字段上的注解，组装成结构化映射信息：
- 扫描类是否带有 @Table，获取表名
- 遍历所有声明字段，检查是否有 @Column
- 对每个带注解的字段，提取列名、是否主键、是否允许为空等属性
- 把字段名（Java 属性）和列名（数据库字段）存入 Map 或封装为 ColumnMapping 对象
示例逻辑片段：
Class> clazz = User.class;
Table tableAnno = clazz.getAnnotation(Table.class);
String tableName = tableAnno != null ? tableAnno.value() : clazz.getSimpleName().toLowerCase();
for (Field field : clazz.getDeclaredFields()) {
Column colAnno = field.getAnnotation(Column.class);
if (colAnno != null) {
String columnName = colAnno.value().isEmpty()
? field.getName() : colAnno.value();
boolean isPk = colAnno.primaryKey();
// 存入映射容器...
}
}
在 SQL 构建中使用映射结果
有了字段映射关系，就可以动态生成 SQL：
- INSERT：根据非主键字段生成列名列表和 ? 占位符，按顺序绑定参数
-
SELECT：拼接
SELECT col1, col2 FROM t_user，再用 ResultSet 反向匹配字段名 → 属性名 - UPDATE：WHERE 条件用主键字段，SET 部分排除主键字段
关键点是保持“属性名 ↔ 列名”的双向可查能力，例如用 Map{"userName" → "user_name"}，或更规范地用封装类缓存。
支持默认命名策略（可选增强）
若字段没加 @Column，可以按规则自动转换：比如 userName → user_name（驼峰转下划线）。这样减少样板注解，又保留显式覆盖能力：
- 优先使用注解指定的列名
- 未标注时调用 camelToUnderline(field.getName())
- 主键字段建议强制标注
@Column(primary = true)，避免推断歧义
这种柔性策略让框架既简洁又可控。
